SpeechRecognitionEngine Classe

Definizione

Fornisce i mezzi per accedere e gestire un motore di riconoscimento vocale in-process.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
Ereditarietà
SpeechRecognitionEngine
Implementazioni

Esempi

Nell'esempio seguente viene illustrata una parte di un'applicazione console che illustra il riconoscimento vocale di base.The following example shows part of a console application that demonstrates basic speech recognition. Poiché in questo esempio viene Multiple utilizzata la modalità RecognizeAsync del metodo, viene eseguito il riconoscimento fino a quando non si chiude la finestra della console o si arresta il debug.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);  
    }  
  }  
}  

Commenti

È possibile creare un'istanza di questa classe per uno qualsiasi dei sistemi di riconoscimento vocale installati.You can create an instance of this class for any of the installed speech recognizers. Per ottenere informazioni sui riconoscitori installati, usare il metodo statico InstalledRecognizers .To get information about which recognizers are installed, use the static InstalledRecognizers method.

Questa classe è destinata all'esecuzione di motori di riconoscimento vocale in-process e fornisce il controllo su diversi aspetti del riconoscimento vocale, come indicato di seguito:This class is for running speech recognition engines in-process, and provides control over various aspects of speech recognition, as follows:

L' SpeechRecognitionEngine oggetto è per l'utilizzo esclusivo del processo che ha creato un'istanza dell'oggetto.The SpeechRecognitionEngine object is for the sole use of the process that instantiated the object. Al SpeechRecognizer contrario, condivide un singolo riconoscimento con qualsiasi applicazione che lo desidera utilizzare.By contrast, the SpeechRecognizer shares a single recognizer with any application that wants to use it.

Nota

Chiamare Dispose sempre prima di rilasciare l'ultimo riferimento al riconoscimento vocale.Always call Dispose before you release your last reference to the speech recognizer. In caso contrario, le risorse utilizzate non verranno liberate finché il Garbage Collector non chiamerà il Finalize metodo dell'oggetto Recognizer.Otherwise, the resources it is using will not be freed until the garbage collector calls the recognizer object's Finalize method.

Costruttori

SpeechRecognitionEngine()

Inizializza una nuova istanza della classe SpeechRecognitionEngine utilizzando il riconoscimento vocale predefinito per il sistema.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

SpeechRecognitionEngine(CultureInfo)

Inizializza una nuova istanza della classe SpeechRecognitionEngine utilizzando il riconoscimento vocale predefinito per le impostazioni locali specificate.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

SpeechRecognitionEngine(RecognizerInfo)

Inizializza una nuova istanza dell'oggetto SpeechRecognitionEngine utilizzando le informazioni disponibili in un oggetto RecognizerInfo per specificare il riconoscimento da utilizzare.Initializes a new instance of the SpeechRecognitionEngine using the information in a RecognizerInfo object to specify the recognizer to use.

SpeechRecognitionEngine(String)

Inizializza una nuova istanza della classe SpeechRecognitionEngine con una parametro di stringa che specifica il nome del riconoscimento da utilizzare.Initializes a new instance of the SpeechRecognitionEngine class with a string parameter that specifies the name of the recognizer to use.

Proprietà

AudioFormat

Ottiene il formato dell'audio ricevuto da SpeechRecognitionEngine.Gets the format of the audio being received by the SpeechRecognitionEngine.

AudioLevel

Ottiene il livello dell'audio ricevuto da SpeechRecognitionEngine.Gets the level of the audio being received by the SpeechRecognitionEngine.

AudioPosition

Ottiene la posizione corrente nel flusso audio generato dal dispositivo che fornisce l'input a SpeechRecognitionEngine.Gets the current location in the audio stream being generated by the device that is providing input to the SpeechRecognitionEngine.

AudioState

Ottiene lo stato dell'audio ricevuto da SpeechRecognitionEngine.Gets the state of the audio being received by the SpeechRecognitionEngine.

BabbleTimeout

Ottiene o imposta l'intervallo di tempo durante il quale SpeechRecognitionEngine accetta input contenente solo il rumore di fondo, prima di completare il riconoscimento.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only background noise, before finalizing recognition.

EndSilenceTimeout

Ottiene o imposta l'intervallo di silenzio che SpeechRecognitionEngine accetterà alla fine dell'input non ambiguo prima di completare un'operazione di riconoscimento.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of unambiguous input before finalizing a recognition operation.

EndSilenceTimeoutAmbiguous

Ottiene o imposta l'intervallo di silenzio che SpeechRecognitionEngine accetterà alla fine dell'input ambiguo prima di completare un'operazione di riconoscimento.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of ambiguous input before finalizing a recognition operation.

Grammars

Ottiene una raccolta di oggetti Grammar caricati in questa istanza di SpeechRecognitionEngine.Gets a collection of the Grammar objects that are loaded in this SpeechRecognitionEngine instance.

InitialSilenceTimeout

Ottiene o imposta l'intervallo di tempo durante il quale SpeechRecognitionEngine accetta input contenente solo silenzio, prima di completare il riconoscimento.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only silence before finalizing recognition.

MaxAlternates

Ottiene o imposta il numero massimo di risultati del riconoscimento alternativi che SpeechRecognitionEngine restituisce per ogni operazione di riconoscimento.Gets or sets the maximum number of alternate recognition results that the SpeechRecognitionEngine returns for each recognition operation.

RecognizerAudioPosition

Ottiene la posizione corrente di SpeechRecognitionEngine nell'input audio in fase di elaborazione.Gets the current location of the SpeechRecognitionEngine in the audio input that it is processing.

RecognizerInfo

Ottiene informazioni sull'istanza corrente di SpeechRecognitionEngine.Gets information about the current instance of SpeechRecognitionEngine.

Metodi

Dispose()

Elimina l'oggetto SpeechRecognitionEngine.Disposes the SpeechRecognitionEngine object.

Dispose(Boolean)

Elimina l'oggetto SpeechRecognitionEngine e rilascia le risorse usate durante la sessione.Disposes the SpeechRecognitionEngine object and releases resources used during the session.

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Emula l'input di parole specifiche al riconoscimento vocale, utilizzando il testo anziché l'audio per il riconoscimento vocale sincrono, e specifica come il riconoscimento gestisce il confronto Unicode tra le parole e le grammatiche di riconoscimento vocale caricate.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 l'input di una frase al riconoscimento vocale, utilizzando il testo anziché l'audio per il riconoscimento vocale sincrono.Emulates input of a phrase to the speech recognizer, using text in place of audio for synchronous speech recognition.

EmulateRecognize(String, CompareOptions)

Emula l'input di una frase al riconoscimento vocale, utilizzando il testo anziché l'audio per il riconoscimento vocale sincrono, e specifica come il riconoscimento gestisce il confronto Unicode tra la frase e le grammatiche di riconoscimento vocale caricate.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 l'input di parole specifiche al riconoscimento vocale, utilizzando una matrice di oggetti RecognizedWordUnit anziché l'audio per il riconoscimento vocale asincrono, e specifica come il riconoscimento gestisce il confronto Unicode tra le parole e le grammatiche di riconoscimento vocale caricate.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 l'input di una frase al riconoscimento vocale, utilizzando il testo anziché l'audio per il riconoscimento vocale asincrono.Emulates input of a phrase to the speech recognizer, using text in place of audio for asynchronous speech recognition.

EmulateRecognizeAsync(String, CompareOptions)

Emula l'input di una frase al riconoscimento vocale, utilizzando il testo anziché l'audio per il riconoscimento vocale asincrono, e specifica come il riconoscimento gestisce il confronto Unicode tra la frase e le grammatiche di riconoscimento vocale caricate.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 l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InstalledRecognizers()

Restituisce informazioni per tutti sistemi di riconoscimento vocale installati nel sistema corrente.Returns information for all of the installed speech recognizers on the current system.

LoadGrammar(Grammar)

Carica un oggetto Grammar in modo sincrono.Synchronously loads a Grammar object.

LoadGrammarAsync(Grammar)

Carica in modo asincrono una grammatica di riconoscimento vocale.Asynchronously loads a speech recognition grammar.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
QueryRecognizerSetting(String)

Restituisce i valori delle impostazioni per il riconoscimento.Returns the values of settings for the recognizer.

Recognize()

Effettua un'operazione sincrona di riconoscimento vocale.Performs a synchronous speech recognition operation.

Recognize(TimeSpan)

Effettua un'operazione sincrona di riconoscimento vocale con un periodo di timeout di inattività iniziale specificato.Performs a synchronous speech recognition operation with a specified initial silence timeout period.

RecognizeAsync()

Effettua un'unica operazione asincrona di riconoscimento vocale.Performs a single, asynchronous speech recognition operation.

RecognizeAsync(RecognizeMode)

Effettua una o più operazioni asincrone di riconoscimento vocale.Performs one or more asynchronous speech recognition operations.

RecognizeAsyncCancel()

Termina il riconoscimento asincrono senza attendere il completamento dell'operazione di riconoscimento corrente.Terminates asynchronous recognition without waiting for the current recognition operation to complete.

RecognizeAsyncStop()

Arresta il riconoscimento asincrono dopo che l'operazione di riconoscimento corrente è stata completata.Stops asynchronous recognition after the current recognition operation completes.

RequestRecognizerUpdate()

Richiede la sospensione del riconoscimento per aggiornarne lo stato.Requests that the recognizer pauses to update its state.

RequestRecognizerUpdate(Object)

Richiede la sospensione del riconoscimento per aggiornarne lo stato e fornire un token utente per l'evento associato.Requests that the recognizer pauses to update its state and provides a user token for the associated event.

RequestRecognizerUpdate(Object, TimeSpan)

Richiede la sospensione del riconoscimento per aggiornarne lo stato e fornire un offset e un token utente per l'evento associato.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 l'oggetto SpeechRecognitionEngine per ricevere l'input da un flusso audio.Configures the SpeechRecognitionEngine object to receive input from an audio stream.

SetInputToDefaultAudioDevice()

Configura l'oggetto SpeechRecognitionEngine per ricevere l'input dal dispositivo audio predefinito.Configures the SpeechRecognitionEngine object to receive input from the default audio device.

SetInputToNull()

Disabilita l'input del riconoscimento vocale.Disables the input to the speech recognizer.

SetInputToWaveFile(String)

Configura l'oggetto SpeechRecognitionEngine per ricevere l'input da un file in formato audio Waveform (.wav).Configures the SpeechRecognitionEngine object to receive input from a Waveform audio format (.wav) file.

SetInputToWaveStream(Stream)

Configura l'oggetto SpeechRecognitionEngine per ricevere l'input da un flusso che contiene i dati in formato audio Waveform (.wav).Configures the SpeechRecognitionEngine object to receive input from a stream that contains Waveform audio format (.wav) data.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
UnloadAllGrammars()

Scarica tutti gli oggetti Grammar dal riconoscimento.Unloads all Grammar objects from the recognizer.

UnloadGrammar(Grammar)

Scarica un oggetto Grammar specificato dall'istanza SpeechRecognitionEngine.Unloads a specified Grammar object from the SpeechRecognitionEngine instance.

UpdateRecognizerSetting(String, Int32)

Aggiorna l'impostazione specificata per SpeechRecognitionEngine con il valore Integer specificato.Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

UpdateRecognizerSetting(String, String)

Aggiorna l'impostazione specificata del motore di riconoscimento vocale con il valore di stringa specificato.Updates the specified speech recognition engine setting with the specified string value.

Eventi

AudioLevelUpdated

Generato quando SpeechRecognitionEngine segnala il livello del relativo input audio.Raised when the SpeechRecognitionEngine reports the level of its audio input.

AudioSignalProblemOccurred

Generato quando SpeechRecognitionEngine rileva un problema nel segnale audio.Raised when the SpeechRecognitionEngine detects a problem in the audio signal.

AudioStateChanged

Generato in seguito alla modifica dello stato nell'audio ricevuto da SpeechRecognitionEngine.Raised when the state changes in the audio being received by the SpeechRecognitionEngine.

EmulateRecognizeCompleted

Generato quando SpeechRecognitionEngine completa un'operazione di riconoscimento asincrona di input emulato.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation of emulated input.

LoadGrammarCompleted

Generato quando SpeechRecognitionEngine termina il caricamento asincrono di un oggetto Grammar.Raised when the SpeechRecognitionEngine finishes the asynchronous loading of a Grammar object.

RecognizeCompleted

Generato quando SpeechRecognitionEngine completa un'operazione di riconoscimento asincrona.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation.

RecognizerUpdateReached

Generato quando un oggetto SpeechRecognitionEngine in esecuzione viene sospeso per accettare le modifiche.Raised when a running SpeechRecognitionEngine pauses to accept modifications.

SpeechDetected

Generato quando SpeechRecognitionEngine rileva un input identificabile come funzione vocale.Raised when the SpeechRecognitionEngine detects input that it can identify as speech.

SpeechHypothesized

Generato quando SpeechRecognitionEngine ha riconosciuto una o più parole che possono essere componenti di più frasi complete in una grammatica.Raised when the SpeechRecognitionEngine has recognized a word or words that may be a component of multiple complete phrases in a grammar.

SpeechRecognitionRejected

Generato quando SpeechRecognitionEngine riceve input che non corrisponde ad alcun oggetto Grammar caricato e abilitato.Raised when the SpeechRecognitionEngine receives input that does not match any of its loaded and enabled Grammar objects.

SpeechRecognized

Generato quando SpeechRecognitionEngine riceve input che corrisponde a un oggetto Grammar caricato e abilitato.Raised when the SpeechRecognitionEngine receives input that matches any of its loaded and enabled Grammar objects.

Si applica a

Vedi anche