Команда MusicOnHold()


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

Назначение:

Проигрывает музыку ожидания (Music On Hold), неопределенно долго.

Описание:

MusicOnHold(class)

Проигрывает музыку ожидания (Music On Hold) по заданному классу class. Если этот параметр не определен, будет использован класс по умолчанию для данного канала. Если вы настроили музыку Music-On-Hold в файле конфигурации musiconhold.conf, то она будет автоматически проигрываться, если заданный екстеншен переводиться в режим ожидания (on hold). Эта команда ФОРСИРУЕТ проигрывание музыки ожидания.

Класс по умолчанию для MusicOnHold можно установить командой SetMusicOnHold.

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

Возвращает -1 при разрыве связи. Иначе выход из функции не происходит.

Пример

Есть екстеншен, определенный в файле extensions.conf, с принудительным включением музыки, командой MusicOnHold. Не забудьте ответить на вызов, перед включением музыки ожидания в линию. Иначе, проигрывание музыки ожидания может работать неправильно.
; Требуется команда Answer, т.к. команда MusicOnHold
; не переводит вызов в отвеченное состояние
exten => 6000,1,Answer
exten => 6000,2,MusicOnHold()

Принудительное включение музыки ожидания может быть необходимо в следующих ситуациях:
  1. когда происходит вызов на особый номер екстеншена
  2. когда приходит вызов на особый номер екстеншена
  3. когда у нас вызов в особо дорогую сеть
  4. когда происходит соединение с конференцией

(Интересно, а как мы будем дальше обрабатывать эти ситуации?)

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


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