TranslationRecognizer 類別
在語音輸入上執行翻譯。
- 繼承
-
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 版中新增。
