User`s manual
SIP User's Manual 488 Document #: LTRT-83303
Mediant 1000 & Mediant 600
10.2.2.2 Playing Announcements
A <Play> request is used to play an announcement to the caller. Each <Play> request
contains a single Prompt block and the following request-specific parameters:
id: an optional random number used to synchronize request and response.
prompturl: a specific audio file URL that is used in addition to the references in the
Prompt block. This audio file is the first to be played.
An example of an MSCML <Play> Request that includes local and streaming audio files as
well as variables is shown below:
<?xml version="1.0" encoding="utf-8"?>
<MediaServerControl version="1.0">
<request>
<play id=”123”>
<prompt>
<audio url="http://localhost/1"/>
<variable type="digits" value="284"/>
<variable type="silence" value="1"/>
<audio url="http://10.3.0.2/aa.wav"/>
<audiourl="nfs://10.3.0.3/prov_data/bb.wav"/>
</prompt>
</play>
</request>
</MediaServerControl>
10.2.2.3 Playing Announcements and Collecting Digits
The <PlayCollect> request is used to play an announcement to the caller and to then
collect entered DTMF digits. The play part of the <PlayCollect> request is identical to the
<Play> request. The collect part includes an expected digit map. The collected digits are
continuously compared to the digit map. Once a match is found, the collected digits are
sent in a <PlayCollect> response. The digit map should be in MGCP format (the type value
must be set to ‘mgcpdigitmap’).
For example:
<regex type="mgcpdigitmap" value="([0-1]xxx)">
</regex>
Each <PlayCollect> request contains the following request-specific parameters in addition
to the Prompt block (all parameters are optional):
id: an optional random number used to synchronize request and response.
prompturl: a specific audio file URL that is used in addition to the references in the
prompt block. This audio file is the first to be played.
barge: if set to ‘NO’, DTMF digits received during announcement playback are
ignored. If set to ‘YES’, DTMF digits received during announcement playback stop the
playback and start the digit collection phase.
firstdigittimer: defines the amount of time (in milliseconds) the user does not enter any
digits, after which a response is sent indicating timeout.
interdigittimer: defines the amount of time (in milliseconds) the user does not enter any
digits after the first DTMF digit is received, after which a response is sent indicating
timeout.