Command 事件

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

Description

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

语法

Subagent_Command (ByValUserInput**) **

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

注解

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

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

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

例如,如果用户从字符的弹出菜单中选择命令,则服务器返回名称 (ID) Nameproperty 中选择的命令。 它还将 Confidence 参数的值作为 100 返回, 语音 参数的值作为空字符串 (“”) 。 Alt1Name 和 Alt2Name 还返回空字符串。 Alt1Confidence 和 Alt2Confidence 返回零 (0) ,Alt1Voice 和 Alt2Voice 返回空字符串。 计数 返回 1。

注意

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