ThbWaveIn is a component to use a waveform-audio input device for recording.

The ThbWaveIn component can be used to record audio datat to wave files through any available Windows waveform-audio input device including voice modems, specialized telephony hardware and common sound cards.

Voice modems use the UnimodemV Telephony Service Provider (TSP) to interact with TAPI. The UnimodemV TSP is limited to using the wave format "PCM 8000 Hz, 16 Bit, Mono", this is the format used by ThbWaveIn for recording too.

Recording wave files

To record a wave file through a waveform-audio input device, select the device using the DeviceName and DeviceID properties of ThbWaveIn. Set the Filename property the the path, you want the recorded data is to be saved. Recording begins directly after setting ThbWaveIn.Active property to True and stops with setting ThbWaveIn.Active to False.

Using ThbWaveIn along with ThbTapiLine resp. ThbTapiCall

This will allow you to record audio heard over the phone line.

The ThbTapiLine.WaveIn and ThbTapiCall.WaveIn properties are used to associate the components. The ThbTapiLine.WaveIn.Available indicates whether the telephony device has a wave record audio device associated with it. The ThbTapiLine.Active property must first be set to True prior checkingTapiLine.WaveIn.Available. The ThbTapiLine.WaveIn.DeviceID property holds the Windows ID of the waveform-audio input device associated with the TAPI line device.

If a connection is established using ThbTapiLine, the ThbTapiCall.WaveIn.DeviceID property can be used to record wave files over the channel to be heard by the remote party. Set the ThbWaveIn.DeviceID property to the value in the ThbTapiCall.WaveIn.DeviceID to ensure that you are using the correct wave audio device. When using ThbWaveIn and ThbWaveIn along with ThbTapiLine it is importent to remember to stop recording and recording any wave files prior to hanging up a call or when the ThbTapiLine.OnDisconnected event is fired.

Using ThbWaveIn along with ThbTapiPhone

This allows you to record the audio heard on the handset, headset or speakerphone.

The ThbTapiPhone.WaveIn properties are used to associate the ThbTapiPhone and ThbWaveIn components. The ThbTapiPhone.WaveIn.Available property indicates whether the TAPI phone device has a waveform-audio input device associated with it. The ThbTapiPhone.WaveIn.DeviceID holds the Windows ID of the wave record device associated with the TAPI phone device. Set the ThbWaveIn.DeviceID property to the value in the ThbTapiPhone.WaveIn.DeviceID to ensure that you are using the correct waveform-audio input device.