SpeechRecognitionEngine.RecognizeCompleted Evento

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v11.0.0-preview.3.26207.106

Source:

SpeechRecognitionEngine.cs

Se genera cuando finaliza SpeechRecognitionEngine una operación de reconocimiento asincrónica.

public:
 event EventHandler<System::Speech::Recognition::RecognizeCompletedEventArgs ^> ^ RecognizeCompleted;

public event EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs>? RecognizeCompleted;

member this.RecognizeCompleted : EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs> 

Public Custom Event RecognizeCompleted As EventHandler(Of RecognizeCompletedEventArgs) 

Tipo de evento

EventHandler<RecognizeCompletedEventArgs>

Ejemplos

En el ejemplo siguiente se reconocen frases como "Mostrar la lista de artistas en la categoría jazz" o "Mostrar álbumes gospel". En el ejemplo se usa un controlador para el RecognizeCompleted evento para mostrar información sobre los resultados del reconocimiento en la consola.

using System;
using System.Speech.Recognition;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize an in-process speech recognition engine.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine())
      {

        //  Create lists of alternative choices.
        Choices listTypes = new Choices(new string[] { "albums", "artists" });
        Choices genres = new Choices(new string[] {
          "blues", "classical", "gospel", "jazz", "rock" });

        //  Create a GrammarBuilder object and assemble the grammar components.
        GrammarBuilder mediaMenu = new GrammarBuilder("Display");
        mediaMenu.Append("the list of", 0, 1);
        mediaMenu.Append(listTypes);
        mediaMenu.Append("in the", 0, 1);
        mediaMenu.Append(genres);
        mediaMenu.Append("category.", 0, 1);

        //  Build a Grammar object from the GrammarBuilder.
        Grammar mediaMenuGrammar = new Grammar(mediaMenu);
        mediaMenuGrammar.Name = "Media Chooser";

        // Attach event handlers.
        recognizer.RecognizeCompleted +=
          new EventHandler<RecognizeCompletedEventArgs>(recognizer_RecognizeCompleted);
        recognizer.LoadGrammarCompleted +=
          new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);

        // Load the grammar object to the recognizer.
        recognizer.LoadGrammarAsync(mediaMenuGrammar);

        // Set the input to the recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // 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:");
        Console.WriteLine("  Grammar: " + e.Result.Grammar.Name);
        Console.WriteLine("  Recognized text: " + e.Result.Text);
        Console.WriteLine("  Confidence score: " + e.Result.Confidence);
        Console.WriteLine("  Audio position: " + 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)
    {
      Console.WriteLine("Grammar loaded:  " + e.Grammar.Name);
    }
  }
}

Comentarios

El SpeechRecognitionEngine método del RecognizeAsync objeto inicia una operación de reconocimiento asincrónica. Cuando el reconocedor finaliza la operación asincrónica, genera este evento.

Con el controlador para el RecognizeCompleted evento, puede tener acceso a RecognitionResult en el RecognizeCompletedEventArgs objeto . Si el reconocimiento no se realizó correctamente, RecognitionResult será null. Para determinar si un tiempo de espera o una interrupción en la entrada de audio provocaron un error en el reconocimiento, puede acceder a las propiedades de InitialSilenceTimeout, BabbleTimeouto InputStreamEnded.

Consulte la RecognizeCompletedEventArgs clase para obtener más información.

Para obtener detalles sobre los mejores candidatos de reconocimiento rechazados, adjunte un controlador para el SpeechRecognitionRejected evento.

Al crear un RecognizeCompleted delegado, se identifica el método que controlará el evento. Para asociar el evento con el controlador de eventos, agregue una instancia del delegado al evento. Se llama al controlador de eventos cada vez que se produce el evento, a menos que quite el delegado.

Consulte también

• RecognizeCompletedEventArgs
• RecognizeAsync()
• SpeechRecognized