User`s manual

Version 5.4 483 May 2008
SIP User's Manual 10. Media Server Capabilities
10.2 Announcement Server
The device supports playing and recording of announcements (local Voice Prompts or
HTTP streaming) and playing of Call Progress Tones over the IP network. Three different
methods are available for playing and recording announcements:
 NetAnn for playing a single announcement (refer to ''NetAnn Interface'' on page 483)
 MSCML for playing single or multiple announcements and collecting digits (refer to
''MSCML Interface'' on page 484)
10.2.1 NetAnn Interface
The device supports playing announcements using NetAnn format (according to RFC
4240).
10.2.1.1 Playing a Local Voice Prompt
To play a single local Voice Prompt, 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:[e-mail]; play=file://12 SIP/2.0
The left part of the SIP URI includes the string ‘annc’. In the example above, the device
starts playing announcement number 12 from the internal Voice Prompts file (file:// and
http://localhost formats are supported). The NetAnn Announcement Identifier string is
configured using the ini file (parameter NetAnnAnncID) or Web interface (refer to
''Configuring the IPmedia Parameters'' on page 242). Sending a BYE request terminates
the SIP session and stops the playing of the announcement. If the played Voice Prompt
reaches its end, the device initiates a BYE message to notify the Application Server that
the session has ended.
10.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:[e-mail];
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 (refer to ''Configuring the IPmedia Parameters'' on page
242). 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.