SpeechRecognizer Classe

Définition

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

Héritage

Object

SpeechRecognizer

Implémente

IDisposable

Exemples

L’exemple suivant fait partie d’une application console qui charge une grammaire de reconnaissance vocale et illustre l’entrée émulée asynchrone, les résultats de la reconnaissance associée et les événements associés déclenchés par le module de reconnaissance vocale. Si la reconnaissance vocale Windows n’est pas en cours d’exécution, le démarrage de cette application démarre également la reconnaissance vocale Windows. Si la reconnaissance vocale Windows est à l’état en veille , EmulateRecognizeAsync retourne toujours la valeur 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;  
    }  
  }  
}  

Remarques

Les applications utilisent le module de reconnaissance partagée pour accéder à la reconnaissance vocale Windows. Utilisez l’objet SpeechRecognizer à ajouter à l’expérience utilisateur de Windows Speech.

Cette classe permet de contrôler différents aspects du processus de reconnaissance vocale :

• Pour gérer les grammaires de reconnaissance vocale, utilisez , LoadGrammarLoadGrammarAsync, UnloadGrammar, UnloadAllGrammarset Grammars.

• Pour obtenir des informations sur les SpeechRecognizerSpeechDetectedopérations de reconnaissance vocale actuelles, abonnez-vous aux événements , SpeechHypothesized, SpeechRecognitionRejectedet SpeechRecognized .

• Pour afficher ou modifier le nombre de résultats alternatifs retournés par le module de reconnaissance, utilisez la MaxAlternates propriété . Le module de reconnaissance retourne les résultats de la reconnaissance dans un RecognitionResult objet .

• Pour accéder à l’état du module de reconnaissance partagé ou le surveiller, utilisez les AudioLevelpropriétés AudioLevelUpdated, AudioStateAudioPosition, Enabled, PauseRecognizerOnRecognition, , RecognizerAudioPosition, et State les événements , AudioSignalProblemOccurred, AudioStateChangedet StateChanged .

• Pour synchroniser les modifications apportées au module de reconnaissance, utilisez la RequestRecognizerUpdate méthode . Le module de reconnaissance partagé utilise plusieurs threads pour effectuer des tâches.

• Pour émuler l’entrée dans le module de reconnaissance partagé, utilisez les EmulateRecognize méthodes et EmulateRecognizeAsync .

La configuration de la reconnaissance vocale Windows est gérée par l’utilisation de la boîte de dialogue Propriétés vocales dans le Panneau de configuration. Cette interface est utilisée pour sélectionner le moteur et la langue de reconnaissance vocale par défaut du bureau, le périphérique d’entrée audio et le comportement de veille de la reconnaissance vocale. Si la configuration de la reconnaissance vocale Windows est modifiée pendant l’exécution de l’application (par instance, si la reconnaissance vocale est désactivée ou si la langue d’entrée est modifiée), la modification affecte tous les SpeechRecognizer objets.

Pour créer un module de reconnaissance vocale in-process indépendant de la reconnaissance vocale Windows, utilisez la SpeechRecognitionEngine classe .

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• SpeechRecognitionEngine
• Grammar
• RecognitionResult