Shkerka.ruзаметки админа
Asterisk и IP-АТС

Как в Asterisk проиграть звуковой файл несколько раз

Опубликовано: Обновлено: 3 мин чтенияАвтор: Редакция Shkerka.ru

Чтобы проверить, жива ли АТС, удобно держать тестовый номер, который отвечает и проигрывает сообщение. Разбираем четыре способа повторить звуковой файл в диалплане Asterisk — от простого Playback до цикла с счётчиком.

Задача: номер для проверки АТС

Звонок на служебный номер — самый быстрый способ убедиться, что IP-АТС на Asterisk в сети и обрабатывает вызовы. Номер должен ответить и проиграть сообщение: если звук есть, регистрация, маршрутизация и медиапоток работают. Полной диагностики такой тест, конечно, не даёт: очереди, транки и внешние линии проверяются отдельно.

Ниже — четыре варианта, которые отличаются тем, сколько раз и как долго звучит файл.

Способ Что делает Когда подходит
Playback + Hangup Проигрывает файл один раз и кладёт трубку Простейшая проверка «отвечает / не отвечает»
MusicOnHold Крутит класс музыки на удержании Нужен долгий непрерывный звук
Dial с опцией m Звонящий слышит музыку вместо гудков, пока ждёт ответа Тест маршрута до абонента
While / Goto Повторяет файл заданное число раз Нужен точный счётчик повторов

Способ 1. Проиграть файл и завершить вызов

Самый короткий диалплан: ответить, проиграть сообщение, подождать и положить трубку. Повтора здесь нет, но для теста доступности этого достаточно.

[test-number]
exten => 911,1,Wait(1)
 same => n,Answer()
 same => n,Playback(tt-weasels)
 same => n,Wait(2)
 same => n,Hangup()

Wait(1) перед Answer() даёт телефону время на установку соединения, иначе начало фразы иногда «съедается». Имя файла пишется без расширения: Asterisk сам подберёт формат, совместимый с кодеком канала.

Способ 2. Музыка на удержании

Если звук должен идти долго, проще отдать вызов в Music On Hold. Сначала заведите отдельный класс в musiconhold.conf, чтобы не смешивать тестовую мелодию с музыкой для клиентов:

[test-loop]
mode=files
directory=/var/lib/asterisk/moh/test
sort=alpha

Затем в диалплане:

exten => 912,1,Answer()
 same => n,MusicOnHold(test-loop,60)
 same => n,Hangup()

Второй параметр MusicOnHold — длительность в секундах. Без него вызов будет висеть, пока звонящий сам не положит трубку, и тестовый номер займёт канал у транка, если на него позвонят снаружи. После правки конфигурации выполните в консоли moh reload.

Способ 3. Опция m в Dial

Когда нужно проверить не саму АТС, а маршрут до внутреннего абонента, используйте Dial с опцией m: вместо гудков звонящий услышит музыку выбранного класса, пока абонент не ответит.

exten => 913,1,Dial(PJSIP/101,30,m(test-loop))
 same => n,Hangup()

В старых конфигурациях на chan_sip строка выглядела как Dial(SIP/101,30,m(test-loop)). Начиная с Asterisk 21 модуль chan_sip удалён, поэтому используйте PJSIP.

Способ 4. Цикл While с счётчиком

Если файл нужно повторить ровно N раз, пригодится цикл. Вынесите его в отдельный контекст, чтобы не мешать остальной логике:

exten => 914,1,Answer()
 same => n,Goto(loop-msg,s,1)

[loop-msg]
exten => s,1,Set(i=0)
 same => n,While($[${i} < 5])
 same => n,Playback(tt-weasels)
 same => n,Wait(1)
 same => n,Set(i=$[${i} + 1])
 same => n,EndWhile()
 same => n,Hangup()

Частая ошибка в таких диалпланах — поставить Goto(s,1) внутри цикла: тогда счётчик каждый раз обнуляется и вызов крутится бесконечно. Возвращаться нужно через EndWhile(), а не через переход на первую строку.

Если хотите, чтобы звонящий мог прервать повтор и выбрать пункт меню, замените Playback на Background, а после цикла добавьте WaitExten(5) и экстеншены 1, 2, t (таймаут) и i (неверный набор).

Проверка

  1. Сохраните extensions.conf и выполните в консоли asterisk -rvvv команду dialplan reload.
  2. Убедитесь, что контекст подключён к контексту абонентов: dialplan show 914@from-internal должен показать ваши строки (подставьте свой контекст).
  3. Позвоните на номер с внутреннего телефона и посмотрите в консоли, какие приложения выполняются.

Если в консоли видно Playback с предупреждением File tt-weasels does not exist, проверьте путь к звукам командой core show settings (строка Data directory) и наличие русского пакета звуков в каталоге sounds/ru.

Частые вопросы

Какой способ выбрать для тестового номера?

Для проверки «станция отвечает» хватает Answer, Playback и Hangup. Если звонящему нужно слышать звук долго, используйте MusicOnHold с таймаутом или цикл While с ограничением числа повторов.

Почему Playback не находит файл?

Имя файла указывается без расширения, а путь — либо абсолютный, либо относительно каталога sounds с учётом языка канала. Проверьте, что файл лежит в /var/lib/asterisk/sounds/ru или /usr/share/asterisk/sounds/ru и имеет поддерживаемый формат (gsm, wav, ulaw, sln).

Можно ли прервать повтор нажатием клавиши?

Да: вместо Playback используйте Background, а затем WaitExten. Нажатая цифра переведёт вызов на соответствующий экстеншен в том же контексте.

Работает ли этот диалплан в Asterisk 18–21?

Да. Приложения Answer, Playback, MusicOnHold, While/EndWhile и Goto не менялись. Изменился только путь к звукам в некоторых пакетах дистрибутивов, его стоит проверить командой core show settings.