ADSI_Set_Level

Use the ADSI_Set_Level state table to set the volume level (or loudness) at which Blueworx Voice Response transmits the voice data.

Voice data can lose some of its volume on long-distance telephone calls. The ADSI_Set_Level state table tells the PlayVoiceFromHost action that the volume is at a different level from the default level; this causes Blueworx Voice Response to transmit the voice data at a different level. This means you can make Blueworx Voice Response transmit the data either louder or quieter.

ASCII syntax

InvokeStateTable ("DIRECT", ADSI_Set_Level, set_level, level);

Entry point

set_level: You must specify the string set_level.

Description

level

Specify the volume_level element of the PLAY_VOICE_STREAM_PARM_ST structure, which is input to the CA_Play_Voice_Stream subroutine. This subroutine is described in the Blueworx Voice Response for AIX: Custom Servers information.

You can specify any level in the range -15 through 15. If you specify a value outside this range, the volume is set to the default level.

To increase the volume, specify a positive value; to decrease the volume, specify a negative value. The value you specify is added to the default volume level, which is normally set to -15 dB.

Results

The InvokeStateTable action terminates with a result that indicates whether or not the operation was successful. If it was not successful, the result shows the reason for the failure:

0: Success
9: Failure

Example

In this example, the maximum volume of the voice data is increased by 4 dB to -11 dB.

InvokeStateTable("DIRECT", ADSI_Set_Level, set_level, 4);