Tone definitions

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Added tone detection strings)
(Rewrote playing and collecting tones section)
Line 66: Line 66:
 
|}
 
|}
  
=== Playing tones  ===
+
=== Playing and collecting tones  ===
  
To learn how to play these tones using the [[CAF: Working With Call Legs|Call Leg API]], refer to the [[CAF: Working With Call Legs#Playing_and_Collecting_Tones|Playing and Collecting Tones section]]. Here are the tone strings that must be passed to the '''AddToneString()''' function in order to play the call progress tones discussed in this article:
+
To learn how to play these tones using the [[CAF: Working With Call Legs|Call Leg API]], refer to the [[CAF: Working With Call Legs#Playing_and_Collecting_Tones|Playing and Collecting Tones section]].
  
*Ring: <code>cg/rt</code>
+
For example, to play the '''ringing''' tone, one could pass either directly <code>((((#440)+(#480)),2000),(#0,4000))*0</code> or <code>cg/rt</code> to the '''AddToneString()''' function. The <code>cg/rt</code> string refers to the current Tone Profile Params ringing tone setting from the Web Portal.
*Busy: <code>cg/bt</code>  
+
*Congestion: <code>cg/ct</code>  
+
*Warning: <code>cg/wt</code>
+
  
 
=== Available tones ===
 
=== Available tones ===

Revision as of 15:10, 14 July 2010

Contents

Tone definitions

It is possible through the Toolpack Web Portal to specify the parameters of ringing, busy, congestion (or fast busy) and warning call progress tones. These settings are available in the Profiles -> Tone Profile Params section of the Web Portal.

The tones are described using a programmable string of characters as defined in the H.248 Dynamic Tone Definition Package. To learn more about tone description strings, see the section related to this subject.

Examples of Call Progress tones

The following table contains a few call progress tone definition strings that can be used to replace the default ones in the Toolpack Web Portal.

Ring Busy Congestion Warning
Brazil ((#425,1000),(#0,4000))*0 ((#425,250),(#0,250))*0 ((#425,750),(#0,250),(#425,250),(#0,250))*0 unused
China ((#450,1000),(#0,4000))*0 ((#450,350),(#0,350))*0 ((#450,700),(#0,700))*0 unused
France ((#440,1500),(#0,3500))*0 ((#450,500),(#0,500))*0 unused unused
Germany ((#425,1000),(#0,4000))*0 ((#425,480),(#0,480))*0 ((#425,240),(#0,240))*0 ((#425,240),(#0,240),(#425,240),(#0,1280))*0
Hong Kong ((((#440)+(#480)),400),(#0,200),(((#440)+(#480)),400),(#0,3000))*0 ((((#480)+(#620)),500),(#0,500))*0 ((((#480)+(#620)),250),(#0,250))*0 unused
Spain ((#425,1500),(#0,3000))*0 ((#425,200),(#0,200))*0 ((#425,200),(#0,200),(#425,200),(#0,200),(#425,200),(#0,600))*0 (((#1400),400),(#0,5000))*0
US ((((#440)+(#480)),2000),(#0,4000))*0 ((((#480)+(#620)),500),(#0,500))*0 ((((#480)+(#620)),250),(#0,250))*0 ((#1400),500)
UK ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0 ((#400,375),(#0,375))*0 ((#400,400),(#0,350),(#400,225),(#400,525))*0 unused

Playing and collecting tones

To learn how to play these tones using the Call Leg API, refer to the Playing and Collecting Tones section.

For example, to play the ringing tone, one could pass either directly ((((#440)+(#480)),2000),(#0,4000))*0 or cg/rt to the AddToneString() function. The cg/rt string refers to the current Tone Profile Params ringing tone setting from the Web Portal.

Available tones

Below is a comprehensive list of all the tone strings that can be passed to the AddToneString() function.

Tone generation
Package Signal String
Basic DTMF generation 0 dg/d0
1 dg/d1
2 dg/d2
3 dg/d3
4 dg/d4
5 dg/d5
6 dg/d6
7 dg/d7
8 dg/d8
9 dg/d9
* dg/ds
# dg/do
A dg/da
B dg/db
C dg/dc
D dg/dd
Call Progress generation Ring cg/rt
Busy cg/bt
Congestion cg/ct
Warning cg/wt
MF tone generation 0 mfg/mf0
1 mfg/mf1
2 mfg/mf2
3 mfg/mf3
4 mfg/mf4
5 mfg/mf5
6 mfg/mf6
7 mfg/mf7
8 mfg/mf8
9 mfg/mf9
KP mfg/mfa
ST mfg/mfe
Telcofax CNG telcofax/cng
g164 telcofax/g164
Tone detection
Package Signal String
Basic DTMF detection 0 dd/d0
1 dd/d1
2 dd/d2
3 dd/d3
4 dd/d4
5 dd/d5
6 dd/d6
7 dd/d7
8 dd/d8
9 dd/d9
* dd/ds
# dd/do
A dd/da
B dd/db
C dd/dc
D dd/dd
MF tone generation 0 mfd/mf0
1 mfd/mf1
2 mfd/mf2
3 mfd/mf3
4 mfd/mf4
5 mfd/mf5
6 mfd/mf6
7 mfd/mf7
8 mfd/mf8
9 mfd/mf9
KP mfd/mfa
ST mfd/mfe
Telcofax CNG telcofax/cng
g164 telcofax/g164

References

Personal tools