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 |
