SMplaystrph
Previous Topic  Next Topic 

Synopsis:

       SMplaystrph(vox_chan,ipf_id,str_words[,dataformat,samplerate])


Arguments:

       vox_chan The voice channel

       ipf_id The IPF id as specified in the PR.PAR file

       str_words A string containing the list of words to play from the IPF file (as ASCII values)

       [dataformat] Optional format of ipf file

       [samplerate] Optional sample rate of ipf file


Description:  This function allow for a string of words/phrases from the IPF file specified by ipf_id to be played.        The string_words string contains the string of ascii values each of which represents the id of a prompt within the IPF file to play.


For example:


       x=SMplaystrph(vox_chan,1,"`01`04`06");


The above function call will play the first, fourth and sixth prompts from IPF file with ipf_id = 1


Returns:  The function will return the terminating event that caused the play function to complete which will be one of the following as defined in ACULAB.INC


# Terminating events

const TERM_ERROR       = -1;

const TERM_TONE          = 1;

const TERM_ABORT       = 6;

const TERM_EODATA    = 7;


The function may also return other negative error codes if invalid parameters were specified.