SpeechRecognitionEngine.UpdateRecognizerSetting Method

 

Updates the value of a setting for the recognizer.

Namespace:   System.Speech.Recognition
Assembly:  System.Speech (in System.Speech.dll)

NameDescription
System_CAPS_pubmethodUpdateRecognizerSetting(String, Int32)

Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

System_CAPS_pubmethodUpdateRecognizerSetting(String, String)

Updates the specified speech recognition engine setting with the specified string value.

Recognizer settings can contain string, 64-bit integer, or memory address data. 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. A SAPI-compliant recognizer is not required to support these settings and can support other settings.

Name

Description

ResourceUsage

Specifies the recognizer's CPU consumption. The range is from 0 to 100. 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. The range is from 0 to 10,000 milliseconds (ms). This setting corresponds to the recognizer's EndSilenceTimeout property. Default = 150ms.

ComplexResponseSpeed

Indicates the length of silence in milliseconds (ms) at the end of ambiguous input before the speech recognizer completes a recognition operation. The range is from 0 to 10,000ms. This setting corresponds to the recognizer's EndSilenceTimeoutAmbiguous property. Default = 500ms.

AdaptationOn

Indicates whether adaptation of the acoustic model is ON (value = 1) or OFF (value = 0). The default value is 1 (ON).

PersistedBackgroundAdaptation

Indicates whether background adaptation is ON (value = 1) or OFF (value = 0), and persists the setting in the registry. The default value is 1 (ON).

To return one of the recognizer's settings, use the QueryRecognizerSetting method.

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.

You can modify how the speech recognition responds to non-speech input using the BabbleTimeout, InitialSilenceTimeout, EndSilenceTimeout, and EndSilenceTimeoutAmbiguous properties.

Return to top
Show: