ControlPlayback()

`ControlPlayback()`
	Appendix B. Applications in the dialplan

ControlPlayback()

Appendix B. Applications in the dialplan

`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)


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 -

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 -


`ContinueWhile()`	\|	`DateTime()`

ControlPlayback()

WARNING: ALPHA-VERSION!

`ControlPlayback()`