Partilhar via


SpeechRecognizer.EmulateRecognize Método

Definição

Emula a entrada para o reconhecedor de fala compartilhado usando texto em vez de áudio para reconhecimento de fala síncrono.

Sobrecargas

EmulateRecognize(String)

Emula a entrada de uma frase para o reconhecedor de fala compartilhado usando texto em vez de áudio para reconhecimento de fala síncrono.

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Emula a entrada de palavras específicas no reconhecedor de fala compartilhado 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 compartilhado 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. Isso pode ser útil quando você está testando ou depurando um aplicativo ou gramática.

Observação

Se o Reconhecimento de Fala do Windows estiver no estado De suspensão , esses métodos retornarão null.

O reconhecedor compartilhado 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 compartilhado 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:
SpeechRecognizer.cs
Origem:
SpeechRecognizer.cs
Origem:
SpeechRecognizer.cs

Emula a entrada de uma frase para o reconhecedor de fala compartilhado usando texto em vez de áudio para 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

O resultado da operação de reconhecimento ou null, se a operação não for bem-sucedida ou se o Reconhecimento de Fala do Windows estiver em estado de Espera.

Exemplos

O exemplo a seguir carrega uma gramática de exemplo para o reconhecedor compartilhado e emula a entrada para o reconhecedor. Se o Reconhecimento de Fala do Windows não estiver em execução, iniciar este aplicativo também iniciará o Reconhecimento de Fala do Windows. Se o Reconhecimento de Fala do Windows estiver no estado De suspensão , EmulateRecognize sempre retornará nulo.

using System;  
using System.Speech.Recognition;  

namespace SharedRecognizer  
{  
  class Program  
  {  

    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);  

        RecognitionResult result;  

        // This EmulateRecognize call matches the grammar and returns a  
        // recognition result.  
        result = recognizer.EmulateRecognize("testing testing");  
        OutputResult(result);  

        // This EmulateRecognize call does not match the grammar and   
        // returns null.  
        result = recognizer.EmulateRecognize("testing one two three");  
        OutputResult(result);  
      }  

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

    // Output information about a recognition result to the console.  
    private static void OutputResult(RecognitionResult result)  
    {  
      if (result != null)  
      {  
        Console.WriteLine("Recognition result = {0}",  
          result.Text ?? "<no text>");  
      }  
      else  
      {  
        Console.WriteLine("No recognition result");  
      }  
    }  
  }  
}  

Comentários

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:
SpeechRecognizer.cs
Origem:
SpeechRecognizer.cs
Origem:
SpeechRecognizer.cs

Emula a entrada de palavras específicas no reconhecedor de fala compartilhado 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

O resultado da operação de reconhecimento ou null, se a operação não for bem-sucedida ou se o Reconhecimento de Fala do Windows estiver em estado de Espera.

Comentários

Esse método cria um RecognitionResult objeto usando as informações fornecidas no wordUnits parâmetro .

O reconhecedor usa o 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. Os reconhecedores sempre ignoram a largura do caractere e nunca ignoram o tipo Kana. Os reconhecedores também ignoram novas linhas e espaço em branco extra e tratam 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:
SpeechRecognizer.cs
Origem:
SpeechRecognizer.cs
Origem:
SpeechRecognizer.cs

Emula a entrada de uma frase no reconhecedor de fala compartilhado 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

O resultado da operação de reconhecimento ou null, se a operação não for bem-sucedida ou se o Reconhecimento de Fala do Windows estiver em estado de Espera.

Comentários

O reconhecedor usa o 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. Os reconhecedores sempre ignoram a largura do caractere e nunca ignoram o tipo Kana. Os reconhecedores também ignoram novas linhas e espaço em branco extra e tratam 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