SpeechRecognizer 類別
語音辨識器。 如果您需要指定來來源語言資訊,請只指定這三個參數之一、語言、source_language_config或auto_detect_source_language_config。
- 繼承
-
SpeechRecognizer
建構函式
SpeechRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig = None, language: str = None, source_language_config: SourceLanguageConfig = None, auto_detect_source_language_config: AutoDetectSourceLanguageConfig = None)
參數
名稱 | Description |
---|---|
speech_config
必要
|
語音辨識器的設定 |
audio_config
|
音訊輸入的設定 預設值: None
|
language
|
來源語言 預設值: None
|
source_language_config
|
來來源語言設定 預設值: None
|
auto_detect_source_language_config
|
自動偵測來來源語言設定 預設值: None
|
方法
recognize_once |
在封鎖 (同步) 模式中執行辨識。 在辨識出單一語句之後傳回。 單一語句的結尾會藉由聽取結束時的靜默來決定,或是在處理音訊達 15 秒的上限時結束。 此工作會傳回辨識文字作為結果。 針對長時間執行的多重表達辨識,請改為使用 start_continuous_recognition_async。 |
recognize_once_async |
在非封鎖 (非同步) 模式中執行辨識。 這將會辨識單一語句。 單一語句的結尾會藉由聽取結束時的靜默來決定,或是在處理音訊達 15 秒的上限時結束。 針對長時間執行的多重表達辨識,請改為使用 start_continuous_recognition_async。 |
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 |
以非同步方式結束關鍵字起始的辨識。 |
recognize_once
在封鎖 (同步) 模式中執行辨識。 在辨識出單一語句之後傳回。 單一語句的結尾會藉由聽取結束時的靜默來決定,或是在處理音訊達 15 秒的上限時結束。 此工作會傳回辨識文字作為結果。 針對長時間執行的多重表達辨識,請改為使用 start_continuous_recognition_async。
recognize_once() -> SpeechRecognitionResult
傳回
類型 | Description |
---|---|
同步辨識的結果值。 |
recognize_once_async
在非封鎖 (非同步) 模式中執行辨識。 這將會辨識單一語句。 單一語句的結尾會藉由聽取結束時的靜默來決定,或是在處理音訊達 15 秒的上限時結束。 針對長時間執行的多重表達辨識,請改為使用 start_continuous_recognition_async。
recognize_once_async() -> ResultFuture
傳回
類型 | Description |
---|---|
未來,包含非同步辨識的結果值。 |
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) -> ResultFuture
參數
名稱 | 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
包含已取消辨識結果的事件訊號, (指出因為結果或直接取消要求而取消的辨識嘗試,或者傳輸或通訊協定失敗) 。
連接到這個訊號的回呼會以 ,以 實例作為單一 SpeechRecognitionCanceledEventArgs 引數呼叫。
endpoint_id
用於辨識的自訂語音模型的端點識別碼,或用於語音合成的自訂語音模型。
properties
為這個辨識器定義的屬性及其值集合。
recognized
包含最終辨識結果的事件訊號 (指出成功辨識嘗試) 。
連接到此訊號的回呼會以 實例作為單一 SpeechRecognitionEventArgs 引數呼叫,視辨識器的類型而定。
recognizing
包含中繼辨識結果的事件訊號。
連接到此訊號的回呼會以 實例作為單一 SpeechRecognitionEventArgs 引數呼叫。
session_started
指出辨識會話開始 (作業) 的事件訊號。
連接到此訊號的回呼會以 實例作為單一 SessionEventArgs 引數呼叫。
session_stopped
指出辨識會話結束 (作業) 的事件訊號。
連接到此訊號的回呼會以 實例作為單一 SessionEventArgs 引數呼叫。
speech_end_detected
指出語音結束的事件訊號。
連接到此訊號的回呼會以 實例作為單一 RecognitionEventArgs 引數呼叫。
speech_start_detected
指出語音開始的事件訊號。
連接到此訊號的回呼會以 實例作為單一 RecognitionEventArgs 引數呼叫。