Recognizer GET-PARAMS
The GET-PARAMS method, sent from the client to the server, retrieves the recognizer resource’s current session parameters—timers, thresholds, and the other settings listed below. To query a parameter, the client includes its header with an empty value; the server returns each header populated with its current value.
These values are established and changed with the SET-PARAMS method. The headers below can be used with both SET-PARAMS and GET-PARAMS; the table records whether each 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
The client requests three parameters by sending their headers with empty values; the server replies with the current values:
| C->S: GET-PARAMS 543256 MRCP/1.0 Sensitivity-Level: Recognition-Timeout: Confidence-threshold: S->C: MRCP/1.0 543256 200 COMPLETE Sensitivity-Level:20 Recognition-Timeout:30 Confidence-Threshold:85 |
MRCPv2 example
The same query in MRCPv2, with the Channel-Identifier header and the 0.0–1.0 value range used for sensitivity and confidence:
| C->S: MRCP/2.0 ... GET-PARAMS 543256 Channel-Identifier:32AECB23433802@speechrecog Sensitivity-Level: Recognition-Timeout: Confidence-Threshold: S->C: MRCP/2.0 ... 543256 200 COMPLETE Channel-Identifier:32AECB23433802@speechrecog Sensitivity-Level:0.2 Recognition-Timeout:30 Confidence-Threshold:0.85 |
