SpeechRecognitionEngine.RecognizeCompleted 事件

定義

命名空間:

System.Speech.Recognition

組件:

System.Speech.dll

套件:

System.Speech v11.0.0-preview.3.26207.106

來源:

SpeechRecognitionEngine.cs

當非 SpeechRecognitionEngine 同步識別操作完成時，會被提出。

public:
 event EventHandler<System::Speech::Recognition::RecognizeCompletedEventArgs ^> ^ RecognizeCompleted;

public event EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs>? RecognizeCompleted;

member this.RecognizeCompleted : EventHandler<System.Speech.Recognition.RecognizeCompletedEventArgs> 

Public Custom Event RecognizeCompleted As EventHandler(Of RecognizeCompletedEventArgs) 

事件類型

EventHandler<RecognizeCompletedEventArgs>

範例

以下範例識別了像是「顯示爵士類別中的藝術家名單」或「顯示福音專輯」等片語。 範例中使用了事件 RecognizeCompleted 處理程序來顯示主控台中辨識結果的資訊。

using System;
using System.Speech.Recognition;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize an in-process speech recognition engine.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine())
      {

        //  Create lists of alternative choices.
        Choices listTypes = new Choices(new string[] { "albums", "artists" });
        Choices genres = new Choices(new string[] {
          "blues", "classical", "gospel", "jazz", "rock" });

        //  Create a GrammarBuilder object and assemble the grammar components.
        GrammarBuilder mediaMenu = new GrammarBuilder("Display");
        mediaMenu.Append("the list of", 0, 1);
        mediaMenu.Append(listTypes);
        mediaMenu.Append("in the", 0, 1);
        mediaMenu.Append(genres);
        mediaMenu.Append("category.", 0, 1);

        //  Build a Grammar object from the GrammarBuilder.
        Grammar mediaMenuGrammar = new Grammar(mediaMenu);
        mediaMenuGrammar.Name = "Media Chooser";

        // Attach event handlers.
        recognizer.RecognizeCompleted +=
          new EventHandler<RecognizeCompletedEventArgs>(recognizer_RecognizeCompleted);
        recognizer.LoadGrammarCompleted +=
          new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);

        // Load the grammar object to the recognizer.
        recognizer.LoadGrammarAsync(mediaMenuGrammar);

        // Set the input to the recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // 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:");
        Console.WriteLine("  Grammar: " + e.Result.Grammar.Name);
        Console.WriteLine("  Recognized text: " + e.Result.Text);
        Console.WriteLine("  Confidence score: " + e.Result.Confidence);
        Console.WriteLine("  Audio position: " + 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)
    {
      Console.WriteLine("Grammar loaded:  " + e.Grammar.Name);
    }
  }
}

備註

SpeechRecognitionEngine物件的方法RecognizeAsync會啟動非同步識別操作。 當識別器完成非同步操作時，會觸發此事件。

使用事件RecognizeCompleted處理程序，你可以在物件中RecognizeCompletedEventArgs存取 。RecognitionResult 若未成功識別， RecognitionResult 將為 null。 要判斷是逾時還是音訊輸入中斷導致識別失敗，你可以存取 、 InitialSilenceTimeoutBabbleTimeout、 或 InputStreamEnded的屬性。

詳情請參閱課程。RecognizeCompletedEventArgs

要取得最佳被拒絕認可候選人的詳細資訊，請為該活動指定處理人員 SpeechRecognitionRejected 。

當你建立 RecognizeCompleted 代理人時，你就能確定處理事件的方法。 要將事件與你的事件處理器關聯，請將該代理的實例加入事件中。 事件處理程序會在事件發生時被呼叫，除非你移除代理。

另請參閱

• RecognizeCompletedEventArgs
• RecognizeAsync()
• SpeechRecognized