Version 6.4 427 March 2012
SIP User's Manual 20. Configuring the IP Media Parameters
20.1.2.1.2 Playing using HTTP/NFS Streaming
To play a single announcement via HTTP or NFS streaming, the Application Server (or any
SIP user agent) sends a regular SIP INVITE message with SIP URI that includes the
NetAnn Announcement Identifier name. For example:
INVITE sip:annc@ac.com;
play=http://server.net/gem/Hello.wav SIP/2.0
The left part of the SIP URI includes the string ‘annc’ terminated by the IP address of the
HTTP server, and the name and path of the file to be played. In the example above, the
device starts playing the ‘Hello.wav’ file that resides in the folder ‘server.net/gem’. The
NetAnn Announcement Identifier string is configured using the ini file (parameter
NetAnnAnncID) or Web interface (see 'Configuring the IPmedia Parameters' on page 411).
Sending a BYE request terminates the SIP session and stops the playing of the
announcement. If the played announcement reaches its end, the device initiates a BYE
message to notify the Application Server that the session is ended.
Notes:
• A 200 OK message is sent only after the HTTP connection is
successfully established and the requested file is found. If the file isn’t
found, a 404 Not Found response is sent.
• To use NFS, the requested file system should be first mounted by using
the NFS Servers table, see 'Configuring the NFS Settings' on page 127.
20.1.2.1.3 Supported Attributes
When playing announcements, the following attributes are available:
Repeat: defines the number of times the announcement is repeated. The default
value is 1. The valid range is 1 to 1000, or -1 (i.e., repeats the message forever).
Delay: defines the delay (in msec) between announcement repetitions. The default
value is 0. The valid range is 1 to 3,600,000.
Duration: defines the total duration (in msec) the announcement(s) are played. The
default value is 0 (i.e., no limitation). The valid range is 1 to 3,600,000.
For example:
INVITE sip:annc@ac.com;
play=http://server.net/gem/Hello.wav; repeat=5;delay=10000 SIP/2.0
20.1.2.2 MSCML Interface
Media Server Control Markup Language (MSCML), according to IETF RFC 5022 is a
protocol used in conjunction with SIP to provide advanced announcements handling.
MSCML is implemented by adding an XML body to existing SIP INFO messages. Only a
single message body (containing a single request or response) is allowed per message.
The device supports all the Interactive Voice Response (IVR) requirements for playing
announcements, collecting digits, and recording (Play, PlayCollect, and PlayRecord).
Note: MSCML is only supported on devices operating with 128-MByte RAM size.
To Next Page
Loading...
Need help?
General
