RecognizeCompletedEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona datos para el evento RecognizeCompleted
provocado por un objeto SpeechRecognitionEngine o SpeechRecognizer.
public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs
public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
type RecognizeCompletedEventArgs = class
inherit AsyncCompletedEventArgs
Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs
- Herencia
Ejemplos
En el ejemplo siguiente se realiza el reconocimiento de voz asincrónico en una gramática de reconocimiento de voz mediante el SpeechRecognitionEngine.RecognizeAsync método con el reconocedor en proceso. En el ejemplo se usan Choices objetos y GrammarBuilder para crear la gramática de reconocimiento de voz antes de compilarla en un Grammar objeto . Un controlador para el SpeechRecognitionEngine.RecognizeCompleted evento genera información sobre la operación de reconocimiento en la consola.
using System;
using System.Speech.Recognition;
namespace SampleRecognition
{
class Program
{
private static SpeechRecognitionEngine recognizer;
public static void Main(string[] args)
{
// Initialize a SpeechRecognitionEngine object and set its input.
recognizer = new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US"));
recognizer.SetInputToDefaultAudioDevice();
// Configure recognition parameters.
recognizer.InitialSilenceTimeout = TimeSpan.FromSeconds(5.0);
recognizer.BabbleTimeout = TimeSpan.FromSeconds(3.0);
recognizer.EndSilenceTimeout = TimeSpan.FromSeconds(1.0);
recognizer.EndSilenceTimeoutAmbiguous = TimeSpan.FromSeconds(1.0);
// Add a handler for the LoadGrammarCompleted event.
recognizer.LoadGrammarCompleted +=
new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);
// Add a handler for the RecognizeCompleted event.
recognizer.RecognizeCompleted +=
new EventHandler<RecognizeCompletedEventArgs>(recognizer_RecognizeCompleted);
// Create a speech recognition grammar and build it into a Grammar object.
Choices bankingMenu = new Choices(new string[]
{ "Access accounts", "Transfer funds", "Pay bills", "Get loan balance" });
GrammarBuilder banking = new GrammarBuilder(bankingMenu);
Grammar bankGrammar = new Grammar(banking);
bankGrammar.Name = "Banking Menu";
// Load the Grammar objects to the recognizer.
recognizer.LoadGrammarAsync(bankGrammar);
// Start asynchronous, continuous recognition.
recognizer.RecognizeAsync();
// Keep the console window open.
Console.ReadLine();
}
// Handle the RecognizeCompleted event.
static void recognizer_RecognizeCompleted(object sender, RecognizeCompletedEventArgs e)
{
if (e.Error != null)
{
Console.WriteLine(
"RecognizeCompleted, error occurred during recognition: {0}", e.Error);
return;
}
if (e.InitialSilenceTimeout || e.BabbleTimeout)
{
Console.WriteLine(
"RecognizeCompleted: BabbleTimeout({0}), InitialSilenceTimeout({1}).",
e.BabbleTimeout, e.InitialSilenceTimeout);
return;
}
if (e.InputStreamEnded)
{
Console.WriteLine(
"RecognizeCompleted: AudioPosition({0}), InputStreamEnded({1}).",
e.AudioPosition, e.InputStreamEnded);
}
if (e.Result != null)
{
Console.WriteLine(
"RecognizeCompleted: Grammar ({0}), Text ({1}), Confidence ({2}), AudioPosition ({3}).",
e.Result.Grammar.Name, e.Result.Text, e.Result.Confidence, e.AudioPosition);
}
else
{
Console.WriteLine("RecognizeCompleted: No result.");
}
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
// Handle the LoadGrammarCompleted event.
static void recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)
{
string grammarName = e.Grammar.Name;
bool grammarLoaded = e.Grammar.Loaded;
bool grammarEnabled = e.Grammar.Enabled;
if (e.Error != null)
{
Console.WriteLine("LoadGrammar for {0} failed with a {1}.",
grammarName, e.Error.GetType().Name);
// Add exception handling code here.
}
Console.WriteLine("Grammar {0} {1} loaded and {2} enabled.", grammarName,
(grammarLoaded) ? "is" : "is not", (grammarEnabled) ? "is" : "is not");
}
}
}
Comentarios
Se crea una instancia de cuando el SpeechRecognitionEngineSpeechRecognizer objeto o genera su SpeechRecognized
evento después de RecognizeCompleted completar una RecognizeAsync
operación. Para obtener más información sobre los eventos de reconocimiento de voz, consulte Uso de eventos de reconocimiento de voz.
Propiedades
AudioPosition |
Obtiene la ubicación en el flujo de audio del dispositivo de entrada asociado al evento de RecognizeCompleted. |
BabbleTimeout |
Obtiene un valor que indica si un tiempo de espera de habla generó el evento RecognizeCompleted. |
Cancelled |
Obtiene un valor que indica si se ha cancelado una operación asincrónica. (Heredado de AsyncCompletedEventArgs) |
Error |
Obtiene un valor que indica el error que se produjo durante una operación asincrónica. (Heredado de AsyncCompletedEventArgs) |
InitialSilenceTimeout |
Obtiene un valor que indica si un tiempo de espera inicial de silencio generó el evento RecognizeCompleted. |
InputStreamEnded |
Obtiene un valor que indica si el flujo de entrada finalizó. |
Result |
Obtiene el resultado de reconocimiento. |
UserState |
Obtiene el identificador único de la tarea asincrónica. (Heredado de AsyncCompletedEventArgs) |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
RaiseExceptionIfNecessary() |
Genera una excepción proporcionada por el usuario si se ha producido un error en una operación asincrónica. (Heredado de AsyncCompletedEventArgs) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |