RecognizeCompletedEventArgs Klas

Definitie

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
RecognizeCompletedEventArgs

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)

Van toepassing op

Zie ook