Configuring Regional Parameters and Supplementary Services
Advanced Scripting for Cadences, Call Progress Tones, and Ring Tones
150
Cisco SPA and Wireless IP Administration Phone Guide
8
A RingScript is a mini-script that describes a ring tone. The syntax follows:
n=
ring-tone-name
;w=
waveform-id-or-path
;c=
cadence-id
;b=
break-
time
;t=
total-time
ring-tone-name
is a name to identify this ring tone specification. This name will
appear on the Ring Tone menu of the phone. The same name can be used in a
SIP Alert-Info header in an inbound INVITE request to tell the phone to play the
corresponding ring tone specification. Because of this, the name should
contain characters allowed in a URL only.
Waveform-id
is the index of the desired waveform to use in this ring tone
specification. There are 4 built-in waveforms:
-
1 = A classic phone with mechanical bell
-
2 = Typical phone ring
-
3 = A classic ring tone
-
4 = A wide-band frequency sweep signal
This field can also be a network path (url) to download a ring tone data file from a
server on-the-fly. In this case, the syntax of the field is
w=[tftp://]hostname[:port]/path.
cadence-id
is the index of the desired cadence to play the given waveform. 8
cadences (1–8) as defined in <Cadence 1> through <Cadence 8>.
Cadence-id
can be 0 If w=3,4, or an url. Setting c=0 implies the on-time is the natural length
of the ring tone file.
break-time
specifies the number of seconds to break between two bursts of
ring tone, such as b=2.5
total-time
specifies the total number of seconds to play the ring tone before it
times out
Example 1
:
SIT Tone
n=Classic-1,w=3;c=1
n=Simple-1,w=2;c=1
