Synopsis:

       term_event=SMplayph(vox_chan [,ipf_id, dataformat, samplerate])

Arguments:

       vox_chan – The voice channel

       [ipf_id] – Optional ipf_id (defaults to 1 if not specified)

       [dataformat] – Optional voice prompt format (defaults to SMDataFormatOKIADPCM)

`        [samplerate] – The sample rate of the file (defaults to 6000)

Description:  This function plays the set of words/phrases that have been added to the list with the SMword() function.      If the SMword() function was called specifying a ipf_id then any ipf_id specified in this fuction will be ignored for that particular word.     

If the optional argument ipf_id is not specified then it defaults to 1.     By default the words added using the SMword() function will play from the given ipf_id file (unless a specific one was specified in a call to SMword()).

The optional dataformat argument defines what the speech file format in the IPF file, and defaults to SMDataFormatOKIADPCM  (see SMplay() for a list of valid speech file formats).

The optional  samplerate can specify the same rate of the data in the IPF file and defaults to 6000 if not specified (see SMplay for a list of valid sample rates).

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.