SpeechRecognizer Classe

Definizione

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

Ereditarietà

Object

SpeechRecognizer

Implementazioni

IDisposable

Esempio

L'esempio seguente fa parte di un'applicazione console che carica una grammatica di riconoscimento vocale e illustra l'input emulato asincrono, i risultati di riconoscimento associati e gli eventi associati generati dal riconoscimento vocale. Se Riconoscimento vocale Windows non è in esecuzione, l'avvio dell'applicazione avvierà anche Riconoscimento vocale Windows. Se il riconoscimento vocale di Windows è in stato di sospensione , EmulateRecognizeAsync restituisce sempre 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;  
    }  
  }  
}  

Commenti

Le applicazioni usano il riconoscitore condiviso per accedere al riconoscimento vocale Windows. Usare l'oggetto SpeechRecognizer per aggiungere all'esperienza utente di riconoscimento vocale di Windows.

Questa classe fornisce il controllo su vari aspetti del processo di riconoscimento vocale:

• Per gestire le grammatiche di riconoscimento vocale, usare LoadGrammar, LoadGrammarAsync, UnloadGrammar, UnloadAllGrammarse Grammars.

• Per ottenere informazioni sulle operazioni di riconoscimento vocale correnti, sottoscrivere gli SpeechRecognizereventi , SpeechHypothesized, SpeechRecognitionRejectede SpeechRecognized di SpeechDetected.

• Per visualizzare o modificare il numero di risultati alternativi restituiti dal riconoscitore, utilizzare la MaxAlternates proprietà . Il riconoscitore restituisce i risultati del riconoscimento in un RecognitionResult oggetto .

• Per accedere o monitorare lo stato del riconoscitore condiviso, usare le AudioLevelproprietà , AudioPosition, AudioState, EnabledPauseRecognizerOnRecognition, RecognizerAudioPosition, e State e gli AudioLevelUpdatedeventi , AudioStateChangedAudioSignalProblemOccurred, e StateChanged .

• Per sincronizzare le modifiche apportate al sistema di riconoscimento, usare il RequestRecognizerUpdate metodo . Il riconoscitore condiviso usa più di un thread per eseguire attività.

• Per emulare l'input al riconoscitore condiviso, usare i EmulateRecognize metodi e EmulateRecognizeAsync .

La configurazione di Riconoscimento vocale Windows viene gestita dall'uso della finestra di dialogo Proprietà voce nel Pannello di controllo. Questa interfaccia viene usata per selezionare il motore e la lingua di riconoscimento vocale desktop predefiniti, il dispositivo di input audio e il comportamento di sospensione del riconoscimento vocale. Se la configurazione di Riconoscimento vocale di Windows viene modificata durante l'esecuzione dell'applicazione, ad esempio se il riconoscimento vocale è disabilitato o la lingua di input viene modificata, la modifica influisce su tutti gli SpeechRecognizer oggetti.

Per creare un riconoscimento vocale in-process indipendente da Riconoscimento vocale Windows, usare la SpeechRecognitionEngine classe .

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• SpeechRecognitionEngine
• Grammar
• RecognitionResult