TranslationRecognizer 類別

在語音輸入上執行翻譯。

繼承

Recognizer

TranslationRecognizer

建構函式

TranslationRecognizer(translation_config: SpeechTranslationConfig, auto_detect_source_language_config: AutoDetectSourceLanguageConfig | None = None, audio_config: AudioConfig | None = None)

參數

名稱	Description
translation_config 必要	翻譯辨識器的組態。
auto_detect_source_language_config	自動偵測來來源語言設定 預設值: None
audio_config	音訊輸入的組態。 預設值: None

方法

add_target_language	將 語言 新增至翻譯的目的語言清單。 注意 已在 1.7.0 版中新增。
recognize_once	在封鎖 (同步) 模式中執行辨識。 在辨識出單一語句之後傳回。 單一語句的結尾會藉由聽取結束時的靜默來決定，或是在處理音訊達 15 秒的上限時結束。 此工作會傳回辨識文字作為結果。 針對長時間執行的多重表達辨識，請改為使用 start_continuous_recognition_async。
recognize_once_async	在非封鎖 (非同步) 模式中執行辨識。 這將會辨識單一語句。 單一語句的結尾會藉由聽取結束時的靜默來決定，或是在處理音訊達 15 秒的上限時結束。 針對長時間執行的多重表達辨識，請改為使用 start_continuous_recognition_async。
remove_target_language	從翻譯的目的語言清單中移除 語言 。 注意 已在 1.7.0 版中新增。
start_continuous_recognition	同步起始連續辨識作業。 使用者必須連線至 EventSignal，才能接收辨識結果。 呼叫 stop_continuous_recognition_async 以停止辨識。
start_continuous_recognition_async	以非同步方式起始連續辨識作業。 使用者必須連線至 EventSignal，才能接收辨識結果。 呼叫 stop_continuous_recognition_async 以停止辨識。
start_keyword_recognition	使用指定的關鍵字模型，以同步方式設定辨識器。 呼叫這個方法之後，辨識器會接聽 關鍵字來啟動辨識。 呼叫 stop_keyword_recognition () 結束關鍵字起始的辨識。
start_keyword_recognition_async	使用指定的關鍵字模型以非同步方式設定辨識器。 呼叫這個方法之後，辨識器會接聽 關鍵字來啟動辨識。 呼叫 stop_keyword_recognition_async () 結束關鍵字起始的辨識。
stop_continuous_recognition	同步終止進行中的連續辨識作業。
stop_continuous_recognition_async	以非同步方式終止進行中的連續辨識作業。
stop_keyword_recognition	同步結束關鍵字起始的辨識。
stop_keyword_recognition_async	以非同步方式結束關鍵字起始的辨識。

add_target_language

將 語言 新增至翻譯的目的語言清單。

注意

已在 1.7.0 版中新增。

add_target_language(language: str)

參數

名稱	Description
language 必要	要加入的語言代碼。

recognize_once

在封鎖 (同步) 模式中執行辨識。 在辨識出單一語句之後傳回。 單一語句的結尾會藉由聽取結束時的靜默來決定，或是在處理音訊達 15 秒的上限時結束。 此工作會傳回辨識文字作為結果。 針對長時間執行的多重表達辨識，請改為使用 start_continuous_recognition_async。

recognize_once() -> TranslationRecognitionResult

傳回

類型	Description
	同步辨識的結果值。

recognize_once_async

在非封鎖 (非同步) 模式中執行辨識。 這將會辨識單一語句。 單一語句的結尾會藉由聽取結束時的靜默來決定，或是在處理音訊達 15 秒的上限時結束。 針對長時間執行的多重表達辨識，請改為使用 start_continuous_recognition_async。

recognize_once_async() -> ResultFuture

傳回

類型	Description
	未來，包含非同步辨識的結果值。

remove_target_language

從翻譯的目的語言清單中移除 語言 。

注意

已在 1.7.0 版中新增。

remove_target_language(language: str)

參數

名稱	Description
language 必要	要移除的語言代碼。

start_continuous_recognition

同步起始連續辨識作業。 使用者必須連線至 EventSignal，才能接收辨識結果。 呼叫 stop_continuous_recognition_async 以停止辨識。

start_continuous_recognition()

start_continuous_recognition_async

以非同步方式起始連續辨識作業。 使用者必須連線至 EventSignal，才能接收辨識結果。 呼叫 stop_continuous_recognition_async 以停止辨識。

start_continuous_recognition_async() -> ResultFuture

傳回

類型	Description
	一旦初始化辨識之後，即已完成的未來。

start_keyword_recognition

使用指定的關鍵字模型，以同步方式設定辨識器。 呼叫這個方法之後，辨識器會接聽 關鍵字來啟動辨識。 呼叫 stop_keyword_recognition () 結束關鍵字起始的辨識。

start_keyword_recognition(model: KeywordRecognitionModel)

參數

名稱	Description
model 必要	關鍵字辨識模型，指定要辨識的關鍵字。

start_keyword_recognition_async

使用指定的關鍵字模型以非同步方式設定辨識器。 呼叫這個方法之後，辨識器會接聽 關鍵字來啟動辨識。 呼叫 stop_keyword_recognition_async () 結束關鍵字起始的辨識。

start_keyword_recognition_async(model: KeywordRecognitionModel)

參數

名稱	Description
model 必要	關鍵字辨識模型，指定要辨識的關鍵字。

傳回

類型	Description
	一旦初始化辨識之後，即已完成的未來。

stop_continuous_recognition

同步終止進行中的連續辨識作業。

stop_continuous_recognition()

stop_continuous_recognition_async

以非同步方式終止進行中的連續辨識作業。

stop_continuous_recognition_async()

傳回

類型	Description
	一旦停止辨識之後，就會滿足的未來。

stop_keyword_recognition

同步結束關鍵字起始的辨識。

stop_keyword_recognition()

stop_keyword_recognition_async

以非同步方式結束關鍵字起始的辨識。

stop_keyword_recognition_async()

傳回

類型	Description
	一旦停止辨識之後，就會滿足的未來。

屬性

authorization_token

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

注意

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

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

新的有效權杖。 否則，辨識器會在辨識期間遇到錯誤。

canceled

包含已取消辨識結果的事件訊號 (指出因結果或直接取消要求而取消的辨識嘗試，或者傳輸或通訊協定失敗) 。

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

endpoint_id

用於辨識的自訂語音模型端點識別碼，或用於語音合成的自訂語音模型。

properties

為這個辨識器定義的屬性及其值集合。

recognized

包含最終辨識結果的事件訊號， (指出成功辨識嘗試) 。

連接到這個訊號的回呼會以 呼叫，實例做為單一 TranslationRecognitionEventArgs 引數，取決於辨識器的類型。

recognizing

包含中繼辨識結果的事件訊號。

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

session_started

指出辨識會話開始 (作業) 的事件訊號。

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

session_stopped

表示辨識會話結束 (作業) 的事件訊號。

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

speech_end_detected

表示語音結束的事件訊號。

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

speech_start_detected

指出語音開始的事件訊號。

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

synthesizing

事件會發出收到翻譯合成結果的訊號。

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

target_languages

翻譯的目的語言。

注意

已在 1.7.0 版中新增。