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 版中新增。