命令事件

[从 Windows 7 开始，Microsoft 代理已弃用，可能在后续版本的 Windows 中不可用。]

Description

当用户选择 (客户端的) 命令时发生。

语法

Subagent_Command (ByValUserInput**) **

组成部分

说明

UserInput

标识服务器返回的 Command 对象。 可以从 Command 对象访问以下属性： CharacterID 一个字符串值，标识接收命令的字符的名称 (ID) 。 名称 一个字符串值，标识命令的名称 (ID) 。 置信度 一个 Long 整数值，指示命令的置信度评分。 语音 标识命令的语音文本的字符串值。 Alt1Name 一个字符串值，标识下一个 (秒) 最佳命令的名称。 Alt1Confidence 一个 Long 整数值，指示下一个 (秒) 最佳命令的置信度评分。 Alt1Voice 一个字符串值，用于标识下一个最佳备用命令匹配的语音文本。 Alt2Name 一个字符串值，标识第三个最佳命令匹配项的名称。 Alt2Confidence 一个长整型，标识第三最佳命令匹配项的置信度评分。 Alt2Voice 一个字符串值，用于标识第三个最佳命令匹配的语音文本。 Count 指示返回的替代项数的长整型值。

备注

当应用程序处于输入活动状态并且用户通过口述输入或字符的弹出菜单选择命令时，服务器会发出此事件通知。 事件在 Count 中传回可能的匹配命令数，以及这些匹配项的名称、置信度评分和语音文本。

如果语音输入触发此事件，服务器将返回一个字符串，该字符串标识 Name 参数中的最佳匹配项，以及 Alt1Name 和 Alt2Name 中的第二和第三最佳匹配项。 空字符串指示输入与应用程序定义的任何命令都不匹配;例如，它可以是服务器定义的命令之一。 如果命令与 代理的 命令匹配;例如 Hide， Name 参数中将返回空字符串，但仍会收到 Voice 参数中听到的文本。

你可能会在多个条目中返回相同的命令名称。 Confidence、Alt1Confidence 和 Alt2Confidence 参数返回 -100 到 100 范围内的相对分数，这些分数由语音识别引擎为每个相应的匹配项返回。 Voice、Alt1Voice 和 Alt2Voice 参数返回语音识别引擎为每个替代项匹配的语音文本。 如果 Count 返回零 (0) ，则服务器检测到语音输入，但确定没有匹配的命令。

如果语音输入不是命令的源，例如，如果用户从字符的弹出菜单中选择命令，服务器将返回名称 (ID) Name 属性中选择的命令。 它还将 Confidence 参数的值作为 100 返回， 并将 Voice 参数的值作为空字符串返回 (“”) 。 Alt1Name 和 Alt2Name 也返回空字符串。 Alt1Confidence 和 Alt2Confidence 返回零 (0) ，Alt1Voice 和 Alt2Voice 返回空字符串。 Count 返回 1。

注意

并非所有语音识别引擎都可以返回此事件的所有参数的所有值。 请咨询引擎供应商，确定引擎是否支持用于返回替代项和置信度分数的 Microsoft 语音 API 接口。