RecognizeCompletedEventArgs Klasa
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Udostępnia dane dla zdarzenia zgłoszonego RecognizeCompleted przez SpeechRecognitionEngine obiekt lub SpeechRecognizer .
public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs
public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
type RecognizeCompletedEventArgs = class
inherit AsyncCompletedEventArgs
Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs
- Dziedziczenie
Przykłady
Poniższy przykład wykonuje asynchroniczne rozpoznawanie mowy w gramatyce rozpoznawania mowy przy użyciu SpeechRecognitionEngine.RecognizeAsync metody z rozpoznawaniem w procesie. W przykładzie użyto obiektów Choices i GrammarBuilder do utworzenia gramatyki rozpoznawania mowy przed utworzeniem Grammar jej w obiekcie. Procedura obsługi zdarzeń SpeechRecognitionEngine.RecognizeCompleted generuje informacje o operacji rozpoznawania w konsoli programu .
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");
}
}
}
Uwagi
Wystąpienie RecognizeCompleted obiektu jest tworzone, gdy SpeechRecognitionEngine obiekt lub SpeechRecognizer zgłasza jego SpeechRecognized zdarzenie po zakończeniu RecognizeAsync operacji. Aby uzyskać więcej informacji na temat zdarzeń rozpoznawania mowy, zobacz Using Speech Recognition Events (Używanie zdarzeń rozpoznawania mowy).
Właściwości
| Nazwa | Opis |
|---|---|
| AudioPosition |
Pobiera lokalizację w strumieniu audio urządzenia wejściowego skojarzonym ze zdarzeniem RecognizeCompleted . |
| BabbleTimeout |
Pobiera wartość wskazującą, czy limit czasu babble wygenerował RecognizeCompleted zdarzenie. |
| Cancelled |
Pobiera wartość wskazującą, czy operacja asynchroniczna została anulowana. (Dziedziczone od AsyncCompletedEventArgs) |
| Error |
Pobiera wartość wskazującą, który błąd wystąpił podczas operacji asynchronicznej. (Dziedziczone od AsyncCompletedEventArgs) |
| InitialSilenceTimeout |
Pobiera wartość wskazującą, czy początkowy limit czasu ciszy wygenerował RecognizeCompleted zdarzenie. |
| InputStreamEnded |
Pobiera wartość wskazującą, czy strumień wejściowy zakończył się. |
| Result |
Pobiera wynik rozpoznawania. |
| UserState |
Pobiera unikatowy identyfikator zadania asynchronicznego. (Dziedziczone od AsyncCompletedEventArgs) |
Metody
| Nazwa | Opis |
|---|---|
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od Object) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Dziedziczone od Object) |
| GetType() |
Type Pobiera bieżące wystąpienie. (Dziedziczone od Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object) |
| RaiseExceptionIfNecessary() |
Zgłasza wyjątek dostarczony przez użytkownika, jeśli operacja asynchroniczna nie powiodła się. (Dziedziczone od AsyncCompletedEventArgs) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object) |