SpeechRecognizer 类

定义

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

继承

Object

SpeechRecognizer

实现

IDisposable

示例

以下示例是控制台应用程序的一部分，该应用程序加载语音识别语法并演示异步仿真输入、关联的识别结果以及语音识别器引发的关联事件。 如果 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;  

        // Start asynchronous emulated recognition.   
        // This matches the grammar and generates a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing testing");  

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

        completed = false;  

        // Start asynchronous emulated recognition.  
        // This 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 SpeechRecognizeCompleted 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;  
    }  
  }  
}  

注解

应用程序使用共享识别器访问 Windows 语音识别。 SpeechRecognizer使用 对象添加到 Windows 语音用户体验。

此类提供对语音识别过程的各个方面的控制：

• 若要管理语音识别语法，请使用 LoadGrammar、、LoadGrammarAsyncUnloadGrammar、 UnloadAllGrammars和 Grammars。

• 若要获取有关当前语音识别操作的信息，请 SpeechRecognizer订阅 的 SpeechDetected、 SpeechHypothesized、 SpeechRecognitionRejected和 SpeechRecognized 事件。

• 若要查看或修改识别器返回的备用结果数，请使用 MaxAlternates 属性。 识别器在 对象中 RecognitionResult 返回识别结果。

• 若要访问或监视共享识别器的状态，请使用 AudioLevel、、AudioPosition、 RecognizerAudioPositionEnabledAudioStatePauseRecognizerOnRecognition和 State 属性以及 AudioLevelUpdated、AudioSignalProblemOccurred、 AudioStateChanged和 StateChanged 事件。

• 若要同步对识别器所做的更改，请使用 RequestRecognizerUpdate 方法。 共享识别器使用多个线程来执行任务。

• 若要模拟共享识别器输入，请使用 EmulateRecognize 和 EmulateRecognizeAsync 方法。

Windows 语音识别的配置通过使用控制面板中的“语音属性”对话框进行管理。 此接口用于选择默认桌面语音识别引擎和语言、音频输入设备以及语音识别的睡眠行为。 如果在应用程序运行时更改了 Windows 语音识别的配置， (例如，如果语音识别被禁用或输入语言) 更改，则更改会影响所有 SpeechRecognizer 对象。

若要创建独立于 Windows 语音识别的进程内语音识别器，请使用 SpeechRecognitionEngine 类。

构造函数

属性

方法

事件

适用于

另请参阅

• SpeechRecognitionEngine
• Grammar
• RecognitionResult