DTMF-генератор на Asterisk
Приложение SendDTMF превращает Asterisk в генератор тональных сигналов: он может имитировать нажатия клавиш, проходить голосовые меню и проверять, как удалённая сторона принимает DTMF. Собираем тестовый номер, который отправляет цифры с заданным интервалом.
Зачем Asterisk генерировать DTMF
DTMF — это тональные сигналы, которые телефон отправляет при нажатии клавиш. Обычно Asterisk их принимает: в голосовых меню, при вводе PIN-кодов, при переводе вызова. Но он умеет и отправлять их сам приложением SendDTMF. Это пригодится, когда нужно:
- автоматически пройти голосовое меню чужой АТС, например набрать добавочный номер после ответа автосекретаря;
- проверить, как оператор или шлюз передаёт DTMF — доходят ли цифры, не дублируются ли, не теряются ли на транскодировании;
- держать соединение активным: некоторые сервисы разрывают «молчащий» вызов, а периодический сигнал показывает, что на линии кто-то есть;
- проверить стойкость защиты собственных сервисов, например конференц-комнат с PIN-кодом: насколько быстро система блокирует перебор.
Проверять подбором кодов можно только свои системы или системы, владелец которых дал на это согласие.
Синтаксис SendDTMF
SendDTMF(digits[,timeout_ms[,duration_ms[,channel[,options]]]])
digits— строка из цифр0–9,*,#и буквA–D. Символwвставляет паузу 0,5 секунды,W— 1 секунду.timeout_ms— пауза между цифрами, по умолчанию 250 мс.duration_ms— длительность каждого сигнала.channel— имя другого канала, если цифры надо отправить не в текущий.
Пример: ответить, подождать приветствия меню и набрать добавочный 205:
exten => 3559010,1,Dial(PJSIP/4951234567@provider,60,D(ww205))
Опция D() у Dial отправляет цифры вызываемой стороне сразу после ответа. Две w дают секунду паузы.
Генератор по таймеру
Задача: тестовый номер отвечает и в течение заданного времени каждые 30 секунд отправляет #, а ещё через 30 секунд — 1. Один круг занимает минуту, число кругов задаёт длительность. Номер 3559000 работает около 10 минут, 3559001 — около получаса.
[dtmf-gen]
exten => 3559000,1,Set(ROUNDS=10)
same => n,Goto(dtmf-loop,s,1)
exten => 3559001,1,Set(ROUNDS=30)
same => n,Goto(dtmf-loop,s,1)
[dtmf-loop]
exten => s,1,Answer()
same => n,Wait(2)
same => n,Set(i=0)
same => n,While($[${i} < ${ROUNDS}])
same => n,SendDTMF(#)
same => n,Wait(30)
same => n,SendDTMF(1)
same => n,Wait(30)
same => n,Set(i=$[${i} + 1])
same => n,EndWhile()
same => n,Hangup()
Переменная ROUNDS устанавливается в канале до перехода и остаётся доступной в контексте dtmf-loop. Внутри цикла не нужен Goto на первую строку: EndWhile() сам возвращает выполнение к While. Если добавить Goto(s,1), счётчик будет обнуляться каждый круг, и вызов никогда не закончится.
Для страховки ограничьте максимальную длительность канала — добавьте сразу после Answer() строку:
same => n,Set(TIMEOUT(absolute)=2000)
После 2000 секунд Asterisk завершит вызов, даже если в логике цикла ошибка.
DTMF из звукового файла
Иногда нужно передать сигнал именно как звук в разговорном канале — например, если на другой стороне аналоговая линия или устройство не понимает RFC 4733. Тогда вместо SendDTMF используют PlayTones или заранее записанный файл:
; тон DTMF «1» длительностью 200 мс
exten => s,n,PlayTones(697+1209/200)
exten => s,n,Wait(1)
exten => s,n,StopPlayTones()
Частоты DTMF — сочетание низкой (697, 770, 852, 941 Гц) и высокой (1209, 1336, 1477, 1633 Гц) составляющих. Для «1» это 697 + 1209 Гц, для «#» — 941 + 1477 Гц.
Звук в канале чувствителен к кодеку: при сжатии G.729 или в джиттер-буфере тоны искажаются. Для таких тестов используйте G.711 (alaw или ulaw).
Режимы передачи DTMF
От настройки endpoint в pjsip.conf зависит, как SendDTMF доставит цифры:
| dtmf_mode | Как передаётся | Когда подходит |
|---|---|---|
rfc4733 |
Отдельные RTP-события | Большинство операторов и IP-телефонов |
inband |
Звуком в аудиопотоке | Старые шлюзы, только с G.711 |
info |
SIP-сообщения INFO | Отдельные операторы и шлюзы |
auto |
rfc4733, если поддерживается, иначе inband | Смешанные устройства |
auto_info |
rfc4733 или INFO | Если inband нежелателен |
Режим rfc4733 — это бывший rfc2833 из chan_sip. Набор доступных значений немного отличается между версиями, поэтому сверьтесь с документацией своей версии Asterisk.
Запуск генератора из консоли
Не обязательно звонить на тестовый номер с телефона. Вызов можно создать из консоли и сразу передать в контекст генератора:
asterisk -rx "channel originate PJSIP/4951234567@provider extension s@dtmf-loop"
Переменную ROUNDS при таком запуске нужно задать в самом контексте или через call-файл с Setvar. Механизм call-файлов подробно описан в статье про автообзвон на Asterisk.
Отладка
- Откройте консоль
asterisk -rvvvvv. - Включите вывод SIP-сообщений:
pjsip set logger on. - Для RTP-событий используйте
rtp set debug on— в выводе будут видны пакеты с DTMF-событиями.
Если цифры уходят, но удалённая сторона их не распознаёт, сравните payload type события telephone-event в SDP обеих сторон. Несовпадение — частая причина «потерянных» DTMF у операторов.
Ещё один приём работы с циклами разобран в статье как проиграть звуковой файл несколько раз.
Частые вопросы
Почему удалённая сторона не видит DTMF от SendDTMF?
Чаще всего не совпадает режим передачи. Проверьте dtmf_mode у endpoint: rfc4733, inband, info или auto, и что выбранный режим поддерживает оператор или устройство на другой стороне.
Как сделать паузу между цифрами в SendDTMF?
Символ w в строке цифр означает паузу в полсекунды, W — секунду. Например, SendDTMF(1w2w#) отправит 1, 2 и решётку с паузами.
Можно ли отправить DTMF в уже идущий разговор?
Да: SendDTMF умеет отправлять цифры в другой канал, его имя передаётся четвёртым параметром. Через AMI для этого есть действие PlayDTMF.
Как распознать DTMF, которые прислали Asterisk?
Read, WaitExten и Background принимают цифры от звонящего. Для отладки включите в консоли core set verbose 5 и core set debug 1 — получение DTMF будет видно в журнале.