IAgentCharacterEx::GetTTSModeID

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

HRESULT GetTTSModeID(
   BSTR * pbszModeID  // address of TTS engine ID
);

检索为字符设置的 TTS 引擎的模式 ID。

  • 返回S_OK以指示作成功。

pbszModeID

接收字符 TTS 引擎的模式 ID 设置的 BSTR 的地址。

此设置返回字符语音输出的 TTS(文本转语音)引擎模式 ID。 TTS 引擎的模式 ID 是由语音供应商唯一标识引擎的 GUID(用大括号和短划线格式)的字符串表示形式。 有关详细信息,请参阅 Microsoft 语音 SDK 文档。 如果尚未加载此属性,则查询此属性将加载关联的引擎。

如果未设置字符的 TTS 引擎模式 ID,服务器将尝试返回与字符编译的 TTS 设置和字符的当前语言设置匹配(使用Microsoft语音 API 接口)的引擎。 如果这些不同,则字符的语言设置将替代其创作模式设置。 如果尚未设置字符的语言设置,则字符的语言为用户默认语言 ID,服务器会基于该语言 ID 尝试匹配。

如果 IAgentAudioObjectProperties::GetEnabled 返回 False,则此函数不会失败。

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

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

另请参阅

IAgentCharacterEx::SetTTSModeID