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