SpeechRecognizer.EmulateRecognize Método
Definição
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 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
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
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
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
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
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized