SRModeID 属性

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

Description

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

语法

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

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

 

注解

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

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

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

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

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

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

注意

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

 

注意

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

 

另请参阅

LanguageID 属性