SpeechRecognitionEngine.QueryRecognizerSetting(String) 方法

定義

命名空間:

System.Speech.Recognition

組件:

System.Speech.dll

傳回辨識器的設定值。

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到10000毫秒 (ms) 。 此設定對應于辨識器的 EndSilenceTimeout 屬性。 預設值 = 150ms。
ComplexResponseSpeed	表示在語音辨識器完成辨識作業之前，不明確輸入結束時的無回應長度。 範圍是從0到10，毫秒。 此設定對應于辨識器的 EndSilenceTimeoutAmbiguous 屬性。 預設值 = 500 毫秒。
AdaptationOn	指出聲場模型是否 (值 = 1) 或 OFF (值 = 0) 。 1) 上 (預設值。
PersistedBackgroundAdaptation	指出背景調適 (值 = 1) 或 OFF (值 = 0) ，並將設定保存在登錄中。 1) 上 (預設值。

若要更新辨識器的設定，請使用其中一種 UpdateRecognizerSetting 方法。

另請參閱

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous