共用方式為


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)

參數

名稱 Description
speech_config
必要

語音合成器的組態

audio_config

音訊輸出的組態。 這是選擇性參數。 如果未提供,預設喇叭裝置將會用於音訊輸出。 如果是 None,則會卸載輸出音訊。 無可用於效能測試等案例。

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

參數

名稱 Description
locale
必要

以 BCP-47 格式指定語音的地區設定;或將它保留空白,以取得所有可用的語音。

傳回

類型 Description

工作,表示取得語音的非同步作業。

speak_ssml

在封鎖 (同步) 模式中對 ssml 執行合成。

speak_ssml(ssml: str) -> SpeechSynthesisResult

參數

名稱 Description
ssml
必要

傳回

類型 Description

SpeechSynthesisResult。

speak_ssml_async

在非封鎖 (非同步) 模式中對 ssml 執行合成。

speak_ssml_async(ssml: str) -> ResultFuture

參數

名稱 Description
ssml
必要

傳回

類型 Description

具有 SpeechSynthesisResult 的未來。

speak_text

在封鎖 (同步) 模式中對純文字執行合成。

speak_text(text: str) -> SpeechSynthesisResult

參數

名稱 Description
text
必要

傳回

類型 Description

SpeechSynthesisResult。

speak_text_async

在非封鎖 (非同步) 模式中對純文字執行合成。

speak_text_async(text: str) -> ResultFuture

參數

名稱 Description
text
必要

傳回

類型 Description

具有 SpeechSynthesisResult 的未來。

start_speaking_ssml

在封鎖 (同步) 模式中啟動 ssml 的合成。

start_speaking_ssml(ssml: str) -> SpeechSynthesisResult

參數

名稱 Description
ssml
必要

傳回

類型 Description

SpeechSynthesisResult。

start_speaking_ssml_async

在非封鎖 (非同步) 模式中啟動 ssml 的合成。

start_speaking_ssml_async(ssml: str) -> ResultFuture

參數

名稱 Description
ssml
必要

傳回

類型 Description

具有 SpeechSynthesisResult 的未來。

start_speaking_text

在封鎖 (同步) 模式中啟動純文字合成。

start_speaking_text(text: str) -> SpeechSynthesisResult

參數

名稱 Description
text
必要

傳回

類型 Description

SpeechSynthesisResult。

start_speaking_text_async

在非封鎖 (非同步) 模式中啟動純文字的合成。

start_speaking_text_async(text: str) -> ResultFuture

參數

名稱 Description
text
必要

傳回

類型 Description

具有 SpeechSynthesisResult 的未來。

stop_speaking

同步終止進行中的合成作業。 這個方法會停止播放並清除 PullAudioOutputStream 中的未讀取資料。

stop_speaking() -> None

stop_speaking_async

以非同步方式終止進行中的合成作業。 這個方法會停止播放並清除 PullAudioOutputStream 中的未讀取資料。

stop_speaking_async() -> ResultFuture

傳回

類型 Description

一旦停止合成,就會滿足的未來。

屬性

authorization_token

將用於連線至服務的授權權杖。

注意

呼叫端必須確定授權權杖有效。 在 之前

授權權杖到期,呼叫端必須使用 呼叫這個 setter 來重新整理它

新的有效權杖。 否則,合成器會在語音合成時遇到錯誤。

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

表示收到 viseme 之事件的訊號。

連接到此訊號的回呼會以 實例作為單一 SpeechSynthesisVisemeEventArgs 引數來呼叫。

注意

已在 1.16.0 版中新增。