RecognizeCompletedEventArgs Klasse

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paket:

System.Speech v9.0.0-rc.2.24473.5

Quelle:

RecognizeCompletedEventArgs.cs

Stellt Daten für das RecognizeCompleted-Ereignis bereit, das von einem SpeechRecognitionEngine- oder einem SpeechRecognizer-Objekt ausgelöst wird.

public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type RecognizeCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs

Vererbung

Object

EventArgs

AsyncCompletedEventArgs

RecognizeCompletedEventArgs

Beispiele

Im folgenden Beispiel wird die asynchrone Spracherkennung für eine Spracherkennungsgrammatik mithilfe der SpeechRecognitionEngine.RecognizeAsync -Methode mit der Prozesserkennung durchgeführt. Im Beispiel werden -Objekte und GrammarBuilder verwendetChoices, um die Spracherkennungsgrammatik zu erstellen, bevor sie in ein -Objekt integriert Grammar wird. Ein Handler für das SpeechRecognitionEngine.RecognizeCompleted Ereignis gibt Informationen zum Erkennungsvorgang an die Konsole aus.

using System;  
using System.Speech.Recognition;  

namespace SampleRecognition  
{  
  class Program  
  {  
    private static SpeechRecognitionEngine recognizer;  
    public static void Main(string[] args)  
    {  

      // Initialize a SpeechRecognitionEngine object and set its input.  
      recognizer = new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US"));  
      recognizer.SetInputToDefaultAudioDevice();  

      // Configure recognition parameters.  
      recognizer.InitialSilenceTimeout = TimeSpan.FromSeconds(5.0);  
      recognizer.BabbleTimeout = TimeSpan.FromSeconds(3.0);  
      recognizer.EndSilenceTimeout = TimeSpan.FromSeconds(1.0);  
      recognizer.EndSilenceTimeoutAmbiguous = TimeSpan.FromSeconds(1.0);  

      // Add a handler for the LoadGrammarCompleted event.  
      recognizer.LoadGrammarCompleted +=  
        new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);  

      // Add a handler for the RecognizeCompleted event.  
      recognizer.RecognizeCompleted +=   
        new EventHandler<RecognizeCompletedEventArgs>(recognizer_RecognizeCompleted);  

      // Create a speech recognition grammar and build it into a Grammar object.  
      Choices bankingMenu = new Choices(new string[]   
      { "Access accounts", "Transfer funds", "Pay bills", "Get loan balance" });  
      GrammarBuilder banking = new GrammarBuilder(bankingMenu);  
      Grammar bankGrammar = new Grammar(banking);  
      bankGrammar.Name = "Banking Menu";  

      // Load the Grammar objects to the recognizer.  
      recognizer.LoadGrammarAsync(bankGrammar);  

      // 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: Grammar ({0}), Text ({1}), Confidence ({2}), AudioPosition ({3}).",  
          e.Result.Grammar.Name, e.Result.Text, e.Result.Confidence, 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)  
    {  
      string grammarName = e.Grammar.Name;  
      bool grammarLoaded = e.Grammar.Loaded;  
      bool grammarEnabled = e.Grammar.Enabled;  

      if (e.Error != null)  
      {  
        Console.WriteLine("LoadGrammar for {0} failed with a {1}.",  
        grammarName, e.Error.GetType().Name);  

        // Add exception handling code here.  
      }  

      Console.WriteLine("Grammar {0} {1} loaded and {2} enabled.", grammarName,   
        (grammarLoaded) ? "is" : "is not", (grammarEnabled) ? "is" : "is not");  
    }  
  }            
}  

Hinweise

Eine instance von RecognizeCompleted wird erstellt, wenn das SpeechRecognitionEngine - oder das SpeechRecognizer -Objekt nach Abschluss eines Vorgangs RecognizeAsync sein SpeechRecognized -Ereignis auslöst. Weitere Informationen zu Spracherkennungsereignissen finden Sie unter Verwenden von Spracherkennungsereignissen.

Eigenschaften

AudioPosition	Ruft die Position im Audiostream des Eingabegeräts ab, die dem RecognizeCompleted-Ereignis zugeordnet ist.
BabbleTimeout	Ruft einen Wert ab, der angibt, ob ein Geplappertimeout das RecognizeCompleted-Ereignis generiert hat.
Cancelled	Ruft einen Wert ab, der angibt, ob ein asynchroner Vorgang abgebrochen wurde. (Geerbt von AsyncCompletedEventArgs)
Error	Ruft einen Wert ab, der angibt, welcher Fehler während eines asynchronen Vorgangs aufgetreten ist. (Geerbt von AsyncCompletedEventArgs)
InitialSilenceTimeout	Ruft einen Wert ab, der angibt, ob das ursprüngliche Ruhetimeout RecognizeCompleted-Ereignis generiert hat.
InputStreamEnded	Ruft einen Wert, der angibt, ob der Eingabedatenstrom beendet worden ist.
Result	Ruft das Erkennungsergebnis ab.
UserState	Ruft den eindeutigen Bezeichner der asynchronen Aufgabe ab. (Geerbt von AsyncCompletedEventArgs)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RaiseExceptionIfNecessary()	Löst eine benutzerdefinierte Ausnahme aus, wenn bei einem asynchronen Vorgang ein Fehler aufgetreten ist. (Geerbt von AsyncCompletedEventArgs)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• SpeechRecognitionEngine
• RecognizeCompleted
• RecognizeAsync()
• EmulateRecognizeCompletedEventArgs