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?