共用方式為

IntentRecognizer class

  • 參考
套件:
microsoft-cognitiveservices-speech-sdk

意圖辨識器。

Extends
Recognizer

建構函式

IntentRecognizer(SpeechConfig, AudioConfig)

初始化 IntentRecognizer 的實例。

屬性

authorizationToken

取得用來與服務通訊的授權令牌。
canceled

事件已取消，表示辨識期間發生錯誤。
internalData
properties

針對這個 IntentRecognizer 定義的屬性及其值集合。
recognized

事件辨識的訊號表示收到最終辨識結果。
recognizing

事件辨識訊號表示收到中繼辨識結果。
speechRecognitionLanguage

取得辨識的口語。
telemetryEnabled

這個方法會傳回遙測設定的目前狀態。

繼承的屬性

sessionStarted

定義工作階段啟動事件的事件處理程式。
sessionStopped

定義會話已停止事件的事件處理程式。
speechEndDetected

定義語音停止事件的事件處理程式。
speechStartDetected

定義語音啟動事件的事件處理程式。

方法

addAllIntents(LanguageUnderstandingModel, string)
addIntent(string, string)

新增應辨識為意圖的片語。
addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

從 Language Understanding 服務新增意圖以進行辨識。
close(() => void, (error: string) => void)

關閉這個類別實例所持有的所有外部資源。
recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)

啟動意圖辨識，並在辨識第一個語句之後停止。 工作會傳回辨識文字和意圖作為結果。 注意：RecognizeOnceAsync（） 在辨識第一個語句時傳回，因此它只適用於命令或查詢等單次辨識。 針對長時間執行的辨識，請改用 StartContinuousRecognitionAsync（） 。
startContinuousRecognitionAsync(() => void, (e: string) => void)

啟動語音辨識，直到呼叫 stopContinuousRecognitionAsync（） 為止。 使用者必須訂閱事件，才能接收辨識結果。
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

使用關鍵詞找出啟動語音識別，直到呼叫 stopKeywordRecognitionAsync（） 為止。 使用者必須訂閱事件，才能接收辨識結果。 注意：關鍵詞辨識功能僅適用於語音裝置 SDK。 此功能目前未包含在 SDK 本身中。
stopContinuousRecognitionAsync(() => void, (e: string) => void)

停止連續意圖辨識。
stopKeywordRecognitionAsync(() => void, (e: string) => void)

停止連續語音辨識。 注意：關鍵詞辨識功能僅適用於語音裝置 SDK。 此功能目前未包含在 SDK 本身中。

繼承的方法

enableTelemetry(boolean)

這個方法會全域啟用或停用遙測。

建構函式詳細資料

IntentRecognizer(SpeechConfig, AudioConfig)

初始化 IntentRecognizer 的實例。

new IntentRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

參數

speechConfig
SpeechConfig

組態屬性集。

audioConfig
AudioConfig

與辨識器相關聯的選擇性音訊輸入組態

屬性詳細資料

authorizationToken

取得用來與服務通訊的授權令牌。

string authorizationToken

屬性值

string

授權令牌。

canceled

事件已取消，表示辨識期間發生錯誤。

public canceled: (sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

屬性值

(sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

internalData 

object internalData

屬性值

object

properties

針對這個 IntentRecognizer 定義的屬性及其值集合。

PropertyCollection properties

屬性值

PropertyCollection

針對這個 IntentRecognizer 定義的屬性及其值集合。

recognized

事件辨識的訊號表示收到最終辨識結果。

public recognized: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

屬性值

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

recognizing

事件辨識訊號表示收到中繼辨識結果。

public recognizing: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

屬性值

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

speechRecognitionLanguage

取得辨識的口語。

string speechRecognitionLanguage

屬性值

string

辨識的口語。

telemetryEnabled

這個方法會傳回遙測設定的目前狀態。

static boolean telemetryEnabled

屬性值

boolean

如果已啟用遙測，則為 true，否則為 false。

繼承的屬性詳細資料

sessionStarted

定義工作階段啟動事件的事件處理程式。

public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void

屬性值

(sender: Recognizer, event: SessionEventArgs) => void

繼承自Recognizer.sessionStarted

sessionStopped

定義會話已停止事件的事件處理程式。

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

屬性值

(sender: Recognizer, event: SessionEventArgs) => void

繼承自Recognizer.sessionStopped

speechEndDetected

定義語音停止事件的事件處理程式。

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

屬性值

(sender: Recognizer, event: RecognitionEventArgs) => void

繼承自Recognizer.speechEndDetected

speechStartDetected

定義語音啟動事件的事件處理程式。

public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

屬性值

(sender: Recognizer, event: RecognitionEventArgs) => void

繼承自Recognizer.speechStartDetected

方法詳細資料

addAllIntents(LanguageUnderstandingModel, string) 

function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)

參數

model
LanguageUnderstandingModel

包含意圖的語言理解模型。

intentId

string

要以 IntentRecognitionResult 的 getIntentId（） 方法傳回的自定義標識符字串。

addIntent(string, string)

新增應辨識為意圖的片語。

function addIntent(simplePhrase: string, intentId?: string)

參數

simplePhrase

string

intentId

string

String，表示要辨識之意圖的標識符。

addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

從 Language Understanding 服務新增意圖以進行辨識。

function addIntentWithLanguageModel(intentId: string, model: LanguageUnderstandingModel, intentName?: string)

參數

intentId

string

String，表示要辨識之意圖的標識符。 如果 intentName 是空的，則會忽略 。

model
LanguageUnderstandingModel

Language Understanding 服務的意圖模型。

intentName

string

意圖模型中定義的意圖名稱。 如果它是空的，則會新增模型中定義的所有意圖名稱。

close(() => void, (error: string) => void)

關閉這個類別實例所持有的所有外部資源。

function close(cb?: () => void, errorCb?: (error: string) => void)

參數

cb

() => void

errorCb

(error: string) => void

recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)

啟動意圖辨識，並在辨識第一個語句之後停止。 工作會傳回辨識文字和意圖作為結果。 注意：RecognizeOnceAsync（） 在辨識第一個語句時傳回，因此它只適用於命令或查詢等單次辨識。 針對長時間執行的辨識，請改用 StartContinuousRecognitionAsync（） 。

function recognizeOnceAsync(cb?: (e: IntentRecognitionResult) => void, err?: (e: string) => void)

參數

cb

(e: IntentRecognitionResult) => void

接收辨識的回呼已完成 IntentRecognitionResult。

err

(e: string) => void

發生錯誤時叫用回呼。

startContinuousRecognitionAsync(() => void, (e: string) => void)

啟動語音辨識，直到呼叫 stopContinuousRecognitionAsync（） 為止。 使用者必須訂閱事件，才能接收辨識結果。

function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

參數

cb

() => void

一旦辨識啟動，就會叫用回呼。

err

(e: string) => void

發生錯誤時叫用回呼。

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

使用關鍵詞找出啟動語音識別，直到呼叫 stopKeywordRecognitionAsync（） 為止。 使用者必須訂閱事件，才能接收辨識結果。 注意：關鍵詞辨識功能僅適用於語音裝置 SDK。 此功能目前未包含在 SDK 本身中。

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

參數

model
KeywordRecognitionModel

指定要辨識之關鍵詞的關鍵詞辨識模型。

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

發生錯誤時叫用回呼。

stopKeywordRecognitionAsync(() => void, (e: string) => void)

停止連續語音辨識。 注意：關鍵詞辨識功能僅適用於語音裝置 SDK。 此功能目前未包含在 SDK 本身中。

function stopKeywordRecognitionAsync(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。

繼承自Recognizer.enableTelemetry