SpeechRecognitionEngine.UpdateRecognizerSetting メソッド

定義

認識エンジンの設定の値を更新します。Updates the value of a setting for the recognizer.

オーバーロード

UpdateRecognizerSetting(String, Int32)

SpeechRecognitionEngine の指定された設定を、指定された整数値で更新します。Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

UpdateRecognizerSetting(String, String)

指定された音声認識エンジンの設定を、指定された文字列値で更新します。Updates the specified speech recognition engine setting with the specified string value.

注釈

レコグナイザーの設定には、文字列、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.

名前Name 説明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 音声認識エンジンが認識操作を完了する前に、あいまいな入力の最後に無音の長さをミリ秒 (ms) で示します。Indicates the length of silence in milliseconds (ms) 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).

認識エンジンの設定の1つを返すには、メソッドを使用し QueryRecognizerSetting ます。To return one of the recognizer's settings, use the QueryRecognizerSetting method.

を除き、 PersistedBackgroundAdaptation メソッドを使用して設定されたプロパティ値は、 UpdateRecognizerSetting の現在のインスタンスに対してのみ有効 SpeechRecognitionEngine です。その後、既定の設定に戻ります。With the exception of PersistedBackgroundAdaptation, property values set using the UpdateRecognizerSetting methods remain in effect only for the current instance of SpeechRecognitionEngine, after which they revert to their default settings.

、、、およびの各プロパティを使用して、音声認識が音声以外の入力にどのように応答するかを変更でき BabbleTimeout InitialSilenceTimeout EndSilenceTimeout EndSilenceTimeoutAmbiguous ます。You can modify how the speech recognition responds to non-speech input using the BabbleTimeout, InitialSilenceTimeout, EndSilenceTimeout, and EndSilenceTimeoutAmbiguous properties.

UpdateRecognizerSetting(String, Int32)

SpeechRecognitionEngine の指定された設定を、指定された整数値で更新します。Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

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

更新する設定の名前。The name of the setting to update.

updatedValue
Int32

設定の新しい値。The new value for the setting.

例外

settingNamenullです。settingName is null.

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 updates the confidence level settings, and then queries the recognizer to check the updated values. この例では、次の出力が生成されます。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  

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 です。その後、既定の設定に戻ります。With the exception of PersistedBackgroundAdaptation, property values set using the UpdateRecognizerSetting method remain in effect only for the current instance of SpeechRecognitionEngine, after which they revert to their default settings. UpdateRecognizerSettingサポートされる設定の説明については、を参照してください。See UpdateRecognizerSetting for descriptions of supported settings.

こちらもご覧ください

適用対象

UpdateRecognizerSetting(String, String)

指定された音声認識エンジンの設定を、指定された文字列値で更新します。Updates the specified speech recognition engine setting with the specified string value.

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

更新する設定の名前。The name of the setting to update.

updatedValue
String

設定の新しい値。The new value for the setting.

例外

settingNamenullです。settingName is null.

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

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

注釈

を除き、 PersistedBackgroundAdaptation メソッドを使用して設定されたプロパティ値は、 UpdateRecognizerSetting の現在のインスタンスに対してのみ有効 SpeechRecognitionEngine です。その後、既定の設定に戻ります。With the exception of PersistedBackgroundAdaptation, property values set using the UpdateRecognizerSetting method remain in effect only for the current instance of SpeechRecognitionEngine, after which they revert to their default settings. UpdateRecognizerSettingサポートされる設定の説明については、を参照してください。See UpdateRecognizerSetting for descriptions of supported settings.

こちらもご覧ください

適用対象