你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

SpeechSynthesizer 类

语音合成器。

继承

builtins.object

SpeechSynthesizer

构造函数

SpeechSynthesizer(speech_config: ~azure.cognitiveservices.speech.SpeechConfig, audio_config: ~azure.cognitiveservices.speech.audio.AudioOutputConfig | None = <azure.cognitiveservices.speech.audio.AudioOutputConfig object>, auto_detect_source_language_config: ~azure.cognitiveservices.speech.languageconfig.AutoDetectSourceLanguageConfig = None)

参数

名称	说明
speech_config 必需	语音合成器的配置
audio_config	音频输出的配置。 此参数是可选的。 如果未提供，则默认扬声器设备将用于音频输出。 如果为“无”，则将删除输出音频。 无可用于性能测试等方案。
auto_detect_source_language_config	自动检测源语言配置 默认值: None

方法

get_voices_async	异步获取可用语音。
speak_ssml	在阻止 (同步) 模式下对 ssml 执行合成。
speak_ssml_async	在非阻塞 (异步) 模式下对 ssml 执行合成。
speak_text	在阻止 (同步) 模式下对纯文本执行合成。
speak_text_async	在非阻塞 (异步) 模式下对纯文本执行合成。
start_speaking_ssml	在阻止 (同步) 模式下在 ssml 上启动合成。
start_speaking_ssml_async	在非阻塞 (异步) 模式下在 ssml 上启动合成。
start_speaking_text	在阻止 (同步) 模式下开始对纯文本进行合成。
start_speaking_text_async	在非阻塞 (异步) 模式下开始对纯文本进行合成。
stop_speaking	同步终止正在进行的合成操作。 此方法将停止播放并清除 PullAudioOutputStream 中的未读数据。
stop_speaking_async	异步终止正在进行的合成操作。 此方法将停止播放并清除 PullAudioOutputStream 中的未读数据。

get_voices_async

异步获取可用语音。

get_voices_async(locale: str = '') -> ResultFuture

参数

名称	说明
locale 必需	以 BCP-47 格式指定语音的区域设置;或将其留空以获取所有可用语音。

返回

类型	说明
	表示获取语音的异步操作的任务。

speak_ssml

在阻止 (同步) 模式下对 ssml 执行合成。

speak_ssml(ssml: str) -> SpeechSynthesisResult

参数

名称	说明
ssml 必需

返回

类型	说明
	SpeechSynthesisResult。

speak_ssml_async

在非阻塞 (异步) 模式下对 ssml 执行合成。

speak_ssml_async(ssml: str) -> ResultFuture

参数

名称	说明
ssml 必需

返回

类型	说明
	具有 SpeechSynthesisResult 的未来。

speak_text

在阻止 (同步) 模式下对纯文本执行合成。

speak_text(text: str) -> SpeechSynthesisResult

参数

名称	说明
text 必需

返回

类型	说明
	SpeechSynthesisResult。

speak_text_async

在非阻塞 (异步) 模式下对纯文本执行合成。

speak_text_async(text: str) -> ResultFuture

参数

名称	说明
text 必需

返回

类型	说明
	具有 SpeechSynthesisResult 的未来。

start_speaking_ssml

在阻止 (同步) 模式下在 ssml 上启动合成。

start_speaking_ssml(ssml: str) -> SpeechSynthesisResult

参数

名称	说明
ssml 必需

返回

类型	说明
	SpeechSynthesisResult。

start_speaking_ssml_async

在非阻塞 (异步) 模式下在 ssml 上启动合成。

start_speaking_ssml_async(ssml: str) -> ResultFuture

参数

名称	说明
ssml 必需

返回

类型	说明
	具有 SpeechSynthesisResult 的未来。

start_speaking_text

在阻止 (同步) 模式下开始对纯文本进行合成。

start_speaking_text(text: str) -> SpeechSynthesisResult

参数

名称	说明
text 必需

返回

类型	说明
	SpeechSynthesisResult。

start_speaking_text_async

在非阻塞 (异步) 模式下开始对纯文本进行合成。

start_speaking_text_async(text: str) -> ResultFuture

参数

名称	说明
text 必需

返回

类型	说明
	具有 SpeechSynthesisResult 的未来。

stop_speaking

同步终止正在进行的合成操作。 此方法将停止播放并清除 PullAudioOutputStream 中的未读数据。

stop_speaking() -> None

stop_speaking_async

异步终止正在进行的合成操作。 此方法将停止播放并清除 PullAudioOutputStream 中的未读数据。

stop_speaking_async() -> ResultFuture

返回

类型	说明
	一个在停止合成后实现的未来。

属性

authorization_token

将用于连接到服务的授权令牌。

注意

调用方需要确保授权令牌有效。 在

授权令牌过期，调用方需要通过调用此资源库来刷新它

新的有效令牌。 否则，合成器在语音合成时会遇到错误。

bookmark_reached

指示已到达书签的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisBookmarkEventArgs 作为单个参数。

注意

在版本 1.16.0 中添加。

properties

为此 SpeechSynthesizer 定义的属性及其值的集合。

synthesis_canceled

指示已取消合成的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisEventArgs 作为单个参数。

synthesis_completed

指示合成已完成的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisEventArgs 作为单个参数。

synthesis_started

指示合成已开始的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisEventArgs 作为单个参数。

synthesis_word_boundary

指示单词边界的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisWordBoundaryEventArgs 作为单个参数。

synthesizing

指示正在合成的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisEventArgs 作为单个参数。

viseme_received

指示已接收视素的事件的信号。

连接到此信号的回调调用时，实例 SpeechSynthesisVisemeEventArgs 作为单个参数。

注意

在版本 1.16.0 中添加。