SpeechRecognizer.LoadGrammarCompleted Événement

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paquet:

System.Speech v11.0.0-preview.2.26159.112

Source:

SpeechRecognizer.cs

Se produit lorsque le module de reconnaissance termine le chargement asynchrone d’une grammaire de reconnaissance vocale.

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) 

Type d'événement

EventHandler<LoadGrammarCompletedEventArgs>

Exemples

L’exemple suivant crée un module de reconnaissance vocale partagée, puis crée deux types de grammaires pour reconnaître des mots spécifiques et accepter la dictée libre. L’exemple charge de manière asynchrone toutes les grammaires créées dans le module de reconnaissance. Les gestionnaires pour les événements et SpeechRecognized les événements du LoadGrammarCompleted module de reconnaissance écrivent dans la console le nom de la grammaire utilisée pour effectuer la reconnaissance et le texte du résultat de la reconnaissance, respectivement.

using System;
using System.Speech.Recognition;

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

      // Initialize a shared speech recognition engine.
      recognizer = new SpeechRecognizer();

        // 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);

        // Add a handler for the StateChanged event.
        recognizer.StateChanged +=
          new EventHandler<StateChangedEventArgs>(recognizer_StateChanged);

        // Create "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 "done" grammar.
        Grammar doneGrammar =
          new Grammar(new Choices(new string[] { "done", "exit", "quit", "stop" }));
        doneGrammar.Name = "Done";

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

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

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

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

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

    // Put the shared speech recognizer into "listening" mode.
    static void recognizer_StateChanged(object sender, StateChangedEventArgs e)
    {
      if (e.RecognizerState != RecognizerState.Stopped)
      {
        recognizer.EmulateRecognizeAsync("Start listening");
      }
    }
  }
}

Remarques

La méthode du module de LoadGrammarAsync reconnaissance lance une opération asynchrone. Le module de reconnaissance déclenche l’événement LoadGrammarCompleted lorsqu’il termine l’opération. Pour obtenir l’objet Grammar chargé par le module de reconnaissance, utilisez la Grammar propriété de l’objet associé LoadGrammarCompletedEventArgs. Pour obtenir les objets actuels chargés Grammar par le module de reconnaissance, utilisez la propriété du module de Grammars reconnaissance.

Lorsque vous créez un délégué pour un LoadGrammarCompleted événement, vous identifiez la méthode qui gère l’événement. Pour associer l’événement à votre gestionnaire d’événements, ajoutez une instance du délégué à l’événement. Le gestionnaire d’événements est appelé chaque fois que l’événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués de gestionnaire d’événements, consultez Événements et délégués.

Voir aussi

• Grammar
• LoadGrammarCompletedEventArgs
• Grammars
• LoadGrammarAsync(Grammar)