SpeechRecognitionEngine.UpdateRecognizerSetting メソッド

定義

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

オーバーロード

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.cs
ソース:
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

設定の新しい値。

例外

settingNamenullです。

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

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

次の例は、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

こちらもご覧ください

適用対象

UpdateRecognizerSetting(String, String)

ソース:
SpeechRecognitionEngine.cs
ソース:
SpeechRecognitionEngine.cs
ソース:
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

設定の新しい値。

例外

settingNamenullです。

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

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

注釈

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

こちらもご覧ください

適用対象