RecognizeCompletedEventArgs Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt gegevens voor de RecognizeCompleted gebeurtenis die wordt gegenereerd door een SpeechRecognitionEngine of een SpeechRecognizer object.
public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs
public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
type RecognizeCompletedEventArgs = class
inherit AsyncCompletedEventArgs
Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs
- Overname
Voorbeelden
In het volgende voorbeeld wordt asynchrone spraakherkenning uitgevoerd op een grammatica van spraakherkenning, met behulp van de SpeechRecognitionEngine.RecognizeAsync methode met de in-process recognizer. In het voorbeeld worden Choices en objecten gebruikt om GrammarBuilder de grammatica van spraakherkenning te maken voordat u deze in een Grammar object inbouwt. Een handler voor de SpeechRecognitionEngine.RecognizeCompleted gebeurtenis voert informatie uit over de herkenningsbewerking naar de 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");
}
}
}
Opmerkingen
Er wordt een exemplaar van RecognizeCompleted gemaakt wanneer het object de SpeechRecognitionEngineSpeechRecognizer gebeurtenis genereert SpeechRecognized nadat een RecognizeAsync bewerking is voltooid. Zie Spraakherkenningsevenementen gebruiken voor meer informatie over spraakherkenningsevenementen.
Eigenschappen
| Name | Description |
|---|---|
| AudioPosition |
Hiermee haalt u de locatie op in de audiostream van het invoerapparaat die is gekoppeld aan de RecognizeCompleted gebeurtenis. |
| BabbleTimeout |
Hiermee wordt een waarde opgehaald die aangeeft of een time-out voor babble de RecognizeCompleted gebeurtenis heeft gegenereerd. |
| Cancelled |
Hiermee wordt een waarde opgehaald die aangeeft of een asynchrone bewerking is geannuleerd. (Overgenomen van AsyncCompletedEventArgs) |
| Error |
Hiermee wordt een waarde opgehaald die aangeeft welke fout is opgetreden tijdens een asynchrone bewerking. (Overgenomen van AsyncCompletedEventArgs) |
| InitialSilenceTimeout |
Hiermee wordt een waarde opgehaald die aangeeft of een time-out voor de eerste stilte de RecognizeCompleted gebeurtenis heeft gegenereerd. |
| InputStreamEnded |
Hiermee wordt een waarde opgehaald die aangeeft of de invoerstroom is beƫindigd. |
| Result |
Hiermee haalt u het herkenningsresultaat op. |
| UserState |
Hiermee haalt u de unieke id voor de asynchrone taak op. (Overgenomen van AsyncCompletedEventArgs) |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| RaiseExceptionIfNecessary() |
Genereert een door de gebruiker opgegeven uitzondering als een asynchrone bewerking is mislukt. (Overgenomen van AsyncCompletedEventArgs) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |