SpeechRecognitionEngine Classe

Definição

Fornece os meios de acessar e gerenciar um mecanismo de reconhecimento de fala no processo.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
Herança
SpeechRecognitionEngine
Implementações

Exemplos

O exemplo a seguir mostra parte de um aplicativo de console que demonstra o reconhecimento de fala básico.The following example shows part of a console application that demonstrates basic speech recognition. Como este exemplo usa o modo de Multiple do método RecognizeAsync, ele executa o reconhecimento até que você feche a janela do console ou interrompa a depuração.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);  
    }  
  }  
}  

Comentários

Você pode criar uma instância dessa classe para qualquer um dos reconhecedores de fala instalados.You can create an instance of this class for any of the installed speech recognizers. Para obter informações sobre quais reconhecedores estão instalados, use o método de InstalledRecognizers estático.To get information about which recognizers are installed, use the static InstalledRecognizers method.

Essa classe é para executar mecanismos de reconhecimento de fala em processo e fornece controle sobre vários aspectos do reconhecimento de fala, da seguinte maneira:This class is for running speech recognition engines in-process, and provides control over various aspects of speech recognition, as follows:

O objeto SpeechRecognitionEngine é para o uso exclusivo do processo que instanciou o objeto.The SpeechRecognitionEngine object is for the sole use of the process that instantiated the object. Por outro lado, o SpeechRecognizer compartilha um único reconhecedor com qualquer aplicativo que queira usá-lo.By contrast, the SpeechRecognizer shares a single recognizer with any application that wants to use it.

Observação

Chame sempre Dispose antes de liberar sua última referência para o reconhecedor de fala.Always call Dispose before you release your last reference to the speech recognizer. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o método de Finalize do objeto reconhecedor.Otherwise, the resources it is using will not be freed until the garbage collector calls the recognizer object's Finalize method.

Construtores

SpeechRecognitionEngine()

Inicializa uma nova instância da classe SpeechRecognitionEngine usando o reconhecedor de fala padrão do sistema.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

SpeechRecognitionEngine(CultureInfo)

Inicializa uma nova instância da classe SpeechRecognitionEngine usando o reconhecedor de fala padrão de uma localidade específica.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

SpeechRecognitionEngine(RecognizerInfo)

Inicializa uma nova instância do SpeechRecognitionEngine usando as informações em um objeto RecognizerInfo para especificar o reconhecedor a ser usado.Initializes a new instance of the SpeechRecognitionEngine using the information in a RecognizerInfo object to specify the recognizer to use.

SpeechRecognitionEngine(String)

Inicializa uma nova instância da classe SpeechRecognitionEngine com um parâmetro de cadeia de caracteres que especifica o nome do reconhecedor a ser usado.Initializes a new instance of the SpeechRecognitionEngine class with a string parameter that specifies the name of the recognizer to use.

Propriedades

AudioFormat

Obtém o formato de áudio sendo recebido pelo SpeechRecognitionEngine.Gets the format of the audio being received by the SpeechRecognitionEngine.

AudioLevel

Obtém o nível do áudio sendo recebido pelo SpeechRecognitionEngine.Gets the level of the audio being received by the SpeechRecognitionEngine.

AudioPosition

Obtém o local atual no fluxo de áudio que está sendo gerado pelo dispositivo que está fornecendo a entrada para o SpeechRecognitionEngine.Gets the current location in the audio stream being generated by the device that is providing input to the SpeechRecognitionEngine.

AudioState

Obtém o nível do áudio sendo recebido pelo SpeechRecognitionEngine.Gets the state of the audio being received by the SpeechRecognitionEngine.

BabbleTimeout

Obtém ou define o intervalo de tempo durante o qual um SpeechRecognitionEngine aceita entrada contendo apenas ruídos de fundo, antes de finalizar o reconhecimento.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only background noise, before finalizing recognition.

EndSilenceTimeout

Obtém ou define o intervalo de silêncio que o SpeechRecognitionEngine aceitará ao final de uma entrada não ambígua antes de finalizar uma operação de reconhecimento.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of unambiguous input before finalizing a recognition operation.

EndSilenceTimeoutAmbiguous

Obtém ou define o intervalo de silêncio que o SpeechRecognitionEngine aceitará ao final de uma entrada ambígua antes de finalizar uma operação de reconhecimento.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of ambiguous input before finalizing a recognition operation.

Grammars

Obtém uma coleção de objetos Grammar carregados nessa instância SpeechRecognitionEngine.Gets a collection of the Grammar objects that are loaded in this SpeechRecognitionEngine instance.

InitialSilenceTimeout

Obtém ou define o intervalo de tempo durante o qual um SpeechRecognitionEngine aceita entradas contendo apenas silêncio antes de finalizar o reconhecimento.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only silence before finalizing recognition.

MaxAlternates

Obtém ou define o número máximo de resultados alternativos de reconhecimento que o SpeechRecognitionEngine retorna para cada operação de reconhecimento.Gets or sets the maximum number of alternate recognition results that the SpeechRecognitionEngine returns for each recognition operation.

RecognizerAudioPosition

Obtém o local atual do SpeechRecognitionEngine na entrada de áudio que está sendo processada.Gets the current location of the SpeechRecognitionEngine in the audio input that it is processing.

RecognizerInfo

Obtém informações sobre a instância atual de SpeechRecognitionEngine.Gets information about the current instance of SpeechRecognitionEngine.

Métodos

Dispose()

Descarta o objeto SpeechRecognitionEngine.Disposes the SpeechRecognitionEngine object.

Dispose(Boolean)

Descarta o objeto SpeechRecognitionEngine e libera os recursos usados durante a sessão.Disposes the SpeechRecognitionEngine object and releases resources used during the session.

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Emula a entrada de palavras específicas no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala síncrono e especifica como o reconhecedor trata a comparação Unicode entre as palavras e as gramáticas do reconhecimento de fala carregado.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)

Emula a entrada de uma fase para o reconhecedor de fala usando o texto no lugar do áudio para o reconhecimento de fala síncrono.Emulates input of a phrase to the speech recognizer, using text in place of audio for synchronous speech recognition.

EmulateRecognize(String, CompareOptions)

Emula a entrada de uma frase no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala síncrono e especifica como o reconhecedor trata a comparação Unicode entre a frase e as gramáticas do reconhecimento de fala carregado.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)

Emula a entrada de palavras específicas no reconhecedor de fala usando uma matriz de objetos RecognizedWordUnit em vez de áudio para o reconhecimento de fala assíncrono e especifica como o reconhecedor trata a comparação Unicode entre as palavras e as gramáticas do reconhecimento de fala carregado.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)

Emula a entrada de uma fase para o reconhecedor de fala usando o texto no lugar do áudio para o reconhecimento de fala assíncrono.Emulates input of a phrase to the speech recognizer, using text in place of audio for asynchronous speech recognition.

EmulateRecognizeAsync(String, CompareOptions)

Emula a entrada de uma frase no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala assíncrono e especifica como o reconhecedor trata a comparação Unicode entre a frase e as gramáticas do reconhecimento de fala carregado.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)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InstalledRecognizers()

Retorna as informações de todos os identificadores de fala instalados no sistema atual.Returns information for all of the installed speech recognizers on the current system.

LoadGrammar(Grammar)

Carrega de forma síncrona um objeto Grammar.Synchronously loads a Grammar object.

LoadGrammarAsync(Grammar)

Carrega de forma assíncrona uma gramática de reconhecimento de fala.Asynchronously loads a speech recognition grammar.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
QueryRecognizerSetting(String)

Retorna os valores das configurações do reconhecedor.Returns the values of settings for the recognizer.

Recognize()

Executa uma operação de reconhecimento de fala síncrona.Performs a synchronous speech recognition operation.

Recognize(TimeSpan)

Executa uma operação síncrona de reconhecimento de fala com um período de tempo limite de silêncio inicial especificado.Performs a synchronous speech recognition operation with a specified initial silence timeout period.

RecognizeAsync()

Executa uma única operação de reconhecimento de fala síncrona.Performs a single, asynchronous speech recognition operation.

RecognizeAsync(RecognizeMode)

Executa uma ou mais operações de reconhecimento de fala assíncronas.Performs one or more asynchronous speech recognition operations.

RecognizeAsyncCancel()

Encerra o reconhecimento assíncrono sem esperar que a operação de reconhecimento atual seja concluída.Terminates asynchronous recognition without waiting for the current recognition operation to complete.

RecognizeAsyncStop()

Interrompe o reconhecimento assíncrono após a conclusão da operação de reconhecimento atual.Stops asynchronous recognition after the current recognition operation completes.

RequestRecognizerUpdate()

Solicita que o reconhecedor pause para atualizar seu estado.Requests that the recognizer pauses to update its state.

RequestRecognizerUpdate(Object)

Solicita que o reconhecedor pause para atualizar seu estado e forneça um token de usuário para o evento associado.Requests that the recognizer pauses to update its state and provides a user token for the associated event.

RequestRecognizerUpdate(Object, TimeSpan)

Solicita que o reconhecedor pause para atualizar seu estado e forneça deslocamento e um token de usuário para o evento associado.Requests that the recognizer pauses to update its state and provides an offset and a user token for the associated event.

SetInputToAudioStream(Stream, SpeechAudioFormatInfo)

Configura o objeto SpeechRecognitionEngine para receber entrada de um fluxo de áudio.Configures the SpeechRecognitionEngine object to receive input from an audio stream.

SetInputToDefaultAudioDevice()

Configura o objeto SpeechRecognitionEngine para receber a entrada do dispositivo de áudio padrão.Configures the SpeechRecognitionEngine object to receive input from the default audio device.

SetInputToNull()

Desabilita a entrada para o reconhecedor de fala.Disables the input to the speech recognizer.

SetInputToWaveFile(String)

Configura o objeto SpeechRecognitionEngine para receber entrada de um arquivo de formato de áudio Waveform (.wav).Configures the SpeechRecognitionEngine object to receive input from a Waveform audio format (.wav) file.

SetInputToWaveStream(Stream)

Configura o objeto SpeechRecognitionEngine para receber a entrada de um fluxo que contém dados de formato de áudio Waveform (.wav).Configures the SpeechRecognitionEngine object to receive input from a stream that contains Waveform audio format (.wav) data.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UnloadAllGrammars()

Descarrega todos os objetos Grammar do reconhecedor.Unloads all Grammar objects from the recognizer.

UnloadGrammar(Grammar)

Descarrega um objeto Grammar especificado da instância SpeechRecognitionEngine.Unloads a specified Grammar object from the SpeechRecognitionEngine instance.

UpdateRecognizerSetting(String, Int32)

Atualiza a configuração especificada para o SpeechRecognitionEngine com o valor inteiro especificado.Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

UpdateRecognizerSetting(String, String)

Atualiza a configuração de mecanismo de reconhecimento de fala especificado com o valor de cadeia de caracteres especificada.Updates the specified speech recognition engine setting with the specified string value.

Eventos

AudioLevelUpdated

Gerado quando o SpeechRecognitionEngine relata o nível de sua entrada de áudio.Raised when the SpeechRecognitionEngine reports the level of its audio input.

AudioSignalProblemOccurred

Gerado quando o SpeechRecognitionEngine detecta um problema no sinal de áudio.Raised when the SpeechRecognitionEngine detects a problem in the audio signal.

AudioStateChanged

Gerado quando o estado é alterado no áudio que está sendo recebido pelo SpeechRecognitionEngine.Raised when the state changes in the audio being received by the SpeechRecognitionEngine.

EmulateRecognizeCompleted

Gerado quando o SpeechRecognitionEngine finaliza uma operação de reconhecimento assíncrono da entrada emulada.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation of emulated input.

LoadGrammarCompleted

Gerado quando o SpeechRecognitionEngine termina o carregamento assíncrono de um Grammar objeto.Raised when the SpeechRecognitionEngine finishes the asynchronous loading of a Grammar object.

RecognizeCompleted

Acionado quando o SpeechRecognitionEngine finaliza uma operação assíncrona de reconhecimento.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation.

RecognizerUpdateReached

Gerado quando um SpeechRecognitionEngine em execução pausa para aceitar modificações.Raised when a running SpeechRecognitionEngine pauses to accept modifications.

SpeechDetected

Gerado quando o SpeechRecognitionEngine detecta a entradas que podem ser identificadas como fala.Raised when the SpeechRecognitionEngine detects input that it can identify as speech.

SpeechHypothesized

Gerada quando o SpeechRecognitionEngine tiver reconhecido uma palavra ou palavras que podem ser um componente de várias frases completas em uma 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

Gerado quando o SpeechRecognitionEngine recebe uma entrada que não corresponde a nenhum de seus objetos Grammar carregados e habilitados.Raised when the SpeechRecognitionEngine receives input that does not match any of its loaded and enabled Grammar objects.

SpeechRecognized

Gerado quando o SpeechRecognitionEngine recebe uma entrada que corresponde a um de seus objetos Grammar carregados e habilitados.Raised when the SpeechRecognitionEngine receives input that matches any of its loaded and enabled Grammar objects.

Aplica-se a

Veja também