SpeechRecognitionEngine.LoadGrammarCompleted Evento

Definição

Espaço de Nomes:
System.Speech.Recognition
Assemblagem:
System.Speech.dll

Elevado quando termina SpeechRecognitionEngine o carregamento assíncrono de um Grammar objeto.

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 Custom Event LoadGrammarCompleted As EventHandler(Of LoadGrammarCompletedEventArgs) 
Public Event LoadGrammarCompleted As EventHandler(Of LoadGrammarCompletedEventArgs)

Tipo de Evento

EventHandler<LoadGrammarCompletedEventArgs>

Exemplos

O exemplo seguinte cria um reconhecedor de fala em processo e, depois, cria dois tipos de gramáticas para reconhecer palavras específicas e para aceitar ditado livre. O exemplo constrói um Grammar objeto a partir de cada uma das gramáticas de reconhecimento de fala concluídas e depois carrega assíncronamente os Grammar objetos na SpeechRecognitionEngine instância. Os handlers dos reconhecedores LoadGrammarCompleted e SpeechRecognized eventos escrevem na consola o nome do Grammar objeto usado para realizar o reconhecimento e o texto do resultado do reconhecimento, respetivamente.

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.
    }
  }
}

Observações

O método do LoadGrammarAsync recognizer inicia uma operação assíncrona. Este SpeechRecognitionEngine evento é levantado quando a operação termina. Para obter o Grammar objeto que o reconhecedor carregou, use a Grammar propriedade do atributo associado LoadGrammarCompletedEventArgs. Para obter os objetos atuais Grammar que o recognizer carregou, use a propriedade do Grammars recognizer.

Se o reconhecedor estiver a funcionar, as aplicações devem usar RequestRecognizerUpdate para pausar o motor de reconhecimento de fala antes de carregar, descarregar, ativar ou desativar uma gramática.

Quando cria um LoadGrammarCompleted delegado, identifica o método que irá gerir o evento. Para associar o evento ao seu gestor de eventos, adicione uma instância do delegado ao evento. O gestor de eventos é chamado sempre que o evento ocorre, a menos que remova o delegado. Para mais informações sobre os delegados gestores de eventos, consulte Eventos e Delegados.

Aplica-se a

Ver também