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 ~ 1万ミリ秒 (ms) です。The range is from 0 to 10,000 milliseconds (ms). この設定は、レコグナイザーのEndSilenceTimeoutプロパティに対応しています。This setting corresponds to the recognizer's EndSilenceTimeout property. 既定値は150ミリ秒です。Default = 150ms.
ComplexResponseSpeed 音声認識エンジンが認識操作を完了する前に、あいまいな入力の最後に無音の長さを示します。Indicates the length of silence at the end of ambiguous input before the speech recognizer completes a recognition operation. 範囲は 0 ~ 10, 000ms 秒です。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) かオフ (値 = 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.

適用対象

こちらもご覧ください