SIP User's Manual
extradigittimer: used to enable the following:
•
Detection of command keys (ReturnKey and EscapeKey).
•
Not report the shortest match. MGCP Digitmap searches for the shortest possible
match. This means that if a digitmap of (123 | 1234) is defined, once the user
enters 123, a match is found and a response is sent. If ExtraDigitTimer is defined,
the match can also be 1234 because the device waits for the next digits. To use
ExtraDigitTimer, it must be defined in the request and you must add a "T" to the
Digitmap (for example, 'xxT'). The ExtraDigitTimer is only used when a match is
found. Before a match is found, the timer used is the InterDigitTimer. Therefore, if
the ExtraDigitTimer expires, a "match" response reason is reported -- never a
"timeout".
maxdigits: defines the maximum number of collected DTMF digits after which the
device sends a response.
cleardigits: defines whether or not the device clears the digit buffer between
subsequent requests.
returnkey: defines a specific digit (including '*' and '#') which (when detected during a
collection) stops the collection and initiates a response (that includes all digits
collected up to that point) to be sent.
escapekey: defines a specific digit (including '*' and '#') which (when detected during a
collection) stops the collection and initiates a response (with no collected digits) to be
sent.
An example is shown below of an MSCML <PlayCollect> Request that includes a
sequence with variables and an MGCP digit map:
<?xml version="1.0" encoding="utf-8"?>
<MediaServerControl version="1.0">
value="20041210"/>
1]xxx)">
</MediaServerControl>
An example is shown below of an MSCML <PlayCollect> Response:
<?xml version="1.0" encoding="utf-8"?>
<MediaServerControl version="1.0">
text="OK" digits="4563">
</MediaServerControl>
Version 5.4
<request>
<playcollect id="6379" barge="NO" returnkey="#">
<prompt>
</prompt>
<regex type="mgcpdigitmap" value="([0-
</regex>
</playcollect>
</request>
<response request="playcollect" id="6478" code="200"
</response>
<audio url="http://localhost/1">
<variable type="silence" value="1"/>
<variable type="date" subtype="mdy"
489
10. Media Server Capabilities
May 2008