명령 이벤트

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

Description

사용자가 (클라이언트의) 명령을 선택할 때 발생합니다.

Syntax

Subagent_Command(ByValUserInput**)**

부분

Description

UserInput

서버에서 반환된 Command 개체를 식별합니다. Command 개체에서 다음 속성에 액세스할 수 있습니다. CharacterID 명령을 받은 문자의 이름(ID)을 식별하는 문자열 값입니다. 이름 명령의 이름(ID)을 식별하는 문자열 값입니다. 신뢰도 명령에 대한 신뢰도 점수를 나타내는 Long 정수 값입니다. 음성 명령의 음성 텍스트를 식별하는 문자열 값입니다. Alt1Name 다음(두 번째) 최상의 명령의 이름을 식별하는 문자열 값입니다. Alt1Confidence 다음(두 번째) 최상의 명령에 대한 신뢰도 점수를 나타내는 Long 정수 값입니다. Alt1Voice 다음으로 가장 적합한 대체 명령 일치를 위한 음성 텍스트를 식별하는 문자열 값입니다. Alt2Name 세 번째 최상의 명령 일치 이름을 식별하는 문자열 값입니다. Alt2Confidence 세 번째 최고의 명령 일치에 대한 신뢰도 점수를 식별하는 Long 정수입니다. Alt2Voice 세 번째 최상의 명령 일치에 대한 음성 텍스트를 식별하는 문자열 값입니다. 개수 반환된 대체 항목 수를 나타내는 긴 정수 값입니다.

설명

서버는 애플리케이션이 입력 활성 상태이고 사용자가 음성 입력 또는 문자의 팝업 메뉴로 명령을 선택할 때 이 이벤트를 알립니다. 이벤트는 Count 에서 가능한 일치 명령 수와 해당 일치 항목의 이름, 신뢰도 점수 및 음성 텍스트를 다시 전달합니다.

음성 입력이 이 이벤트를 트리거하는 경우 서버는 Name 매개 변수에서 가장 일치하는 문자열을 반환하고 Alt1Name 및 Alt2Name 에서 두 번째 및 세 번째로 일치하는 문자열을 반환합니다. 빈 문자열은 입력이 애플리케이션이 정의한 명령과 일치하지 않음을 나타냅니다. 예를 들어 서버의 정의된 명령 중 하나일 수 있습니다. 명령이 에이전트의 명령과 일치하는 경우 예를 들어 Hide, 빈 문자열은 Name 매개 변수에 반환되지만 Voice 매개 변수에서 들은 텍스트는 계속 수신됩니다.

둘 이상의 항목에서 반환된 동일한 명령 이름을 가져올 수 있습니다. Confidence, Alt1Confidence 및 Alt2Confidence 매개 변수는 각 일치 항목에 대해 음성 인식 엔진에서 반환하는 상대 점수(-100~100)를 반환합니다. Voice, Alt1Voice 및 Alt2Voice 매개 변수는 음성 인식 엔진이 각 대안에 대해 일치하는 음성 텍스트를 반환합니다. Count가 0을 반환하면 서버에서 음성 입력을 검색했지만 일치하는 명령이 없음을 확인했습니다.

예를 들어 사용자가 문자의 팝업 메뉴에서 명령을 선택한 경우 음성 입력이 명령의 원본이 아닌 경우 서버는 Name속성에서 선택한 명령의 이름(ID)을 반환합니다. 또한 Confidence 매개 변수의 값을 100으로 반환하고 Voice 매개 변수의 값을 빈 문자열("")로 반환합니다. Alt1Name 및 Alt2Name도 빈 문자열을 반환합니다. Alt1Confidence 및 Alt2Confidence는 0을 반환하고 Alt1Voice 및 Alt2Voice는 빈 문자열을 반환합니다. Count 는 1을 반환합니다.

참고

모든 음성 인식 엔진이 이 이벤트의 모든 매개 변수에 대한 모든 값을 반환할 수 있는 것은 아닙니다. 엔진 공급업체에 문의하여 엔진이 대체 및 신뢰도 점수를 반환하기 위해 Microsoft Speech API 인터페이스를 지원하는지 확인합니다.