SpeechRecognitionEngine SpeechRecognitionEngine SpeechRecognitionEngine SpeechRecognitionEngine Class

Definición

Proporciona los medios para obtener acceso y administrar un motor de reconocimiento de voz en curso.Provides the means to access and manage an in-process speech recognition engine.

public ref class SpeechRecognitionEngine : IDisposable
public class SpeechRecognitionEngine : IDisposable
type SpeechRecognitionEngine = class
    interface IDisposable
Public Class SpeechRecognitionEngine
Implements IDisposable
Herencia
SpeechRecognitionEngineSpeechRecognitionEngineSpeechRecognitionEngineSpeechRecognitionEngine
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra parte de una aplicación de consola que muestra el reconocimiento de voz básico.The following example shows part of a console application that demonstrates basic speech recognition. Dado que en este ejemplo Multiple se usa el RecognizeAsync modo del método, realiza el reconocimiento hasta que cierre la ventana de la consola o detenga la depuración.Because this example uses the Multiple mode of the RecognizeAsync method, it performs recognition until you close the console window or stop debugging.

using System;  
using System.Speech.Recognition;  
  
namespace SpeechRecognitionApp  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
  
      // Create an in-process speech recognizer for the en-US locale.  
      using (  
      SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(  
          new System.Globalization.CultureInfo("en-US")))  
      {  
  
        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  
  
        // Add a handler for the speech recognized event.  
        recognizer.SpeechRecognized +=   
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  
  
        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  
  
        // Start asynchronous, continuous speech recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  
  
        // Keep the console window open.  
        while (true)  
        {  
          Console.ReadLine();  
        }  
      }  
    }  
  
    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Recognized text: " + e.Result.Text);  
    }  
  }  
}  

Comentarios

Puede crear una instancia de esta clase para cualquiera de los reconocedores de voz instalados.You can create an instance of this class for any of the installed speech recognizers. Para obtener información acerca de los reconocedores instalados, use el InstalledRecognizers método estático.To get information about which recognizers are installed, use the static InstalledRecognizers method.

Esta clase se usa para ejecutar motores de reconocimiento de voz en proceso y proporciona control sobre diversos aspectos del reconocimiento de voz, como se indica a continuación:This class is for running speech recognition engines in-process, and provides control over various aspects of speech recognition, as follows:

El SpeechRecognitionEngine objeto es para el uso exclusivo del proceso que creó la instancia del objeto.The SpeechRecognitionEngine object is for the sole use of the process that instantiated the object. Por el contrario, SpeechRecognizer el comparte un único reconocedor con cualquier aplicación que desee usarlo.By contrast, the SpeechRecognizer shares a single recognizer with any application that wants to use it.

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

SpeechRecognitionEngine() SpeechRecognitionEngine() SpeechRecognitionEngine() SpeechRecognitionEngine()

Inicializa una nueva instancia de la clase SpeechRecognitionEngine utilizando el reconocedor de voz predeterminado para el sistema.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

SpeechRecognitionEngine(CultureInfo) SpeechRecognitionEngine(CultureInfo) SpeechRecognitionEngine(CultureInfo) SpeechRecognitionEngine(CultureInfo)

Inicializa una nueva instancia de la clase SpeechRecognitionEngine utilizando el reconocedor de voz predeterminado para una configuración regional especificada.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

SpeechRecognitionEngine(RecognizerInfo) SpeechRecognitionEngine(RecognizerInfo) SpeechRecognitionEngine(RecognizerInfo) SpeechRecognitionEngine(RecognizerInfo)

Inicializa una nueva instancia de SpeechRecognitionEngine utilizando la información de un objeto RecognizerInfo para especificar el reconocedor que de va a utilizar.Initializes a new instance of the SpeechRecognitionEngine using the information in a RecognizerInfo object to specify the recognizer to use.

SpeechRecognitionEngine(String) SpeechRecognitionEngine(String) SpeechRecognitionEngine(String) SpeechRecognitionEngine(String)

Inicializa una nueva instancia de la clase SpeechRecognitionEngine con un parámetro de cadena que especifica el nombre del reconocedor que se va a utilizar.Initializes a new instance of the SpeechRecognitionEngine class with a string parameter that specifies the name of the recognizer to use.

Propiedades

AudioFormat AudioFormat AudioFormat AudioFormat

Obtiene el formato del sonido que es recibido por SpeechRecognitionEngine.Gets the format of the audio being received by the SpeechRecognitionEngine.

AudioLevel AudioLevel AudioLevel AudioLevel

Obtiene el nivel del sonido que es recibido por SpeechRecognitionEngine.Gets the level of the audio being received by the SpeechRecognitionEngine.

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 SpeechRecognitionEngine.Gets the current location in the audio stream being generated by the device that is providing input to the SpeechRecognitionEngine.

AudioState AudioState AudioState AudioState

Obtiene el estado del sonido que es recibido por SpeechRecognitionEngine.Gets the state of the audio being received by the SpeechRecognitionEngine.

BabbleTimeout BabbleTimeout BabbleTimeout BabbleTimeout

Obtiene o establece el intervalo de tiempo durante el que SpeechRecognitionEngine acepta la entrada que contiene solo ruido de fondo, antes de finalizar el reconocimiento.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only background noise, before finalizing recognition.

EndSilenceTimeout EndSilenceTimeout EndSilenceTimeout EndSilenceTimeout

Obtiene o establece el intervalo de silencio que SpeechRecognitionEngine aceptará al final de la entrada no ambigua antes de finalizar una operación de reconocimiento.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of unambiguous input before finalizing a recognition operation.

EndSilenceTimeoutAmbiguous EndSilenceTimeoutAmbiguous EndSilenceTimeoutAmbiguous EndSilenceTimeoutAmbiguous

Obtiene o establece el intervalo de silencio que SpeechRecognitionEngine aceptará al final de la entrada ambigua antes de finalizar una operación de reconocimiento.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of ambiguous input before finalizing a recognition operation.

Grammars Grammars Grammars Grammars

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

InitialSilenceTimeout InitialSilenceTimeout InitialSilenceTimeout InitialSilenceTimeout

Obtiene o establece el intervalo de tiempo durante el que SpeechRecognitionEngine acepta la entrada que contiene solo silencio, antes de finalizar el reconocimiento.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only silence before finalizing recognition.

MaxAlternates MaxAlternates MaxAlternates MaxAlternates

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

RecognizerAudioPosition RecognizerAudioPosition RecognizerAudioPosition RecognizerAudioPosition

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

RecognizerInfo RecognizerInfo RecognizerInfo RecognizerInfo

Obtiene información acerca de la instancia actual de SpeechRecognitionEngine.Gets information about the current instance of SpeechRecognitionEngine.

Métodos

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

Desecha el objeto SpeechRecognitionEngine.Disposes the SpeechRecognitionEngine object.

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

Desecha el objeto SpeechRecognitionEngine y libera los recursos utilizados durante la sesión.Disposes the SpeechRecognitionEngine 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, 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 speech recognizer, using text in place 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, usando el texto en lugar de audio para el reconocimiento de voz sincrónico.Emulates input of a phrase to the speech recognizer, using text in place 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, 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 speech recognizer, using text in place 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, usando una matriz de objetos RecognizedWordUnit 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 speech recognizer, using an array of RecognizedWordUnit objects in place 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, usando el texto en lugar de audio para el reconocimiento de voz asincrónico.Emulates input of a phrase to the speech recognizer, using text in place 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, 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 speech recognizer, using text in place 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)
InstalledRecognizers() InstalledRecognizers() InstalledRecognizers() InstalledRecognizers()

Devuelve información para todos los reconocedores de voz instalados en el sistema actual.Returns information for all of the installed speech recognizers on the current system.

LoadGrammar(Grammar) LoadGrammar(Grammar) LoadGrammar(Grammar) LoadGrammar(Grammar)

De forma sincrónica carga un objeto Grammar.Synchronously loads a Grammar object.

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)
QueryRecognizerSetting(String) QueryRecognizerSetting(String) QueryRecognizerSetting(String) QueryRecognizerSetting(String)

Devuelve los valores de configuración para el reconocedor.Returns the values of settings for the recognizer.

Recognize() Recognize() Recognize() Recognize()

Realiza una operación de reconocimiento de voz sincrónica.Performs a synchronous speech recognition operation.

Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan)

Realiza una operación de reconocimiento de voz sincrónica con un tiempo de espera de silencio inicial especificado.Performs a synchronous speech recognition operation with a specified initial silence timeout period.

RecognizeAsync() RecognizeAsync() RecognizeAsync() RecognizeAsync()

Realiza una operación de reconocimiento de voz asincrónica única.Performs a single, asynchronous speech recognition operation.

RecognizeAsync(RecognizeMode) RecognizeAsync(RecognizeMode) RecognizeAsync(RecognizeMode) RecognizeAsync(RecognizeMode)

Realiza una o más operaciones de reconocimiento de voz asincrónicas.Performs one or more asynchronous speech recognition operations.

RecognizeAsyncCancel() RecognizeAsyncCancel() RecognizeAsyncCancel() RecognizeAsyncCancel()

Finaliza el reconocimiento asincrónico sin esperar a que la operación actual de reconocimiento se complete.Terminates asynchronous recognition without waiting for the current recognition operation to complete.

RecognizeAsyncStop() RecognizeAsyncStop() RecognizeAsyncStop() RecognizeAsyncStop()

Detiene el reconocimiento asincrónico después de que se complete la operación actual de reconocimiento.Stops asynchronous recognition after the current recognition operation completes.

RequestRecognizerUpdate() RequestRecognizerUpdate() RequestRecognizerUpdate() RequestRecognizerUpdate()

Solicita que el reconocedor pause para actualizar su estado.Requests that the recognizer pauses to update its state.

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

Solicita que el reconocedor pause para actualizar su estado y proporcione un token de usuario para el evento asociado.Requests that the recognizer pauses to 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 pause para actualizar su estado y proporcione un desplazamiento y un token de usuario para el evento asociado.Requests that the recognizer pauses to update its state and provides an offset and a user token for the associated event.

SetInputToAudioStream(Stream, SpeechAudioFormatInfo) SetInputToAudioStream(Stream, SpeechAudioFormatInfo) SetInputToAudioStream(Stream, SpeechAudioFormatInfo) SetInputToAudioStream(Stream, SpeechAudioFormatInfo)

Configura el objeto SpeechRecognitionEngine para recibir entradas de una secuencia de audio.Configures the SpeechRecognitionEngine object to receive input from an audio stream.

SetInputToDefaultAudioDevice() SetInputToDefaultAudioDevice() SetInputToDefaultAudioDevice() SetInputToDefaultAudioDevice()

Configura el objeto SpeechRecognitionEngine para recibir entradas del dispositivo de audio predeterminado.Configures the SpeechRecognitionEngine object to receive input from the default audio device.

SetInputToNull() SetInputToNull() SetInputToNull() SetInputToNull()

Deshabilita la entrada al módulo de reconocimiento de voz.Disables the input to the speech recognizer.

SetInputToWaveFile(String) SetInputToWaveFile(String) SetInputToWaveFile(String) SetInputToWaveFile(String)

Configura el objeto SpeechRecognitionEngine para recibir entradas de un archivo de formato de audio de forma de onda (.wav).Configures the SpeechRecognitionEngine object to receive input from a Waveform audio format (.wav) file.

SetInputToWaveStream(Stream) SetInputToWaveStream(Stream) SetInputToWaveStream(Stream) SetInputToWaveStream(Stream)

Configura el objeto SpeechRecognitionEngine para recibir entradas de un flujo que contiene datos de formato de audio de forma de onda (.wav).Configures the SpeechRecognitionEngine object to receive input from a stream that contains Waveform audio format (.wav) data.

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 todos los objetos Grammar del reconocedor.Unloads all Grammar objects from the recognizer.

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

Descarga un objeto Grammar especificado de la instancia de SpeechRecognitionEngine.Unloads a specified Grammar object from the SpeechRecognitionEngine instance.

UpdateRecognizerSetting(String, Int32) UpdateRecognizerSetting(String, Int32) UpdateRecognizerSetting(String, Int32) UpdateRecognizerSetting(String, Int32)

Actualiza el valor especificado para SpeechRecognitionEngine con el valor entero especificado.Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

UpdateRecognizerSetting(String, String) UpdateRecognizerSetting(String, String) UpdateRecognizerSetting(String, String) UpdateRecognizerSetting(String, String)

Actualiza el valor especificado del motor de reconocimiento de voz con el valor de cadena especificado.Updates the specified speech recognition engine setting with the specified string value.

Eventos

AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated

Se genera cuando SpeechRecognitionEngine indica el nivel de su entrada de audio.Raised when the SpeechRecognitionEngine reports the level of its audio input.

AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred

Se genera cuando SpeechRecognitionEngine detecta un problema en la señal de audio.Raised when the SpeechRecognitionEngine detects a problem in the audio signal.

AudioStateChanged AudioStateChanged AudioStateChanged AudioStateChanged

Se genera cuando cambia el estado en el sonido que recibe el SpeechRecognitionEngine.Raised when the state changes in the audio being received by the SpeechRecognitionEngine.

EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted

Se genera cuando SpeechRecognitionEngine concluye una operación de reconocimiento asincrónica de entrada emulada.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation of emulated input.

LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted

Se genera cuando SpeechRecognitionEngine finaliza la carga asincrónica de un objeto Grammar.Raised when the SpeechRecognitionEngine finishes the asynchronous loading of a Grammar object.

RecognizeCompleted RecognizeCompleted RecognizeCompleted RecognizeCompleted

Se genera cuando SpeechRecognitionEngine concluye una operación de reconocimiento asincrónica.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation.

RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached

Se genera cuando un objeto SpeechRecognitionEngine en ejecución hace una pausa para aceptar modificaciones.Raised when a running SpeechRecognitionEngine pauses to accept modifications.

SpeechDetected SpeechDetected SpeechDetected SpeechDetected

Se genera cuando SpeechRecognitionEngine detecta una entrada que puede identificar como voz.Raised when the SpeechRecognitionEngine detects input that it can identify as speech.

SpeechHypothesized SpeechHypothesized SpeechHypothesized SpeechHypothesized

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

SpeechRecognitionRejected SpeechRecognitionRejected SpeechRecognitionRejected SpeechRecognitionRejected

Se genera cuando SpeechRecognitionEngine recibe una entrada que no coincide con ninguno de los objetos Grammar cargados y habilitados.Raised when the SpeechRecognitionEngine receives input that does not match any of its loaded and enabled Grammar objects.

SpeechRecognized SpeechRecognized SpeechRecognized SpeechRecognized

Se genera cuando SpeechRecognitionEngine recibe una entrada que coincide con cualquiera de los objetos Grammar cargados y habilitados.Raised when the SpeechRecognitionEngine receives input that matches any of its loaded and enabled Grammar objects.

Se aplica a

Consulte también: