B.22. ControlPlayback()

Plays a sound file with fast forward and rewind controls.
ControlPlayback(soundfile[,skipms[,ffchar[,rewchar[,stopchar[,pausechar]]]]])
Plays the specified file; the caller can manipulate playback by pressing the defined keys ffchar and rewchar. The defaults are "#" (forward) and "*" (backward). Playback is stopped when stopchar is pressed (if it is defined). If the file does not exist, the application jumps to priority n+101, if it exists.
The pausechar option is similar in behavior to stopchar except that playback can be resumed by pressing pausechar a second time.
The skipms defines how far forward or backward ControlPlayback() will skip in the file when ffchar or rewchar is pressed.
Returns -1 if the caller hangs up during playback.
; play "symphony" to the caller with playback control:
exten => 123,1,ControlPlayback(symphony,5000,#,*,5,0)

Note

Internal help for this application in Asterisk 1.4:
  -= Info about application 'ControlPlayback' =- 

[Synopsis]
Play a file with fast forward and rewind

[Description]
  ControlPlayback(file[|skipms[|ff[|rew[|stop[|pause[|restart|options]]]]]]]):
This application will play back the given filename. By default, the '*' key
can be used to rewind, and the '#' key can be used to fast-forward.
Parameters:
  skipms  - This is number of milliseconds to skip when rewinding or
            fast-forwarding.
  ff      - Fast-forward when this DTMF digit is received.
  rew     - Rewind when this DTMF digit is received.
  stop    - Stop playback when this DTMF digit is received.
  pause   - Pause playback when this DTMF digit is received.
  restart - Restart playback when this DTMF digit is received.
Options:
  j - Jump to priority n+101 if the requested file is not found.
This application sets the following channel variable upon completion:
  CPLAYBACKSTATUS -  This variable contains the status of the attempt as a text
                     string, one of: SUCCESS | USERSTOPPED | ERROR
diff output to internal help in Asterisk 1.2:
- none -