SpeechRecognitionEngine.EmulateRecognizeAsync Metodo

Definizione

Spazio dei nomi:: System.Speech.Recognition

Assembly:: System.Speech.dll

Pacchetto:: System.Speech v11.0.0-preview.2.26159.112

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Emula l'input al riconoscimento vocale, usando il testo al posto dell'audio per il riconoscimento vocale asincrono.

Overload

Nome	Descrizione
EmulateRecognizeAsync(String)	Emula l'input di una frase al riconoscimento vocale, usando il testo al posto dell'audio per il riconoscimento vocale asincrono.
EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)	Emula l'input di parole specifiche al riconoscimento vocale, usando una matrice di RecognizedWordUnit oggetti al posto dell'audio per il riconoscimento vocale asincrono e specifica come il riconoscimento gestisce il confronto Unicode tra le parole e le grammatiche di riconoscimento vocale caricate.
EmulateRecognizeAsync(String, CompareOptions)	Emula l'input di una frase al riconoscimento vocale, usando il testo al posto dell'audio per il riconoscimento vocale asincrono e specifica come il riconoscimento gestisce il confronto Unicode tra la frase e le grammatiche di riconoscimento vocale caricate.

Commenti

Questi metodi ignorano l'input audio di sistema e forniscono testo al riconoscitore come String oggetti o come matrice di RecognizedWordUnit oggetti. Questo può essere utile quando si esegue il test o il debug di un'applicazione o una grammatica. Ad esempio, è possibile usare l'emulazione per determinare se una parola si trova in una grammatica e quale semantica viene restituita quando viene riconosciuta la parola. Usare il metodo per disabilitare l'input SetInputToNull audio al motore di riconoscimento vocale durante le operazioni di emulazione.

Il riconoscimento vocale genera gli SpeechDetectedeventi , SpeechHypothesized, SpeechRecognitionRejectede SpeechRecognized come se l'operazione di riconoscimento non sia emulata. Quando il riconoscitore completa l'operazione di riconoscimento asincrono, genera l'evento EmulateRecognizeCompleted . Il riconoscitore ignora nuove righe e spazi vuoti aggiuntivi e considera la punteggiatura come input letterale.

Annotazioni

L'oggetto RecognitionResult generato dal riconoscimento vocale in risposta all'input emulato ha un valore di null per la relativa Audio proprietà.

Per emulare il riconoscimento sincrono, usare il EmulateRecognize metodo .

EmulateRecognizeAsync(String)

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Emula l'input di una frase al riconoscimento vocale, usando il testo al posto dell'audio per il riconoscimento vocale asincrono.

public:
 void EmulateRecognizeAsync(System::String ^ inputText);

public void EmulateRecognizeAsync(string inputText);

member this.EmulateRecognizeAsync : string -> unit

Public Sub EmulateRecognizeAsync (inputText As String)

Parametri

inputText: String

Input per l'operazione di riconoscimento.

Eccezioni

InvalidOperationException

Il riconoscitore non dispone di grammatiche di riconoscimento vocale caricate o il riconoscitore dispone di un'operazione di riconoscimento asincrona non ancora completata.

ArgumentNullException

inputText è null.

ArgumentException

inputText è la stringa vuota ("").

Esempio

L'esempio di codice seguente fa parte di un'applicazione console che illustra l'input emulato asincrono, i risultati di riconoscimento associati e gli eventi associati generati dal riconoscimento vocale. L'esempio genera l'output seguente.

TestRecognizeAsync("Smith")...
 SpeechDetected event raised.
 SpeechRecognized event raised.
  Grammar = Smith; Text = Smith
 EmulateRecognizeCompleted event raised.
  Grammar = Smith; Text = Smith
 Done.

TestRecognizeAsync("Jones")...
 SpeechDetected event raised.
 SpeechRecognized event raised.
  Grammar = Jones; Text = Jones
 EmulateRecognizeCompleted event raised.
  Grammar = Jones; Text = Jones
 Done.

TestRecognizeAsync("Mister")...
 SpeechDetected event raised.
 SpeechHypothesized event raised.
  Grammar = Smith; Text = mister
 SpeechRecognitionRejected event raised.
  Grammar = <not available>; Text =
 EmulateRecognizeCompleted event raised.
  No recognition result available.
 Done.

TestRecognizeAsync("Mister Smith")...
 SpeechDetected event raised.
 SpeechRecognized event raised.
  Grammar = Smith; Text = mister Smith
 EmulateRecognizeCompleted event raised.
  Grammar = Smith; Text = mister Smith
 Done.

press any key to exit...

using System;
using System.Globalization;
using System.Speech.Recognition;
using System.Threading;

namespace SreEmulateRecognizeAsync
{
  class Program
  {
    // Indicate when an asynchronous operation is finished.
    static bool completed;

    static void Main(string[] args)
    {
      using (SpeechRecognitionEngine recognizer =
        new SpeechRecognitionEngine(new CultureInfo("en-US")))
      {
        // Load grammars.
        recognizer.LoadGrammar(CreateNameGrammar("Smith"));
        recognizer.LoadGrammar(CreateNameGrammar("Jones"));

        // Configure the audio input.
        recognizer.SetInputToNull();

        // Add event handlers for the events raised by the
        // EmulateRecognizeAsync method.
        recognizer.SpeechDetected +=
          new EventHandler<SpeechDetectedEventArgs>(
            SpeechDetectedHandler);
        recognizer.SpeechHypothesized +=
          new EventHandler<SpeechHypothesizedEventArgs>(
            SpeechHypothesizedHandler);
        recognizer.SpeechRecognitionRejected +=
          new EventHandler<SpeechRecognitionRejectedEventArgs>(
            SpeechRecognitionRejectedHandler);
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(
            SpeechRecognizedHandler);
        recognizer.EmulateRecognizeCompleted +=
          new EventHandler<EmulateRecognizeCompletedEventArgs>(
            EmulateRecognizeCompletedHandler);

        // Start four asynchronous emulated recognition operations.
        TestRecognizeAsync(recognizer, "Smith");
        TestRecognizeAsync(recognizer, "Jones");
        TestRecognizeAsync(recognizer, "Mister");
        TestRecognizeAsync(recognizer, "Mister Smith");
      }

      Console.WriteLine("press any key to exit...");
      Console.ReadKey(true);
    }

    // Create a simple name grammar.
    // Set the grammar name to the surname.
    private static Grammar CreateNameGrammar(string surname)
    {
      GrammarBuilder builder = new GrammarBuilder("mister", 0, 1);
      builder.Append(surname);

      Grammar nameGrammar = new Grammar(builder);
      nameGrammar.Name = surname;

      return nameGrammar;
    }

    // Send emulated input to the recognizer for asynchronous
    // recognition.
    private static void TestRecognizeAsync(
      SpeechRecognitionEngine recognizer, string input)
    {
      completed = false;

      Console.WriteLine("TestRecognizeAsync(\"{0}\")...", input);
      recognizer.EmulateRecognizeAsync(input);

      // Wait for the operation to complete.
      while (!completed)
      {
        Thread.Sleep(333);
      }

      Console.WriteLine(" Done.");
      Console.WriteLine();
    }

    static void SpeechDetectedHandler(
      object sender, SpeechDetectedEventArgs e)
    {
      Console.WriteLine(" SpeechDetected event raised.");
    }

    static void SpeechHypothesizedHandler(
      object sender, SpeechHypothesizedEventArgs e)
    {
      Console.WriteLine(" SpeechHypothesized event raised.");
      if (e.Result != null)
      {
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          e.Result.Grammar.Name ?? "<none>", e.Result.Text);
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }
    }

    // Handle events.
    static void SpeechRecognitionRejectedHandler(
      object sender, SpeechRecognitionRejectedEventArgs e)
    {
      Console.WriteLine(" SpeechRecognitionRejected event raised.");
      if (e.Result != null)
      {
        string grammarName;
        if (e.Result.Grammar != null)
        {
          grammarName = e.Result.Grammar.Name ?? "<none>";
        }
        else
        {
          grammarName = "<not available>";
        }
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          grammarName, e.Result.Text);
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }
    }

    static void SpeechRecognizedHandler(
      object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine(" SpeechRecognized event raised.");
      if (e.Result != null)
      {
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          e.Result.Grammar.Name ?? "<none>", e.Result.Text );
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }
    }

    static void EmulateRecognizeCompletedHandler(
      object sender, EmulateRecognizeCompletedEventArgs e)
    {
      Console.WriteLine(" EmulateRecognizeCompleted event raised.");

      if (e.Error != null)
      {
        Console.WriteLine("  {0} exception encountered: {1}:",
          e.Error.GetType().Name, e.Error.Message);
      }
      else if (e.Cancelled)
      {
        Console.WriteLine("  Operation cancelled.");
      }
      else if (e.Result != null)
      {
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          e.Result.Grammar.Name ?? "<none>", e.Result.Text);
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }

      completed = true;
    }
  }
}

Commenti

I riconoscitori forniti con Vista e Windows 7 ignorano la larghezza di maiuscole e minuscole e caratteri quando si applicano regole grammaticali alla frase di input. Per altre informazioni su questo tipo di confronto, vedere i CompareOptions valori OrdinalIgnoreCase di enumerazione e IgnoreWidth. I riconoscitori ignorano anche nuove righe e spazi vuoti aggiuntivi e considerano la punteggiatura come input letterale.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da EmulateRecognize(String).

Vedi anche

Si applica a

EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Emula l'input di parole specifiche al riconoscimento vocale, usando una matrice di RecognizedWordUnit oggetti al posto dell'audio per il riconoscimento vocale asincrono e specifica come il riconoscimento gestisce il confronto Unicode tra le parole e le grammatiche di riconoscimento vocale caricate.

public:
 void EmulateRecognizeAsync(cli::array <System::Speech::Recognition::RecognizedWordUnit ^> ^ wordUnits, System::Globalization::CompareOptions compareOptions);

public void EmulateRecognizeAsync(System.Speech.Recognition.RecognizedWordUnit[] wordUnits, System.Globalization.CompareOptions compareOptions);

member this.EmulateRecognizeAsync : System.Speech.Recognition.RecognizedWordUnit[] * System.Globalization.CompareOptions -> unit

Public Sub EmulateRecognizeAsync (wordUnits As RecognizedWordUnit(), compareOptions As CompareOptions)

Parametri

wordUnits: RecognizedWordUnit[]

Matrice di unità di parole che contiene l'input per l'operazione di riconoscimento.

compareOptions: CompareOptions

Combinazione bit per bit dei valori di enumerazione che descrivono il tipo di confronto da utilizzare per l'operazione di riconoscimento emulato.

Eccezioni

InvalidOperationException

Il riconoscitore non dispone di grammatiche di riconoscimento vocale caricate o il riconoscitore dispone di un'operazione di riconoscimento asincrona non ancora completata.

ArgumentNullException

wordUnits è null.

ArgumentException

wordUnits contiene uno o più null elementi.

NotSupportedException

compareOptions contiene il IgnoreNonSpaceflag , IgnoreSymbolso StringSort .

Commenti

Il riconoscitore usa quando applica le regole grammaticali compareOptions alla frase di input. I riconoscitori forniti con Vista e Windows 7 ignorano la distinzione tra maiuscole e minuscole se il OrdinalIgnoreCase valore o IgnoreCase è presente. I riconoscitori ignorano sempre la larghezza del carattere e non ignorano mai il tipo Kana. I riconoscitori ignorano anche nuove righe e spazi vuoti aggiuntivi e considerano la punteggiatura come input letterale. Per altre informazioni sulla larghezza dei caratteri e sul tipo Kana, vedere l'enumerazione CompareOptions .

Vedi anche

Si applica a

EmulateRecognizeAsync(String, CompareOptions)

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Origine:: SpeechRecognitionEngine.cs

Emula l'input di una frase al riconoscimento vocale, usando il testo al posto dell'audio per il riconoscimento vocale asincrono e specifica come il riconoscimento gestisce il confronto Unicode tra la frase e le grammatiche di riconoscimento vocale caricate.

public:
 void EmulateRecognizeAsync(System::String ^ inputText, System::Globalization::CompareOptions compareOptions);

public void EmulateRecognizeAsync(string inputText, System.Globalization.CompareOptions compareOptions);

member this.EmulateRecognizeAsync : string * System.Globalization.CompareOptions -> unit

Public Sub EmulateRecognizeAsync (inputText As String, compareOptions As CompareOptions)

Parametri

inputText: String

Frase di input per l'operazione di riconoscimento.

compareOptions: CompareOptions

Combinazione bit per bit dei valori di enumerazione che descrivono il tipo di confronto da utilizzare per l'operazione di riconoscimento emulato.

Eccezioni

InvalidOperationException

Il riconoscitore non dispone di grammatiche di riconoscimento vocale caricate o il riconoscitore dispone di un'operazione di riconoscimento asincrona non ancora completata.

ArgumentNullException

inputText è null.

ArgumentException

inputText è la stringa vuota ("").

NotSupportedException

compareOptions contiene il IgnoreNonSpaceflag , IgnoreSymbolso StringSort .

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

SpeechRecognitionEngine.EmulateRecognizeAsync Metodo

Definizione

Overload

Commenti

EmulateRecognizeAsync(String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

EmulateRecognizeAsync(String, CompareOptions)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti