Tone definitions

From TBwiki
(Difference between revisions)
Jump to: navigation, search
m (Added unused cells.)
(Added playing tones section)
Line 1: Line 1:
 
=== Tone definitions  ===
 
=== Tone definitions  ===
  
It is possible through the [[Toolpack]] [[Web Portal]] to specify the parameters of ringing, busy, congestion (or fast busy) and warning tones.  
+
It is possible through the [[Toolpack]] [[Web Portal]] to specify the parameters of ringing, busy, congestion (or fast busy) and warning call progress tones.  
  
 
The tones are described using a programmable string of characters as defined in the [[H.248]] Dynamic Tone Definition Package.  
 
The tones are described using a programmable string of characters as defined in the [[H.248]] Dynamic Tone Definition Package.  
Line 9: Line 9:
 
The following table contains a few tone definition strings that can be used to replace the default ones in the Toolpack Web Portal.  
 
The following table contains a few tone definition strings that can be used to replace the default ones in the Toolpack Web Portal.  
  
{| cellpadding="2" cellspacing="1" border="1"
+
{| cellspacing="1" cellpadding="2" border="1"
 
|-
 
|-
!|
+
!  
!| Ring
+
! Ring  
!| Busy
+
! Busy  
!| Congestion
+
! Congestion  
!| Warning
+
! Warning
 
|-
 
|-
!| Brazil
+
! Brazil  
| ((#425,1000),(#0,4000))*0
+
| ((#425,1000),(#0,4000))*0  
| ((#425,250),(#0,250))*0
+
| ((#425,250),(#0,250))*0  
| ((#425,750),(#0,250),(#425,250),(#0,250))*0
+
| ((#425,750),(#0,250),(#425,250),(#0,250))*0  
 
| ''unused''
 
| ''unused''
 
|-
 
|-
!| China
+
! China  
| ((#450,1000),(#0,4000))*0
+
| ((#450,1000),(#0,4000))*0  
| ((#450,350),(#0,350))*0
+
| ((#450,350),(#0,350))*0  
| ((#450,700),(#0,700))*0
+
| ((#450,700),(#0,700))*0  
 
| ''unused''
 
| ''unused''
 
|-
 
|-
!| France
+
! France  
| ((#440,1500),(#0,3500))*0
+
| ((#440,1500),(#0,3500))*0  
| ((#450,500),(#0,500))*0
+
| ((#450,500),(#0,500))*0  
| ''unused''
+
| ''unused''  
 
| ''unused''
 
| ''unused''
 
|-
 
|-
!| Germany
+
! Germany  
| ((#425,1000),(#0,4000))*0
+
| ((#425,1000),(#0,4000))*0  
| ((#425,480),(#0,480))*0
+
| ((#425,480),(#0,480))*0  
| ((#425,240),(#0,240))*0
+
| ((#425,240),(#0,240))*0  
 
| ((#425,240),(#0,240),(#425,240),(#0,1280))*0
 
| ((#425,240),(#0,240),(#425,240),(#0,1280))*0
 
|-
 
|-
!| Hong Kong
+
! Hong Kong  
| ((((#440)+(#480)),400),(#0,200),(((#440)+(#480)),400),(#0,3000))*0
+
| ((((#440)+(#480)),400),(#0,200),(((#440)+(#480)),400),(#0,3000))*0  
| ((((#480)+(#620)),500),(#0,500))*0
+
| ((((#480)+(#620)),500),(#0,500))*0  
| ((((#480)+(#620)),250),(#0,250))*0
+
| ((((#480)+(#620)),250),(#0,250))*0  
 
| ''unused''
 
| ''unused''
 
|-
 
|-
!| Spain
+
! Spain  
| ((#425,1500),(#0,3000))*0
+
| ((#425,1500),(#0,3000))*0  
| ((#425,200),(#0,200))*0
+
| ((#425,200),(#0,200))*0  
| ((#425,200),(#0,200),(#425,200),(#0,200),(#425,200),(#0,600))*0
+
| ((#425,200),(#0,200),(#425,200),(#0,200),(#425,200),(#0,600))*0  
 
| (((#1400),400),(#0,5000))*0
 
| (((#1400),400),(#0,5000))*0
 
|-
 
|-
!| US
+
! US  
| ((((#440)+(#480)),2000),(#0,4000))*0
+
| ((((#440)+(#480)),2000),(#0,4000))*0  
| ((((#480)+(#620)),500),(#0,500))*0
+
| ((((#480)+(#620)),500),(#0,500))*0  
| ((((#480)+(#620)),250),(#0,250))*0
+
| ((((#480)+(#620)),250),(#0,250))*0  
 
| ((#1400),500)
 
| ((#1400),500)
 
|-
 
|-
!| UK
+
! UK  
| ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0
+
| ((((#400)+(#450)),400),(#0,200),(((#400)+(#450)),400),(#0,2000))*0  
| ((#400,375),(#0,375))*0
+
| ((#400,375),(#0,375))*0  
| ((#400,400),(#0,350),(#400,225),(#400,525))*0
+
| ((#400,400),(#0,350),(#400,225),(#400,525))*0  
 
| ''unused''
 
| ''unused''
 
|}
 
|}
 +
 +
=== Playing 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:
 +
 +
*Ring: <code>cg/rt</code>
 +
*Busy: <code>cg/bt</code>
 +
*Congestion: <code>cg/ct</code>
 +
*Warning: <code>cg/wt</code>
  
 
=== References  ===
 
=== References  ===
Line 72: Line 81:
 
*[http://www.itu.int/rec/T-REC-H.248.1-200509-I/en H.248 Gateway Control Protocol] section E.7 (Call Progress Tone Definitions Package)
 
*[http://www.itu.int/rec/T-REC-H.248.1-200509-I/en H.248 Gateway Control Protocol] section E.7 (Call Progress Tone Definitions Package)
  
[[category:Needs revising]]
+
[[Category:Needs_revising]]

Revision as of 13:52, 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.

The tones are described using a programmable string of characters as defined in the H.248 Dynamic Tone Definition Package.

Examples

The following table contains a few 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 tones

To learn how to play these tones using the Call Leg API, refer to the 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:

  • Ring: cg/rt
  • Busy: cg/bt
  • Congestion: cg/ct
  • Warning: cg/wt

References

Personal tools