SpeechRecognitionEngine.EmulateRecognizeCompleted Event

Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation of emulated input.

Namespace:  Microsoft.Speech.Recognition
Assembly:  Microsoft.Speech (in Microsoft.Speech.dll)

Syntax

'Declaration
Public Event EmulateRecognizeCompleted As EventHandler(Of EmulateRecognizeCompletedEventArgs)
'Usage
Dim instance As SpeechRecognitionEngine
Dim handler As EventHandler(Of EmulateRecognizeCompletedEventArgs)

AddHandler instance.EmulateRecognizeCompleted, handler

public event EventHandler<EmulateRecognizeCompletedEventArgs> EmulateRecognizeCompleted

Remarks

Each EmulateRecognizeAsync method begins an asynchronous recognition operation. The SpeechRecognitionEngine raises the EmulateRecognizeCompleted event when it finalizes the asynchronous operation.

The EmulateRecognizeAsync(String) operation can raise the SpeechDetected, SpeechHypothesized, SpeechRecognitionRejected, and SpeechRecognized events. The EmulateRecognizeCompleted event is the last such event that the recognizer raises for a given operation.

If emulated recognition was successful, you can access the recognition result using the either of the following:

• The Result property in the EmulateRecognizeCompletedEventArgs object in the handler for the EmulateRecognizeCompleted event.

• The Result property in the SpeechRecognizedEventArgs object in the handler for the SpeechRecognized event.

If emulated recognition was not successful, the SpeechRecognized event is not raised and the Result will be null.

EmulateRecognizeCompletedEventArgs derives from AsyncCompletedEventArgs.

SpeechRecognizedEventArgs derives from RecognitionEventArgs.

When you create an EmulateRecognizeCompleted delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see Events and Delegates.

Examples

The following example is part of a console application that loads a speech recognition grammar and demonstrates asynchronous emulated input, the associated recognition results, and the associated events raised by the speech recognizer.

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

namespace InProcessRecognizer
{
  class Program
  {
    // Indicate whether the asynchronous emulate recognition
    // operation has completed.
    static bool completed;

    static void Main(string[] args)
    {

      // Initialize a SpeechRecognitionEngine object.
      using (SpeechRecognitionEngine recognizer = 
        new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US")))
      {
        // 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;

        // This EmulateRecognizeAsync call mathches 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;

        // This EmulateRecognizeAsync call 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("Result of 1st call to EmulateRecognizeAsync = {0}",
          e.Result.Text ?? "<no text>");
        Console.WriteLine();
      }
      else
      {
        Console.WriteLine("No recognition result");
      }
    }

    // Handle the EmulateRecognizeCompleted event.
    static void EmulateRecognizeCompletedHandler(
      object sender, EmulateRecognizeCompletedEventArgs e)
    {
      if (e.Result == null)
      {
        Console.WriteLine("Result of 2nd call to EmulateRecognizeAsync = No result generated.");
      }

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

See Also

Reference

SpeechRecognitionEngine Class

SpeechRecognitionEngine Members

Microsoft.Speech.Recognition Namespace

EmulateRecognizeCompletedEventArgs

SpeechRecognized

SpeechDetected

SpeechHypothesized

SpeechRecognitionRejected