SpeechRecognitionEngine.QueryRecognizerSetting(String) メソッド

定義

名前空間:

System.Speech.Recognition

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v8.0.0

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 Speech API (SAPI) 準拠の認識エンジンに対して定義されている設定について説明します。 次の設定は、設定をサポートする認識エンジンごとに同じ範囲である必要があります。 SAPI 準拠の認識エンジンは、これらの設定をサポートするために必要ではなく、他の設定をサポートできます。

名前	説明
ResourceUsage	認識エンジンの CPU 消費量を指定します。 範囲は 0 ~ 100 です。 既定値は 50 です。
ResponseSpeed	音声認識エンジンが認識操作を完了する前の、明確な入力の最後の無音の長さを示します。 範囲は 0 から 10,000 ミリ秒 (ミリ秒) です。 この設定は、認識エンジンの EndSilenceTimeout プロパティに対応します。 既定値は 150 ミリ秒です。
ComplexResponseSpeed	音声認識エンジンが認識操作を完了するまでのあいまいな入力の最後の無音の長さを示します。 範囲は 0 から 10,000 ミリ秒です。 この設定は、認識エンジンの EndSilenceTimeoutAmbiguous プロパティに対応します。 既定値は 500 ミリ秒です。
AdaptationOn	音響モデルの適応が ON (値 = ) か OFF (値 = 10) かを示します。 既定値は 1 (ON) です。
PersistedBackgroundAdaptation	バックグラウンド適応が ON (値 = 1) か OFF (値 = 0) かを示し、レジストリに設定を保持します。 既定値は 1 (ON) です。

認識エンジンの設定を更新するには、いずれかのメソッドを UpdateRecognizerSetting 使用します。

こちらもご覧ください

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous