swiep_magic_word_max_msec

Specifies the maximum duration of a magic word candidate for recognition.

Value

Integer: milliseconds. Minimum is 0; there is no maximum.

DEFAULT: 800 (milliseconds)

How to set

Shown in precedence order (see Rules of parameter precedence):

In the browser, using the Vendor-Specific-Parameters (MRCPv1)In the browser, using the Vendor-Specific-Parameters (MRCPv1) or Hotword-Max-Duration header (MRCPv2) (set before a magic_word recognition event) in a RECOGNIZE or SET-PARAMS request.

In Management Station set on the Nuance recognition service. If not using Management Station, set in a Recognizer configuration file (User-nrsxx.xml).

Usage

Seldom used because most applications do not require the magic word feature. But when the feature is needed, this parameter is frequently adjusted.

This parameter is relevant when swiep_mode is set to magic_word.

This parameter (in conjunction with swiep_magic_word_min_msec) defines the expected duration of magic_word utterances. Any utterance outside the range is discarded from the audio before recognition processing.

Considerations when setting the duration:

  • Determine the approximate lengths of the shortest and longest magic word allowed, and set the minimum and maximum values.
  • A range that is too narrow will fail to recognize magic words that are spoken too quickly or too slowly. A range that is too wide adds processing load to your system.
  • Fine tune the range for each magic_word grammar in each application. The optimum range for a grammar is slightly shorter and longer than the time required to speak the shortest and longest magic words. Tuning is necessary in part because callers in different geographic regions speak at different speeds.

Browsers usually set this parameter in a RECOGNIZE request, and the parameter automatically reverts to the previous value after the recognition event. (Alternatively, browsers can use the SET-PARAMS method. See Configuring Recognizer with the browser.)

Vendor-Specific-Parameters: swiep_magic_word_max_msec=400

Related parameters: