SpeechRecognizer SpeechRecognizer SpeechRecognizer SpeechRecognizer Class

Definition

Bietet Zugriff auf den freigegebenen Spracherkennungsdienst, der auf dem Windows-Desktop verfügbar ist.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
Vererbung
SpeechRecognizerSpeechRecognizerSpeechRecognizerSpeechRecognizer
Implementiert

Beispiele

Im folgende Beispiel ist Teil einer Konsolenanwendung, die lädt eine spracherkennungsgrammatik aus, und zeigt, asynchrone emulierte Eingabe, die zugehörigen Erkennungsergebnisse und die zugehörigen Ereignisse, die von der Spracherkennung ausgelöst.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. Wenn Windows-Spracherkennung nicht ausgeführt wird, wird Windows-Spracherkennung starten Sie dann auf diese Anwendung ebenfalls gestartet.If Windows Speech Recognition is not running, then starting this application will also start Windows Speech Recognition. Windows-Spracherkennung ist in der Sleeping aufweist, klicken Sie dann EmulateRecognizeAsync gibt immer null zurück.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;  
    }  
  }  
}  

Hinweise

Anwendungen verwenden die freigegebene Erkennung auf der Windows-Spracherkennung.Applications use the shared recognizer to access Windows Speech Recognition. Verwenden der SpeechRecognizer Objekt, das die Benutzeroberfläche der Windows-Spracherkennung hinzugefügt.Use the SpeechRecognizer object to add to the Windows speech user experience.

Diese Klasse stellt die Kontrolle über verschiedene Aspekte des Prozesses Speech Recognition bereit:This class provides control over various aspects of the speech recognition process:

Die Konfiguration der Windows-Spracherkennung wird durch die Verwendung von verwaltet die Spracheigenschaften im Dialogfeld die Systemsteuerung.The configuration of Windows Speech Recognition is managed by the use of the Speech Properties dialog in the Control Panel. Diese Schnittstelle wird verwendet, um die standardmäßige desktop spracherkennungs-Engine und Sprache, die Audioeingabegerät und das Verhalten der Standbymodus der Spracherkennung auszuwählen.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. Wenn die Konfiguration der Windows-Spracherkennung geändert wird, während die Anwendung ausgeführt wird (z. B. wenn die Spracherkennung ist deaktiviert, oder die Eingabesprache geändert wird), die Änderung wirkt sich auf alle SpeechRecognizer Objekte.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.

Verwenden Sie zum Erstellen einer in-Process-Spracherkennung, die unabhängig von der Windows-Spracherkennung ist das SpeechRecognitionEngine Klasse.To create an in-process speech recognizer that is independent of Windows Speech Recognition, use the SpeechRecognitionEngine class.

Hinweis

Rufen Sie immer Dispose bereits vor der Veröffentlichung des letzten Verweis auf die freigegebene Spracherkennung.Always call Dispose before you release your last reference to the speech recognizer. Andernfalls werden die verwendeten Ressourcen werden nicht reserviert, bis der ruft der Garbage Collector des erkennerobjekts Finalize Methode.Otherwise, the resources it is using will not be freed until the garbage collector calls the recognizer object's Finalize method.

Konstruktoren

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

Initialisiert eine neue Instanz der SpeechRecognizer-Klasse.Initializes a new instance of the SpeechRecognizer class.

Eigenschaften

AudioFormat AudioFormat AudioFormat AudioFormat

Ruft das Audioformat ab, das von der Spracherkennung empfangen wird.Gets the format of the audio being received by the speech recognizer.

AudioLevel AudioLevel AudioLevel AudioLevel

Ruft den Level des Audiosignals ab, das von der Spracherkennung empfangen wird.Gets the level of the audio being received by the speech recognizer.

AudioPosition AudioPosition AudioPosition AudioPosition

Ruft die aktuelle Position im Audiostream ab, die durch das Gerät generiert wird, das die Spracherkennung mit Eingaben versorgt.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

Ruft den Status des von der Spracherkennung empfangenen Audiosignals ab.Gets the state of the audio being received by the speech recognizer.

Enabled Enabled Enabled Enabled

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob dieses SpeechRecognizer-Objekt für die Sprachverarbeitung bereit ist.Gets or sets a value that indicates whether this SpeechRecognizer object is ready to process speech.

Grammars Grammars Grammars Grammars

Ruft eine Auflistung der Grammar-Objekte ab, die in diese SpeechRecognizer-Instanz geladen werden.Gets a collection of the Grammar objects that are loaded in this SpeechRecognizer instance.

MaxAlternates MaxAlternates MaxAlternates MaxAlternates

Ruft die Höchstzahl alternativer Erkennungsergebnisse ab, welche die gemeinsame Erkennung für jeden Erkennungsvorgang zurückgibt, oder legt diese fest.Gets or sets the maximum number of alternate recognition results that the shared recognizer returns for each recognition operation.

PauseRecognizerOnRecognition PauseRecognizerOnRecognition PauseRecognizerOnRecognition PauseRecognizerOnRecognition

Ruft einen Wert ab, bzw. legt diesen fest, der angibt, ob das gemeinsame Erkennungsmodul Erkennungsvorgänge anhält, während eine Anwendung ein SpeechRecognized-Ereignis verarbeitet.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

Ruft die aktuelle Position der Erkennung in der Audioeingabe ab, die verarbeitet wird.Gets the current location of the recognizer in the audio input that it is processing.

RecognizerInfo RecognizerInfo RecognizerInfo RecognizerInfo

Ruft Informationen über die freigegebene Spracherkennung ab.Gets information about the shared speech recognizer.

State State State State

Ruft den Zustand eines SpeechRecognizer-Objekts ab.Gets the state of a SpeechRecognizer object.

Methoden

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

Gibt das SpeechRecognizer-Objekt frei.Disposes the SpeechRecognizer object.

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

Verwirft das SpeechRecognizer-Objekt und gibt Ressourcen frei, die während der Sitzung verwendet werden.Disposes the SpeechRecognizer object and releases resources used during the session.

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

Emuliert die Eingabe bestimmter Wörter für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen den Wörtern und den geladenen Spracherkennungsgrammatiken behandelt.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)

Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet.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)

Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen dem Ausdruck und den geladenen Spracherkennungsgrammatiken behandelt.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)

Emuliert die Eingabe bestimmter Wörter für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die asynchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen den Wörtern und den geladenen Spracherkennungsgrammatiken behandelt.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)

Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die asynchrone Spracherkennung verwendet.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)

Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die asynchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen dem Ausdruck und den geladenen Spracherkennungsgrammatiken behandelt.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)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Lädt eine Spracherkennungsgrammatik.Loads a speech recognition grammar.

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

Lädt asynchron eine Spracherkennungsgrammatik.Asynchronously loads a speech recognition grammar.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Fordert an, dass die freigegebene Erkennung anhält und ihren Zustand aktualisiert.Requests that the shared recognizer pause and update its state.

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

Fordert an, dass die freigegebene Erkennung anhält, um den Zustand zu aktualisieren und stellt ein Benutzertoken für das zugeordnete Ereignis bereit.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)

Fordert an, dass die freigegebene Erkennung anhält, um den Zustand zu aktualisieren und stellt ein Offset für das zugeordnete Ereignis bereit.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()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

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

Entlädt alle Spracherkennungsgrammatiken aus dem freigegebenen Erkennungsmodul.Unloads all speech recognition grammars from the shared recognizer.

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

Entlädt eine angegebene Spracherkennungsgrammatik aus dem freigegebenen Erkennungsmodul.Unloads a specified speech recognition grammar from the shared recognizer.

Ereignisse

AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated

Tritt auf, wenn die freigegebene Erkennung die Ebene ihrer Audioeingabe meldet.Occurs when the shared recognizer reports the level of its audio input.

AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred

Tritt auf, wenn in der Erkennung ein Problem beim Audiosignal auftritt.Occurs when the recognizer encounters a problem in the audio signal.

AudioStateChanged AudioStateChanged AudioStateChanged AudioStateChanged

Tritt bei Zustandsänderungen im Audio auf, das von der Erkennung empfangen wird.Occurs when the state changes in the audio being received by the recognizer.

EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted

Tritt auf, wenn die freigegebene Erkennung einen asynchronen Erkennungsvorgang für emulierte Eingabe abgeschlossen hat.Occurs when the shared recognizer finalizes an asynchronous recognition operation for emulated input.

LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted

Tritt auf, wenn die Erkennung das asynchrone Laden einer Spracherkennungsgrammatik beendet.Occurs when the recognizer finishes the asynchronous loading of a speech recognition grammar.

RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached

Tritt auf, wenn die Erkennung anhält, um Erkennungs- und andere Vorgänge zu synchronisieren.Occurs when the recognizer pauses to synchronize recognition and other operations.

SpeechDetected SpeechDetected SpeechDetected SpeechDetected

Tritt auf, wenn die Erkennung eine Eingabe erkennt, die sie als Sprache identifizieren kann.Occurs when the recognizer detects input that it can identify as speech.

SpeechHypothesized SpeechHypothesized SpeechHypothesized SpeechHypothesized

Tritt auf, wenn die Erkennung ein Wort oder Wörter erkannt hat, die möglicherweise eine Komponente von mehreren vollständigen Ausdrücken in einer Grammatik sind.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

Tritt auf, wenn die Erkennung Eingaben empfängt, die mit keiner der Spracherkennungsgrammatiken übereinstimmen, die sie geladen hat.Occurs when the recognizer receives input that does not match any of the speech recognition grammars it has loaded.

SpeechRecognized SpeechRecognized SpeechRecognized SpeechRecognized

Tritt auf, wenn die Erkennung Eingaben empfängt, die mit einer ihrer Spracherkennungsgrammatiken übereinstimmen.Occurs when the recognizer receives input that matches one of its speech recognition grammars.

StateChanged StateChanged StateChanged StateChanged

Tritt auf, wenn sich der Ausführzustand der Erkennungs-Engine von Windows Desktop Speech Technology ändert.Occurs when the running state of the Windows Desktop Speech Technology recognition engine changes.

Gilt für:

Siehe auch