Recognizer SET-PARAMS

The SET-PARAMS method, sent from the client to the server, sets or modifies the recognizer context parameters that govern how the resource behaves—sensitivity, confidence thresholds, timers, result detail, and so on. Values set this way persist for the session until changed, establishing the defaults that subsequent requests inherit.

Many of these parameters can also be supplied directly on another method, such as RECOGNIZE, in which case they apply to that request only and override the session defaults. If the server accepts the supplied parameters, it responds with a Status-Code of 200.

The headers below can be used with SET-PARAMS and GET-PARAMS for the recognizer resource. The table records whether each header is defined in MRCPv1, defined in MRCPv2, and supported on Capacity Private Cloud.

Header

MRCP V1

MRCP V2

Platform Support

Confidence-Threshold

Sensitivity-Level

Speed-Vs-Accuracy

N-Best-List-Length

Input-Type

No-Input-Timeout

Recognition-Timeout

Waveform-URI

Input-Waveform-URI

Completion-Cause

Completion-Reason

Recognizer-Context-Block

Start-Input-Timers

Recognizer-Start-Timers

Speech-Complete-Timeout

Speech-Incomplete-Timeout

Dtmf-Interdigit-Timeout

Dtmf-Term-Timeout

Dtmf-Term-Char

Failed-URI

Failed-URI-Cause

Save-Waveform

Media-Type (v2)

New-Audio-Channel

Speech-Language

Ver-Buffer-Utterance

Recognition-Mode

Cancel-If-Queue

Hotword-Max-Duration

Hotword-Min-Duration

Interpret-Text *

Dtmf-Buffer-Time

Clear-Dtmf-Buffer

Early-No-Match

✓ = defined or supported  |  — = not defined in that version, or not supported on the platform  |  * Interpret-Text is used with the INTERPRET method.

MRCPv1 example

Setting three recognizer parameters for the session:

C->S: SET-PARAMS 543256 MRCP/1.0
             Sensitivity-Level:20
             Recognition-Timeout:30
            Confidence-Threshold:85


S->C: MRCP/1.0 543256 200 COMPLETE

MRCPv2 example

The same request in MRCPv2, with the Channel-Identifier header and the 0.0–1.0 value range MRCPv2 uses for sensitivity and confidence:

C->S: MRCP/2.0 ... SET-PARAMS 543256
      Channel-Identifier:32AECB23433801@speechrecog
      Sensitivity-Level:0.2
      Recognition-Timeout:30
      Confidence-Threshold:0.85

S->C: MRCP/2.0 ... 543256 200 COMPLETE
      Channel-Identifier:32AECB23433801@speechrecog

Related articles


Was this article helpful?