Medialon MxMs' Help 
  
Name : Medialon Telephony
Version : 1.0.0
Available for : Manager V5 (all versions)
Limitation In :  
Device Brand : Medialon
Positrack Compatible : No
Resources type : None
 
Compatible hardware interfaces - available resource modules (MRC) :
 

 

> Overview | > Installation (MXM) | > Creation (Device) | > Commands (List Of) | > Variables (List Of) | > Support


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