SpeechRecognitionEngine.EmulateRecognizeCompleted Händelse

public:
 event EventHandler<System::Speech::Recognition::EmulateRecognizeCompletedEventArgs ^> ^ EmulateRecognizeCompleted;

public event EventHandler<System.Speech.Recognition.EmulateRecognizeCompletedEventArgs>? EmulateRecognizeCompleted;

public event EventHandler<System.Speech.Recognition.EmulateRecognizeCompletedEventArgs> EmulateRecognizeCompleted;

member this.EmulateRecognizeCompleted : EventHandler<System.Speech.Recognition.EmulateRecognizeCompletedEventArgs> 

Public Custom Event EmulateRecognizeCompleted As EventHandler(Of EmulateRecognizeCompletedEventArgs) 

Public Event EmulateRecognizeCompleted As EventHandler(Of EmulateRecognizeCompletedEventArgs) 

Händelsetyp

Exempel

Följande exempel är en del av ett konsolprogram som läser in en grammatik för taligenkänning och visar asynkrona emulerade indata, associerade igenkänningsresultat och associerade händelser som genereras av taligenkänningen.

using System;
using System.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 an instance of an in-process recognizer.
      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 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;

        // 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;
    }
  }
}

Kommentarer

Varje EmulateRecognizeAsync metod påbörjar en asynkron igenkänningsåtgärd. SpeechRecognitionEngine Genererar EmulateRecognizeCompleted händelsen när den slutför den asynkrona åtgärden.

Åtgärden EmulateRecognizeAsync kan generera SpeechDetectedhändelserna , SpeechHypothesized, SpeechRecognitionRejectedoch SpeechRecognized . Händelsen EmulateRecognizeCompleted är den sista händelsen som identifieraren genererar för en viss åtgärd.

Om emulerad igenkänning lyckades kan du komma åt igenkänningsresultatet med något av följande:

• Egenskapen Result i EmulateRecognizeCompletedEventArgs objektet i hanteraren för EmulateRecognizeCompleted händelsen.

• Result -egenskapen i SpeechRecognizedEventArgs -objektet i hanteraren för SpeechRecognized händelsen.

Om den emulerade igenkänningen SpeechRecognized inte lyckades utlöses inte händelsen och Result kommer att vara null.

EmulateRecognizeCompletedEventArgs härleds från AsyncCompletedEventArgs.

SpeechRecognizedEventArgs härleds från RecognitionEventArgs.

När du skapar ett EmulateRecognizeCompleted ombud identifierar du den metod som ska hantera händelsen. Om du vill associera händelsen med händelsehanteraren lägger du till en instans av ombudet till händelsen. Händelsehanteraren anropas när händelsen inträffar, såvida du inte tar bort ombudet. Mer information om ombud för händelsehanterare finns i Händelser och ombud.

Se även

• EmulateRecognizeCompletedEventArgs
• SpeechRecognized
• SpeechDetected
• SpeechHypothesized
• SpeechRecognitionRejected
• RecognizeCompleted