SpeechRecognitionEngine.LoadGrammarCompleted Ereignis

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) 

Ereignistyp

Beispiele

Im folgenden Beispiel wird eine prozessinterne Spracherkennung erstellt, und anschließend werden zwei Grammatiktypen zum Erkennen bestimmter Wörter und zum Akzeptieren des freien Diktierens erstellt. Im Beispiel wird ein Grammar Objekt aus jeder der vollständigen Spracherkennungsgrammatiken erstellt. Anschließend werden die Grammar Objekte asynchron in die SpeechRecognitionEngine Instanz geladen. Handler für die Erkennungs LoadGrammarCompleted - und SpeechRecognized Ereignisereignisse schreiben in die Konsole den Namen des Grammar Objekts, das zum Ausführen der Erkennung bzw. des Texts des Erkennungsergebnisses verwendet wurde.

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

Hinweise

Die Methode der LoadGrammarAsync Erkennung initiiert einen asynchronen Vorgang. Das SpeechRecognitionEngine Ereignis löst dieses Ereignis aus, wenn er den Vorgang abgeschlossen hat. Um das Grammar Objekt abzurufen, das die Erkennung geladen hat, verwenden Sie die Grammar Eigenschaft der zugeordneten LoadGrammarCompletedEventArgs. Um die aktuellen Grammar Objekte abzurufen, die die Erkennung geladen hat, verwenden Sie die Eigenschaft der Grammars Erkennung.

Wenn die Erkennung ausgeführt wird, müssen Anwendungen das Spracherkennungsmodul vor dem Laden, Entladen, Aktivieren oder Deaktivieren einer Grammatik anhalten RequestRecognizerUpdate .

Wenn Sie einen LoadGrammarCompleted 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 zu Ereignishandlerdelegatn finden Sie unter "Ereignisse und Stellvertretungen".

Weitere Informationen

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