User`s manual

SIP User's Manual 490 Document #: LTRT-83303
Mediant 1000 & Mediant 600
10.2.2.4 Playing Announcements and Recording Voice
The <PlayRecord> request is used to play an announcement to the caller and to then
record the voice stream associated with that caller. The play part of the <PlayRecord>
request is identical to the <Play> request. The record part includes a URL to which the
voice stream is recorded. This URL refers to an HTTP server.
Each <PlayRecord> request contains the following request-specific parameters in addition
to the Prompt block (all parameters except ‘recurl’ 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 recording phase.
 cleardigits: defines whether or not the device clears the digit buffer between
subsequent requests.
 escapekey: defines a specific digit (including ‘*’ and ‘#’) which (when detected during
any phase) stops the request and initiates a response.
 recurl: the URL on the external storage server to which the RTP stream is sent for
recording. This is a mandatory parameter.
 mode: defines if the recording ‘overwrites’ the existing file or ‘appends’ to it.
 initsilence: defines how long to wait for initial speech input before terminating the
recording. This parameter may take an integer value in milliseconds.
 endsilence: defines how long the device waits after speech has ended to stop the
recording. This parameter may take an integer value in milliseconds.
 duration: the total time in milliseconds for the entire recording. Once this time expires,
recording stops and a response is generated.
 recstopmask: defines a digit pattern to which the device compares digits detected
during the recording phase. If a match is found, recording stops and a response is
sent.
An example is shown below of an MSCML <PlayRecord> Request:
<?xml version="1.0" encoding="utf-8"?>
<MediaServerControl version="1.0">
<request>
<playrecord id="75899" barge="NO"
Recurl=nfs://10.11.12.13/save/recordings/11.wav>
<prompt>
<audio url="nfs://100.101.102.103/45">
<variable type="date" subtype="mdy"
value="20041210"/>
</prompt>
</playrecord>
</request>
</MediaServerControl>