SpeechRecognitionEngine Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece os meios para acessar e gerenciar um mecanismo de reconhecimento de fala em processo.
public ref class SpeechRecognitionEngine : IDisposablepublic class SpeechRecognitionEngine : IDisposabletype SpeechRecognitionEngine = class
interface IDisposablePublic 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. Como este exemplo usa o Multiple modo do método, ele executa o RecognizeAsync reconhecimento até que você feche a janela do console ou interrompa a depuração.
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. Para obter informações sobre quais reconhecedores estão instalados, use o método estático InstalledRecognizers .
Essa classe destina-se à execução de mecanismos de reconhecimento de fala em processo e fornece controle sobre vários aspectos do reconhecimento de fala, da seguinte maneira:
Para criar um reconhecedor de fala em processo, use um dos SpeechRecognitionEngine construtores.
Para gerenciar gramáticas de reconhecimento de fala, use os métodos, os métodos e UnloadAllGrammars a UnloadGrammarLoadGrammarLoadGrammarAsyncGrammars propriedade.
Para configurar a entrada para o reconhecedor, use o SetInputToAudioStreammétodo , , SetInputToDefaultAudioDevice, SetInputToWaveFileSetInputToNullou SetInputToWaveStream .
Para executar o reconhecimento de fala, use o método ou RecognizeAsync o Recognize método.
Para modificar como o reconhecimento lida com o silêncio ou a entrada inesperada, use as propriedades e EndSilenceTimeoutAmbiguous as BabbleTimeoutInitialSilenceTimeoutEndSilenceTimeoutpropriedades.
Para alterar o número de alternativas retornadas pelo reconhecedor, use a MaxAlternates propriedade. O reconhecedor retorna resultados de reconhecimento em um RecognitionResult objeto.
Para sincronizar as alterações no reconhecedor, use o RequestRecognizerUpdate método. O reconhecedor usa mais de um thread para executar tarefas.
Para emular a entrada para o reconhecedor, use o e EmulateRecognizeAsync os EmulateRecognize métodos.
O SpeechRecognitionEngine objeto é para o uso exclusivo do processo que instanciou o objeto. Por outro lado, os SpeechRecognizer compartilhamentos de um único reconhecedor com qualquer aplicativo que queira usá-lo.
Observação
Sempre ligue Dispose antes de lançar sua última referência ao reconhecedor de fala. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o método do objeto reconhecedor Finalize .
Construtores
| Nome | Description |
|---|---|
| SpeechRecognitionEngine() |
Inicializa uma nova instância da SpeechRecognitionEngine classe usando o reconhecedor de fala padrão para o sistema. |
| SpeechRecognitionEngine(CultureInfo) |
Inicializa uma nova instância da SpeechRecognitionEngine classe usando o reconhecedor de fala padrão para uma localidade especificada. |
| SpeechRecognitionEngine(RecognizerInfo) |
Inicializa uma nova instância do uso das SpeechRecognitionEngine informações em um RecognizerInfo objeto para especificar o reconhecedor a ser usado. |
| SpeechRecognitionEngine(String) |
Inicializa uma nova instância da SpeechRecognitionEngine classe com um parâmetro de cadeia de caracteres que especifica o nome do reconhecedor a ser usado. |
Propriedades
| Nome | Description |
|---|---|
| AudioFormat |
Obtém o formato do áudio que está sendo recebido pelo SpeechRecognitionEngine. |
| AudioLevel |
Obtém o nível do áudio que está sendo recebido pelo SpeechRecognitionEngine. |
| AudioPosition |
Obtém o local atual no fluxo de áudio que está sendo gerado pelo dispositivo que está fornecendo entrada para o SpeechRecognitionEngine. |
| AudioState |
Obtém o estado do áudio que está sendo recebido pelo SpeechRecognitionEngine. |
| BabbleTimeout |
Obtém ou define o intervalo de tempo durante o qual uma SpeechRecognitionEngine entrada aceita que contém apenas ruído de plano de fundo, antes de finalizar o reconhecimento. |
| EndSilenceTimeout |
Obtém ou define o intervalo de silêncio que o SpeechRecognitionEngine aceitará no final da entrada inequívoca antes de finalizar uma operação de reconhecimento. |
| EndSilenceTimeoutAmbiguous |
Obtém ou define o intervalo de silêncio que o SpeechRecognitionEngine aceitará no final da entrada ambígua antes de finalizar uma operação de reconhecimento. |
| Grammars |
Obtém uma coleção dos Grammar objetos que são carregados nesta SpeechRecognitionEngine instância. |
| InitialSilenceTimeout |
Obtém ou define o intervalo de tempo durante o qual uma SpeechRecognitionEngine entrada aceita que contém somente silêncio antes de finalizar o reconhecimento. |
| MaxAlternates |
Obtém ou define o número máximo de resultados de reconhecimento alternativo que o SpeechRecognitionEngine retorna para cada operação de reconhecimento. |
| RecognizerAudioPosition |
Obtém o local atual da SpeechRecognitionEngine entrada de áudio que está sendo processada. |
| RecognizerInfo |
Obtém informações sobre a instância atual de SpeechRecognitionEngine. |
Métodos
| Nome | Description |
|---|---|
| Dispose() |
Descarta o SpeechRecognitionEngine objeto. |
| Dispose(Boolean) |
Descarta o SpeechRecognitionEngine objeto e libera os recursos usados durante a sessão. |
| EmulateRecognize(RecognizedWordUnit[], CompareOptions) |
Emula a entrada de palavras específicas para o reconhecedor de fala, usando texto no lugar do áudio para reconhecimento de fala síncrono e especifica como o reconhecedor lida com a comparação Unicode entre as palavras e as gramáticas de reconhecimento de fala carregadas. |
| EmulateRecognize(String, CompareOptions) |
Emula a entrada de uma frase para o reconhecedor de fala, usando texto no lugar do áudio para reconhecimento de fala síncrono e especifica como o reconhecedor lida com a comparação Unicode entre a frase e as gramáticas de reconhecimento de fala carregadas. |
| EmulateRecognize(String) |
Emula a entrada de uma frase para o reconhecedor de fala, usando texto no lugar do áudio para reconhecimento de fala síncrono. |
| EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) |
Emula a entrada de palavras específicas para o reconhecedor de fala, usando uma matriz de RecognizedWordUnit objetos no lugar de áudio para reconhecimento de fala assíncrono e especifica como o reconhecedor lida com a comparação Unicode entre as palavras e as gramáticas de reconhecimento de fala carregadas. |
| EmulateRecognizeAsync(String, CompareOptions) |
Emula a entrada de uma frase para o reconhecedor de fala, usando texto no lugar de áudio para reconhecimento de fala assíncrono e especifica como o reconhecedor lida com a comparação Unicode entre a frase e as gramáticas de reconhecimento de fala carregadas. |
| EmulateRecognizeAsync(String) |
Emula a entrada de uma frase para o reconhecedor de fala, usando texto no lugar do áudio para reconhecimento de fala assíncrono. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InstalledRecognizers() |
Retorna informações para todos os reconhecedores de fala instalados no sistema atual. |
| LoadGrammar(Grammar) |
Carrega um objeto de forma Grammar síncrona. |
| LoadGrammarAsync(Grammar) |
Carrega de forma assíncrona uma gramática de reconhecimento de fala. |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| QueryRecognizerSetting(String) |
Retorna os valores das configurações para o reconhecedor. |
| Recognize() |
Executa uma operação de reconhecimento de fala síncrona. |
| Recognize(TimeSpan) |
Executa uma operação de reconhecimento de fala síncrona com um período de tempo limite de silêncio inicial especificado. |
| RecognizeAsync() |
Executa uma única operação de reconhecimento de fala assíncrona. |
| RecognizeAsync(RecognizeMode) |
Executa uma ou mais operações de reconhecimento de fala assíncronas. |
| RecognizeAsyncCancel() |
Encerra o reconhecimento assíncrono sem aguardar a conclusão da operação de reconhecimento atual. |
| RecognizeAsyncStop() |
Interrompe o reconhecimento assíncrono após a conclusão da operação de reconhecimento atual. |
| RequestRecognizerUpdate() |
Solicita que o reconhecedor pause para atualizar seu estado. |
| RequestRecognizerUpdate(Object, TimeSpan) |
Solicita que o reconhecedor pause para atualizar seu estado e forneça um deslocamento e um token de usuário para o evento associado. |
| RequestRecognizerUpdate(Object) |
Solicita que o reconhecedor pause para atualizar seu estado e forneça um token de usuário para o evento associado. |
| SetInputToAudioStream(Stream, SpeechAudioFormatInfo) |
Configura o SpeechRecognitionEngine objeto para receber a entrada de um fluxo de áudio. |
| SetInputToDefaultAudioDevice() |
Configura o SpeechRecognitionEngine objeto para receber a entrada do dispositivo de áudio padrão. |
| SetInputToNull() |
Desabilita a entrada para o reconhecedor de fala. |
| SetInputToWaveFile(String) |
Configura o SpeechRecognitionEngine objeto para receber entrada de um arquivo de formato de áudio waveform (.wav). |
| SetInputToWaveStream(Stream) |
Configura o SpeechRecognitionEngine objeto para receber a entrada de um fluxo que contém dados de formato de áudio Waveform (.wav). |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| UnloadAllGrammars() |
Descarrega todos os Grammar objetos do reconhecedor. |
| UnloadGrammar(Grammar) |
Descarrega um objeto especificado Grammar da SpeechRecognitionEngine instância. |
| UpdateRecognizerSetting(String, Int32) |
Atualiza a configuração especificada para o SpeechRecognitionEngine valor inteiro especificado. |
| UpdateRecognizerSetting(String, String) |
Atualiza a configuração do mecanismo de reconhecimento de fala especificada com o valor de cadeia de caracteres especificado. |
Eventos
| Nome | Description |
|---|---|
| AudioLevelUpdated |
Gerado quando o SpeechRecognitionEngine relatório relata o nível de sua entrada de áudio. |
| AudioSignalProblemOccurred |
Gerado quando detecta SpeechRecognitionEngine um problema no sinal de áudio. |
| AudioStateChanged |
Gerado quando o estado é alterado no áudio que está sendo recebido pelo SpeechRecognitionEngine. |
| EmulateRecognizeCompleted |
Gerado quando o SpeechRecognitionEngine finaliza uma operação de reconhecimento assíncrono de entrada emulada. |
| LoadGrammarCompleted |
Gerado quando o SpeechRecognitionEngine carregamento assíncrono é concluído de um Grammar objeto. |
| RecognizeCompleted |
Gerado quando o SpeechRecognitionEngine finaliza uma operação de reconhecimento assíncrono. |
| RecognizerUpdateReached |
Gerado quando uma execução SpeechRecognitionEngine pausa para aceitar modificações. |
| SpeechDetected |
Gerado quando detecta a SpeechRecognitionEngine entrada que ele pode identificar como fala. |
| SpeechHypothesized |
Gerado quando o SpeechRecognitionEngine reconheceu uma palavra ou palavras que podem ser um componente de várias frases completas em uma gramática. |
| SpeechRecognitionRejected |
Gerado quando a SpeechRecognitionEngine entrada recebe que não corresponde a nenhum de seus objetos carregados e habilitados Grammar . |
| SpeechRecognized |
Gerado quando a SpeechRecognitionEngine entrada recebe que corresponde a qualquer um de seus objetos carregados e habilitados Grammar . |
