STREAM FILE

STREAM FILE filename escape_digits [sample_offset]

 

Play the audio file indicated by filename, allowing playback to be interrupted by the digits specified by escape_digits, if any. Use double quotes for the digits if you wish none to be permitted. If sample_offset is provided, the audio will seek to sample_offset before playback starts.

Remember, the file extension must not be included in the filename.

Return values:



0

Playback completed with no digit pressed



-1

Error or hangup



value

ASCII value of digit (if pressed), in decimal