IAgentCharacterEx::SetTTSModeID
[自 Windows 7 起弃用 Microsoft 代理,在后续版本的 Windows 中可能不可用。
HRESULT SetTTSModeID(
BSTR bszModeID // TTS engine ID
);
设置字符的 TTS 引擎集的模式 ID。
- 返回S_OK以指示操作成功。
-
bszModeID
-
字符的 TTS 引擎的模式 ID 设置。
注意
如果未安装Speech.dll并且指定的引擎与字符的编译 TTS 模式设置不匹配,则 IAgentCharacterEx:SetTTSModeID 可能会失败。
此设置确定字符口语 TTS 输出的首选引擎模式。 TTS (文本转语音) 引擎的模式 ID 是由语音供应商定义的 GUID,它唯一标识格式为大括号和短划线的引擎模式 () 。 有关详细信息,请参阅 Microsoft 语音 SDK 文档。
如果设置 TTS 模式 ID,它将替代服务器尝试根据字符的已编译 TTS 模式 ID、当前系统语言 ID 和字符的当前语言 ID 匹配语音引擎。 但是,如果在 Microsoft Agent 属性表中或未安装关联的引擎时尝试设置模式 ID,则此调用将失败。
如果未为字符设置 TTS 引擎模式 ID,服务器将使用 Microsoft 语音 API 接口 (设置与字符的语言设置匹配的引擎) 。 如果尚未加载此属性,则设置此属性将加载关联的引擎。
此属性仅适用于客户端应用程序对字符的使用;此设置不会影响客户端应用程序的字符或其他字符的其他客户端。
Microsoft 代理的语音引擎要求基于 Microsoft 语音 API。 可以安装支持 Microsoft 代理 SAPI 要求的引擎,并将其与代理一起使用。
另请参阅
IAgentCharacterEx:GetTTSModeID