SpeechRecognizer クラス

定義

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

継承

Object

SpeechRecognizer

実装

IDisposable

例

次の例は、音声認識文法を読み込み、非同期エミュレートされた入力、関連する認識結果、および音声認識エンジンによって発生する関連イベントを示すコンソール アプリケーションの一部です。 Windows 音声認識が実行されていない場合、このアプリケーションを起動すると、Windows 音声認識も開始されます。 Windows 音声認識が スリープ 状態の場合は、常に null を EmulateRecognizeAsync 返します。

using System;  
using System.Speech.Recognition;  
using System.Threading;  

namespace SharedRecognizer  
{  
  class Program  
  {  

    // Indicate whether the asynchronous emulate recognition  
    // operation has completed.  
    static bool completed;  

    static void Main(string[] args)  
    {  

      // Initialize an instance of the shared recognizer.  
      using (SpeechRecognizer recognizer = new SpeechRecognizer())  
      {  

        // Create and load a sample grammar.  
        Grammar testGrammar =  
          new Grammar(new GrammarBuilder("testing testing"));  
        testGrammar.Name = "Test Grammar";  
        recognizer.LoadGrammar(testGrammar);  

        // Attach event handlers for recognition events.  
        recognizer.SpeechRecognized +=  
          new EventHandler<SpeechRecognizedEventArgs>(  
            SpeechRecognizedHandler);  
        recognizer.EmulateRecognizeCompleted +=  
          new EventHandler<EmulateRecognizeCompletedEventArgs>(  
            EmulateRecognizeCompletedHandler);  

        completed = false;  

        // Start asynchronous emulated recognition.   
        // This matches the grammar and generates a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing testing");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  

        completed = false;  

        // Start asynchronous emulated recognition.  
        // This does not match the grammar or generate a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing one two three");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  

    // Handle the SpeechRecognized event.  
    static void SpeechRecognizedHandler(  
      object sender, SpeechRecognizedEventArgs e)  
    {  
      if (e.Result != null)  
      {  
        Console.WriteLine("Recognition result = {0}",  
          e.Result.Text ?? "<no text>");  
      }  
      else  
      {  
        Console.WriteLine("No recognition result");  
      }  
    }  

    // Handle the SpeechRecognizeCompleted event.  
    static void EmulateRecognizeCompletedHandler(  
      object sender, EmulateRecognizeCompletedEventArgs e)  
    {  
      if (e.Result == null)  
      {  
        Console.WriteLine("No result generated.");  
      }  

      // Indicate the asynchronous operation is complete.  
      completed = true;  
    }  
  }  
}  

注釈

アプリケーションでは、共有認識エンジンを使用して Windows 音声認識にアクセスします。 オブジェクトを SpeechRecognizer 使用して、Windows 音声ユーザー エクスペリエンスに追加します。

このクラスは、音声認識プロセスのさまざまな側面を制御します。

• 音声認識文法を管理するには、および を使用LoadGrammarUnloadAllGrammarsLoadGrammarAsyncUnloadGrammarします。Grammars

• 現在の音声認識操作に関する情報を取得するには、 の SpeechDetected、SpeechHypothesizedSpeechRecognitionRejectedおよび SpeechRecognized イベントをSpeechRecognizerサブスクライブします。

• 認識エンジンから返される代替結果の数を表示または変更するには、 プロパティを MaxAlternates 使用します。 認識エンジンは、認識結果を RecognitionResult オブジェクトで返します。

• 共有認識エンジンの状態にアクセスまたは監視するには、、AudioPositionAudioState、、、Enabled、PauseRecognizerOnRecognitionRecognizerAudioPosition、および の各プロパティとState、、AudioSignalProblemOccurred、AudioStateChanged、および イベントをAudioLevelUpdatedStateChanged使用AudioLevelします。

• 認識エンジンへの変更を同期するには、 メソッドを使用します RequestRecognizerUpdate 。 共有認識エンジンは、複数のスレッドを使用してタスクを実行します。

• 共有認識エンジンへの入力をエミュレートするには、 メソッドと EmulateRecognizeAsync メソッドをEmulateRecognize使用します。

Windows 音声認識の構成は、コントロール パネルの [音声プロパティ] ダイアログを使用して管理されます。 このインターフェイスは、既定のデスクトップ音声認識エンジンと言語、オーディオ入力デバイス、音声認識のスリープ動作を選択するために使用されます。 アプリケーションの実行中に Windows 音声認識の構成が変更された場合 (たとえば、音声認識が無効になっている場合や入力言語が変更された場合)、変更はすべての SpeechRecognizer オブジェクトに影響します。

Windows 音声認識に依存しないインプロセス音声認識エンジンを作成するには、 クラスを使用します SpeechRecognitionEngine 。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• SpeechRecognitionEngine
• Grammar
• RecognitionResult