TTSModeID 属性

  • 项目

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

Description

返回或设置用于字符的 TTS 引擎模式。

语法

agent**。字符 (“CharacterID”) 。TTSModeID** [ = ModeID]

组成部分 描述
ModeID 对应于语音引擎的模式 ID 的字符串表达式。

 

备注

此属性确定 TTS (文本转语音) 角色语音输出的引擎模式 ID。 TTS 引擎的模式 ID 是由唯一标识引擎模式的语音供应商定义的格式化字符串。 有关详细信息，请参阅 在代码中访问语音引擎。

设置此属性会根据字符的编译 TTS 设置和字符的当前 LanguageID 设置替代服务器加载引擎的尝试。 但是，如果为未安装的引擎指定模式 ID，或者用户在 Microsoft 代理属性表中禁用了语音输出， (AudioOutput.Enabled = False) ，则服务器将引发错误。

如果未 (或未成功) 设置字符的 TTS 模式 ID，服务器将检查字符的已编译 TTS 模式设置是否与字符的 LanguageID 设置匹配，以及是否已安装关联的 TTS 引擎。 如果是这样，则字符用于语音输出的 TTS 模式，此属性将返回该模式 ID。 如果不是，服务器会请求一个兼容的 SAPI 语音引擎，该引擎与字符的 LanguageID 以及字符的编译模式 ID 的性别和年龄集匹配。 如果尚未设置字符的 LanguageID，则其 LanguageID 是当前用户语言。 如果找不到匹配的引擎，则查询此属性将返回引擎模式 ID 的空字符串。 同样，如果用户在 Microsoft 代理属性表中禁用语音输出时查询此属性， (AudioOutput.Enabled = False) ，则该值将为空字符串。

如果尚未加载) ，则查询或设置此属性将加载关联的引擎 (。 但是，如果已安装在字符的编译 TTS 设置中指定的引擎，并且与字符的语言 ID 设置匹配，则会在加载字符时加载引擎。

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

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

注意

如果系统上未安装兼容的声音支持，则此属性还会返回空字符串。

 

注意

如果未安装Speech.dll，并且指定的引擎与字符的已编译 TTS 模式设置不匹配，则设置 TTSModeID 可能会失败。

 

注意

查询此属性通常不会返回错误。 但是，如果语音引擎加载时间过长，则可能会收到一个错误，指示查询超时。

 

另请参阅

LanguageID 属性