IntentRecognizer class
意図認識エンジン。
- Extends
コンストラクター
Intent |
IntentRecognizer のインスタンスを初期化します。 |
プロパティ
authorization |
サービスとの通信に使用される承認トークンを取得します。 |
canceled | イベントが取り消されると、認識中にエラーが発生したことが通知されます。 |
internal |
|
properties | この IntentRecognizer に対して定義されているプロパティとその値のコレクション。 |
recognized | イベントが認識されると、最終的な認識結果が受信されたことを通知します。 |
recognizing | 中間認識結果を受信したことを通知するイベント。 |
speech |
認識の読み上げ言語を取得します。 |
telemetry |
このメソッドは、テレメトリ設定の現在の状態を返します。 |
継承されたプロパティ
session |
セッション開始イベントのイベント ハンドラーを定義します。 |
session |
セッション停止イベントのイベント ハンドラーを定義します。 |
speech |
音声停止イベントのイベント ハンドラーを定義します。 |
speech |
音声開始イベントのイベント ハンドラーを定義します。 |
メソッド
add |
|
add |
意図として認識する必要がある語句を追加します。 |
add |
認識Language Understandingサービスから意図を追加します。 |
close(() => void, (error: string) => void) | は、このクラスのインスタンスによって保持されているすべての外部リソースを閉じます。 |
recognize |
意図認識を開始し、最初の発話が認識された後に停止します。 タスクは、結果として認識テキストと意図を返します。 注: RecognizeOnceAsync() は、最初の発話が認識されると を返します。そのため、コマンドやクエリなどのシングル ショット認識にのみ適しています。 実行時間の長い認識の場合は、代わりに StartContinuousRecognitionAsync() を使用します。 |
start |
stopContinuousRecognitionAsync() が呼び出されるまで音声認識を開始します。 ユーザーは、認識結果を受信するためにイベントをサブスクライブする必要があります。 |
start |
stopKeywordRecognitionAsync() が呼び出されるまで、キーワード スポッティングを使用して音声認識を開始します。 ユーザーは、認識結果を受信するためにイベントをサブスクライブする必要があります。 注: キーワードスポッティング機能は、Speech Devices SDK でのみ使用できます。 この機能は現在、SDK 自体には含まれていません。 |
stop |
継続的な意図認識を停止します。 |
stop |
継続的な音声認識を停止します。 注: キーワードスポッティング機能は、Speech Devices SDK でのみ使用できます。 この機能は現在、SDK 自体には含まれていません。 |
継承されたメソッド
enable |
このメソッドは、テレメトリをグローバルに有効または無効にします。 |
コンストラクターの詳細
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
プロパティ値
この 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
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
メソッドの詳細
addAllIntents(LanguageUnderstandingModel, string)
function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)
パラメーター
意図を含む言語理解モデル。
- intentId
-
string
IntentRecognitionResult の getIntentId() メソッドで返されるカスタム ID String。
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 が空の場合は無視されます。
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() が呼び出されるまで、キーワード スポッティングを使用して音声認識を開始します。 ユーザーは、認識結果を受信するためにイベントをサブスクライブする必要があります。 注: キーワードスポッティング機能は、Speech Devices 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)
継続的な音声認識を停止します。 注: キーワードスポッティング機能は、Speech Devices 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 に送信されません。