Команда Playback()


Оригинал: http://www.voip-info.org/tiki-index.php?page=Asterisk+cmd+Playback

Назначение

Проигрывает звуковой файл

Описание

Playback(filename,options...)

Проигрывает заданный звуковой файл (Вам не нужно указывать расширение файла). Звуковые файлы, по умолчанию, находятся в директории /var/lib/asterisk/sounds (Этот путь может быть изменен в файле asterisk.conf).

Команда Playback совместима с многоязыковой поддержкой в Asterisk. Она будет искать подходящий файл в поддиректории, которая соответствует выбранному языковому коду (который назначен командой SetLanguage или, используя языковой код заданный по умолчанию для канала. Если файл не найден, тогда будет проигрываться файл, который не связан ни с каким из языков (из базовой директории).

Команда Playback будет проигрывать звуковой файл и, по окончании, возвратит управление. Сравните с командой Background, которая начинает проигрывать файл и сразу же возвращает управление, позволяя выполнять дальнейшие команды для канала Asterisk, проигрывая в фоне музыку из заданного файла.

Опции

skip: Задает проигрывать звуковой файл, если только канал уже в отвеченном состоянии. Если на канале еще не установлено соединение, команда Playback сразу же закончит работу без проигрывания файла.

noanswer: Задает проигрывать звуковой файл, но не переводить канал в отвеченное состояние (если он еще находится в неотвеченном состоянии). Не все каналы поддерживают проигрыш сообщений без перевода канала в отвеченное состояние.

Если не заданы опции skip и noanswer, тогда команда Playback сначала переведет канал в отвеченное состояние (если он еще находится в неотвеченном состоянии) и после этого начнет проигрывать звуковой файл.

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

Пример

exten => 500,1,Playback(tt-weasels,skip)

Коды возврата:

Возвращает -1, если соединение было прервано на канале или не найден заданный файл. Иначе, возвращает 0.

Ссылки по теме:

  • Команда ControlPlayback: Проигрывает звуковой файл с возможностью перемотки вперед, назад и останова
  • Команда Background: Проигрывает звуковой файл, в это время могут исполняться другие команды
  • Команда Playtones: Проигрывает список тонов, в это время могут исполняться другие команды
  • Команда MP3Player: Проигрывает MP3 файл или поток
  • Команда MusicOnHold
  • Звуковые файлы
  • Asterisk tips answer-before-playback: Что Вам нужно сделать, перед тем как проигрывать звуковые файлы на канале

Asterisk | Файлы конфигурации | План набора: extensions.conf | Список команд | Monitor