SpeechRecognizer Klas

Definitie

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

Overname

Object

SpeechRecognizer

Implementeringen

IDisposable

Voorbeelden

Het volgende voorbeeld maakt deel uit van een consoletoepassing die een grammatica van spraakherkenning laadt en asynchrone geëmuleerde invoer demonstreert, de bijbehorende herkenningsresultaten en de bijbehorende gebeurtenissen die door de spraakherkenning worden gegenereerd. Als Windows Spraakherkenning niet wordt uitgevoerd, wordt het starten van deze toepassing ook gestart Windows Spraakherkenning. Als Windows Spraakherkenning de status Sleeping heeft, retourneert EmulateRecognizeAsync altijd 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;
    }
  }
}

Opmerkingen

Toepassingen gebruiken de shared recognizer voor toegang tot Windows spraakherkenning. Gebruik het object SpeechRecognizer om toe te voegen aan de Windows spraakgebruikerservaring.

Deze klasse biedt controle over verschillende aspecten van het spraakherkenningsproces:

• Als u grammaticaën voor spraakherkenning wilt beheren, gebruikt u de LoadGrammar, LoadGrammarAsync, UnloadGrammaren UnloadAllGrammars.Grammars

• Als u informatie wilt over huidige spraakherkenningsbewerkingen, abonneert u zich op de SpeechRecognizer'sSpeechDetected, SpeechHypothesizedSpeechRecognitionRejecteden SpeechRecognized gebeurtenissen.

• Als u het aantal alternatieve resultaten wilt weergeven of wijzigen dat door de recognizer wordt geretourneerd, gebruikt u de MaxAlternates eigenschap. De recognizer retourneert herkenningsresultaten in een RecognitionResult object.

• Als u de status van de gedeelde recognizer wilt openen of bewaken, gebruikt u de AudioLeveleigenschappen , , EnabledPauseRecognizerOnRecognitionAudioPositionAudioState, , RecognizerAudioPositionen State eigenschappen en de AudioSignalProblemOccurredAudioLevelUpdated, en AudioStateChangedStateChanged gebeurtenissen.

• Als u wijzigingen wilt synchroniseren met de recognizer, gebruikt u de RequestRecognizerUpdate methode. De shared recognizer gebruikt meer dan één thread om taken uit te voeren.

• Als u invoer wilt emuleren voor de gedeelde herkenning, gebruikt u de EmulateRecognize en EmulateRecognizeAsync methoden.

De configuratie van Windows Spraakherkenning wordt beheerd door het dialoogvenster Speech Properties in het dialoogvenster Configuratiescherm. Deze interface wordt gebruikt voor het selecteren van de standaard-engine voor spraakherkenning op het bureaublad, het audio-invoerapparaat en het slaapstandgedrag van spraakherkenning. Als de configuratie van Windows Spraakherkenning wordt gewijzigd terwijl de toepassing wordt uitgevoerd (bijvoorbeeld als spraakherkenning is uitgeschakeld of de invoertaal wordt gewijzigd), is de wijziging van invloed op alle SpeechRecognizer-objecten.

Als u een in-process spraakherkenning wilt maken die onafhankelijk is van Windows Spraakherkenning, gebruikt u de klasse SpeechRecognitionEngine.

Zie ook

• SpeechRecognitionEngine
• Grammar
• RecognitionResult