SpeechRecognizer.EmulateRecognize SpeechRecognizer.EmulateRecognize SpeechRecognizer.EmulateRecognize SpeechRecognizer.EmulateRecognize Method

定義

同期音声認識に音声ではなくテキストを使用して、共有音声認識エンジンに対する入力をエミュレートします。Emulates input to the shared speech recognizer, using text instead of audio for synchronous speech recognition.

オーバーロード

EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String)

同期音声認識に音声ではなくテキストを使用して、共有音声認識エンジンに対する語句の入力をエミュレートします。Emulates input of a phrase to the shared speech recognizer, using text instead of audio for synchronous speech recognition.

EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions)

同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対する特定の語の入力をエミュレートし、語と読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。Emulates input of specific words to the shared speech recognizer, using text instead of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the words and the loaded speech recognition grammars.

EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions)

同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対するフレーズの入力をエミュレートし、フレーズと読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。Emulates input of a phrase to the shared speech recognizer, using text instead of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the phrase and the loaded speech recognition grammars.

注釈

これらのメソッドは、システムオーディオ入力をバイパスします。These methods bypass the system audio input. これは、アプリケーションまたは文法をテストまたはデバッグするときに役立ちます。This can be helpful when you are testing or debugging an application or grammar.

注意

Windows 音声認識がスリープ状態の場合、これらのメソッドはをnull返します。If Windows Speech Recognition is in the Sleeping state, then these methods return null.

認識操作がエミュレートさSpeechDetectedれてSpeechRecognitionRejectedいないSpeechRecognizedかのように、共有認識エンジンは、 SpeechHypothesized、、およびの各イベントを発生させます。The shared recognizer raises the SpeechDetected, SpeechHypothesized, SpeechRecognitionRejected, and SpeechRecognized events as if the recognition operation is not emulated. レコグナイザーは、新しい行と余分な空白文字を無視し、句読点をリテラル入力として扱います。The recognizer ignores new lines and extra white space and treats punctuation as literal input.

注意

エミュレートされた入力への応答として共有認識エンジンによっnullて生成Audioされるオブジェクトのプロパティには、の値が含まれます。RecognitionResultThe RecognitionResult object generated by the shared recognizer in response to emulated input has a value of null for its Audio property.

非同期認識をエミュレートするにはEmulateRecognizeAsync 、メソッドを使用します。To emulate asynchronous recognition, use the EmulateRecognizeAsync method.

EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String)

同期音声認識に音声ではなくテキストを使用して、共有音声認識エンジンに対する語句の入力をエミュレートします。Emulates input of a phrase to the shared speech recognizer, using text instead of audio for synchronous speech recognition.

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 String String String

認識操作の入力。The input for the recognition operation.

戻り値

認識操作の認識結果。操作に成功しなかった場合や、Windows の音声認識がスリープ状態である場合は nullThe recognition result for the recognition operation, or null, if the operation is not successful or Windows Speech Recognition is in the Sleeping state.

次の例では、共有認識エンジンにサンプル文法を読み込み、認識エンジンへの入力をエミュレートします。The following example loads a sample grammar to the shared recognizer and emulates input to the recognizer. Windows 音声認識が実行されていない場合は、このアプリケーションを起動すると、Windows 音声認識も開始されます。If Windows Speech Recognition is not running, then starting this application will also start Windows Speech Recognition. Windows 音声認識がスリープ状態の場合、 EmulateRecognizeは常に null を返します。If Windows Speech Recognition is in the Sleeping state, then EmulateRecognize always returns null.


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 に付属しているレコグナイザーは、文法規則を入力語句に適用するときに大文字と小文字の区別を無視します。The recognizers that ship with Vista and Windows 7 ignore case and character width when applying grammar rules to the input phrase. この種類の比較の詳細については、 CompareOptions列挙値OrdinalIgnoreCaseIgnoreWidth「」を参照してください。For more information about this type of comparison, see the CompareOptions enumeration values OrdinalIgnoreCase and IgnoreWidth. また、このレコグナイザーは新しい行と余分な空白を無視し、句読点をリテラル入力として扱います。The recognizers also ignore new lines and extra white space and treat punctuation as literal input.

こちらもご覧ください

EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions)

同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対する特定の語の入力をエミュレートし、語と読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。Emulates input of specific words to the shared speech recognizer, using text instead of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the words and the loaded speech recognition grammars.

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

パラメーター

wordUnits
RecognizedWordUnit[]

認識操作のための必要を格納する単語単位の配列。An array of word units that contains the input for the recognition operation.

compareOptions
CompareOptions CompareOptions CompareOptions CompareOptions

エミュレートされた認識操作に使用する比較の種類を示す列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that describe the type of comparison to use for the emulated recognition operation.

戻り値

認識操作の認識結果。操作に成功しなかった場合や、Windows の音声認識がスリープ状態である場合は nullThe recognition result for the recognition operation, or null, if the operation is not successful or Windows Speech Recognition is in the Sleeping state.

注釈

このメソッドは、 RecognitionResult wordUnitsパラメーターに指定された情報を使用してオブジェクトを作成します。This method creates a RecognitionResult object using the information provided in the wordUnits parameter.

認識エンジンは、 compareOptions文法規則を入力語句に適用するときにを使用します。The recognizer uses the compareOptions when it applies grammar rules to the input phrase. OrdinalIgnoreCaseまたはIgnoreCaseの値が存在する場合、Vista および Windows 7 に付属しているレコグナイザーは、大文字小文字を区別しません。The recognizers that ship with Vista and Windows 7 ignore case if the OrdinalIgnoreCase or IgnoreCase value is present. レコグナイザーは、文字幅を常に無視し、かなの種類を無視しません。The recognizers always ignore the character width and never ignore the Kana type. また、このレコグナイザーは新しい行と余分な空白を無視し、句読点をリテラル入力として扱います。The recognizers also ignore new lines and extra white space and treats punctuation as literal input. 文字幅とかなの種類の詳細についてはCompareOptions 、列挙体を参照してください。For more information about character width and Kana type, see the CompareOptions enumeration.

こちらもご覧ください

EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions)

同期音声認識にオーディオではなくテキストを使用して、共有された音声認識エンジンに対するフレーズの入力をエミュレートし、フレーズと読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。Emulates input of a phrase to the shared speech recognizer, using text instead of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the phrase and the loaded speech recognition grammars.

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

パラメーター

inputText
String String String String

認識操作の入力語句。The input phrase for the recognition operation.

compareOptions
CompareOptions CompareOptions CompareOptions CompareOptions

エミュレートされた認識操作に使用する比較の種類を示す列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that describe the type of comparison to use for the emulated recognition operation.

戻り値

認識操作の認識結果。操作に成功しなかった場合や、Windows の音声認識がスリープ状態である場合は nullThe recognition result for the recognition operation, or null, if the operation is not successful or Windows Speech Recognition is in the Sleeping state.

注釈

認識エンジンは、 compareOptions文法規則を入力語句に適用するときにを使用します。The recognizer uses the compareOptions when it applies grammar rules to the input phrase. OrdinalIgnoreCaseまたはIgnoreCaseの値が存在する場合、Vista および Windows 7 に付属しているレコグナイザーは、大文字小文字を区別しません。The recognizers that ship with Vista and Windows 7 ignore case if the OrdinalIgnoreCase or IgnoreCase value is present. レコグナイザーは、文字幅を常に無視し、かなの種類を無視しません。The recognizers always ignore the character width and never ignore the Kana type. また、このレコグナイザーは新しい行と余分な空白を無視し、句読点をリテラル入力として扱います。The recognizers also ignore new lines and extra white space and treats punctuation as literal input. 文字幅とかなの種類の詳細についてはCompareOptions 、列挙体を参照してください。For more information about character width and Kana type, see the CompareOptions enumeration.

こちらもご覧ください

適用対象