Record()¶

Synopsis¶

Record to a file.

Since¶

0.1.8

Description¶

If filename contains '%d', these characters will be replaced with a number incremented by one each time the file is recorded. Use core show file formats to see the available formats on your system User can press '#' to terminate the recording and continue to the next priority. If the user hangs up during a recording, all data will be lost and the application will terminate.

RECORDED_FILE - Will be set to the final filename of the recording, without an extension.
RECORD_STATUS - This is the final status of the command
- DTMF - A terminating DTMF was received ('#' or '*', depending upon option 't')
- SILENCE - The maximum silence occurred in the recording.
- SKIP - The line was not yet answered and the 's' option was specified.
- TIMEOUT - The maximum length was reached.
- HANGUP - The channel was hung up.
- ERROR - An unrecoverable error occurred, which resulted in a WARNING to the logs.

Syntax¶

Record(filename.format,[silence,[maxduration,[options]]])

Arguments¶

filename
- filename required
- format required - Is the format of the file type to be recorded (wav, gsm, etc).
silence - Is the number of seconds of silence to allow before returning.
maxduration - Is the maximum recording duration in seconds. If missing or 0 there is no maximum.
options
- a - Append to existing recording rather than replacing.
- n - Do not answer, but record anyway if line not yet answered.
- o - Exit when 0 is pressed, setting the variable RECORD_STATUS to 'OPERATOR' instead of 'DTMF'
- q - quiet (do not play a beep tone).
- s - skip recording if the line is not yet answered.
- t - use alternate '*' terminator key (DTMF) instead of default '#'
- u - Don't truncate recorded silence.
- x - Ignore all terminator keys (DTMF) and keep recording until hangup.
- k - Keep recorded file upon hangup.
- y - Terminate recording if any DTMF digit is received.

Generated Version¶

This documentation was generated from Asterisk branch 22 using version GIT