tapiPlay (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Format of .WAV file
Required configuration

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Telephony functions

tapiPlay (Function)

In french: telJoue

Plays a sound file (.WAV) for the specified line. You have the ability to:

play the message of the answerphone when a call is received,
play a message during an outgoing call (after tapiDial for example).

Example

PROCEDURE CallDetection(nServiceID, nCallID, nStatus)

// Picks up the line to answer a call
tapiAnswerCall(nCallID)

// Trigger the answerphone
tapiPlay("answerphone.wav", tapiPlayLock, nCallID)

// If the star key was pressed
// the answerphone is stopped
IF Position(tapiKeyPressed(nCallID), "*") >0 THEN
tapiStop(nCallID)
END

Syntax

<Result> = tapiPlay(<Name of WAV file> [, <Option> [, <Call identifier>]])

<Result>: Boolean

True if the file is played,
False otherwise. If the file is not played, check the format of the WAV file. See remarks for more details.

<Name of WAV file>: Character string (with quotes)

Name and path of the .WAV file to play. The file extension must be specified.

<Option>: Optional integer

Option used to specify the options of sound file to play.
tapiPlayLock The function is locking: the code continues to run only when the sound was played.
If this parameter is not specified, the function returns a result as soon as the sound starts to play.
tapiPlayLoop The sound is played in loop.
If this parameter is not specified, the sound is played once only.

<Call identifier>: Optional integer

Identifier of the call to handle. This identifier is defined in the WLanguage procedure called by tapiListen. The current call is handled if this parameter is not specified.

Remarks

Format of .WAV file

Caution: Some WAV formats are not compatible with the telephony. You must use the CCITT G.711 A-Law, u-Law compression codec supplied by Microsoft.

Note: A GSpot program allows you to check the codec of the.WAV file.

Required configuration

This function can only be used in Windows XP. To use this function with the other operating systems, the Unimodem Voice of Microsoft must be installed.

Reminder: The telephony functions are using the TAPI 2.0 technology. This technology can be used on all the systems.

However, if the system used is Windows NT4, the service pack 4 (or later) must be installed.

Note: The TAPI 3.0 technology (and later) is not supported in this version.

Telephony functions use TAPI 2.0 technology and/or TAPI 3.1 technology. These technologies can be used on all systems.

Versions 24 and later
TAPI 3.1 technology is now supported.

New in version 24
TAPI 3.1 technology is now supported.

TAPI 3.1 technology is now supported.

Component : wd240com.dll