SpeechRecognitionEngine.QueryRecognizerSetting(String) 方法

定义

为识别器返回设置的值。

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

要返回的设置的名称。

返回

设置的值。

例外

settingNamenull

settingName 为空字符串 ("")。

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

示例

以下示例是控制台应用程序的一部分,该应用程序输出为支持 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 一。

适用于

另请参阅