Команда 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