IAgentCommand::SetVoice

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

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

명령대한 Voice 속성을 설정합니다.

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

bszVoice

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

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

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

별표(*) 연산자를 사용하여 그룹에 포함된 단어의 인스턴스를 0개 이상 지정하거나 더하기(+) 연산자를 사용하여 하나 이상의 인스턴스를 지정할 수 있습니다. 예를 들어 다음을 수행하면 "try this", "please try this", "please please try this"를 지원하는 문법이 생성되며, "please"를 무제한으로 반복합니다.

   "please* try this"

+ 연산자가 "please"의 인스턴스를 하나 이상 정의하므로 다음 문법 형식은 "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 피자!" 대신 "숫자 10달러 피자"를 사용합니다. 한 명령에 대해 발음할 수 없는 문자나 기호를 포함하면 음성 엔진이 모든 명령에 대한 문법을 컴파일하지 못할 수 있습니다. 마지막으로, 정의한 다른 음성 명령에서 음성 매개 변수를 가능한 한 명확하게 만듭니다. 명령에 대한 음성 문법 간의 유사성이 클수록 음성 엔진이 인식 오류를 발생시킬 가능성이 높습니다. 신뢰도 점수를 사용하여 유사하거나 유사한 음성 문법을 가질 수 있는 두 명령을 더 잘 구분할 수도 있습니다.

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

참고 항목

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