SpeechRecognizer.EmulateRecognize メソッド

定義

名前空間:

System.Speech.Recognition

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-rc.1.24431.7

同期音声認識に音声ではなくテキストを使用して、共有音声認識エンジンに対する入力をエミュレートします。

オーバーロード

EmulateRecognize(String)	同期音声認識に音声ではなくテキストを使用して、共有音声認識エンジンに対する語句の入力をエミュレートします。
EmulateRecognize(RecognizedWordUnit[], CompareOptions)	同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対する特定の語の入力をエミュレートし、語と読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。
EmulateRecognize(String, CompareOptions)	同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対するフレーズの入力をエミュレートし、フレーズと読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。

注釈

これらのメソッドは、システム オーディオ入力をバイパスします。 これは、アプリケーションまたは文法をテストまたはデバッグする場合に役立ちます。

Note

Windows 音声認識が スリープ 状態の場合、これらのメソッドは を返します null。

共有認識エンジンは、認識操作が SpeechDetectedエミュレートされていないかのように、、 SpeechHypothesized、 SpeechRecognitionRejected、および SpeechRecognized イベントを発生させます。 認識エンジンは、新しい行と余分な空白を無視し、句読点をリテラル入力として扱います。

Note

RecognitionResultエミュレートされた入力に応答して共有認識エンジンによって生成されたオブジェクトのプロパティの値は ですnullAudio。

非同期認識をエミュレートするには、 メソッドを使用します EmulateRecognizeAsync 。

EmulateRecognize(String)

ソース:

SpeechRecognizer.cs

同期音声認識に音声ではなくテキストを使用して、共有音声認識エンジンに対する語句の入力をエミュレートします。

public:
 System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText);

public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText);

member this.EmulateRecognize : string -> System.Speech.Recognition.RecognitionResult

Public Function EmulateRecognize (inputText As String) As RecognitionResult

パラメーター

inputText

String

認識操作の入力。

戻り値

RecognitionResult

認識操作の認識結果。操作に成功しなかった場合や、Windows の音声認識がスリープ状態である場合は null。

例

次の例では、共有認識エンジンにサンプル文法を読み込み、認識エンジンへの入力をエミュレートします。 Windows 音声認識が実行されていない場合、このアプリケーションを起動すると、Windows 音声認識も開始されます。 Windows 音声認識が スリープ 状態の場合は、常に null を EmulateRecognize 返します。

using System;  
using System.Speech.Recognition;  

namespace SharedRecognizer  
{  
  class Program  
  {  

    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);  

        RecognitionResult result;  

        // This EmulateRecognize call matches the grammar and returns a  
        // recognition result.  
        result = recognizer.EmulateRecognize("testing testing");  
        OutputResult(result);  

        // This EmulateRecognize call does not match the grammar and   
        // returns null.  
        result = recognizer.EmulateRecognize("testing one two three");  
        OutputResult(result);  
      }  

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

    // Output information about a recognition result to the console.  
    private static void OutputResult(RecognitionResult result)  
    {  
      if (result != null)  
      {  
        Console.WriteLine("Recognition result = {0}",  
          result.Text ?? "<no text>");  
      }  
      else  
      {  
        Console.WriteLine("No recognition result");  
      }  
    }  
  }  
}  

注釈

Vista および Windows 7 に付属する認識エンジンは、入力語句に文法規則を適用するときに、大文字と小文字と文字の幅を無視します。 この種類の比較の詳細については、列挙値OrdinalIgnoreCaseと IgnoreWidthをCompareOptions参照してください。 認識エンジンは、新しい行と余分な空白も無視し、句読点をリテラル入力として扱います。

こちらもご覧ください

• RecognitionResult
• EmulateRecognizeAsync(String)
• SpeechDetected
• SpeechHypothesized
• SpeechRecognitionRejected
• SpeechRecognized

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

ソース:

SpeechRecognizer.cs

同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対する特定の語の入力をエミュレートし、語と読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。

public:
 System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(cli::array <System::Speech::Recognition::RecognizedWordUnit ^> ^ wordUnits, System::Globalization::CompareOptions compareOptions);

public System.Speech.Recognition.RecognitionResult EmulateRecognize (System.Speech.Recognition.RecognizedWordUnit[] wordUnits, System.Globalization.CompareOptions compareOptions);

member this.EmulateRecognize : System.Speech.Recognition.RecognizedWordUnit[] * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult

Public Function EmulateRecognize (wordUnits As RecognizedWordUnit(), compareOptions As CompareOptions) As RecognitionResult

パラメーター

wordUnits

RecognizedWordUnit[]

認識操作のための必要を格納する単語単位の配列。

compareOptions

CompareOptions

エミュレートされた認識操作に使用する比較の種類を示す列挙値のビットごとの組み合わせ。

戻り値

RecognitionResult

認識操作の認識結果。操作に成功しなかった場合や、Windows の音声認識がスリープ状態である場合は null。

注釈

このメソッドは、 パラメーターに RecognitionResult 指定された情報を使用して オブジェクトを wordUnits 作成します。

認識エンジンは、入力語句に compareOptions 文法規則を適用するときに を使用します。 または の値が存在する場合 OrdinalIgnoreCase 、Vista および Windows 7 に付属する認識エンジンでは大文字と IgnoreCase 小文字が区別されません。 認識エンジンは常に文字幅を無視し、かな型は無視しません。 認識エンジンは、新しい行と余分な空白も無視し、句読点をリテラル入力として扱います。 文字幅とかな型の詳細については、 列挙を CompareOptions 参照してください。

こちらもご覧ください

• RecognitionResult
• EmulateRecognizeAsync(String)
• SpeechDetected
• SpeechHypothesized
• SpeechRecognitionRejected
• SpeechRecognized

EmulateRecognize(String, CompareOptions)

ソース:

SpeechRecognizer.cs

同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対するフレーズの入力をエミュレートし、フレーズと読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。

public:
 System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText, System::Globalization::CompareOptions compareOptions);

public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText, System.Globalization.CompareOptions compareOptions);

member this.EmulateRecognize : string * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult

Public Function EmulateRecognize (inputText As String, compareOptions As CompareOptions) As RecognitionResult

パラメーター

inputText

String

認識操作の入力語句。

compareOptions

CompareOptions

エミュレートされた認識操作に使用する比較の種類を示す列挙値のビットごとの組み合わせ。

戻り値

RecognitionResult

認識操作の認識結果。操作に成功しなかった場合や、Windows の音声認識がスリープ状態である場合は null。

注釈

認識エンジンは、入力語句に compareOptions 文法規則を適用するときに を使用します。 または の値が存在する場合 OrdinalIgnoreCase 、Vista および Windows 7 に付属する認識エンジンでは大文字と IgnoreCase 小文字が区別されません。 認識エンジンは常に文字幅を無視し、かな型は無視しません。 認識エンジンは、新しい行と余分な空白も無視し、句読点をリテラル入力として扱います。 文字幅とかな型の詳細については、 列挙を CompareOptions 参照してください。

こちらもご覧ください

• RecognitionResult
• EmulateRecognizeAsync(String)
• SpeechDetected
• SpeechHypothesized
• SpeechRecognitionRejected
• SpeechRecognized