Aplicações do Dialplan do Asterisk 23
Descrição:A função
Record() permite gravar áudio em um arquivo no dialplan do Asterisk. Se o nome do arquivo contiver '%d', esses caracteres serão substituídos por um número incrementado em uma unidade a cada nova gravação. Para visualizar os formatos de arquivo disponíveis no seu sistema, utilize o comando
core show file formats. O usuário pode pressionar '#' para encerrar a gravação e continuar para a próxima prioridade. Se o usuário desligar durante a gravação, todos os dados serão perdidos e o aplicativo será encerrado.
Variáveis definidas após a gravação:- RECORDED_FILE – Contém o nome final do arquivo gravado, sem extensão.
- RECORD_STATUS – Indica o status final da operação:
- DTMF – Uma tecla DTMF de término foi recebida ('#' ou '*', dependendo da opção 't').
- SILENCE – O tempo máximo de silêncio foi atingido.
- SKIP – A linha ainda não estava atendida e a opção 's' foi especificada.
- TIMEOUT – A duração máxima foi atingida.
- HANGUP – O canal foi desligado.
- ERROR – Ocorreu um erro irrecuperável, resultando em um aviso nos logs.
Sintaxe:Record(filename.format,[silence,[maxduration,[options]]])
Parâmetros:- filename – (obrigatório) nome do arquivo.
- format – (obrigatório) formato do tipo de arquivo a ser gravado (ex: wav, gsm, etc).
- silence – número de segundos de silêncio permitidos antes de retornar.
- maxduration – duração máxima da gravação em segundos. Se omitido ou 0, não há limite.
- options – opções adicionais:
- a – Anexar à gravação existente em vez de substituir.
- n – Não atender, mas gravar mesmo que a linha ainda não tenha sido atendida.
- o – Sair quando 0 for pressionado, definindo a variável RECORD_STATUS como 'OPERATOR' em vez de 'DTMF'.
- q – Silencioso (não reproduzir tom de beep).
- s – Pular gravação se a linha ainda não estiver atendida.
- t – Usar '*' como tecla terminadora alternativa (DTMF) em vez do padrão '#'
- u – Não truncar silêncio gravado.
- x – Ignorar todas as teclas DTMF terminadoras e continuar gravando até o desligamento.
- k – Manter o arquivo gravado após desligamento.
- y – Terminar gravação se qualquer dígito DTMF for recebido.
Função relacionada: Dialplan Functions RECORDING_INFO.