RecognizeCompletedEventArgs Klasa

Definicja

Udostępnia dane dla zdarzenia zgłoszonego RecognizeCompleted przez SpeechRecognitionEngine obiekt lub SpeechRecognizer .

public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs
public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
type RecognizeCompletedEventArgs = class
    inherit AsyncCompletedEventArgs
Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs
Dziedziczenie
RecognizeCompletedEventArgs

Przykłady

Poniższy przykład wykonuje asynchroniczne rozpoznawanie mowy w gramatyce rozpoznawania mowy przy użyciu SpeechRecognitionEngine.RecognizeAsync metody z rozpoznawaniem w procesie. W przykładzie użyto obiektów Choices i GrammarBuilder do utworzenia gramatyki rozpoznawania mowy przed utworzeniem Grammar jej w obiekcie. Procedura obsługi zdarzeń SpeechRecognitionEngine.RecognizeCompleted generuje informacje o operacji rozpoznawania w konsoli programu .

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");  
    }  
  }            
}  

Uwagi

Wystąpienie RecognizeCompleted obiektu jest tworzone, gdy SpeechRecognitionEngine obiekt lub SpeechRecognizer zgłasza jego SpeechRecognized zdarzenie po zakończeniu RecognizeAsync operacji. Aby uzyskać więcej informacji na temat zdarzeń rozpoznawania mowy, zobacz Using Speech Recognition Events (Używanie zdarzeń rozpoznawania mowy).

Właściwości

AudioPosition

Pobiera lokalizację w strumieniu audio urządzenia wejściowego skojarzonym ze zdarzeniem RecognizeCompleted .

BabbleTimeout

Pobiera wartość wskazującą, czy limit czasu babble wygenerował RecognizeCompleted zdarzenie.

Cancelled

Pobiera wartość wskazującą, czy operacja asynchroniczna została anulowana.

(Odziedziczone po AsyncCompletedEventArgs)
Error

Pobiera wartość wskazującą, który błąd wystąpił podczas operacji asynchronicznej.

(Odziedziczone po AsyncCompletedEventArgs)
InitialSilenceTimeout

Pobiera wartość wskazującą, czy początkowy limit czasu ciszy wygenerował RecognizeCompleted zdarzenie.

InputStreamEnded

Pobiera wartość wskazującą, czy strumień wejściowy zakończył się.

Result

Pobiera wynik rozpoznawania.

UserState

Pobiera unikatowy identyfikator zadania asynchronicznego.

(Odziedziczone po AsyncCompletedEventArgs)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
RaiseExceptionIfNecessary()

Zgłasza wyjątek dostarczony przez użytkownika, jeśli operacja asynchroniczna nie powiodła się.

(Odziedziczone po AsyncCompletedEventArgs)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też