IAgentCharacterEx::GetSRModeID
[Microsoft 代理从 Windows 7 开始已弃用,可能在后续版本的 Windows 中不可用。]
HRESULT GetSRModeID(
BSTR * pbszModeID // address of speech recognition engine ID
);
检索字符的语音识别引擎集的模式 ID。
- 返回指示操作成功的S_OK。
-
pbszModeID
-
接收字符语音识别引擎的模式 ID 设置的 BSTR 的地址。
此设置返回字符语音输入的引擎集。 语音识别引擎的模式 ID 是 GUID (格式的字符串表示形式,由唯一标识引擎的语音供应商) 大括号和短划线。 有关详细信息,请参阅 Microsoft 语音 SDK 文档。
如果未为字符设置语音识别引擎模式 ID,则服务器将使用 Microsoft 语音 API 接口) 返回与字符的语言设置 (匹配的引擎。 如果没有匹配的语音识别引擎可用于字符,则服务器将返回空 (空) 字符串。
在“高级字符选项”窗口中 (启用语音输入) 时,查询或设置此属性将加载关联的引擎 ((如果尚未加载) ),并启动语音服务。 也就是说,“侦听”键可用,并且“侦听提示”可显示。 (仅当在“高级字符选项”中也启用“侦听键”和“侦听提示”时才启用。) 但是,如果在禁用语音时查询属性,服务器不会启动语音服务,并且它将返回空字符串 (空字符串) 。
此函数仅返回客户端应用程序使用 字符的设置;设置不反映客户端应用程序的字符或其他字符的其他客户端。
如果 IAgentSpeechInputProperties::GetEnabled 返回 False,则此函数不会失败。
Microsoft 代理的语音引擎要求基于 Microsoft 语音 API。 支持 Microsoft 代理 SAPI 要求的引擎可以与代理一起安装并使用。
另请参阅
IAgentCharacterEx::SetSRModeID