SpeechRecognitionEngine.EmulateRecognize Método

Referência

Definição

Namespace:: System.Speech.Recognition

Assembly:: System.Speech.dll

Pacote:: System.Speech v8.0.0

Pacote:: System.Speech v9.0.0-preview.3.24172.9

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Emula a entrada para o reconhecedor de fala usando o texto no lugar do áudio para o reconhecimento de fala síncrono.

Sobrecargas

EmulateRecognize(String)	Emula a entrada de uma fase para o reconhecedor de fala usando o texto no lugar do áudio para o reconhecimento de fala síncrono.
EmulateRecognize(RecognizedWordUnit[], CompareOptions)	Emula a entrada de palavras específicas no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala síncrono e especifica como o reconhecedor trata a comparação Unicode entre as palavras e as gramáticas do reconhecimento de fala carregado.
EmulateRecognize(String, CompareOptions)	Emula a entrada de uma frase no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala síncrono e especifica como o reconhecedor trata a comparação Unicode entre a frase e as gramáticas do reconhecimento de fala carregado.

Comentários

Esses métodos ignoram a entrada de áudio do sistema e fornecem texto ao reconhecedor como String objetos ou como uma matriz de RecognizedWordUnit objetos. Isso pode ser útil quando você está testando ou depurando um aplicativo ou gramática. Por exemplo, você pode usar a emulação para determinar se uma palavra está em uma gramática e qual semântica é retornada quando a palavra é reconhecida. Use o SetInputToNull método para desabilitar a entrada de áudio no mecanismo de reconhecimento de fala durante operações de emulação.

O reconhecedor de fala gera os SpeechDetectedeventos , SpeechHypothesized, SpeechRecognitionRejectede SpeechRecognized como se a operação de reconhecimento não fosse emulada. O reconhecedor ignora novas linhas e espaço em branco extra e trata a pontuação como entrada literal.

Observação

O RecognitionResult objeto gerado pelo reconhecedor de fala em resposta à entrada emulada tem um valor de null para sua Audio propriedade.

Para emular o reconhecimento assíncrono, use o EmulateRecognizeAsync método.

EmulateRecognize(String)

Origem:: SpeechRecognitionEngine.cs

Origem:: SpeechRecognitionEngine.cs

Origem:: SpeechRecognitionEngine.cs

Emula a entrada de uma fase para o reconhecedor de fala usando o texto no lugar do áudio para o reconhecimento de fala síncrono.

public:
 System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText);

public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText);

member this.EmulateRecognize : string -> System.Speech.Recognition.RecognitionResult

Public Function EmulateRecognize (inputText As String) As RecognitionResult

Parâmetros

inputText: String

A entrada da operação de reconhecimento.

Retornos

RecognitionResult

O resultado da operação de reconhecimento ou null se a operação não for bem-sucedida ou o reconhecedor não estiver habilitado.

Exceções

InvalidOperationException

O reconhecedor não tem nenhuma gramática de reconhecimento de fala carregada.

ArgumentNullException

inputText é null.

ArgumentException

inputText é a cadeia de caracteres vazia ("").

Exemplos

O exemplo de código abaixo faz parte de um aplicativo de console que demonstra a entrada emulada, os resultados de reconhecimento associados e os eventos associados gerados pelo reconhecedor de fala. O exemplo gera a saída a seguir.

TestRecognize("Smith")...  
 SpeechDetected event raised.  
 SpeechRecognized event raised.  
  Grammar = Smith; Text = Smith  
...Recognition result text = Smith  

TestRecognize("Jones")...  
 SpeechDetected event raised.  
 SpeechRecognized event raised.  
  Grammar = Jones; Text = Jones  
...Recognition result text = Jones  

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

TestRecognize("Mister Smith")...  
 SpeechDetected event raised.  
 SpeechRecognized event raised.  
  Grammar = Smith; Text = mister Smith  
...Recognition result text = mister Smith  

press any key to exit...

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

namespace Sre_EmulateRecognize  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Create an in-process speech recognizer for the en-US locale.  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(new CultureInfo("en-US")))  
      {  

        // Load grammars.  
        recognizer.LoadGrammar(CreateNameGrammar("Smith"));  
        recognizer.LoadGrammar(CreateNameGrammar("Jones"));  

        // Disable audio input to the recognizer.  
        recognizer.SetInputToNull();  

        // Add handlers for events raised by the EmulateRecognize 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);  

        // Start four synchronous emulated recognition operations.  
        TestRecognize(recognizer, "Smith");  
        TestRecognize(recognizer, "Jones");  
        TestRecognize(recognizer, "Mister");  
        TestRecognize(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 synchronous recognition.  
    private static void TestRecognize(  
      SpeechRecognitionEngine recognizer, string input)  
    {  
      Console.WriteLine("TestRecognize(\"{0}\")...", input);  
      RecognitionResult result =  
        recognizer.EmulateRecognize(input,CompareOptions.IgnoreCase);  
      if (result != null)  
      {  
        Console.WriteLine("...Recognition result text = {0}",  
          result.Text ?? "<null>");  
      }  
      else  
      {  
        Console.WriteLine("...No recognition result.");  
      }  
      Console.WriteLine();  
    }  

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

    // Handle events.  
    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.");  
      }  
    }  

    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.");  
      }  
    }  
  }  
}

Comentários

O reconhecedor de fala gera os SpeechDetectedeventos , SpeechHypothesized, SpeechRecognitionRejectede SpeechRecognized como se a operação de reconhecimento não fosse emulada.

Os reconhecedores fornecidos com Vista e Windows 7 ignoram a largura de maiúsculas e minúsculas e caracteres ao aplicar regras gramaticais à frase de entrada. Para obter mais informações sobre esse tipo de comparação, consulte os CompareOptions valores OrdinalIgnoreCase de enumeração e IgnoreWidth. Os reconhecedores também ignoram novas linhas e espaço em branco extra e tratam a pontuação como entrada literal.

Confira também

Aplica-se a

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Origem:: SpeechRecognitionEngine.cs

Origem:: SpeechRecognitionEngine.cs

Origem:: SpeechRecognitionEngine.cs

Emula a entrada de palavras específicas no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala síncrono e especifica como o reconhecedor trata a comparação Unicode entre as palavras e as gramáticas do reconhecimento de fala carregado.

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

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

member this.EmulateRecognize : System.Speech.Recognition.RecognizedWordUnit[] * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult

Public Function EmulateRecognize (wordUnits As RecognizedWordUnit(), compareOptions As CompareOptions) As RecognitionResult

Parâmetros

wordUnits: RecognizedWordUnit[]

Uma matriz de unidades de palavra que contém a entrada da operação de reconhecimento.

compareOptions: CompareOptions

Uma combinação bit a bit dos valores de enumeração que descrevem o tipo de comparação a ser usada para a operação de reconhecimento emulada.

Retornos

RecognitionResult

O resultado da operação de reconhecimento ou null se a operação não for bem-sucedida ou o reconhecedor não estiver habilitado.

Exceções

InvalidOperationException

O reconhecedor não tem nenhuma gramática de reconhecimento de fala carregada.

ArgumentNullException

wordUnits é null.

ArgumentException

wordUnits contém um ou mais elementos null.

NotSupportedException

compareOptions contém o sinalizador IgnoreNonSpace, IgnoreSymbols ou StringSort.

Comentários

O reconhecedor de fala gera os SpeechDetectedeventos , SpeechHypothesized, SpeechRecognitionRejectede SpeechRecognized como se a operação de reconhecimento não fosse emulada.

O reconhecedor usa compareOptions quando aplica regras gramaticais à frase de entrada. Os reconhecedores fornecidos com Vista e Windows 7 ignoram maiúsculas e minúsculas se o OrdinalIgnoreCase valor ou IgnoreCase estiver presente. O reconhecedor sempre ignora a largura do caractere e nunca ignora o tipo Kana. O reconhecedor também ignora novas linhas e espaço em branco extra e trata a pontuação como entrada literal. Para obter mais informações sobre a largura do caractere e o tipo Kana, consulte a CompareOptions enumeração .

Confira também

Aplica-se a

EmulateRecognize(String, CompareOptions)

Origem:: SpeechRecognitionEngine.cs

Origem:: SpeechRecognitionEngine.cs

Origem:: SpeechRecognitionEngine.cs

Emula a entrada de uma frase no reconhecedor de fala usando texto em vez de áudio para o reconhecimento de fala síncrono e especifica como o reconhecedor trata a comparação Unicode entre a frase e as gramáticas do reconhecimento de fala carregado.

public:
 System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText, System::Globalization::CompareOptions compareOptions);

public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText, System.Globalization.CompareOptions compareOptions);

member this.EmulateRecognize : string * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult

Public Function EmulateRecognize (inputText As String, compareOptions As CompareOptions) As RecognitionResult

Parâmetros

inputText: String

A frase de entrada da operação de reconhecimento.

compareOptions: CompareOptions

Uma combinação bit a bit dos valores de enumeração que descrevem o tipo de comparação a ser usada para a operação de reconhecimento emulada.

Retornos

RecognitionResult

O resultado da operação de reconhecimento ou null se a operação não for bem-sucedida ou o reconhecedor não estiver habilitado.

Exceções

InvalidOperationException

O reconhecedor não tem nenhuma gramática de reconhecimento de fala carregada.

ArgumentNullException

inputText é null.

ArgumentException

inputText é a cadeia de caracteres vazia ("").

NotSupportedException

compareOptions contém o sinalizador IgnoreNonSpace, IgnoreSymbols ou StringSort.

Comentários

O reconhecedor de fala gera os SpeechDetectedeventos , SpeechHypothesized, SpeechRecognitionRejectede SpeechRecognized como se a operação de reconhecimento não fosse emulada.

Confira também

Aplica-se a

SpeechRecognitionEngine.EmulateRecognize Método

Definição

Sobrecargas

Comentários

EmulateRecognize(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

EmulateRecognize(String, CompareOptions)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais