SpeechRecognizer Clase

Definición

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

Herencia

Object

SpeechRecognizer

Implementaciones

IDisposable

Ejemplos

El ejemplo siguiente forma parte de una aplicación de consola que carga una gramática de reconocimiento de voz y muestra la entrada emulada asincrónica, los resultados de reconocimiento asociados y los eventos asociados generados por el reconocedor de voz. Si el reconocimiento de voz de Windows no se está ejecutando, al iniciar esta aplicación también se iniciará el reconocimiento de voz de Windows. Si el reconocimiento de voz de Windows está en estado inactivo , EmulateRecognizeAsync siempre devuelve null.

using System;  
using System.Speech.Recognition;  
using System.Threading;  

namespace SharedRecognizer  
{  
  class Program  
  {  

    // Indicate whether the asynchronous emulate recognition  
    // operation has completed.  
    static bool completed;  

    static void Main(string[] args)  
    {  

      // Initialize an instance of the shared recognizer.  
      using (SpeechRecognizer recognizer = new SpeechRecognizer())  
      {  

        // Create and load a sample grammar.  
        Grammar testGrammar =  
          new Grammar(new GrammarBuilder("testing testing"));  
        testGrammar.Name = "Test Grammar";  
        recognizer.LoadGrammar(testGrammar);  

        // Attach event handlers for recognition events.  
        recognizer.SpeechRecognized +=  
          new EventHandler<SpeechRecognizedEventArgs>(  
            SpeechRecognizedHandler);  
        recognizer.EmulateRecognizeCompleted +=  
          new EventHandler<EmulateRecognizeCompletedEventArgs>(  
            EmulateRecognizeCompletedHandler);  

        completed = false;  

        // Start asynchronous emulated recognition.   
        // This matches the grammar and generates a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing testing");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  

        completed = false;  

        // Start asynchronous emulated recognition.  
        // This does not match the grammar or generate a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing one two three");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  

    // Handle the SpeechRecognized event.  
    static void SpeechRecognizedHandler(  
      object sender, SpeechRecognizedEventArgs e)  
    {  
      if (e.Result != null)  
      {  
        Console.WriteLine("Recognition result = {0}",  
          e.Result.Text ?? "<no text>");  
      }  
      else  
      {  
        Console.WriteLine("No recognition result");  
      }  
    }  

    // Handle the SpeechRecognizeCompleted event.  
    static void EmulateRecognizeCompletedHandler(  
      object sender, EmulateRecognizeCompletedEventArgs e)  
    {  
      if (e.Result == null)  
      {  
        Console.WriteLine("No result generated.");  
      }  

      // Indicate the asynchronous operation is complete.  
      completed = true;  
    }  
  }  
}  

Comentarios

Las aplicaciones usan el reconocedor compartido para acceder al reconocimiento de voz de Windows. Use el SpeechRecognizer objeto para agregar a la experiencia del usuario de voz de Windows.

Esta clase proporciona control sobre varios aspectos del proceso de reconocimiento de voz:

• Para administrar las gramáticas de reconocimiento de voz, use , LoadGrammarLoadGrammarAsyncUnloadGrammar, , UnloadAllGrammarsy .Grammars

• Para obtener información sobre las operaciones actuales de reconocimiento de voz, suscríbase a los SpeechRecognizerSpeechDetectedeventos , SpeechHypothesized, SpeechRecognitionRejectedy SpeechRecognized .

• Para ver o modificar el número de resultados alternativos que devuelve el reconocedor, use la MaxAlternates propiedad . El reconocedor devuelve resultados de reconocimiento en un RecognitionResult objeto .

• Para acceder o supervisar el estado del reconocedor compartido, use las AudioLevelpropiedades , AudioPosition, AudioStateEnabled, PauseRecognizerOnRecognition, , RecognizerAudioPosition, y State los AudioLevelUpdatedeventos , AudioSignalProblemOccurredAudioStateChanged, y StateChanged .

• Para sincronizar los cambios en el reconocedor, use el RequestRecognizerUpdate método . El reconocedor compartido usa más de un subproceso para realizar tareas.

• Para emular la entrada al reconocedor compartido, use los EmulateRecognize métodos y EmulateRecognizeAsync .

La configuración del reconocimiento de voz de Windows se administra mediante el uso del cuadro de diálogo Propiedades de voz en el Panel de control. Esta interfaz se usa para seleccionar el lenguaje y el motor de reconocimiento de voz de escritorio predeterminados, el dispositivo de entrada de audio y el comportamiento de suspensión del reconocimiento de voz. Si se cambia la configuración del reconocimiento de voz de Windows mientras se ejecuta la aplicación (por ejemplo, si el reconocimiento de voz está deshabilitado o se cambia el idioma de entrada), el cambio afecta a todos los SpeechRecognizer objetos.

Para crear un reconocedor de voz en proceso independiente del reconocimiento de voz de Windows, use la SpeechRecognitionEngine clase .

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• SpeechRecognitionEngine
• Grammar
• RecognitionResult