Copyright 2010-2017 Obihai Technology, Inc.
204
Ringtones and Ring Patterns
The general format of an OBi Ring Profile is as follows: [field-1];[field-2];...;[field - 5]
Use the ";" to separate up to five (5) configuration fields.
Please note that no spaces are allowed to be used in a tone profile pattern.
Field
–
1 Composition:
Field-1 describes the overall ringing duration in seconds.
The expression is a numeric value, and supports up to 3 decimated digits.
The numeric value can negative, zero, and positive:
▪
Negative value: Ringing lasts indefinitely
▪
No value: Ringing lasts infinitely
▪
Zero value: Ringing is skipped
▪
Positive value: Normal ringing duration
Example: 30.5
The above example illustrates a ringing tone that terminates after 30.5 seconds.
Field
–
2 to Field
–
5 Composition:
Field - 2/3/4/5 share the same definition, and each field describes one single cadence segment. Together, the four (4)
fields form a macro-segment, which will be repeated until ringing expires.
The expression is a string of numeric values with the special notation '
(
' , '
)
' and '
,
'
It has the format as per the following construct: t(on_0+off_0,on_1+off_1,on_2+off_2,on_3+off_3)
t
: The cadence segment duration in seconds.
▪
Negative value: Ringing indefinitely
▪
No value: Ringing indefinitely
▪
Zero value: Ringing is skipped
▪
Positive value: Normal ringing duration
on_0/1/2/3
: The ring active time in seconds.
▪
Negative value: Not allowed
▪
No value: Infinite ring active time
▪
Others: Normal ring active time (up to 3 decimated digits)
off_0/1/2/3
: The ring inactive time in seconds
▪
Negative value: Not allowed
▪
No value: Infinite ring inactive time
▪
Others: Normal ring inactive time (up to 3 decimated digits)
Example:
4(.3+2.34,2+1.5)
