Asterisk™: будущее телефонии Второе издание - Меггелен Джим Ван

L( x [: у ][: z ])

Продолжительность звонка ограничивается x миллисекундами, дается предупреждение, когда осталось у миллисекунд, и предупреждение повторяется каждые у миллисекунд вплоть до истечения допустимой продолжительности разговора. Параметр x - обязательный; y и z - необязательные. Для обеспечения дополнительного контроля могут использоваться следующие специальные переменные:

LIMIT_PLAYAUDIO_CALLER=yes|no

Определяет, воспроизводится ли звуковой файл для вызывающего абонента. По умолчанию - yes.

LIMIT_PLAYAUDIO_CALLEE=yes|no

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

LIMIT_TIMEOUT_FILE= имяфайла

Определяет, какой файл воспроизводится, когда время истекло. LIMIT_CONNECT_FILE= имяфайла

Определяет, какой файл воспроизводится в начале вызова. LIMIT_WARNING_FILE=имяфайла

Определяет, какой файл воспроизводится, если определен аргумент y. По умолчанию проговаривается оставшееся время.

m[класс]

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

M( x [ "аргумент ])

При соединении выполняется макрос x и передаются (необязательно) аргументы, разделенные символом ". Макрос также может задавать одно из приведенных ниже значение для переменной канала MACRO_RESULT, чтобы обозначить, что должно произойти после завершения макроса:

ABORT (прервать)

Повесить трубку на обоих концах соединения. CONGESTION (перегрузка)

Действовать так, как при перегрузке линии. BUSY(занято)

Действовать так, как при занятости линии. Если задана опция j, вызов перенаправляется в приоритет n + 101, где n - текущий приоритет.

CONTINUE (продолжить)

Отключить вызываемую сторону и продолжить выполнение диал- плана.

GOTO:<контекст>"<добавочныйномер>"<приоритет>

Выполнить переадресацию вызова в заданную точку.

В сочетании с этой опцией нельзя использовать никакие дру- I гие дополнительные опции, определяющие действия после ответа. Также сервисы офисной АТС не выполняются для вызванного канала, поэтому не получится задать значения времени ожидания посредством функции TIMEOUT в этом макросе.

n

Эта опция является модификатором для экранного/конфиденциального режима (screen/privacy mode). Она определяет, что вступления (introductions) не должны сохраняться в папке priv-callerintros.

N

Эта опция является модификатором для экранного/конфиденциального режима. Она указывает Asterisk не экранировать вызов, если представлен Caller ID.

o

Использует Caller ID, полученный по входящему плечу вызова, в качестве Caller ID на исходящем плече вызова. Это полезно, если вы принимаете вызов и перенаправляете его в другую точку, но хотите передать Caller ID из входящего плеча вызова, а не заменять его локальным Caller ID. Таким было поведение по умолчанию Asterisk в версиях до 1.0.

O[x]

Эта опция включает режим услуг оператора (Operator Services) для канала Zaptel. При использовании в не-Zaptel-интерфейсе эта опция будет проигнорирована. После ответа вызываемой стороны (предположительно, станции услуг оператора) источник вызова теряет контроль над линией. Вызывающий абонент может повесить трубку, но линия не будет освобождена да тех пор, пока не повесит трубку вызываемая сторона (оператор). Если аргумент не задан или задана 1, то, когда вызывающая сторона вешает трубку, ее телефон немедленно зазвонит. Если задан аргумент 2, то, когда «оператор» выполняет мгновенный сброс магистральной линии, зазвонит телефон вызывающего абонента.

p

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

P[(x)]

Задает конфиденциальный режим. Может быть задан необязательный параметр x как значение семейство/ключ локальной базы данных AstDB. Эта опция полезна для принятия звонков на основании черного списка (явно запрещающего звонки с указанных номеров) или белого списка (явно перечисляющего номера, звонки с которых должны приниматься обязательно). См. также LookupBlacklist().

Указывает генерировать сигналы вызова вызывающему абоненту, не передавая никаких аудиосигналов до тех пор, пока не получен ответ на звонок. Обычно этот флаг не нужен, поскольку Asterisk сама будет генерировать сигналы вызова.

S(x)

Прерывает звонок через x секунд после ответа вызываемой стороны.

Разрешает вызываемой стороне переадресовать звонок, нажав кнопку #. Пожалуйста, обратите внимание, что, если используется эта опция, повторные приглашения выключены, поскольку Asterisk необходимо отслеживать вызов, чтобы зафиксировать момент нажатия кнопки # вызываемой стороной.

Разрешает ответившему абоненту переадресовывать соединенный вызов, нажав кнопку #. Опять же, обратите внимание, что при использовании этой опции повторные приглашения выключены, поскольку Asterisk необходимо отслеживать вызов, чтобы зафиксировать момент нажатия кнопки # вызываемой стороной.

Разрешает ответившему абоненту начинать и останавливать запись разговора на диск, нажав последовательность кнопок automon (которая задана в файле features.conf). Если задана переменная TOUCH_ MONITOR, ее значение будет передано как аргумент в приложение Monitor() в начале записи. Если переменная не задана, в Monitor() передаются значения по умолчанию, WAV||m.

W

Позволяет вызывающему абоненту записывать разговор на диск, нажав последовательность кнопок automon (которая задана в файле features.conf).

k

Позволяет ответившему абоненту парковать вызов (переключать на другой телефон), передав DTMF-последовательность, определенную для парковки вызовов в файле features.conf.

K

Позволяет вызывающей стороне парковать вызов, передав DTMF- последовательность, определенную для парковки вызовов в файле features.conf.

Если включен аргумент URL, этот URL будет отправлен каналу (если поддерживается).

Если задать переменную канала OUTBOUND_GROUP перед вызовом Dial(), все каналы типа peer, созданные данным приложением, будут помещаться в эту группу вызовов. В следующем примере все каналы peer, созданные приложением Dial(), будут частью группы вызовов test:

; используем OUTBOUND_GROUP exten => 123,1,Set(OUTBOUND_GROUP=test) exten => 123,n,Dial(IAX2/anotherbox/12345) Если задана переменная OUTBOUND_GROUP_ONCE, все каналы peer, созданные данным приложением, будут помещены в эту группу. Однако, в отличие от OUTBOUND_GROUP, эта переменная будет сброшена после использования.

Приложение Dial() при выходе задает следующие переменные:

DIALEDTIME (время дозвона)

Общее время с момента начала выполнения Dial() до завершения.

ANSWEREDTIME (время ответа)

Общее время вызова.

DIALSTATUS (статус звонка)

Статус звонка, задается одним из следующих значений:

CHANUNAVAIL (канал недоступен) Канал недоступен.

CONGESTION (перегрузка)

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

NOANSWER (не отвечает)

Канал не ответил в течение времени, заданного опцией времяожи- дания-ответа.

BUSY (занят)

Вызываемый канал в настоящее время занят.

ANSWER(ответ)

Канал ответил на вызов.

CANCEL (отмена)

Вызов был отменен.

DONTCALL (не вызывать)

Вызов был переведен в состояние DONTCALL опциями экранирования или конфиденциальности.

TORTURE (отключение)

Вызов был переведен в состояние TORTURE опциями экранирования или конфиденциальности.

INVALIDARGS (недействительные аргументы)