RecognizeCompletedEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour l'événement RecognizeCompleted
déclenché par un objet SpeechRecognitionEngine ou SpeechRecognizer.
public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs
public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
type RecognizeCompletedEventArgs = class
inherit AsyncCompletedEventArgs
Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs
- Héritage
Exemples
L’exemple suivant effectue la reconnaissance vocale asynchrone sur une grammaire de reconnaissance vocale, à l’aide de la SpeechRecognitionEngine.RecognizeAsync méthode avec le module de reconnaissance in-process. L’exemple utilise des Choices objets et GrammarBuilder pour créer la grammaire de reconnaissance vocale avant de la créer dans un Grammar objet . Un gestionnaire pour l’événement SpeechRecognitionEngine.RecognizeCompleted génère des informations sur l’opération de reconnaissance dans la console.
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");
}
}
}
Remarques
Une instance de RecognizeCompleted est créée lorsque l’objet SpeechRecognitionEngine ou SpeechRecognizer déclenche son SpeechRecognized
événement après une RecognizeAsync
opération. Pour plus d’informations sur les événements de reconnaissance vocale, consultez Utilisation des événements de reconnaissance vocale.
Propriétés
AudioPosition |
Obtient l'emplacement du flux audio du périphérique d'entrée associé à l'événement RecognizeCompleted. |
BabbleTimeout |
Obtient une valeur indiquant si un délai d'attente de rumeur a généré l'événement de RecognizeCompleted . |
Cancelled |
Obtient une valeur qui indique si une opération asynchrone a été annulée. (Hérité de AsyncCompletedEventArgs) |
Error |
Obtient une valeur qui indique quelle erreur s'est produite pendant une opération asynchrone. (Hérité de AsyncCompletedEventArgs) |
InitialSilenceTimeout |
Obtient une valeur indiquant si un délai d'attente silencieux a généré l'événement de RecognizeCompleted . |
InputStreamEnded |
Obtient une valeur indiquant si le flux d'entrée est terminé. |
Result |
Obtient la résultat de la reconnaissance. |
UserState |
Obtient l'identificateur unique de la tâche asynchrone. (Hérité de AsyncCompletedEventArgs) |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
RaiseExceptionIfNecessary() |
Lève une exception fournie par l'utilisateur en cas d'échec d'une opération asynchrone. (Hérité de AsyncCompletedEventArgs) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |