IntentRecognizer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
言語理解 (LUIS) モデルまたはフレーズを使用して意図を認識します。
public sealed class IntentRecognizer : Microsoft.CognitiveServices.Speech.Recognizer
type IntentRecognizer = class
inherit Recognizer
Public NotInheritable Class IntentRecognizer
Inherits Recognizer
- 継承
注釈
意図は、ユーザーが定義したオプションに基づいて、ユーザーが何を開始または実行したいかを示します。 意図認識が成功すると、認識されたテキストと認識された意図の両方が返されます。
「意図認識の概要」も参照してください
コンストラクター
IntentRecognizer(EmbeddedSpeechConfig) |
既定のマイクから音声を受信するように構成された EmbeddedSpeechConfig を使用して、IntentRecognizer の新しいインスタンスを作成します。 1.20.0 で追加されました |
IntentRecognizer(EmbeddedSpeechConfig, AudioConfig) |
AudioConfig オブジェクトで指定されたオーディオ ソースから音声を受信するように構成された EmbeddedSpeechConfig を使用して、IntentRecognizer の新しいインスタンスを作成します。 1.20.0 で追加されました |
IntentRecognizer(SpeechConfig) |
IntentRecognizer の新しいインスタンスを作成します。 |
IntentRecognizer(SpeechConfig, AudioConfig) |
IntentRecognizer の新しいインスタンスを作成します。 |
フィールド
disposed |
disposed は、オブジェクトが破棄されているかどうかを示すために使用されるフラグです。 (継承元 Recognizer) |
gch |
コンテキストのコールバックの GC ハンドル。 (継承元 Recognizer) |
isDisposing |
オブジェクトが現在破棄されているかどうかを示します。 (継承元 Recognizer) |
pointerHandle |
ログ記録用の内部。 (継承元 Recognizer) |
recognizerLock |
recognizerLock は、複数のスレッドからオブジェクト メンバー変数へのアクセスを同期するために使用されます (継承元 Recognizer) |
プロパティ
AuthorizationToken |
サービスとの通信に使用される承認トークンを取得または設定します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。 そうしないと、認識中に認識エンジンでエラーが発生します。 |
Properties |
この IntentRecognizerに対して定義されているプロパティとその値のコレクションを取得します。 |
SpeechRecognitionLanguage |
認識に使用される言語名を取得します。 |
メソッド
AddAllIntents(LanguageUnderstandingModel) |
指定した Language Understanding Model からすべての意図を追加します。 PatternMatchingModel 型と ConversationalLanguageUnderstandingModel 型の場合、これを有効にする前に既存のモデルがクリアされます。 |
AddAllIntents(LanguageUnderstandingModel, String) |
指定した Language Understanding Model から名前で 1 つの意図を追加します。 PatternMatchingModel 型と ConversationalLanguageUnderstandingModel 型の場合、これを有効にする前に既存のモデルがクリアされます。 これらの型の場合、intentName は無視されます。 |
AddIntent(LanguageUnderstandingModel, String) |
指定した Language Understanding Model から名前で 1 つの意図を追加します。 PatternMatchingModel 型と ConversationalLanguageUnderstandingModel 型の場合、これを有効にする前に既存のモデルがクリアされます。 これらの型の場合、intentName は無視されます。 |
AddIntent(LanguageUnderstandingModel, String, String) |
指定した Language Understanding Model から名前で 1 つの意図を追加します。 PatternMatchingModel 型と ConversationalLanguageUnderstandingModel 型の場合、これを有効にする前に既存のモデルがクリアされます。 これらの型の場合、intentName と intentId は無視されます。 |
AddIntent(String) |
特定のユーザー 意図を示す、ユーザーが話す可能性のある単純な語句を追加します。 |
AddIntent(String, String) |
特定のユーザー 意図を示す、ユーザーが話す可能性のある単純な語句を追加します。 |
ApplyLanguageModels(LanguageUnderstandingModelCollection) |
言語理解モデルのコレクションを取得し、それらのコピーを作成し、認識エンジンに適用します。 このアプリケーションは、LanguageUnderstandingModel 型に応じて異なる時間に有効になります。 PatternMatchingModels はすぐにアクティブになりますが、LUIS サービスを利用する LanguageUnderstandingModels は、認識エンジンが意図認識の途中でない限り、すぐにアクティブになります。その場合は、次の Recognized イベントの後に有効になります。 |
Dispose() |
関連付けられているリソースを破棄します。 (継承元 Recognizer) |
Dispose(Boolean) |
このメソッドは、リソースのクリーンアップを実行します。
Boolean パラメーター |
Finalize() |
言語理解 (LUIS) モデルまたはフレーズを使用して意図を認識します。 |
RecognizeOnceAsync() |
非同期操作として意図認識を使用して音声認識を開始します。 |
RecognizeOnceAsync(String) |
意図認識を実行し、渡されたテキストから結果を生成します。 これは、テストや、音声入力が IntentRecognizer に関連付けられていない場合に便利です。 注: インテント サービスでは現在サポートされていないため、オフライン パターン マッチングまたは完全一致インテントに対してのみ有効です。 |
StartContinuousRecognitionAsync() |
が呼び出されるまで StopContinuousRecognitionAsync() 、継続的なオーディオ ストリームで音声認識を非同期的に開始します。 |
StartKeywordRecognitionAsync(KeywordRecognitionModel) |
指定したキーワード (keyword) モデルを使用して認識エンジンを構成します。 このメソッドを呼び出した後、認識エンジンは認識を開始するキーワード (keyword)をリッスンしています。 StopKeywordRecognitionAsync() を呼び出して、キーワード (keyword)開始された認識を終了します。 認識結果を受信するには、イベントをサブスクライブする必要があります。 |
StopContinuousRecognitionAsync() |
実行中の認識操作をできるだけ早く停止し、これまでに処理された入力に基づいてすぐに結果を要求します。 これは、継続的な操作だけでなく、すべての認識操作に対して機能し、手動オーディオ エンドポイントのプッシュツートークまたは "今すぐ終了" ボタンの使用を容易にします。 |
StopKeywordRecognitionAsync() |
キーワード (keyword)開始された認識を終了します。 |
イベント
Canceled |
イベント Canceled は、意図認識が取り消されたことを通知します。 |
Recognized |
イベント Recognized は、最終的な認識結果が受信されたことを通知します。 |
Recognizing |
イベント Recognizing は、中間認識結果が受信されたことを通知します。 |
SessionStarted |
セッション開始イベントのイベント ハンドラーを定義します。 (継承元 Recognizer) |
SessionStopped |
セッション停止イベントのイベント ハンドラーを定義します。 (継承元 Recognizer) |
SpeechEndDetected |
音声終了検出イベントのイベント ハンドラーを定義します。 (継承元 Recognizer) |
SpeechStartDetected |
音声開始検出イベントのイベント ハンドラーを定義します。 (継承元 Recognizer) |
適用対象
Azure SDK for .NET