SpeechRecognitionEngine.LoadGrammarCompleted Evento

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-preview.3.24172.9

Source:

SpeechRecognitionEngine.cs

Se genera cuando SpeechRecognitionEngine finaliza la carga asincrónica de un objeto Grammar.

public:
 event EventHandler<System::Speech::Recognition::LoadGrammarCompletedEventArgs ^> ^ LoadGrammarCompleted;

public event EventHandler<System.Speech.Recognition.LoadGrammarCompletedEventArgs> LoadGrammarCompleted;

member this.LoadGrammarCompleted : EventHandler<System.Speech.Recognition.LoadGrammarCompletedEventArgs> 

Public Event LoadGrammarCompleted As EventHandler(Of LoadGrammarCompletedEventArgs) 

Tipo de evento

EventHandler<LoadGrammarCompletedEventArgs>

Ejemplos

En el ejemplo siguiente se crea un reconocedor de voz en proceso y, a continuación, se crean dos tipos de gramáticas para reconocer palabras específicas y para aceptar dictado libre. En el ejemplo se construye un Grammar objeto a partir de cada una de las gramáticas de reconocimiento de voz completadas y, a continuación, se cargan asincrónicamente los Grammar objetos en la SpeechRecognitionEngine instancia. Los controladores de los eventos y SpeechRecognized del reconocedor LoadGrammarCompleted escriben en la consola el nombre del Grammar objeto que se usó para realizar el reconocimiento y el texto del resultado del reconocimiento, respectivamente.

using System;  
using System.Speech.Recognition;  

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

      // Initialize an in-process speech recognition engine and set its input.  
      recognizer = new SpeechRecognitionEngine();  
      recognizer.SetInputToDefaultAudioDevice();  

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

      // Add a handler for the SpeechRecognized event.  
      recognizer.SpeechRecognized +=  
        new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  

      // Create the "yesno" grammar.  
      Choices yesChoices = new Choices(new string[] { "yes", "yup", "yeah" });  
      SemanticResultValue yesValue =  
          new SemanticResultValue(yesChoices, (bool)true);  
      Choices noChoices = new Choices(new string[] { "no", "nope", "neah" });  
      SemanticResultValue noValue =  
          new SemanticResultValue(noChoices, (bool)false);  
      SemanticResultKey yesNoKey =  
          new SemanticResultKey("yesno", new Choices(new GrammarBuilder[] { yesValue, noValue }));  
      Grammar yesnoGrammar = new Grammar(yesNoKey);  
      yesnoGrammar.Name = "yesNo";  

      // Create the "done" grammar.  
      Grammar doneGrammar =  
        new Grammar(new Choices(new string[] { "done", "exit", "quit", "stop" }));  
      doneGrammar.Name = "Done";  

      // Create a dictation grammar.  
      Grammar dictation = new DictationGrammar();  
      dictation.Name = "Dictation";  

      // Load grammars to the recognizer.  
      recognizer.LoadGrammarAsync(yesnoGrammar);  
      recognizer.LoadGrammarAsync(doneGrammar);  
      recognizer.LoadGrammarAsync(dictation);  

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

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

    // Handle the LoadGrammarCompleted event.   
    static void recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)  
    {  
      string grammarName = e.Grammar.Name;  
      bool grammarLoaded = e.Grammar.Loaded;  

      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.",  
      grammarName, (grammarLoaded) ? "is" : "is not");  
    }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Grammar({0}): {1}", e.Result.Grammar.Name, e.Result.Text);  

      // Add event handler code here.  
    }  
  }  
}  

Comentarios

El método del LoadGrammarAsync reconocedor inicia una operación asincrónica. SpeechRecognitionEngine genera este evento cuando finaliza la operación. Para obtener el Grammar objeto que cargó el reconocedor, use la Grammar propiedad del asociado LoadGrammarCompletedEventArgs. Para obtener los objetos actuales Grammar que el reconocedor ha cargado, use la propiedad del Grammars reconocedor.

Si el reconocedor se está ejecutando, las aplicaciones deben usar RequestRecognizerUpdate para pausar el motor de reconocimiento de voz antes de cargar, descargar, habilitar o deshabilitar una gramática.

Cuando se crea un delegado LoadGrammarCompleted, se identifica el método que controlará el evento. Para asociar el evento al controlador, se debe agregar una instancia del delegado al evento. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. Para obtener más información sobre los delegados del controlador de eventos, vea Eventos y delegados.

Consulte también

• RecognizerUpdateReached
• Grammar
• LoadGrammarCompletedEventArgs
• LoadGrammarAsync(Grammar)
• Grammars