SRModeID 属性

  • 项目

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

Description

返回或设置字符使用的语音识别引擎。

语法

agent**。字符 (“CharacterID”) 。SRModeID** [ = ModeID]

组成部分 说明
ModeID 对应于语音引擎的模式 ID 的字符串表达式。

 

备注

属性确定字符用于语音输入的语音识别引擎。 语音识别引擎的模式 ID 是由唯一标识引擎的语音供应商定义的格式化字符串。 有关详细信息，请参阅 在代码中访问语音引擎。

如果为未安装的语音引擎指定模式 ID、用户在 Microsoft 代理属性表) 中禁用了语音识别 (，或者指定的语音引擎的语言与字符的 LanguageID 设置不匹配，则服务器将引发错误。

如果查询此属性，但尚未成功 () 设置语音识别引擎，则服务器将根据字符的 LanguageID 设置返回 SAPI 返回的引擎的模式 ID。 如果尚未设置字符的 LanguageID，则代理会根据用户的默认语言 ID 设置返回 SAPI 返回的引擎的模式 ID。 如果没有匹配的引擎，服务器将返回空字符串 (“”) 。 查询此属性不需要将 SpeechInput.Enabled 设置为 True。 但是，如果在禁用语音输入时查询 属性，服务器将返回一个空字符串。

在“高级字符选项”窗口中 (启用语音输入) 时，查询或设置此属性将加载关联的引擎 (（如果尚未加载) ），并启动语音服务。 也就是说，“侦听”键可用，并且“侦听提示”可显示。 (仅当在“高级字符选项”中也启用“侦听键”和“侦听提示”时才启用。) 但是，如果在禁用语音时查询属性，服务器不会启动语音服务。

此属性仅适用于客户端应用程序对 字符的使用;设置不会影响客户端应用程序的字符或其他字符的其他客户端。

Microsoft 代理的语音引擎要求基于 Microsoft 语音 API。 支持 Microsoft 代理 SAPI 要求的引擎可以与代理一起安装并使用。

注意

如果系统上未安装兼容的声音支持，则此属性还会返回空字符串。

 

注意

查询此属性通常不会返回错误。 但是，如果语音引擎加载时间过长，则可能会收到一个错误，指示查询超时。

 

另请参阅

LanguageID 属性