命令事件

[自 Windows 7 起弃用 Microsoft Agent，在后续版本的 Windows 中可能不可用。]

描述

当用户选择（客户端）命令时发生。

语法

Sub agent_Command (ByVal UserInput**)**

组成部分	说明
UserInput	标识服务器返回的 Command 对象。 可以从 Command 对象访问以下属性： CharacterID 标识接收命令的字符名称 (ID) 的字符串值。 Name 标识命令名称 (ID) 的字符串值。 Confidence 一个长整数值，表示命令的置信度评分。 语音 标识命令语音文本的字符串值。 Alt1Name 标识下一个（第二个）最佳命令名称的字符串值。 Alt1Confidence 一个长整数值，表示下一个（第二个）最佳命令的置信度评分。 Alt1Voice 一个字符串值，用于标识下一个最佳替代命令匹配的语音文本。 Alt2Name 标识第三个最佳命令匹配名称的字符串值。 Alt2Confidence 一个长整数，用于标识第三个最佳命令匹配的置信度评分。 Alt2Voice 一个字符串值，用于标识第三个最佳命令匹配的语音文本。 计数 表示返回的替代方案数量的长整数值。

注解

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

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

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

如果语音输入不是命令的来源，例如如果用户从字符的弹出菜单中选择命令，则服务器将返回在 Name 属性中所选命令的名称 (ID)。 它还将置信度参数的值返回为 100，语音参数的值返回为空字符串 ("")。 Alt1Name 和 Alt2Name 也返回空字符串。 Alt1Confidence 和 Alt2Confidence 返回零 (0)，Alt1Voice 和 Alt2Voice 返回空字符串。 计数返回 1。

注意

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