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

Related articles


Was this article helpful?