SpeechRecognitionEngine.Recognize SpeechRecognitionEngine.Recognize SpeechRecognitionEngine.Recognize SpeechRecognitionEngine.Recognize Method

定義

同期音声認識操作を開始します。Starts a synchronous speech recognition operation.

オーバーロード

Recognize() Recognize() Recognize() Recognize()

同期音声認識操作を実行します。Performs a synchronous speech recognition operation.

Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan)

指定した最初のサイレント状態のタイムアウト期間の同期音声認識の操作を実行します。Performs a synchronous speech recognition operation with a specified initial silence timeout period.

注釈

これらのメソッドは、1 つの同期の認識操作を実行します。These methods perform a single, synchronous recognition operation. 認識エンジンは、その読み込み済みで有効になっている音声認識文法に対してこの操作を実行します。The recognizer performs this operation against its loaded and enabled speech recognition grammars.

このメソッドの呼び出し中に、認識エンジンは、次のイベントを発生させることができます。During a call to this method, the recognizer can raise the following events:

認識エンジンは発生しません、RecognizeCompletedイベントのいずれかを使用する場合、Recognizeメソッド。The recognizer does not raise the RecognizeCompleted event when using one of the Recognize methods.

Recognizeメソッドを返す、RecognitionResultオブジェクト、またはnull操作が不適切だったり、認識エンジンが有効でない場合。The Recognize methods return a RecognitionResult object, or null if the operation is not successful or the recognizer is not enabled.

次の理由により同期の認識操作を実行できます。A synchronous recognition operation can fail for the following reasons:

  • タイムアウト間隔は、の有効期限が切れる前に、音声が検出されない、BabbleTimeoutまたはInitialSilenceTimeoutプロパティ、または、initialSilenceTimeoutのパラメーター、Recognizeメソッド。Speech is not detected before the timeout intervals expire for the BabbleTimeout or InitialSilenceTimeout properties, or for the initialSilenceTimeout parameter of the Recognize method.

  • 認識エンジンが音声を検出するが読み込み済みで有効になっているのいずれかで一致が検出されないGrammarオブジェクト。The recognition engine detects speech but finds no matches in any of its loaded and enabled Grammar objects.

認識エンジンが音声認識または認識に関してサイレント状態のタイミングでどのように処理する方法を変更するには、使用、 BabbleTimeoutInitialSilenceTimeoutEndSilenceTimeout、およびEndSilenceTimeoutAmbiguousプロパティ。To modify how the recognizer handles the timing of speech or silence with respect to recognition, use the BabbleTimeout, InitialSilenceTimeout, EndSilenceTimeout, and EndSilenceTimeoutAmbiguous properties.

SpeechRecognitionEngineが少なくとも 1 つGrammar認識を実行する前にオブジェクトが読み込まれます。The SpeechRecognitionEngine must have at least one Grammar object loaded before performing recognition. 音声認識文法を読み込むには、使用、LoadGrammarまたはLoadGrammarAsyncメソッド。To load a speech recognition grammar, use the LoadGrammar or LoadGrammarAsync method.

非同期認識を実行するには、いずれかを使用、RecognizeAsyncメソッド。To perform asynchronous recognition, use one of the RecognizeAsync methods.

Recognize() Recognize() Recognize() Recognize()

同期音声認識操作を実行します。Performs a synchronous speech recognition operation.

public:
 System::Speech::Recognition::RecognitionResult ^ Recognize();
public System.Speech.Recognition.RecognitionResult Recognize ();
member this.Recognize : unit -> System.Speech.Recognition.RecognitionResult
Public Function Recognize () As RecognitionResult

戻り値

入力の認識結果。操作が不適切だったり、認識エンジンが有効でない場合は nullThe recognition result for the input, or null if the operation is not successful or the recognizer is not enabled.

次の例では、基本的な音声認識を示すコンソール アプリケーションの一部を示します。The following example shows part of a console application that demonstrates basic speech recognition. 例は、作成、DictationGrammarインプロセス音声認識エンジンに読み込みますや、1 つの認識操作を実行します。The example creates a DictationGrammar, loads it into an in-process speech recognizer, and performs one recognition operation.


using System;  
using System.Speech.Recognition;  

namespace SynchronousRecognition  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
      // Create an in-process speech recognizer for the en-US locale.  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(  
          new System.Globalization.CultureInfo("en-US")))  
      {  

        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Modify the initial silence time-out value.  
        recognizer.InitialSilenceTimeout = TimeSpan.FromSeconds(5);  

        // Start synchronous speech recognition.  
        RecognitionResult result = recognizer.Recognize();  

        if (result != null)  
        {  
          Console.WriteLine("Recognized text = {0}", result.Text);  
        }  
        else  
        {  
          Console.WriteLine("No recognition result available.");  
        }  
      }  

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

注釈

このメソッドでは、1 つの認識操作を実行します。This method performs a single recognition operation. 認識エンジンは、その読み込み済みで有効になっている音声認識文法に対してこの操作を実行します。The recognizer performs this operation against its loaded and enabled speech recognition grammars.

このメソッドの呼び出し中に、認識エンジンは、次のイベントを発生させることができます。During a call to this method, the recognizer can raise the following events:

認識エンジンは発生しません、RecognizeCompletedイベントがこのメソッドを使用する場合。The recognizer does not raise the RecognizeCompleted event when using this method.

Recognize()メソッドを返します。 をRecognitionResultオブジェクト、またはnull操作が成功しなかった場合。The Recognize() method returns a RecognitionResult object, or null if the operation is not successful.

次の理由により同期の認識操作を実行できます。A synchronous recognition operation can fail for the following reasons:

  • タイムアウト間隔は、の有効期限が切れる前に、音声が検出されない、BabbleTimeoutまたはInitialSilenceTimeoutプロパティ。Speech is not detected before the timeout intervals expire for the BabbleTimeout or InitialSilenceTimeout properties.

  • 認識エンジンが音声を検出するが読み込み済みで有効になっているのいずれかで一致が検出されないGrammarオブジェクト。The recognition engine detects speech but finds no matches in any of its loaded and enabled Grammar objects.

非同期認識を実行するには、いずれかを使用、RecognizeAsyncメソッド。To perform asynchronous recognition, use one of the RecognizeAsync methods.

こちらもご覧ください

Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan)

指定した最初のサイレント状態のタイムアウト期間の同期音声認識の操作を実行します。Performs a synchronous speech recognition operation with a specified initial silence timeout period.

public:
 System::Speech::Recognition::RecognitionResult ^ Recognize(TimeSpan initialSilenceTimeout);
public System.Speech.Recognition.RecognitionResult Recognize (TimeSpan initialSilenceTimeout);
member this.Recognize : TimeSpan -> System.Speech.Recognition.RecognitionResult
Public Function Recognize (initialSilenceTimeout As TimeSpan) As RecognitionResult

パラメーター

initialSilenceTimeout
TimeSpan TimeSpan TimeSpan TimeSpan

音声認識エンジンが認識を終了するまでに無音のみを含む入力を受け入れる時間間隔。The interval of time a speech recognizer accepts input containing only silence before finalizing recognition.

戻り値

入力の認識結果。操作が不適切だったり、認識エンジンが有効でない場合は nullThe recognition result for the input, or null if the operation is not successful or the recognizer is not enabled.

次の例では、基本的な音声認識を示すコンソール アプリケーションの一部を示します。The following example shows part of a console application that demonstrates basic speech recognition. 例は、作成、DictationGrammarインプロセス音声認識エンジンに読み込みますや、1 つの認識操作を実行します。The example creates a DictationGrammar, loads it into an in-process speech recognizer, and performs one recognition operation.


using System;  
using System.Speech.Recognition;  

namespace SynchronousRecognition  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
      // Create an in-process speech recognizer for the en-US locale.  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(  
          new System.Globalization.CultureInfo("en-US")))  
      {  
        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Start synchronous speech recognition.  
        RecognitionResult result = recognizer.Recognize(TimeSpan.FromSeconds(5));  

        if (result != null)  
        {  
          Console.WriteLine("Recognized text = {0}", result.Text);  
        }  
        else  
        {  
          Console.WriteLine("No recognition result available.");  
        }  
      }  

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

注釈

指定された時間間隔内で、音声認識エンジンが音声を検出したかどうかinitialSilenceTimeout引数、 Recognize(TimeSpan) 1 つの認識操作を実行してから終了します。If the speech recognition engine detects speech within the time interval specified by initialSilenceTimeout argument, Recognize(TimeSpan) performs a single recognition operation and then terminates. initialSilenceTimeoutパラメーターには、認識エンジンのよりも優先されますInitialSilenceTimeoutプロパティ。The initialSilenceTimeout parameter supersedes the recognizer's InitialSilenceTimeout property.

このメソッドの呼び出し中に、認識エンジンは、次のイベントを発生させることができます。During a call to this method, the recognizer can raise the following events:

認識エンジンは発生しません、RecognizeCompletedイベントがこのメソッドを使用する場合。The recognizer does not raise the RecognizeCompleted event when using this method.

Recognize()メソッドを返します。 をRecognitionResultオブジェクト、またはnull操作が成功しなかった場合。The Recognize() method returns a RecognitionResult object, or null if the operation is not successful.

次の理由により同期の認識操作を実行できます。A synchronous recognition operation can fail for the following reasons:

  • タイムアウト間隔は、の有効期限が切れる前に、音声が検出されない、BabbleTimeoutまたは、initialSilenceTimeoutパラメーター。Speech is not detected before the timeout intervals expire for the BabbleTimeout or for the initialSilenceTimeout parameter.

  • 認識エンジンが音声を検出するが読み込み済みで有効になっているのいずれかで一致が検出されないGrammarオブジェクト。The recognition engine detects speech but finds no matches in any of its loaded and enabled Grammar objects.

非同期認識を実行するには、いずれかを使用、RecognizeAsyncメソッド。To perform asynchronous recognition, use one of the RecognizeAsync methods.

こちらもご覧ください

適用対象