TranslationRecognizer class
翻譯辨識器
- Extends
建構函式
Translation |
初始化 TranslationRecognizer 的實例。 |
屬性
authorization |
取得用來與服務通訊的授權令牌。 |
canceled | 事件已取消,表示辨識期間發生錯誤。 |
internal |
|
properties | 為此 TranslationRecognizer 定義的屬性及其值集合。 |
recognized | 事件辨識的訊號表示收到最終辨識結果。 |
recognizing | 事件辨識訊號表示收到中繼辨識結果。 |
speech |
取得建立辨識器時所設定的語言名稱。 |
synthesizing | 事件合成訊號表示收到轉譯合成結果。 |
target |
取得建立辨識器時所設定之翻譯的目標語言。 語言是以 BCP-47 格式指定。 翻譯會為每個語言提供翻譯的文字。 |
telemetry |
這個方法會傳回遙測設定的目前狀態。 |
voice |
取得輸出語音的名稱。 |
繼承的屬性
session |
定義工作階段啟動事件的事件處理程式。 |
session |
定義會話已停止事件的事件處理程式。 |
speech |
定義語音停止事件的事件處理程式。 |
speech |
定義語音啟動事件的事件處理程式。 |
方法
add |
動態新增語言至目標語言清單(可在辨識進行時使用) |
close(() => void, (error: string) => void) | 關閉這個類別實例所持有的所有外部資源。 |
From |
TranslationRecognizer 建構函式。 |
on |
會處理對話轉譯案例的 ConnectionEstablishedEvent。 |
recognize |
啟動辨識和翻譯,並在辨識第一個語句之後停止。 工作會傳回翻譯文字作為結果。 注意:辨識第一個語句時會傳回 recognizeOnceAsync,因此它只適用於命令或查詢等單次辨識。 針對長時間執行的辨識,請改用 startContinuousRecognitionAsync() 。 |
remove |
動態移除目標語言清單中的語言(可在辨識進行時使用) |
start |
開始辨識和翻譯,直到呼叫 stopContinuousRecognitionAsync() 為止。 使用者必須訂閱事件,才能接收翻譯結果。 |
stop |
停止連續辨識和翻譯。 |
繼承的方法
enable |
這個方法會全域啟用或停用遙測。 |
建構函式詳細資料
TranslationRecognizer(SpeechTranslationConfig, AudioConfig, IConnectionFactory)
初始化 TranslationRecognizer 的實例。
new TranslationRecognizer(speechConfig: SpeechTranslationConfig, audioConfig?: AudioConfig, connectionFactory?: IConnectionFactory)
參數
- speechConfig
- SpeechTranslationConfig
要設定此辨識器的屬性集。
- audioConfig
- AudioConfig
與辨識器相關聯的選擇性音訊組態
- connectionFactory
-
IConnectionFactory
用來產生端點 URI、要設定標頭等的選擇性連線處理站...
屬性詳細資料
authorizationToken
取得用來與服務通訊的授權令牌。
string authorizationToken
屬性值
string
授權令牌。
canceled
事件已取消,表示辨識期間發生錯誤。
public canceled: (sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void
屬性值
(sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void
internalData
object internalData
屬性值
object
properties
為此 TranslationRecognizer 定義的屬性及其值集合。
PropertyCollection properties
屬性值
為此 TranslationRecognizer 定義的屬性及其值集合。
recognized
事件辨識的訊號表示收到最終辨識結果。
public recognized: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
屬性值
(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
recognizing
事件辨識訊號表示收到中繼辨識結果。
public recognizing: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
屬性值
(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
speechRecognitionLanguage
取得建立辨識器時所設定的語言名稱。
string speechRecognitionLanguage
屬性值
string
取得建立辨識器時所設定的語言名稱。
synthesizing
事件合成訊號表示收到轉譯合成結果。
public synthesizing: (sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void
屬性值
(sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void
targetLanguages
取得建立辨識器時所設定之翻譯的目標語言。 語言是以 BCP-47 格式指定。 翻譯會為每個語言提供翻譯的文字。
string[] targetLanguages
屬性值
string[]
取得建立辨識器時所設定之翻譯的目標語言。
telemetryEnabled
這個方法會傳回遙測設定的目前狀態。
static boolean telemetryEnabled
屬性值
boolean
如果已啟用遙測,則為 true,否則為 false。
voiceName
取得輸出語音的名稱。
string voiceName
屬性值
string
輸出語音的名稱。
繼承的屬性詳細資料
sessionStarted
定義工作階段啟動事件的事件處理程式。
public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void
屬性值
(sender: Recognizer, event: SessionEventArgs) => void
sessionStopped
定義會話已停止事件的事件處理程式。
public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void
屬性值
(sender: Recognizer, event: SessionEventArgs) => void
speechEndDetected
定義語音停止事件的事件處理程式。
public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
屬性值
(sender: Recognizer, event: RecognitionEventArgs) => void
speechStartDetected
定義語音啟動事件的事件處理程式。
public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
屬性值
(sender: Recognizer, event: RecognitionEventArgs) => void
方法詳細資料
addTargetLanguage(string)
動態新增語言至目標語言清單(可在辨識進行時使用)
function addTargetLanguage(lang: string)
參數
- lang
-
string
要新增的語言
close(() => void, (error: string) => void)
關閉這個類別實例所持有的所有外部資源。
function close(cb?: () => void, errorCb?: (error: string) => void)
參數
- cb
-
() => void
- errorCb
-
(error: string) => void
FromConfig(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)
TranslationRecognizer 建構函式。
static function FromConfig(speechTranslationConfig: SpeechTranslationConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): TranslationRecognizer
參數
- speechTranslationConfig
- SpeechTranslationConfig
這個辨識器的初始屬性集
- autoDetectSourceLanguageConfig
- AutoDetectSourceLanguageConfig
與辨識器相關聯的來源語言偵測組態
- audioConfig
- AudioConfig
與辨識器相關聯的選擇性音訊組態
傳回
onConnection()
會處理對話轉譯案例的 ConnectionEstablishedEvent。
function onConnection()
recognizeOnceAsync((e: TranslationRecognitionResult) => void, (e: string) => void)
啟動辨識和翻譯,並在辨識第一個語句之後停止。 工作會傳回翻譯文字作為結果。 注意:辨識第一個語句時會傳回 recognizeOnceAsync,因此它只適用於命令或查詢等單次辨識。 針對長時間執行的辨識,請改用 startContinuousRecognitionAsync() 。
function recognizeOnceAsync(cb?: (e: TranslationRecognitionResult) => void, err?: (e: string) => void)
參數
- cb
-
(e: TranslationRecognitionResult) => void
完成翻譯時收到結果的回呼。
- err
-
(e: string) => void
發生錯誤時叫用回呼。
removeTargetLanguage(string)
動態移除目標語言清單中的語言(可在辨識進行時使用)
function removeTargetLanguage(lang: string)
參數
- lang
-
string
要移除的語言
startContinuousRecognitionAsync(() => void, (e: string) => void)
開始辨識和翻譯,直到呼叫 stopContinuousRecognitionAsync() 為止。 使用者必須訂閱事件,才能接收翻譯結果。
function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
參數
- cb
-
() => void
已啟動接收翻譯的回呼。
- err
-
(e: string) => void
發生錯誤時叫用回呼。
stopContinuousRecognitionAsync(() => void, (e: string) => void)
停止連續辨識和翻譯。
function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
參數
- cb
-
() => void
已停止接收翻譯的回呼。
- err
-
(e: string) => void
發生錯誤時叫用回呼。
繼承的方法的詳細資料
enableTelemetry(boolean)
這個方法會全域啟用或停用遙測。
static function enableTelemetry(enabled: boolean)
參數
- enabled
-
boolean
遙測集合的全域設定。 如果設定為 true,則麥克風錯誤等遙測資訊會收集辨識錯誤並傳送至Microsoft。 如果設定為 false,則不會將任何遙測傳送至Microsoft。