Function:

Dial a number, using the current line.

Parameters:

TelNum as String
    The number to dial.
TimeoutSeconds as Integer
    The duration in seconds for timeout of waiting connection.
bAnalyzeRingBackTone as Boolean
    Indicates whether analyze ring back tone to monitor call status. Different setting may cause different message in CallStatus event. There are several situation to use this parameter:
1. If you are using a voice modem:
    A. bAnalyzeRingBackTone=false
       A Connected event will occur immediately after dialing without        the waveform analysis process.
    B. bAnalyzeRingBackTone=true
       A waveform analysis process will be begin after dialing until        events CALLSTATUS_NO_SOUND_AFTER_DIALING CALLSTATUS_BUSY             CALLSTATUS_VOICE_PROMPT_DETECTED CALLSTATUS_FAX_TONE                  CALLSTATUS_CALL_REJECTED CALLSTATUS_CONNECTED                         CALLSTATUS_WAIT_CONNECTION_TIMEOUT occurs.
2. If you are using an advanced TAPI device like a voice boards.
    A. bAnalyzeRingBackTone=false
       VoiceAngel will not make any wave form analysis, but directly        get the call status events from TAPI. CALLSTATUS_CONNECTED,           CALLSTATUS_BUSY, or                                                  CALLSTATUS_WAIT_CONNECTION_TIMEOUT events may occurs after           dialing.
       Note:In this case, the TSP parameters of the boards should be        properly configured to get accurate status reports.
    B. bAnalyzeRingBackTone=true
       Same as voice modems does. Only different is that if the             telephone line is not plug in the board,                             CALLSTATUS_NO_SOUND_AFTER_DIALING will not occurs.
       Note:In this case, you should configure the TSP to blindly give a TAPI CONNECTED message(for VoiceAngel--CALLSTATUS_DIALWELLDONE event)immediately after dialing, just as what a                       modem does. If you are using Dialogic board, click here to see how to configure it

bTakeUnknownVoicePromptAsCRBT as boolean

If set true, all the unknown voice prompts will be recognized as Color Ring Back Tones.

bUsePolar as boolean

Determine if judge the call connection by polar. Telephones usually don't have polar feature.

DigitTellMeConnected as String

Some telephone company's PBX will send a digit to the caller when the call is connected. This can be used to judge the connection. This parameter usually is set an empty string.

DigitsToSendAfterConnected as String

Some telephone company's PBX will send a digit to the caller when the call is connected and the caller need to send a digit to the PBX immediately. This parameter usually is set an empty string.

WaveFileToRecordRingBackTone as String
   If the bAnalyzeRingBackTone = false, this parameter will be ignored. Otherwise, if WaveFileToRecordRingBackTone is not an empty string, a wave file will be created to record ring back tone in the call progress. The record process will continue until Drop method called. If WaveFileToRecordRingBackTone is an empty string, no file will be recorded and the record process will stop when some call status event occurs. The recorded wave file can be used to analyze the feature of the ring back tone. You can play the wave file by StartPlaying(3,false) to simulate the call progress. The same call status event will occur as the actual call. If the call status reports is not accurate, some parameters need to be adjusted, after that you needn't Dial again, just play the wave file.
bOfferWaveData as Boolean
If bOfferWaveData set true, wave data will be passed to the user constantly by OnWaveData event.

Description:

Use this method to make an outgoing call from your computer. CallStatus event will occur after dialing to track the call status. VoiceAngel offer a waveform analysis process to track the call status after dialing. Voice modems do not offer outgoing call status reports. Analog voice boards themself offer call status reports, but they give CONNECTED message whenever it met a CRBT(Color Ring Back Tone) or a voice prompt like "The subscriber you dialed is busy now...". VoiceAngel overcomes the shortcoming to offer accurate status events.

Dependencies:

None

Events Raised:

CallStatus
1.If bAnalysisRingBackTone=true
    CALLSTATUS_DIALWELLDONE   CALLSTATUS_NO_SOUND_AFTER_DIALING
CALLSTATUS_RINGBACK CALLSTATUS_BUSY CALLSTATUS_VOICE_PROMPT_DETECTED CALLSTATUS_FAX_TONE CALLSTATUS_CALL_REJECTED CALLSTATUS_CONNECTED CALLSTATUS_WAIT_CONNECTION_TIMEOUT         
2.If bAnalysisRingBackTone=false
    A. With advanced TAPI devices like voice board:
        CALLSTATUS_BUSY CALLSTATUS_CONNECTED CALLSTATUS_WAIT_CONNECTION_TIMEOUT
    B. With voice modems:
       CALLSTATUS_CONNECTED