SpeechRecognizer.EmulateRecognize Método

Definição

Espaço de Nomes:: System.Speech.Recognition

Assemblagem:: System.Speech.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Emula a entrada do reconhecedor de voz partilhada, usando texto em vez de áudio para reconhecimento de voz síncrono.

Sobrecargas

Name	Description
EmulateRecognize(String)	Emula a entrada de uma frase no reconhecimento de voz partilhado, usando texto em vez de áudio para reconhecimento de fala síncrono.
EmulateRecognize(RecognizedWordUnit[], CompareOptions)	Emula a entrada de palavras específicas para o reconhecedor de fala partilhado, usando texto em vez de áudio para reconhecimento de fala síncrono, e especifica como o reconhecor lida com a comparação Unicode entre as palavras e as gramáticas de reconhecimento de fala carregadas.
EmulateRecognize(String, CompareOptions)	Emula a entrada de uma frase para o reconhecedor de voz partilhado, usando texto em vez de áudio para reconhecimento de fala síncrono, e especifica como o reconhecor lida com a comparação Unicode entre a frase e as gramáticas de reconhecimento de fala carregadas.

Observações

Estes métodos contornam a entrada de áudio do sistema. Isto pode ser útil quando está a testar ou a depurar uma aplicação ou gramática.

Note

Se Windows Reconhecimento de Fala estiver no estado Sleeping, então estes métodos retornam null.

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

Note

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

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

EmulateRecognize(String)

Emula a entrada de uma frase no reconhecimento de voz partilhado, 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 para a operação de reconhecimento.

Devoluções

RecognitionResult

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

Exemplos

O exemplo seguinte carrega uma gramática de exemplo para o reconhecedor partilhado e emula a entrada para o reconhecedor. Se o Reconhecimento de Fala do Windows não estiver a funcionar, então iniciar esta aplicação também iniciará o Reconhecimento de Fala do Windows. Se Windows Reconhecimento de Fala estiver no estado Sleeping, então EmulateRecognize devolve sempre 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");
      }
    }
  }
}

Observações

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

Ver também

Aplica-se a

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Emula a entrada de palavras específicas para o reconhecedor de fala partilhado, usando texto em vez de áudio para reconhecimento de fala síncrono, e especifica como o reconhecor lida com a comparação Unicode entre as palavras e as gramáticas de reconhecimento de fala carregadas.

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[]

Um array de unidades de palavra que contém a entrada para a operação de reconhecimento.

compareOptions: CompareOptions

Uma combinação bit a bit dos valores de enumeração que descreve o tipo de comparação a usar para a operação de reconhecimento emulado.

Devoluções

RecognitionResult

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

Observações

Este método cria um RecognitionResult objeto usando a informação fornecida no wordUnits parâmetro.

O reconhecedor usa o compareOptions quando aplica regras gramaticais à frase de entrada. Os reconhecedores que são enviados com Vista e Windows 7 ignoram o caso se o valor OrdinalIgnoreCase ou IgnoreCase estiver presente. Os reconhecedores ignoram sempre a largura do carácter e nunca ignoram o tipo Kana. Os reconhecedores também ignoram novas linhas e espaços em branco extra e tratam a pontuação como entrada literal. Para mais informações sobre largura de caracteres e tipo Kana, consulte a CompareOptions enumeração.

Ver também

Aplica-se a

EmulateRecognize(String, CompareOptions)

Emula a entrada de uma frase para o reconhecedor de voz partilhado, usando texto em vez de áudio para reconhecimento de fala síncrono, e especifica como o reconhecor lida com a comparação Unicode entre a frase e as gramáticas de reconhecimento de fala carregadas.

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 para a operação de reconhecimento.

compareOptions: CompareOptions

Uma combinação bit a bit dos valores de enumeração que descreve o tipo de comparação a usar para a operação de reconhecimento emulado.

Devoluções

RecognitionResult

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

Observações

Ver também

Aplica-se a

Comentários

Esta página foi útil?