SpeechRecognizer Klasse

Definition

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

Vererbung

Object

SpeechRecognizer

Implementiert

IDisposable

Beispiele

Das folgende Beispiel ist Teil einer Konsolenanwendung, die eine Spracherkennungsgrammatik lädt und asynchrone emulierte Eingaben, die zugeordneten Erkennungsergebnisse und die zugehörigen Ereignisse veranschaulicht, die von der Spracherkennung ausgelöst werden. Wenn die Windows-Spracherkennung nicht ausgeführt wird, startet diese Anwendung auch die Windows-Spracherkennung. Wenn sich die Windows-Spracherkennung im Ruhezustand befindet, EmulateRecognizeAsync gibt immer NULL zurück.

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, um auf die Windows-Spracherkennung zuzugreifen. Verwenden Sie das SpeechRecognizer -Objekt, um der Windows-Sprachbenutzeroberfläche hinzuzufügen.

Diese Klasse bietet Kontrolle über verschiedene Aspekte des Spracherkennungsprozesses:

• Verwenden Sie zum Verwalten von Spracherkennungsgrammatiken , LoadGrammar, UnloadGrammarLoadGrammarAsyncund GrammarsUnloadAllGrammars.

• Um Informationen zu aktuellen Spracherkennungsvorgängen abzurufen, abonnieren Sie die SpeechRecognizerEreignisse ", SpeechDetectedSpeechHypothesized" , SpeechRecognitionRejectedund SpeechRecognized ".

• Verwenden MaxAlternates Sie die -Eigenschaft, um die Anzahl der von der Erkennung zurückgegebenen alternativen Ergebnisse anzuzeigen oder zu ändern. Die Erkennung gibt Erkennungsergebnisse in einem RecognitionResult Objekt zurück.

• Um auf den Zustand der freigegebenen Erkennung zuzugreifen oder diesen zu überwachen, verwenden Sie die AudioLevelEigenschaften , AudioPosition, EnabledAudioState, PauseRecognizerOnRecognitionRecognizerAudioPosition, und State sowie die AudioLevelUpdatedEreignisse , AudioSignalProblemOccurred, AudioStateChangedundStateChanged.

• Verwenden Sie die -Methode, um Änderungen mit der RequestRecognizerUpdate Erkennung zu synchronisieren. Die freigegebene Erkennung verwendet mehr als einen Thread zum Ausführen von Aufgaben.

• Verwenden Sie die Methoden undEmulateRecognizeAsync, um Eingaben für die EmulateRecognize freigegebene Erkennung zu emulieren.

Die Konfiguration der Windows-Spracherkennung wird mithilfe des Dialogfelds Spracheigenschaften im Systemsteuerung verwaltet. Diese Schnittstelle wird verwendet, um die Standardmäßige Desktop-Spracherkennungs-Engine und -Sprache, das Audioeingabegerät und das Ruhezustandsverhalten der Spracherkennung auszuwählen. Wenn die Konfiguration der Windows-Spracherkennung während der Ausführung der Anwendung geändert wird (bei instance, wenn die Spracherkennung deaktiviert oder die Eingabesprache geändert wird), wirkt sich die Änderung auf alle SpeechRecognizer Objekte aus.

Verwenden Sie die -Klasse, um eine prozessinterne Spracherkennung zu erstellen, die von der SpeechRecognitionEngine Windows-Spracherkennung unabhängig ist.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• SpeechRecognitionEngine
• Grammar
• RecognitionResult