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 zugehörigen 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 Zustand "Schlafen" befindet, wird EmulateRecognizeAsync immer NULL zurückgegeben.

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-Spracherkennungs-Benutzeroberfläche hinzuzufügen.

Diese Klasse bietet Kontrolle über verschiedene Aspekte des Spracherkennungsprozesses:

• Zum Verwalten von Spracherkennungsgrammatiken verwenden Sie die LoadGrammar, LoadGrammarAsync, , UnloadGrammar, UnloadAllGrammarsund Grammars.

• Um Informationen zu aktuellen Spracherkennungsvorgängen zu erhalten, abonnieren Sie die SpeechRecognizerEreignisse "s SpeechDetected, SpeechHypothesized, , SpeechRecognitionRejectedund SpeechRecognized Ereignisse".

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

• Um auf den Status der freigegebenen Erkennung zuzugreifen oder zu überwachen, verwenden Sie die AudioLevelEigenschaften , PauseRecognizerOnRecognitionRecognizerAudioPositionEnabledAudioPositionStateAudioStateund die AudioLevelUpdatedEreignisse , AudioSignalProblemOccurred, AudioStateChangedund StateChanged die Ereignisse.

• Verwenden Sie die RequestRecognizerUpdate Methode, um Änderungen an der Erkennung zu synchronisieren. Die freigegebene Erkennung verwendet mehr als einen Thread, um Aufgaben auszuführen.

• Zum Emulieren der Eingabe an die freigegebene Erkennung verwenden Sie die EmulateRecognize und EmulateRecognizeAsync die Methoden.

Die Konfiguration der Windows-Spracherkennung wird mithilfe des Dialogfelds " Spracheigenschaften " in der Systemsteuerung verwaltet. Diese Schnittstelle wird verwendet, um das Standardmodul für die Desktop-Spracherkennung und -sprache, das Audioeingabegerät und das Standbyverhalten der Spracherkennung auszuwählen. Wenn die Konfiguration der Windows-Spracherkennung während der Ausführung der Anwendung geändert wird (z. B. wenn die Spracherkennung deaktiviert oder die Eingabesprache geändert wird), wirkt sich die Änderung auf alle SpeechRecognizer Objekte aus.

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

Weitere Informationen

• SpeechRecognitionEngine
• Grammar
• RecognitionResult