Manipulating audio names and user greetings

Custom server subroutines are also provided for manipulating audio names and user greetings.

In versions of IBM DirectTalk for AIX before 2.2, audio names and user greetings were always compressed before they were stored. In Blueworx Voice Response, when you use custom server subroutines to create an audio name or user greeting, you can specify whether the voice data is stored in compressed or uncompressed form. This means that if you have custom servers that were written to process only compressed audio names and user greetings, you must modify them in case they now have to process either type of voice data. In such a custom server, you must test each occurrence of the following structures:

When you use the CA_Create_Audio_Name() subroutine, note that it is the AUDIO_NAME_INFO_ST structure that determines whether the voice data is stored in compressed or uncompressed form: the Audio Name Compression Type system parameter has no effect on how this voice data is stored. The GREETING_INFO_ST structure performs the same function for user greetings.

When you want to retrieve an audio name, use the CA_Get_Audio_Name() subroutine. You specify the name or greeting you want to retrieve in a AUDIO_NAME_PARM_ST structure. In this structure you must specify a valid compression type (compressed or uncompressed) for the audio name, but the subroutine retrieves the name in whatever format it was recorded. For this reason, whenever you use the CA_Get_Audio_Name() subroutine, you must first call the CA_Get_Audio_Name_Info() subroutine to determine the compression type of the audio name. You must then calculate how much storage to allocate to store the name.

Similarly, when you want to retrieve a user greeting, always use the CA_Get_Greeting_Info() subroutine before the CA_Get_Greeting() subroutine. For the latter subroutine, use the GREETING_PARM_ST structure to specify the name of the greeting you want.

Table 1 summarizes what determines the compression type of audio names.

Table 1. Creating and retrieving audio names

Action

Subroutine

Specify audio name

Compression type

Create

CA_Create_Audio_ Name()

AUDIO_NAME_INFO_ ST

Specify in AUDIO_NAME_INFO_ ST.

Retrieve

CA_Get_Audio_Name()

AUDIO_NAME_PARM_ ST

Retrieved in the format in which it was recorded.