|
|
IVR Software Library
ivr_speak_state
Database Systems Corp. (DSC) provides an API subroutine library of IVR Software routines that perform phone functions. The following is a description of one of the functions within this library that controls the IVR operation - ivr_speak_state.
The routine is from our C programming library, although this same routine has an equivalent for Visual Basic, .NET, C++ and Active-X. DSC provides a separate user guide for each of these languages.
Contact DSC to obtain the most current IVR manuals in your required programming language.
ivr_speak_state()
int
ivr_speak_state(int call,char *text, int allow_interrupt)
The
ivr_speak_state function speaks a state name to the specified call. It
attempts to read the state from a wave file of the same name, stored in the
"States" folder. If the state can not be found, it is then read with
standard text-to-speech. You can re-record the states already in this folder,
or add new abbreviations such as MX for Mexico and CN for Canada.
Parameters
|
int
|
call
|
Specifies which call to speak to.
It can be one of the following values.
CALL_PRIMARY: Speak to Primary Call
CALL_SECONDARY: Speak to Secondary Call
|
|
char *
|
text
|
the state name to be read
|
|
int
|
allow_interrupt
|
Specifies if a digit can interrupt the
state name.
It can be one of the following values.
NO_INTERRUPT: Do not allow reading to be interrupted by a digit
INTERRUPT: Allow reading 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
ivr_speak_state(CALL_PRIMARY, "AZ",
INTERRUPT);
|
|
