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_mixed_messages()
int
ivr_mixed_messages(int call, IVRMIXEDPROMPTS *prompts, int numprompts, int
allow_interrupt)
The
ivr_mixed_messages function plays a series of prompts to the specified
call. The menu items can either be text or wave files.
Parameters
|
int
|
call
|
Specifies which
call play to:
CALL_PRIMARY: Play to Primary Call
CALL_SECONDARY: Play to Secondary Call
|
|
IVRMIXEDPROMPTS *
|
prompts
|
Array of IVRMIXEDPROMPTS
structures containing the pathnames or text 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
IVRMIXEDPROMPTS prompts[4] = {
{PROMPT_WAVE,"D:\\sounds\\Swelcome.wav"},
{PROMPT_TEXT,"This is a text prompt."},
{PROMPT_WAVE,"D:\\sounds\\SGoodbye.wav"},
{PROMPT_TEXT,"Another Text Prompt"}
};
IVRDIGITS ivrd;
if(ivr_mixed_messages(CALL_PRIMARY,prompts,4,INTERRUPT) != IVR_SUCCESS){ ...handle error; }
|
