SpeechRecognitionEngine.UpdateRecognizerSetting メソッド

定義

名前空間:

System.Speech.Recognition

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-preview.3.24172.9

認識エンジンの設定の値を更新します。

オーバーロード

UpdateRecognizerSetting(String, Int32)	SpeechRecognitionEngine の指定された設定を、指定された整数値で更新します。
UpdateRecognizerSetting(String, String)	指定された音声認識エンジンの設定を、指定された文字列値で更新します。

注釈

認識エンジンの設定には、文字列、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) です。

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

を除き PersistedBackgroundAdaptation、 メソッドを使用して設定された UpdateRecognizerSetting プロパティ値は、 の現在のインスタンスに対してのみ有効であり、その後は既定の SpeechRecognitionEngine設定に戻ります。

、および の各プロパティを使用して、音声認識が音声以外のBabbleTimeoutInitialSilenceTimeoutEndSilenceTimeout入力に応答する方法をEndSilenceTimeoutAmbiguous変更できます。

UpdateRecognizerSetting(String, Int32)

ソース:

SpeechRecognitionEngine.cs

SpeechRecognitionEngine の指定された設定を、指定された整数値で更新します。

public:
 void UpdateRecognizerSetting(System::String ^ settingName, int updatedValue);

public void UpdateRecognizerSetting (string settingName, int updatedValue);

member this.UpdateRecognizerSetting : string * int -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As Integer)

パラメーター

settingName

String

更新する設定の名前。

updatedValue

Int32

設定の新しい値。

例外

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  

Updated settings:  

  ResourceUsage                  is not supported by this recognizer.  
  ResponseSpeed                  = 200  
  ComplexResponseSpeed           = 300  
  AdaptationOn                   = 0  
  PersistedBackgroundAdaptation  = 0  

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();  

        // List the current settings.  
        ListSettings(recognizer);  

        // Change some of the settings.  
        recognizer.UpdateRecognizerSetting("ResponseSpeed", 200);  
        recognizer.UpdateRecognizerSetting("ComplexResponseSpeed", 300);  
        recognizer.UpdateRecognizerSetting("AdaptationOn", 1);  
        recognizer.UpdateRecognizerSetting("PersistedBackgroundAdaptation", 0);  

        Console.WriteLine("Updated settings:");  
        Console.WriteLine();  

        // List the updated settings.  
        ListSettings(recognizer);  
      }  

      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  

    private static void ListSettings(SpeechRecognitionEngine recognizer)  
    {  
      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();  
    }  
  }  
}  

注釈

を除き PersistedBackgroundAdaptation、 メソッドを使用して設定された UpdateRecognizerSetting プロパティ値は、 の現在の SpeechRecognitionEngineインスタンスに対してのみ有効であり、その後は既定の設定に戻ります。 サポートされている設定の説明については、「」を参照してください UpdateRecognizerSetting 。

こちらもご覧ください

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

ソース:

SpeechRecognitionEngine.cs

指定された音声認識エンジンの設定を、指定された文字列値で更新します。

public:
 void UpdateRecognizerSetting(System::String ^ settingName, System::String ^ updatedValue);

public void UpdateRecognizerSetting (string settingName, string updatedValue);

member this.UpdateRecognizerSetting : string * string -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As String)

パラメーター

settingName

String

更新する設定の名前。

updatedValue

String

設定の新しい値。

例外

ArgumentNullException

settingName が nullです。

ArgumentException

settingName が空の文字列 ("") です。

KeyNotFoundException

認識エンジンは、その名前で設定されていません。

注釈

を除き PersistedBackgroundAdaptation、 メソッドを使用して設定された UpdateRecognizerSetting プロパティ値は、 の現在の SpeechRecognitionEngineインスタンスに対してのみ有効であり、その後は既定の設定に戻ります。 サポートされている設定の説明については、「」を参照してください UpdateRecognizerSetting 。

こちらもご覧ください

• QueryRecognizerSetting(String)