SpeechRecognizer.EmulateRecognizeCompleted 事件

public:
 event EventHandler<System::Speech::Recognition::EmulateRecognizeCompletedEventArgs ^> ^ EmulateRecognizeCompleted;

public event EventHandler<System.Speech.Recognition.EmulateRecognizeCompletedEventArgs>? EmulateRecognizeCompleted;

public event EventHandler<System.Speech.Recognition.EmulateRecognizeCompletedEventArgs> EmulateRecognizeCompleted;

member this.EmulateRecognizeCompleted : EventHandler<System.Speech.Recognition.EmulateRecognizeCompletedEventArgs> 

Public Custom Event EmulateRecognizeCompleted As EventHandler(Of EmulateRecognizeCompletedEventArgs) 

Public Event EmulateRecognizeCompleted As EventHandler(Of EmulateRecognizeCompletedEventArgs) 

事件类型

示例

以下示例是加载语音识别语法并演示异步模拟输入、关联识别结果以及语音识别器引发的相关事件的控制台应用程序的一部分。 如果 Windows 语音识别未运行，则启动此应用程序也会启动 Windows 语音识别。 如果 Windows 语音识别处于 睡眠 模式，则 EmulateRecognizeAsync 始终返回 null。

using System;
using System.Speech.Recognition;
using System.Threading;

namespace SharedRecognizer
{
  class Program
  {
    // Indicate whether the asynchronous emulate recognition
    // operation has completed.
    static bool completed;

    static void Main(string[] args)
    {

      // Initialize an instance of the shared recognizer.
      using (SpeechRecognizer recognizer = new SpeechRecognizer())
      {
        // Create and load a sample grammar.
        Grammar testGrammar =
          new Grammar(new GrammarBuilder("testing testing"));
        testGrammar.Name = "Test Grammar";
        recognizer.LoadGrammar(testGrammar);

        // Attach event handlers for recognition events.
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(SpeechRecognizedHandler);
        recognizer.EmulateRecognizeCompleted +=
          new EventHandler<EmulateRecognizeCompletedEventArgs>(
            EmulateRecognizeCompletedHandler);

        completed = false;

        // This EmulateRecognizeAsync call generates a SpeechRecognized event.
        recognizer.EmulateRecognizeAsync("testing testing");

        // Wait for the asynchronous operation to complete.
        while (!completed)
        {
          Thread.Sleep(333);
        }

        completed = false;

        // This EmulateRecognizeAsync call does not match the grammar
        // or generate a SpeechRecognized event.
        recognizer.EmulateRecognizeAsync("testing one two three");

        // Wait for the asynchronous operation to complete.
        while (!completed)
        {
          Thread.Sleep(333);
        }
      }

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }

    // Handle the SpeechRecognized event.
    static void SpeechRecognizedHandler(
      object sender, SpeechRecognizedEventArgs e)
    {
      if (e.Result != null)
      {
        Console.WriteLine("Recognition result = {0}",
          e.Result.Text ?? "<no text>");
      }
      else
      {
        Console.WriteLine("No recognition result");
      }
    }

    // Handle the EmulateRecognizeCompleted event.
    static void EmulateRecognizeCompletedHandler(
      object sender, EmulateRecognizeCompletedEventArgs e)
    {
      if (e.Result == null)
      {
        Console.WriteLine("No result generated.");
      }

      // Indicate the asynchronous operation is complete.
      completed = true;
    }
  }
}

注解

每个 EmulateRecognizeAsync 方法都开始异步识别操作。 识别器在完成异步操作时引发 EmulateRecognizeCompleted 事件。

异步识别操作可以引发 SpeechDetected、SpeechHypothesizedSpeechRecognitionRejected和SpeechRecognized事件。 事件 EmulateRecognizeCompleted 是识别器为给定操作引发的最后一个此类事件。

为 EmulateRecognizeCompleted 事件创建委托时，可以标识将处理该事件的方法。 若要将事件与事件处理程序相关联，请将委托的实例添加到事件。 除非删除委托，否则每当事件发生时调用事件处理程序。

另请参阅

• EmulateRecognizeCompletedEventArgs
• EmulateRecognizeAsync(String)
• SpeechDetected
• SpeechHypothesized
• SpeechRecognitionRejected
• SpeechRecognized