RecognizeCompletedEventArgs Kelas

Definisi

Ruang nama:

System.Speech.Recognition

Rakitan:

System.Speech.dll

Paket:

System.Speech v9.0.0-rc.2.24473.5

Sumber:

RecognizeCompletedEventArgs.cs

Menyediakan data untuk peristiwa yang RecognizeCompleted dimunculkan oleh SpeechRecognitionEngine objek atau SpeechRecognizer .

public ref class RecognizeCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class RecognizeCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type RecognizeCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class RecognizeCompletedEventArgs
Inherits AsyncCompletedEventArgs

Warisan

Object

EventArgs

AsyncCompletedEventArgs

RecognizeCompletedEventArgs

Contoh

Contoh berikut melakukan pengenalan ucapan asinkron pada tata bahasa pengenalan ucapan, menggunakan SpeechRecognitionEngine.RecognizeAsync metode dengan pengenal dalam proses. Contoh menggunakan Choices objek dan GrammarBuilder untuk membuat tata bahasa pengenalan ucapan sebelum membangunnya menjadi Grammar objek. Handler untuk SpeechRecognitionEngine.RecognizeCompleted informasi output peristiwa tentang operasi pengenalan ke konsol.

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");  
    }  
  }            
}  

Keterangan

Instans RecognizeCompleted dibuat ketika SpeechRecognitionEngine atau SpeechRecognizer objek menaikkan peristiwanya SpeechRecognized setelah menyelesaikan RecognizeAsync operasi. Untuk informasi selengkapnya tentang peristiwa pengenalan ucapan, lihat Menggunakan Peristiwa Pengenalan Ucapan.

Properti

AudioPosition	Mendapatkan lokasi dalam aliran audio perangkat input yang terkait dengan peristiwa.RecognizeCompleted
BabbleTimeout	Mendapatkan nilai yang menunjukkan apakah batas waktu babble menghasilkan RecognizeCompleted peristiwa.
Cancelled	Mendapatkan nilai yang menunjukkan apakah operasi asinkron telah dibatalkan. (Diperoleh dari AsyncCompletedEventArgs)
Error	Mendapatkan nilai yang menunjukkan kesalahan mana yang terjadi selama operasi asinkron. (Diperoleh dari AsyncCompletedEventArgs)
InitialSilenceTimeout	Mendapatkan nilai yang menunjukkan apakah batas waktu keheningan awal menghasilkan RecognizeCompleted peristiwa.
InputStreamEnded	Mendapatkan nilai yang menunjukkan apakah aliran input berakhir.
Result	Mendapatkan hasil pengenalan.
UserState	Mendapatkan pengidentifikasi unik untuk tugas asinkron. (Diperoleh dari AsyncCompletedEventArgs)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RaiseExceptionIfNecessary()	Meningkatkan pengecualian yang disediakan pengguna jika operasi asinkron gagal. (Diperoleh dari AsyncCompletedEventArgs)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• SpeechRecognitionEngine
• RecognizeCompleted
• RecognizeAsync()
• EmulateRecognizeCompletedEventArgs