Overview :
This mxm provides controls
upon telephony resources present in the system.
These telephony resources are usually modems or virtual modems created by communication
softwares.
The drivers of these telephony resources must be compliant with Microsoft Win32
Telephony application programming interface (marked as " TAPI compliant ").
In order to use the DTMF monitoring, the resource must be at least compliant with
the version 2.0 of TAPI.
> Top
Installation (MXM) :
No special installation required.
> Top
Creation (Device) :
Device creation window :

The listbox contains the list of the telephony resources present in the system.
One of these resources must be selected.
If no resources are present, man can yet create the Manager device by selecting
the line "No device present" that will appear in the list of resources at this
time.
If "Automatic answer " is checked, the device will automatically answer to incoming
calls and play the indicated wave file on the line.
- if "Stop playing wave on dial tone reception", any wave sound playing will be
automatically stopped as
soon as a dial tone is detected on the line.
Important : The format of the wave file must be 8Khz mono 16 bits signed.
> Top
Commands (List Of) :
Answer :
Description : To
pick up the line for an incoming call
Parameters : No parameters.
Usage : If the answering
mode is not set as automatic in the setup, man can answer to incoming calls
by calling this command.
Make Call :
Description : To
call a phone number.
Parameters :
Number : [Type
: String] :The phone number that must be called.
Hang Up :
Description : To
hang up the current call.
Parameters : No parameters.
Send wave :
Description : To
play a specific wave on the line..
Parameters :
Wave path : [Type
: String] : The path of the file containing the wave. An empty path will
stop playing the current wave if any.
Loops count : [Type : Integer] : Count of times that the wave must
be played. A value of 0 will play the wave continuously.
Volume : [Type : Integer] : Indicate the volume of the wave from
0 to 65535 (default 40000).
Usage : This command
only works if the status of the device is "On Line", that is after the device
has answered succesfully to an incoming call, or after the device has made
a succesful call.
Important The format of the wave file must be 8Khz mono 16 bits signed.
Send Dial Tone :
Description : To
send DTMF tones on the line.
Parameters :
String : [Type
: String] : The string containing the ascii character representing the
dial tones to send on the line. Valid characters are 0,1,2,3,4,5, 6, 7,
8,9,A,B,C,D,*,#.
Usage : This command
only works if the status of the device is "On Line", that is after the device
has answered succesfully to an incoming call, or after the device has made
a succesful call.
Clear DialTonesFrame :
Description : Empty
the string variable containing the last dialtones received and reset the dial
tones counter variable to zero..
Parameters : No parameters.
> Top
Variables (List Of) :
LineStatus :
Type : Enum.
Description : Current status of the line.
Available Values :
"Closed": The line is
not active. This is the status when Manager is stopped.
"Ready": The resource has been opened successfully and the device is ready
to receive commands.
"Incoming call":There is request to answer a call on the line (ring).
"On Line":The device has answered succesfully to an incoming call, or has
made a succesful call and the line is opened.
"Error":An error has occured, after a command or an initialization failure,
or the TAPI resource could not be opened or found.
LineMessage :
Type : String.
Description :Litteral message. This can be a more detailed string after
an error or information of the caller during an incoming call, if available.
DialTonesFrame :
Type :String.
Description :A string containing the last dial tones received on the
line.
DialTonesCount :
Type : Integer.
Description : The count of dial tones present in DialTonesFrame.
> Top
Support (Difference with previous versions) :
> Top
|