STREAM FILE —
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