IAgentCharacterEx::SetSRModeID

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

HRESULT SetSRModeID(
   BSTR bszModeID  // speech recognition engine ID
);

设置字符的语音识别引擎集的模式 ID。

  • 返回指示操作成功的S_OK。

bszModeID

字符的语音识别引擎的模式 ID 设置。

此设置为角色的语音输入设置引擎。 语音识别引擎的模式 ID 是由语音供应商定义的 GUID,用于唯一标识引擎的模式 (使用大括号和短划线) 格式。 有关详细信息,请参阅 Microsoft 语音 SDK 文档

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

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

此属性仅适用于 字符的客户端;设置不反映其他客户端的字符或客户端的其他字符的设置。

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

另请参阅

IAgentCharacterEx::GetSRModeID