Record()¶

Synopsis¶

Record to a file.

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