Technical Helpweb

- more articles

'SimplePhone' sample with 'APSoundDevice' Audio Provider

What is 'SimplePhone'? 

SimplePhone is a Visual Basic 2005 Diva Component API sample that makes or receives voice calls through a Diva hardware adapter (analog, basic rate ISDN or E1/T1) or through a Diva virtual adapter such as Diva SoftIP - SIP. 

SimplePhone uses the APSoundDevice Audio Provider DLL (provided here as both a Visual C project and as a compiled DLL) to interface to the sound hardware in the PC so that you can use microphone and speakers (or a headset) connected to the PC. APSoundDevice is written using the Diva C/C++ API. 

This sample serves three purposes:

• It shows how to create an Audio Provider using the Diva C/C++ API
• It shows how to access an Audio Provider from a program that uses the Diva Component API
• It shows how to create an application that uses the Diva Component API for the top-level GUI interface while the Diva C/C++ API is used for timing-critical low-level streaming operations.

Audio Providers 

Using the APSoundDevice sample as a basis, you can write an Audio Provider to interface to other media hardware devices or to 3rd-party software modules such as text to speech (TTS) and automated speech recognition (ASR) engines. 

A sample Audio Provider that provides an interface to the Microsoft Speech API (SAPI) is supplied in the 'samples\Visual_C++\MS_Speech\SAPIAudioProvider' directory in the Diva SDK.

This approach is also appropriate for other applications that process voice or fax streams in real-time. 

Using SimplePhone 

• If you have not already done so, please download and install the Diva SDK
• Download the SimplePhone executables. Unzip the files and ensure that SimplePhone.exe, APSoundDevice.dll and DIVASDKLib.dll are all in the same directory.
• Run SimplePhone.exe.

Common problems:

• "Load APSoundDevice failed - Check SDK version" - You haven't installed the latest version of the Diva SDK.
• "Load APSoundDevice failed - check DLL is present" - The AudioProvider.dll is not in the same directory as SimplePhone.exe
• "Could not load file or assembly 'Interop.DIVASDKLib" - The DIVASDKLib.dll is not in the same directory as SimplePhone.exe
• "SDK initialisation failed - re-install SDK" - The Diva SDK is not installed
• "No Diva hardware or software devices found" - No Diva hardware or virtual adapters found

Downloads:

• SimplePhone executables (zip)
• SimplePhone source (text)
• SimplePhone Visual Basic 2005 Project (zip)
• APSoundDevice Audio Provider Visual C project (zip)

Note
The SDK sample code is not part of any standard Dialogic product and is provided to you solely for the purpose of assisting you in the development of your applications with Diva SDK. The code is provided "AS IS", without warranty of any kind. Dialogic shall not be liable for any damages arising out of your use of sample code, even if it has been advised of the possibility of such damages.