SpeechRecognitionEngine 构造函数

参考

定义

命名空间:: System.Speech.Recognition

程序集:: System.Speech.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

SpeechRecognitionEngine()	使用系统的默认语音识别器来初始化 SpeechRecognitionEngine 类的新实例。
SpeechRecognitionEngine(CultureInfo)	使用指定的区域设置的默认语音识别器来初始化 SpeechRecognitionEngine 类的新实例。
SpeechRecognitionEngine(RecognizerInfo)	用 SpeechRecognitionEngine 对象中的信息初始化 RecognizerInfo 来指定要使用的识别器。
SpeechRecognitionEngine(String)	使用字符串参数初始化 SpeechRecognitionEngine 类的新实例，该参数指定要使用的识别器的名称。

注解

你可以 SpeechRecognitionEngine 从以下任意项构造实例：

系统的默认语音识别引擎
按名称指定的特定语音识别引擎
指定的区域设置的默认语音识别引擎
满足您在对象中指定的条件的特定识别引擎 RecognizerInfo 。

在语音识别器开始识别之前，必须至少加载一个语音识别语法，并为识别器配置输入。

若要加载语法，请调用 LoadGrammar 或 LoadGrammarAsync 方法。

若要配置音频输入，请使用以下方法之一：

SpeechRecognitionEngine()

使用系统的默认语音识别器来初始化 SpeechRecognitionEngine 类的新实例。

public:
 SpeechRecognitionEngine();

public SpeechRecognitionEngine ();

Public Sub New ()

注解

在语音识别器开始语音识别之前，必须至少加载一个识别语法，并为识别器配置输入。

若要加载语法，请调用 LoadGrammar 或 LoadGrammarAsync 方法。

若要配置音频输入，请使用以下方法之一：

适用于

SpeechRecognitionEngine(CultureInfo)

使用指定的区域设置的默认语音识别器来初始化 SpeechRecognitionEngine 类的新实例。

public:
 SpeechRecognitionEngine(System::Globalization::CultureInfo ^ culture);

public SpeechRecognitionEngine (System.Globalization.CultureInfo culture);

new System.Speech.Recognition.SpeechRecognitionEngine : System.Globalization.CultureInfo -> System.Speech.Recognition.SpeechRecognitionEngine

Public Sub New (culture As CultureInfo)

参数

culture: CultureInfo

语音识别器必须支持的区域设置。

例外

ArgumentException

未安装的语音识别器都不支持区域设置，或者 culture 为固定区域性。

ArgumentNullException

Culture 为 null。

示例

下面的示例演示了演示基本语音识别的控制台应用程序的一部分，并为 en-us 区域设置初始化了语音识别器。

using System;  
using System.Speech.Recognition;  

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

      // Create an in-process speech recognizer for the en-US locale.  
      using (  
      SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(  
          new System.Globalization.CultureInfo("en-US")))  
      {  

        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Add a handler for the speech recognized event.  
        recognizer.SpeechRecognized +=   
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Start asynchronous, continuous speech recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  

        // Keep the console window open.  
        while (true)  
        {  
          Console.ReadLine();  
        }  
      }  
    }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Recognized text: " + e.Result.Text);  
    }  
  }  
}

注解

Microsoft Windows 和 Speech API 接受所有有效的语言-国家/地区代码。若要使用参数中指定的语言执行语音识别 CultureInfo ，则必须安装支持该语言-国家/地区代码的语音识别引擎。 Microsoft Windows 7 随附的语音识别引擎使用以下语言-国家/地区代码。

半 GB。英语（英国）
en-us。英语（美国）
取消。德语（德国）
es。西班牙语(西班牙)
fr-fr。法语（法国）
ja-jp。日语（日本）
zh-chs-CN。中文（中国）
zh-chs-幼圆。中文（台湾）

还允许使用两个字母的语言代码，例如 "en"、"fr" 或 "es"。

在语音识别器开始识别之前，必须至少加载一个语音识别语法，并为识别器配置输入。

若要加载语法，请调用 LoadGrammar 或 LoadGrammarAsync 方法。

若要配置音频输入，请使用以下方法之一：

适用于

SpeechRecognitionEngine(RecognizerInfo)

用 SpeechRecognitionEngine 对象中的信息初始化 RecognizerInfo 来指定要使用的识别器。

public:
 SpeechRecognitionEngine(System::Speech::Recognition::RecognizerInfo ^ recognizerInfo);

public SpeechRecognitionEngine (System.Speech.Recognition.RecognizerInfo recognizerInfo);

new System.Speech.Recognition.SpeechRecognitionEngine : System.Speech.Recognition.RecognizerInfo -> System.Speech.Recognition.SpeechRecognitionEngine

Public Sub New (recognizerInfo As RecognizerInfo)

参数

recognizerInfo: RecognizerInfo

特定语音识别器的信息。

示例

下面的示例演示了演示基本语音识别的控制台应用程序的一部分，并初始化了支持英语的语音识别器。

 using System;  
using System.Speech.Recognition;  

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

      // Select a speech recognizer that supports English.  
      RecognizerInfo info = null;  
      foreach (RecognizerInfo ri in SpeechRecognitionEngine.InstalledRecognizers())  
      {  
        if (ri.Culture.TwoLetterISOLanguageName.Equals("en"))  
        {  
          info = ri;  
          break;  
        }  
      }  
      if (info == null) return;  

      // Create the selected recognizer.  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(info))  
      {  

        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Add a handler for the speech recognized event.  
        recognizer.SpeechRecognized +=   
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Start asynchronous, continuous speech recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  

        // Keep the console window open.  
        while (true)  
        {  
          Console.ReadLine();  
        }  
      }  
    }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Recognized text: " + e.Result.Text);  
    }  
  }  
}

注解

可以为任何已安装的语音识别器创建此类的实例。若要获取有关已安装的识别器的信息，请使用 InstalledRecognizers 方法。

在语音识别器开始识别之前，必须至少加载一个语音识别语法，并为识别器配置输入。

若要加载语法，请调用 LoadGrammar 或 LoadGrammarAsync 方法。

若要配置音频输入，请使用以下方法之一：

适用于

SpeechRecognitionEngine(String)

使用字符串参数初始化 SpeechRecognitionEngine 类的新实例，该参数指定要使用的识别器的名称。

public:
 SpeechRecognitionEngine(System::String ^ recognizerId);

public SpeechRecognitionEngine (string recognizerId);

new System.Speech.Recognition.SpeechRecognitionEngine : string -> System.Speech.Recognition.SpeechRecognitionEngine

Public Sub New (recognizerId As String)

参数

recognizerId: String

使用一个识别器的标记名称。

例外

ArgumentException

没有带有此标记名称的语音识别器未安装，或者 recognizerId 是空字符串 ("")。

ArgumentNullException

recognizerId 为 null。

示例

下面的示例演示了演示基本语音识别的控制台应用程序的一部分，并创建了语音识别 8.0 for Windows (英语-US) 的实例。

using System;  
using System.Speech.Recognition;  

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

      // Create an instance of the Microsoft Speech Recognizer 8.0 for  
      // Windows (English - US).  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine("MS-1033-80-DESK"))  
      {  

        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Add a handler for the speech recognized event.  
        recognizer.SpeechRecognized += new EventHandler(recognizer_SpeechRecognized);  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Start asynchronous, continuous speech recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  

        // Keep the console window open.  
        while (true)  
        {  
          Console.ReadLine();  
        }  
      }  
    }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Recognized text: " + e.Result.Text);  
    }  
  }  
}

注解

识别器的标记名称是 Id RecognizerInfo 由识别器的属性返回的对象的属性值 RecognizerInfo 。若要获取所有已安装的识别器的集合，请使用静态 InstalledRecognizers 方法。

在语音识别器开始识别之前，必须至少加载一个语音识别语法，并为识别器配置输入。

若要加载语法，请调用 LoadGrammar 或 LoadGrammarAsync 方法。

若要配置音频输入，请使用以下方法之一：

适用于

SpeechRecognitionEngine 构造函数

定义

重载

注解

SpeechRecognitionEngine()

注解

适用于

SpeechRecognitionEngine(CultureInfo)

参数

例外

示例

注解

适用于

SpeechRecognitionEngine(RecognizerInfo)

参数

示例

注解

适用于

SpeechRecognitionEngine(String)

参数

例外

示例

注解

适用于

其他资源