IVR Software Library
IVR Library Routine Descriptions
The following routine or parameter is maintained in the PACER and WIZARD IVR software library. These routines are developed for programmers who are creating and managing IVR application programs.
IVR programs can be written in C/C++ on Windows, Unix and Linux operating environments.
ivr_play_messages()
int
ivr_menu(int call, char **prompts, int numprompts, int allow_interrupt)
The
ivr_play_messages function plays a series of messages to specified call.
Parameters
|
int
|
call
|
Specifies which
call play to:
CALL_PRIMARY: Play to Primary Call
CALL_SECONDARY: Play to Secondary Call
|
|
char **
|
prompts
|
Array of null terminated string containing the pathnames
of the prompts to play.
|
|
int
|
numprompts
|
Number of prompts in the prompts array.
|
|
int
|
allow_interrupt
|
Specifies
if a digit can interrupt the prompts. It can be one of the following values.
NO_INTERRUPT: Do not allow prompts to be interrupted by a digit
INTERRUPT: Allow prompts to be interrupted by a digit
|
Return Value
Returns
IVR_SUCCESS on a successful function call. On error the function returns one
of the IVR Error Codes.
Example
char *prompts[129] = {
"D:\\ivrdemo\\prompt1.wav",
"D:\\ivrdemo\\prompt2.wav",
"D:\\ivrdemo\\prompt3.wav",
"D:\\ivrdemo\\prompt4.wav"
};if(ivr_play_messages(CALL_PRIMARY,prompts,4,INTERRUPT) != IVR_SUCCESS){ ...handle error; }
|
