SpeechRecognitionEngine.RecognizeCompleted Ereignis

public:
 event EventHandler<System::Speech::Recognition::RecognizeCompletedEventArgs ^> ^ RecognizeCompleted;

public event EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs>? RecognizeCompleted;

public event EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs> RecognizeCompleted;

member this.RecognizeCompleted : EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs> 

Public Custom Event RecognizeCompleted As EventHandler(Of RecognizeCompletedEventArgs) 

Public Event RecognizeCompleted As EventHandler(Of RecognizeCompletedEventArgs) 

Ereignistyp

Beispiele

Im folgenden Beispiel werden Ausdrücke wie "Anzeigen der Liste der Künstler in der Jazzkategorie" oder "Display Albums Gospel" erkannt. Im Beispiel wird ein Handler für das RecognizeCompleted Ereignis verwendet, um Informationen zu den Ergebnissen der Erkennung in der Konsole anzuzeigen.

using System;
using System.Speech.Recognition;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize an in-process speech recognition engine.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine())
      {

        //  Create lists of alternative choices.
        Choices listTypes = new Choices(new string[] { "albums", "artists" });
        Choices genres = new Choices(new string[] {
          "blues", "classical", "gospel", "jazz", "rock" });

        //  Create a GrammarBuilder object and assemble the grammar components.
        GrammarBuilder mediaMenu = new GrammarBuilder("Display");
        mediaMenu.Append("the list of", 0, 1);
        mediaMenu.Append(listTypes);
        mediaMenu.Append("in the", 0, 1);
        mediaMenu.Append(genres);
        mediaMenu.Append("category.", 0, 1);

        //  Build a Grammar object from the GrammarBuilder.
        Grammar mediaMenuGrammar = new Grammar(mediaMenu);
        mediaMenuGrammar.Name = "Media Chooser";

        // Attach event handlers.
        recognizer.RecognizeCompleted +=
          new EventHandler<RecognizeCompletedEventArgs>(recognizer_RecognizeCompleted);
        recognizer.LoadGrammarCompleted +=
          new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);

        // Load the grammar object to the recognizer.
        recognizer.LoadGrammarAsync(mediaMenuGrammar);

        // Set the input to the recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Start asynchronous, continuous recognition.
        recognizer.RecognizeAsync();

        // Keep the console window open.
        Console.ReadLine();
      }
    }

    // Handle the RecognizeCompleted event.
    static void recognizer_RecognizeCompleted(object sender, RecognizeCompletedEventArgs e)
    {
      if (e.Error != null)
      {
        Console.WriteLine(
          "RecognizeCompleted, error occurred during recognition: {0}", e.Error);
        return;
      }

      if (e.InitialSilenceTimeout || e.BabbleTimeout)
      {
        Console.WriteLine(
          "RecognizeCompleted: BabbleTimeout({0}), InitialSilenceTimeout({1}).",
          e.BabbleTimeout, e.InitialSilenceTimeout);
        return;
      }

      if (e.InputStreamEnded)
      {
        Console.WriteLine(
          "RecognizeCompleted: AudioPosition({0}), InputStreamEnded({1}).",
          e.AudioPosition, e.InputStreamEnded);
      }

      if (e.Result != null)
      {
        Console.WriteLine("RecognizeCompleted:");
        Console.WriteLine("  Grammar: " + e.Result.Grammar.Name);
        Console.WriteLine("  Recognized text: " + e.Result.Text);
        Console.WriteLine("  Confidence score: " + e.Result.Confidence);
        Console.WriteLine("  Audio position: " + e.AudioPosition);
      }

      else
      {
        Console.WriteLine("RecognizeCompleted: No result.");
      }

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

    // Handle the LoadGrammarCompleted event.
    static void recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)
    {
      Console.WriteLine("Grammar loaded:  " + e.Grammar.Name);
    }
  }
}

Hinweise

Die SpeechRecognitionEngine Methode des RecognizeAsync Objekts initiiert einen asynchronen Erkennungsvorgang. Wenn die Erkennung den asynchronen Vorgang abgeschlossen hat, wird dieses Ereignis ausgelöst.

Mithilfe des Handlers für das RecognizeCompleted Ereignis können Sie auf das RecognitionResultRecognizeCompletedEventArgs Objekt zugreifen. Wenn die Erkennung nicht erfolgreich war, RecognitionResult lautet dies null. Um festzustellen, ob ein Timeout oder eine Unterbrechung der Audioeingabe zu einem Fehler bei der Erkennung führte, können Sie auf die Eigenschaften für InitialSilenceTimeout, oder BabbleTimeoutInputStreamEnded.

Weitere Informationen finden Sie in der RecognizeCompletedEventArgs Klasse.

Um Details zu den am besten abgelehnten Erkennungskandidaten abzurufen, fügen Sie einen Handler für das SpeechRecognitionRejected Ereignis an.

Wenn Sie einen RecognizeCompleted Delegaten erstellen, identifizieren Sie die Methode, die das Ereignis behandelt. Um das Ereignis dem Ereignishandler zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird immer dann aufgerufen, wenn das Ereignis auftritt, es sei denn, Sie entfernen den Delegaten.

Weitere Informationen

• RecognizeCompletedEventArgs
• RecognizeAsync()
• SpeechRecognized