SpeechRecognizer SpeechRecognizer SpeechRecognizer SpeechRecognizer Class

Definición

Proporciona acceso al servicio de reconocimiento de voz compartido disponible en el escritorio de Windows.Provides access to the shared speech recognition service available on the Windows desktop.

public ref class SpeechRecognizer : IDisposable
public class SpeechRecognizer : IDisposable
type SpeechRecognizer = class
    interface IDisposable
Public Class SpeechRecognizer
Implements IDisposable
Herencia
SpeechRecognizerSpeechRecognizerSpeechRecognizerSpeechRecognizer
Implementaciones

Ejemplos

El siguiente ejemplo forma parte de una aplicación de consola que carga una gramática de reconocimiento de voz y muestra la entrada sincrónica, los resultados de reconocimiento asociados y los eventos asociados generados por el reconocedor de voz.The following example is part of a console application that loads a speech recognition grammar and demonstrates asynchronous emulated input, the associated recognition results, and the associated events raised by the speech recognizer. 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.If Windows Speech Recognition is not running, then starting this application will also start Windows Speech Recognition. Si el reconocimiento de voz de Windows **** se encuentra en estado EmulateRecognizeAsync de suspensión, siempre devuelve NULL.If Windows Speech Recognition is in the Sleeping state, then EmulateRecognizeAsync always returns 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 tener acceso al reconocimiento de voz de Windows.Applications use the shared recognizer to access Windows Speech Recognition. Use el SpeechRecognizer objeto para agregar a la experiencia de usuario de Windows Speech.Use the SpeechRecognizer object to add to the Windows speech user experience.

Esta clase proporciona control sobre los distintos aspectos del proceso de reconocimiento de voz:This class provides control over various aspects of the speech recognition process:

La configuración del reconocimiento de voz de Windows se administra mediante el cuadro de diálogo propiedades de voz del Panel de control.The configuration of Windows Speech Recognition is managed by the use of the Speech Properties dialog in the Control Panel. Esta interfaz se usa para seleccionar el idioma 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.This interface is used to select the default desktop speech recognition engine and language, the audio input device, and the sleep behavior of speech recognition. 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 SpeechRecognizer ), el cambio afecta a todos los objetos.If the configuration of Windows Speech Recognition is changed while the application is running, (for instance, if speech recognition is disabled or the input language is changed), the change affects all SpeechRecognizer objects.

Para crear un reconocedor de voz en proceso que sea independiente del reconocimiento de voz de Windows SpeechRecognitionEngine , use la clase.To create an in-process speech recognizer that is independent of Windows Speech Recognition, use the SpeechRecognitionEngine class.

Nota

Llame Dispose siempre antes de liberar la última referencia al reconocedor de voz.Always call Dispose before you release your last reference to the speech recognizer. De lo contrario, los recursos que utiliza no se liberarán hasta que el recolector de elementos no utilizados llame Finalize al método del objeto del reconocedor.Otherwise, the resources it is using will not be freed until the garbage collector calls the recognizer object's Finalize method.

Constructores

SpeechRecognizer() SpeechRecognizer() SpeechRecognizer() SpeechRecognizer()

Inicializa una nueva instancia de la clase SpeechRecognizer.Initializes a new instance of the SpeechRecognizer class.

Propiedades

AudioFormat AudioFormat AudioFormat AudioFormat

Obtiene el formato del sonido que es recibido por el reconocedor de voz.Gets the format of the audio being received by the speech recognizer.

AudioLevel AudioLevel AudioLevel AudioLevel

Obtiene el nivel del sonido que es recibido por el reconocedor de voz.Gets the level of the audio being received by the speech recognizer.

AudioPosition AudioPosition AudioPosition AudioPosition

Obtiene la ubicación actual en la secuencia audio generada por el dispositivo que está proporcionando entradas al módulo de reconocimiento de voz.Gets the current location in the audio stream being generated by the device that is providing input to the speech recognizer.

AudioState AudioState AudioState AudioState

Obtiene el estado del sonido que es recibido por el reconocedor de voz.Gets the state of the audio being received by the speech recognizer.

Enabled Enabled Enabled Enabled

Obtiene o establece un valor que indica si este objeto SpeechRecognizer está listo para procesar voz.Gets or sets a value that indicates whether this SpeechRecognizer object is ready to process speech.

Grammars Grammars Grammars Grammars

Obtiene una colección de los objetos Grammar cargados en esta instancia SpeechRecognizer.Gets a collection of the Grammar objects that are loaded in this SpeechRecognizer instance.

MaxAlternates MaxAlternates MaxAlternates MaxAlternates

Obtiene o establece el número máximo de resultados alternativos de reconocimiento que el reconocedor compartido devuelve para cada operación de reconocimiento.Gets or sets the maximum number of alternate recognition results that the shared recognizer returns for each recognition operation.

PauseRecognizerOnRecognition PauseRecognizerOnRecognition PauseRecognizerOnRecognition PauseRecognizerOnRecognition

Obtiene o establece un valor que indica si se detiene el reconocedor compartido en las operaciones de reconocimiento mientras una aplicación controla un evento SpeechRecognized.Gets or sets a value that indicates whether the shared recognizer pauses recognition operations while an application is handling a SpeechRecognized event.

RecognizerAudioPosition RecognizerAudioPosition RecognizerAudioPosition RecognizerAudioPosition

Obtiene la ubicación actual del reconocedor en la entrada de audio que está procesando.Gets the current location of the recognizer in the audio input that it is processing.

RecognizerInfo RecognizerInfo RecognizerInfo RecognizerInfo

Obtiene información sobre el reconocedor de voz compartido.Gets information about the shared speech recognizer.

State State State State

Obtiene el estado de un objeto SpeechRecognizer.Gets the state of a SpeechRecognizer object.

Métodos

Dispose() Dispose() Dispose() Dispose()

Desecha el objeto SpeechRecognizer.Disposes the SpeechRecognizer object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Desecha el objeto SpeechRecognizer y libera los recursos utilizados durante la sesión.Disposes the SpeechRecognizer object and releases resources used during the session.

EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Emula la entrada de palabras específicas al módulo de reconocimiento de voz compartido, usando texto en lugar de audio para el reconocimiento de voz sincrónico, y especifica cómo el reconocedor controla la comparación Unicode entre las palabras y las gramáticas reconocimiento de voz cargadas.Emulates input of specific words to the shared speech recognizer, using text instead of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the words and the loaded speech recognition grammars.

EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String)

Emula la entrada de una frase al módulo de reconocimiento de voz compartido, usando el texto en lugar de audio para el reconocimiento de voz sincrónico.Emulates input of a phrase to the shared speech recognizer, using text instead of audio for synchronous speech recognition.

EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions)

Emula la entrada de una frase al módulo de reconocimiento de voz compartido, usando texto en lugar de audio para el reconocimiento de voz sincrónico, y especifica cómo el reconocedor controla la comparación Unicode entre la frase y las gramáticas reconocimiento de voz cargadas.Emulates input of a phrase to the shared speech recognizer, using text instead of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the phrase and the loaded speech recognition grammars.

EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)

Emula la entrada de palabras específicas al módulo de reconocimiento de voz compartido, usando texto en lugar de audio para el reconocimiento de voz asincrónico, y especifica cómo el reconocedor controla la comparación Unicode entre las palabras y las gramáticas reconocimiento de voz cargadas.Emulates input of specific words to the shared speech recognizer, using text instead of audio for asynchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the words and the loaded speech recognition grammars.

EmulateRecognizeAsync(String) EmulateRecognizeAsync(String) EmulateRecognizeAsync(String) EmulateRecognizeAsync(String)

Emula la entrada de una frase al módulo de reconocimiento de voz compartido, usando el texto en lugar de audio para el reconocimiento de voz asincrónico.Emulates input of a phrase to the shared speech recognizer, using text instead of audio for asynchronous speech recognition.

EmulateRecognizeAsync(String, CompareOptions) EmulateRecognizeAsync(String, CompareOptions) EmulateRecognizeAsync(String, CompareOptions) EmulateRecognizeAsync(String, CompareOptions)

Emula la entrada de una frase al módulo de reconocimiento de voz compartido, usando texto en lugar de audio para el reconocimiento de voz asincrónico, y especifica cómo el reconocedor controla la comparación Unicode entre la frase y las gramáticas reconocimiento de voz cargadas.Emulates input of a phrase to the shared speech recognizer, using text instead of audio for asynchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the phrase and the loaded speech recognition grammars.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
LoadGrammar(Grammar) LoadGrammar(Grammar) LoadGrammar(Grammar) LoadGrammar(Grammar)

Carga una gramática de reconocimiento de voz.Loads a speech recognition grammar.

LoadGrammarAsync(Grammar) LoadGrammarAsync(Grammar) LoadGrammarAsync(Grammar) LoadGrammarAsync(Grammar)

De forma asincrónica carga una gramática de reconocimiento de voz.Asynchronously loads a speech recognition grammar.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
RequestRecognizerUpdate() RequestRecognizerUpdate() RequestRecognizerUpdate() RequestRecognizerUpdate()

Solicita que el reconocedor compartido pause y actualice su estado.Requests that the shared recognizer pause and update its state.

RequestRecognizerUpdate(Object) RequestRecognizerUpdate(Object) RequestRecognizerUpdate(Object) RequestRecognizerUpdate(Object)

Solicita que el reconocedor compartido pause y actualice su estado y proporcione un token de usuario para el evento asociado.Requests that the shared recognizer pause and update its state and provides a user token for the associated event.

RequestRecognizerUpdate(Object, TimeSpan) RequestRecognizerUpdate(Object, TimeSpan) RequestRecognizerUpdate(Object, TimeSpan) RequestRecognizerUpdate(Object, TimeSpan)

Solicita que el reconocedor compartido pause y actualice su estado y proporcione un desplazamiento y un token de usuario para el evento asociado.Requests that the shared recognizer pause and update its state and provides an offset and a user token for the associated event.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
UnloadAllGrammars() UnloadAllGrammars() UnloadAllGrammars() UnloadAllGrammars()

Descarga todas las gramáticas de reconocimiento de voz del reconocedor compartido.Unloads all speech recognition grammars from the shared recognizer.

UnloadGrammar(Grammar) UnloadGrammar(Grammar) UnloadGrammar(Grammar) UnloadGrammar(Grammar)

Descarga una gramática especificada de reconocimiento de voz del reconocedor compartido.Unloads a specified speech recognition grammar from the shared recognizer.

Eventos

AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated

Se produce cuando el reconocedor compartido indica el nivel de su entrada de audio.Occurs when the shared recognizer reports the level of its audio input.

AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred

Se produce cuando el reconocedor encuentra un problema en la señal audio.Occurs when the recognizer encounters a problem in the audio signal.

AudioStateChanged AudioStateChanged AudioStateChanged AudioStateChanged

Se produce cuando cambia el estado en el sonido que recibe el reconocedor.Occurs when the state changes in the audio being received by the recognizer.

EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted

Se produce cuando el reconocedor compartido finaliza una operación asincrónica de reconocimiento para una entrada emulada.Occurs when the shared recognizer finalizes an asynchronous recognition operation for emulated input.

LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted

Se produce cuando el reconocedor finaliza la carga asincrónica de una gramática de reconocimiento de voz.Occurs when the recognizer finishes the asynchronous loading of a speech recognition grammar.

RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached

Se produce cuando el reconocedor realiza una pausa para sincronizar el reconocimiento con otras operaciones.Occurs when the recognizer pauses to synchronize recognition and other operations.

SpeechDetected SpeechDetected SpeechDetected SpeechDetected

Se produce cuando el reconocedor detecta una entrada que puede identificar como voz.Occurs when the recognizer detects input that it can identify as speech.

SpeechHypothesized SpeechHypothesized SpeechHypothesized SpeechHypothesized

Se produce cuando el reconocedor ha reconocido una palabra o palabras que pueden ser un componente de varias frases completas en una gramática.Occurs when the recognizer has recognized a word or words that may be a component of multiple complete phrases in a grammar.

SpeechRecognitionRejected SpeechRecognitionRejected SpeechRecognitionRejected SpeechRecognitionRejected

Se produce cuando el reconocedor recibe una entrada que no coincide con ninguna de las gramáticas de reconocimiento de voz que ha cargado.Occurs when the recognizer receives input that does not match any of the speech recognition grammars it has loaded.

SpeechRecognized SpeechRecognized SpeechRecognized SpeechRecognized

Se produce cuando el reconocedor recibe una entrada que coincide con una de sus gramáticas de reconocimiento de voz.Occurs when the recognizer receives input that matches one of its speech recognition grammars.

StateChanged StateChanged StateChanged StateChanged

Se produce cuando cambia el estado actual del motor de reconocimiento de voz con tecnología Windows Desktop Speech.Occurs when the running state of the Windows Desktop Speech Technology recognition engine changes.

Se aplica a

Consulte también: