Property: RingBackSignalUpperDuration
| Type: |
Long |
|
| Properties: |
ReadWrite, available at both design and run time. |
|
| Function: |
Set the upper bound of the ring back signal sound duration range in milli-second. This property affects the accuracy and reliability of the judgement of the telephone line status while dialing or transfering. |
|
| Description: |
RingBackSignalUpperDuration and RingBackSignalLowerDuration define a range of duration of ringback signal on the line. UpFrequency and DownFrequency define a range of frequencies of ring back signal on the line. Sound within these bounds is recognized by VoiceAngel as signal sound (ring back tone or busy tone).Sound within these bounds is recognized by VoiceAngel as signal sound (ring back tone or busy tone). Any sound with frequency beyond these bounds will be taken as non-signal sound.
When VoiceAngel "listens" to the line, patterns of signal and non-signal cause different events and behaviours.
For example, if non-signal sound is detected after signal sound, VoiceAngel will think that someone has picked up the phone and said something. (Obviously, it cannot interpret or understand speech, other than to know that it is "non-signal"). So the connected event will be raised. But this is not always accurate. If the called party was to drop his mobile telephone just after you dialled, a voice prompt will be heard, and voiceangel can not recognize if the voice is from a human or a machine, so the Connected event is still raised.
Sometimes non-signal sound is heard but the line has not been connected successfully. For example ,if the callee has shut down his mobile telephone or he is busy in a call process, VoiceAngel may hear a voice prompt directly without any signal tone. In this case a VoicePromptDetected event is raised.
Setting UpFrequency at design time, makes it apply to all lines. Setting it at run time means it will only apply to the current line. |
|
| See Also: | Judging Telephony Line Status |
Sample Code In Visual Basic:
The following code shows how to set corresponding parameters for judging call status before dialing, to get more accurate and more reliable judgment of the telephony line status. You may also set them at design time. The parameters set here is the default values suitable in most cases, in fact they need not be set if you use default values.
Sub cmdDial_Click()
VoiceAngel1.SilenceSwing = 1000
VoiceAngel1.UpFrequency= 550
VoiceAngel1.DownFrequency=350
VoiceAngel1.RingBackSilenceUpperDuration=5200
VoiceAngel1.RingBackSilenceLowerDuration=3500
VoiceAngel1.RingBackSignalUpperDuration=1200
VoiceAngel1.RingBackSignalLowerDuration=850
VoiceAngel1.BusySilenceUpperDuration=800
VoiceAngel1.BusySilenceLowerDuration=200
VoiceAngel1.BusySignalUpperDuration=750
VoiceAngel1.BusySignalLowerDuration=400
VoiceAngel1.Dial "666666"
End sub
¡¡