Requirements

• TeleTools 3.7 or above if you wish to compile it yourself

• The program was written to use a Way2Call Hi-Phone however it will work with any device that can answer, play wave files, monitor for digits and hang-up.

• You can play digits using any of the following Editions of TeleTools v3.7

  • TeleTools Standard

  • TeleTools Professional

  • TeleTools Enterprise

Using This Sample Program

1. When the program is loaded the etLine TeleScope and etPlay TeleScope are displayed.
   Use the etLine TeleScope to select and active a TAPI line device.
   Use the etPlay TeleScope to select the wave play audio device associated with the line device.

2. Using another telephone line (remote phone) make a call to the telephony device.

3. Answer the call.
   If you have a handset attached to the telephony device then you may answer by picking up the handset (if your device supports this feature).  Otherwise you may click the Answer button.

4. To play the wave file over the selected Windows wave play audio device click the Play button

5. To monitor digits check the MonitorDigits checkbox then press the digits on the remote parties telephone.
   The digits will be displayed in the editbox below the MonitorDigits checkbox.

6. To stop monitoring for digits do any one of the following:

• Press the "#" key on the remote phone

• Hang up the remote phone

• Click the hung up button

• Uncheck the MonitorDigits checkbox

• Hang up the attached phone (if your device supports this feature)

7. Hang up the call.
   If you have a handset attached to the telephony device then you may hang up by hanging up the handset (if your device supports this feature).  Otherwise you may click the Hangup button.

Download this Sample Program

For use with TeleTools v3.7

How this Sample Program Works

When the program is loaded the etLine and etPlay controls are enabled and their TeleScopes are displayed.  The remaining controls are disabled.  

When an inbound call is detected by etLine the etLine1.OnOffering event handler routine is executed which enables the Answer button.

When a call is answered the etLine1.OnConnected event handler routine to be executed.  This routine disables the Answer button and enabled the Play button, MonitorDigits checkbox and hangup button.

When the Play button is clicked it will be disabled, the etPlay1.Source.FileName property is set and then the  etPlay1.Device.Active property is set to true to begin playing the wave file.   Notice that etPlay1.Source.FileName is set to a list of files.  etPlay combines these files and plays them as one.  

When a wave file is done playing the etPlay1_OnDone event handler routine is executed.  This routine enables the Play button so the wave file may be played again.

When the MonitorDigits checkbox is checked the etLine control will detect DTMF tones and display them in the Digits editbox.  The etLine1_OnDigitReceived event handler routine is executed each time a DTMF tone is detected. If a "#" is detected then Monitoring digits will be deactivated.

When the Hang up button is clicked etPlay will stop playing wave files and the call will be hung up.

When the remote party hangs up the phone the etLine1_OnDisconnected will execute.  This routine calls the Hang up buttons click event handler routine; CommandHangup_Click

When a call not longer exists the etLine1_OnIdle event handler routine is executed.  This routine disables all of the buttons in preparation for the next inbound call.

Release Notes

April 3, 2003

Published