RecognizeCompletedEventArgs Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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. (Odziedziczone po AsyncCompletedEventArgs) |
Error |
Pobiera wartość wskazującą, który błąd wystąpił podczas operacji asynchronicznej. (Odziedziczone po 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. (Odziedziczone po AsyncCompletedEventArgs) |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
RaiseExceptionIfNecessary() |
Zgłasza wyjątek dostarczony przez użytkownika, jeśli operacja asynchroniczna nie powiodła się. (Odziedziczone po AsyncCompletedEventArgs) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |