IAgentCommand::SetVoice

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT SetVoice(
   BSTR bszVoice  // voice text setting for Command
);

Command의 Voice 속성을 설정합니다.

  • 작업이 성공했음을 나타내는 S_OK 반환합니다.

bszVoice

명령의 Voice 속성에 대한 텍스트를 지정하는 BSTR입니다.

명령에는 음성 속성과 Enabled 속성이 음성 액세스 가능으로 설정되어 있어야 합니다. 또한 VoiceCaption 속성이 음성 명령 창에 표시되도록 설정되어 있어야 합니다. 이전 버전과의 호환성을 위해 VoiceCaption이 없으면 캡션 설정이 사용됩니다.

제공하는 BSTR 식에는 선택적 단어를 나타내는 대괄호 문자([ ])와 대체 문자열을 나타내는 세로 막대 문자(|)가 포함될 수 있습니다. 대체 항목은 괄호로 묶어야 합니다. 예: "(hello [there] | hi)"는 명령에 대해 "hello", "hello there" 또는 "hi"를 수락하도록 음성 엔진에 지시합니다. 대괄호 또는 괄호 안에 있는 텍스트와 대괄호 또는 괄호 안의 텍스트 사이에 적절한 공백을 포함해야 합니다.

star(*) 연산자를 사용하여 그룹에 포함된 단어의 인스턴스를 0개 이상 지정하거나 더하기(+) 연산자를 사용하여 하나 이상의 인스턴스를 지정할 수 있습니다. 예를 들어 다음에서는 "try this", "please try this", "please try this"를 지원하는 문법을 "please"의 무제한 반복과 함께 만듭니다.

   "please* try this"

+ 연산자가 "please"의 하나 이상의 instance 정의하기 때문에 다음 문법 형식은 "try this"를 제외합니다.

   "please+ try this"

반복 연산자는 일반적인 우선 순위 규칙을 따르고 바로 앞의 텍스트 항목에 적용됩니다. 예를 들어 다음 문법은 "뉴욕"과 "뉴욕"을 반환하지만 "뉴욕 뉴욕"은 반환하지 않습니다.

   "New York+"

따라서 일반적으로 이러한 연산자를 그룹화 문자와 함께 사용하려고 합니다. 예를 들어 다음 문법에는 "뉴욕"과 "뉴욕 뉴욕"이 모두 포함됩니다.

   "(New York)+"

반복 연산자는 전화 번호 또는 항목 목록의 사양과 같은 반복 시퀀스를 포함하는 문법을 작성하려는 경우에 유용합니다.

   "call (one|two|three|four|five|six|seven|eight|nine|zero|oh)*"
   "I'd like (cheese|pepperoni|pineapple|canadian bacon|mushrooms|and)+"

연산자를 대괄호(선택적 그룹화 문자)와 함께 사용할 수도 있지만 이렇게 하면 에이전트가 문법을 처리하는 효율성이 저하될 수 있습니다.

줄임표(...)를 사용하여 단어 스포팅을 지원할 수도 있습니다. 즉, 음성 인식 엔진이 구(가 비 지 단어라고도 함)에서 이 위치에서 말하는 단어를 무시하도록 지시합니다. 따라서 음성 엔진은 인접한 단어 또는 구를 사용하여 말할 때와 관계없이 문자열의 특정 단어만 인식합니다. 예를 들어 이 속성을 "[...]로 설정하면 검사 메일 [...]" 음성 인식 엔진은 이 명령에 "메일을 검사" 또는 "검사 메일 주세요"와 같은 구와 일치합니다. 줄임표는 문자열 내의 어디에서나 사용할 수 있습니다. 그러나 타원을 사용하는 음성 설정이 원치 않는 일치의 가능성을 증가시킬 수 있으므로 이 기술을 사용하여 주의해야 합니다.

명령에 대한 단어와 문법을 정의할 때는 항상 필요한 단어를 하나 이상 포함해야 합니다. 즉, 선택적 단어만 제공하지 않습니다. 또한 단어에 발음 가능한 단어와 문자만 포함되어 있는지 확인합니다. 숫자의 경우 숫자 표현을 사용하는 대신 단어의 철자를 지정하는 것이 좋습니다. 또한 문장 부호 또는 기호를 생략합니다. 예를 들어 "#1 $10 pizza!" 대신 "숫자 10달러 피자"를 사용합니다. 한 명령에 대해 발음할 수 없는 문자나 기호를 포함하면 음성 엔진이 모든 명령에 대한 문법을 컴파일하지 못할 수 있습니다. 마지막으로, 정의한 다른 음성 명령에서 음성 매개 변수를 가능한 한 고유하게 만듭니다. 명령에 대한 음성 문법 간의 유사성이 클수록 음성 엔진에서 인식 오류가 발생할 가능성이 높습니다. 신뢰도 점수를 사용하여 유사하거나 유사한 음성 문법을 가질 수 있는 두 명령을 더 잘 구분할 수도 있습니다.

명령에대한 Voice 속성을 설정하면 에이전트의 음성 서비스가 자동으로 활성화되어 수신 대기 키 및 수신 대기 팁을 사용할 수 있습니다. 그러나 음성 인식 엔진을 로드하지는 않습니다.

참고

사용할 수 있는 문법 기능은 음성 인식 엔진에 따라 달라질 수 있습니다. 엔진 공급업체와 검사 지원되는 문법 옵션을 확인할 수 있습니다. IAgentCharacterEx::SRModeID를 사용하여 엔진을 지정합니다.

 

참고 항목

IAgentCommand::GetVoice, IAgentCommand::SetCaption, IAgentCommand::SetEnabled, IAgentCommands::Add, IAgentCommands::Insert