SpeechRecognitionEngine.QueryRecognizerSetting(String) SpeechRecognitionEngine.QueryRecognizerSetting(String) SpeechRecognitionEngine.QueryRecognizerSetting(String) SpeechRecognitionEngine.QueryRecognizerSetting(String) Method

定義

レコグナイザーの設定の値を返します。Returns the values of settings for the recognizer.

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 String String String

返す設定の名前です。The name of the setting to return.

戻り値

設定値。The value of the setting.

例外

settingName が空の文字列 ("") です。settingName is the empty string ("").

認識エンジンは、その名前で設定されていません。The recognizer does not have a setting by that name.

次の例は、EN-US ロケールをサポートする認識エンジンに定義された設定数の値を出力するコンソール アプリケーションの一部です。The following example is part of a console application that outputs the values for a number of the settings defined for the recognizer that supports the en-US locale. 例では、次の出力を生成します。The example generates the following output.

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 ビットの整数、またはメモリ アドレス データに含めることができます。Recognizer settings can contain string, 64-bit integer, or memory address data. 次の表に、Microsoft Speech API (SAPI) が定義されている設定に準拠しているレコグナイザーします。The following table describes the settings that are defined for a Microsoft Speech API (SAPI)-compliant recognizer. 次の設定では、設定をサポートする各認識エンジンと同じ範囲が必要です。The following settings must have the same range for each recognizer that supports the setting. SAPI 準拠の認識エンジンでは、これらの設定をサポートする必要はありませんし、その他の設定をサポートすることができます。A SAPI-compliant recognizer is not required to support these settings and can support other settings.

nameName 説明Description
ResourceUsage 認識エンジンの CPU 使用量を指定します。Specifies the recognizer's CPU consumption. 範囲は 0 ~ 100 です。The range is from 0 to 100. 既定値は 50 です。The default value is 50.
ResponseSpeed 音声認識エンジンが認識操作を完了する前に、明確な入力の末尾に無音状態の長さを示します。Indicates the length of silence at the end of unambiguous input before the speech recognizer completes a recognition operation. 範囲は 0 ~ 10,000 ミリ秒 (ms) です。The range is from 0 to 10,000 milliseconds (ms). この設定は、認識エンジンに対する対応EndSilenceTimeoutプロパティ。This setting corresponds to the recognizer's EndSilenceTimeout property. 既定の 150ms を = です。Default = 150ms.
ComplexResponseSpeed 音声認識エンジンが認識操作を完了する前に、あいまいな入力の末尾に無音状態の長さを示します。Indicates the length of silence at the end of ambiguous input before the speech recognizer completes a recognition operation. 範囲は 0 ~ 10,000 ミリ秒です。The range is from 0 to 10,000ms. この設定は、認識エンジンに対する対応EndSilenceTimeoutAmbiguousプロパティ。This setting corresponds to the recognizer's EndSilenceTimeoutAmbiguous property. 既定の 500 ミリ秒になります。Default = 500ms.
AdaptationOn 音響モデル適応は ON です。 かどうかを示します (値 = 1) または OFF (値 = 0)。Indicates whether adaptation of the acoustic model is ON (value = 1) or OFF (value = 0). 既定値は1(ON)。The default value is 1 (ON).
PersistedBackgroundAdaptation バック グラウンドで調整がオンかどうかを示します (値 = 1) または OFF (値 = 0)、レジストリの設定が引き続き発生するとします。Indicates whether background adaptation is ON (value = 1) or OFF (value = 0), and persists the setting in the registry. 既定値は1(ON)。The default value is 1 (ON).

認識エンジンの設定を更新するには、いずれかを使用、UpdateRecognizerSettingメソッド。To update a setting for the recognizer, use one of the UpdateRecognizerSetting methods.

適用対象

こちらもご覧ください