SpeechRecognitionEngine.QueryRecognizerSetting(String) 方法

定义

命名空间:

System.Speech.Recognition

程序集:

System.Speech.dll

包:

System.Speech v9.0.0-preview.3.24172.9

Source:

SpeechRecognitionEngine.cs

为识别器返回设置的值。

public:
 System::Object ^ QueryRecognizerSetting(System::String ^ settingName);

public object QueryRecognizerSetting (string settingName);

member this.QueryRecognizerSetting : string -> obj

Public Function QueryRecognizerSetting (settingName As String) As Object

参数

settingName

String

要返回的设置的名称。

返回

Object

设置的值。

例外

ArgumentNullException

settingName 为 null。

ArgumentException

settingName 为空字符串 ("")。

KeyNotFoundException

不用该名称设置的识别器。

示例

以下示例是控制台应用程序的一部分，该应用程序输出为支持 en-US 区域设置的识别器定义的许多设置的值。 该示例生成以下输出。

Settings for recognizer MS-1033-80-DESK:  

  ResourceUsage                  is not supported by this recognizer.  
  ResponseSpeed                  = 150  
  ComplexResponseSpeed           = 500  
  AdaptationOn                   = 1  
  PersistedBackgroundAdaptation  = 1  

Press any key to exit...  

using System;  
using System.Globalization;  
using System.Speech.Recognition;  

namespace RecognizerSettings  
{  
  class Program  
  {  
    static readonly string[] settings = new string[] {  
      "ResourceUsage",  
      "ResponseSpeed",  
      "ComplexResponseSpeed",  
      "AdaptationOn",  
      "PersistedBackgroundAdaptation"  
    };  

    static void Main(string[] args)  
    {  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US")))  
      {  
        Console.WriteLine("Settings for recognizer {0}:",  
          recognizer.RecognizerInfo.Name);  
        Console.WriteLine();  

        foreach (string setting in settings)  
        {  
          try  
          {  
            object value = recognizer.QueryRecognizerSetting(setting);  
            Console.WriteLine("  {0,-30} = {1}", setting, value);  
          }  
          catch  
          {  
            Console.WriteLine("  {0,-30} is not supported by this recognizer.",  
              setting);  
          }  
        }  
      }  
      Console.WriteLine();  

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

注解

识别器设置可以包含字符串、64 位整数或内存地址数据。 下表描述了为Microsoft语音 API (SAPI) 兼容识别器定义的设置。 对于支持设置的每个识别器，以下设置必须具有相同的范围。 支持这些设置不需要符合 SAPI 的识别器，并且可以支持其他设置。

名称	说明
ResourceUsage	指定识别器 CPU 消耗量。 范围为 0 到 100。 默认值为 50。
ResponseSpeed	指示语音识别器完成识别操作之前明确输入结束时的静音长度。 范围为 0 到 10，000 毫秒 (毫秒) 。 此设置对应于识别器的属性 EndSilenceTimeout 。 默认值 = 150 毫秒。
ComplexResponseSpeed	指示在语音识别器完成识别操作之前，在不明确输入结束时的静音长度。 范围为 0 到 10，000 毫秒。 此设置对应于识别器的属性 EndSilenceTimeoutAmbiguous 。 默认值 = 500 毫秒。
AdaptationOn	指示声学模型的适应是 ON (value = 1) 还是 OFF (value = 0) 。 默认值为 1 (ON) 。
PersistedBackgroundAdaptation	指示背景适应是 ON (value = 1) 还是 OFF (value = 0) ，并在注册表中保留设置。 默认值为 1 (ON) 。

若要更新识别器设置，请使用 方法之 UpdateRecognizerSetting 一。

另请参阅

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous