Читать онлайн «Asterisk™: будущее телефонии Второе издание». Страница 109

Это приложение задает для переменной канала WAITSTATUS значение SILENCE или TIMEOUT.

; ожидаем трех пауз по 300 мс exten => 123,WaitForSilence(300,3)

Смотрите также

WaitForRing()

WaitMusicOnHold()

Ожидает заданное количество секунд, воспроизводя музыку во время ожидания

WaitMusicOnHold(задержка)

Воспроизводит музыку во время ожидания в течение заданного количества секунд. Если музыка во время ожидания недоступна, задержка все равно будет, но без музыки.

Возвращает 0 по завершении выполнения, или -1 при разрыве соединения.

; даем вызывающему абоненту пять минут ; послушать музыку во время ожидания exten => 123,1,Answer() exten => 123,2,WaitMusic0nHold(300) exten => 123,3,Hangup()

Смотрите также

SetMusicOnHold(), musiconhold.conf

While()

Начинает выполнение цикла while

While(выражение)

Начинает выполнение цикла while. Выполнение возвратится в эту точку, когда будет вызвано приложение EndWhile(), если раньше не будет выполнено условие выражения. Если условие выполнено, что приводит к завершению цикла, Asterisk продолжает выполнение диалплана со следующего приоритета после соответствующего приложения EndWhile().

exten => 123,1,Set(COUNT=1)

exten => 123,2,While($[ ${COUNT} < 5 ])

exten => 123,3,SayNumber(${COUNT})

exten => 123,4,Set(COUNT=$[${COUNT} + 1])

exten => 123,5,EndWhile()

Смотрите также

EndWhile(), ExitWhile(), GotoIf()

Zapateller()

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

Zapateller(опции)

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

Аргумент опции - это разделенный символами вертикальной черты список опций. Доступны следующие опции:

answer

Перед воспроизведением тона должно быть установлено соединение.

nocallerid

Zapateller воспроизводит тон, только если недоступна информация идентификатора вызывающего абонента.

; отвечаем на звонок и воспроизводим SIT-тон,

; если не получаем информации CallerID

exten => 123,1,Zapateller(answer\nocallerid)

Смотрите также

PrivacyManager()

ZapBarge()

Прослушивает (отслеживает) Zap-канал

ZapBarge([кaнaл])

Прослушивает заданный Zap-канал или предлагает ввести номер канала, если он не задан. Абоненты, говорящие по каналу, не смогут слышать вас и не получат никакого сигнала о том, что их разговор прослушивается.

Если канал не задан, вам будет предложено ввести номер канала. Введите 4# для Zap/4, например.

exten => 123,1,ZapBarge(Zap/2) exten => 123,2,Hangup()

Смотрите также

ZapScan()

ZapRAS()

Выполняет ISDN-сервер удаленного доступа Zaptel

ZapRAS(аргументы)

Выполняет RAS-сервер ISDN, используя pppd для текущего канала. Чтобы использовать эту функцию, канал должен быть выделенным (то есть PRI-источником) и Zaptel-каналом.

Чтобы поддерживать Zaptel, необходимо установить все патчи для pppd. аргументы - это разделенный символами вертикальной черты список аргументов.

Это приложение может использоваться только для ISDN-линий, и, чтобы ядро поддерживало ZapRAS(), необходимо установить все необходимые патчи. Также ядро должно поддерживать ppp.

exten => 123,1,Answer()

exten => 123,1,ZapRas(debug\64000\noauth\netmask\255.255.255.0\ 10.0.0.1:10.0.0.2)

ZapScan()

Сканирует Zap-каналы для прослушивания звонков

ZapScan([группа])

Предоставляет управляющему информационно-справочной службы удобный способ прослушивания Zap-каналов, используя кнопку # для выбора следующего канала и * для выхода. Можно ограничить сканирование конкретной группой каналов (определенной функцией GROUP()), задавая аргумент группа. exten => 123,1,ZapScan()

Смотрите также

ZapBarge()

C

Справочник по AGI

ANSWER

Отвечает на вызов, поступающий по каналу (если соединение еще не установлено, то есть трубка не снята). Возвращаемые значения:

Сбой.

0

Успешное выполнение.

CHANNEL STATUS

CHANNEL STATUS [имяканала]

Запрашивает статус канала, определенного параметром имяканала или, если канал не задан, текущего. Возвращаемые значения:

0

Канал свободен и доступен.

1

Канал свободен, но зарезервирован.

Канал подключен.

Производится набор номера.

По линии поступил вызов.

Линия подключена.

Линия занята.

DATABASE DEL

DATABASE DEL семейство ключ

Удаляет запись из базы данных Asterisk для заданного семейства и ключа.

Возвращаемые значения:

0

Сбой.

1

Успешное выполнение.

DATABASE DELTREE

DATABASE DELTREE семейство [деревоключей]

Удаляет семейство и/или дерево ключей из базы данных Asterisk. Возвращаемые значения:

0

Сбой.

1

Успешное выполнение.

DATABASE GET

DATABASE GET семейство ключ

Извлекает значение из базы данных Asterisk по заданному семейству и ключу.

Возвращаемые значения:

0

Не задано. 1 ( значение )

Значение задано (и приведено в круглых скобках).

DATABASE PUT

DATABASE PUT семейство ключ .значение

Добавляет заданное значение для указанного семейства и ключа или обновляет запись базы данных Asterisk.

Возвращаемые значения:

0

Сбой.

1

Успешное выполнение.

EXEC

EXEC приложение опции

Выполняет заданное приложение диалплана, включая опции. Возвращаемые значения:

-2

Не удалось найти приложение.

значение

Возвращаемое значение приложения.

GET DATA

GET DATA имяфайла [времяожидания] [максимум_цифр]

Воспроизводит аудиофайл, заданный параметром имяфайла, и принимает DTMF-последовательность максимальной длиной максимум_цифр. Подобно приложению диалплана Background(). Возвращаемое значение: значение

Цифры, полученные от вызывающего абонента.

GET FULL VARIABLE

GET FULL VARIABLE имяпеременной [имяканала]

Если переменная, указанная в параметре имяпеременной, задана, возвращает ее значение в круглых скобках. Эта команда, в отличие от GET VARIABLE, принимает имена комплексных и встроенных переменных. Возвращаемые значения: 0

Канал или переменная не заданы.

1 ( значение )

Значение получено (и приведено в круглых скобках).

GET OPTION

GET OPTION имяфайла коды_выхода [времяожидания]

Ведет себя аналогично STREAM FILE, но имеет опцию времяожидания (в секундах).

Возвращаемое значение:

значение

ASCII-значение полученных цифр, в десятичной форме.

GET VARIABLE

GET VARIABLE имяпеременной

Если переменная задана, возвращает ее значение в круглых скобках. Эта команда не принимает комплексных или встроенных переменных; используйте команду GET FULL VARIABLE, если приложению необходимы такие типы переменных. Возвращаемые значения: 0

Канал или переменная не заданы. 1 ( значение )

Значение получено (и приведено в круглых скобках).

HANGUP

HANGUP [имяканала]

Выполняет разрыв соединения по указанному каналу или, если канал не задан, по текущему каналу. Возвращаемые значения:

-1

Указанный канал не существует.

1

Разрыв соединения выполнен успешно.

NoOp

NoOp [ текст]

Не выполняет никакого действия. В качестве побочного эффекта это команда выводит значение параметра текст в консоль Asterisk. Обычно используется в целях отладки. Возвращаемое значение:

0

Канал или переменная не заданы.

RECEIVE CHAR

RECEIVE CHAR времяожидания

Принимает один символ текста из канала. Параметр времяожидания, в миллисекундах, задает максимальную продолжительность ожидания ввода; при значении 0 ожидание будет длиться неопределенно долго. Обратите внимание, что большинство каналов не поддерживают прием текста. Возвращаемые значения: -1 (разрыв)

Сбой или разрыв соединения.

char (времяожидания) Время ожидания.

значение

ASCII-значение символа, в десятичной форме.

RECORD FILE

RECORD FILE имяфайла формат коды_выхода времяожидания [фрагменты_смещения] [BEEP] [s=пaузa]

Записывает аудиосигнал, передаваемый по каналу, в заданный файл до получения определенного кода выхода (DTMF). Аргумент формат определяет тип записываемого файла (wav, gsm и пр.). Аргумент времяожидания - это максимальная продолжительность записи в миллисекундах. Может быть задан равным -1, что означает отсутствие времени ожидания. Аргумент фрагменты_смещения необязательный; если задан, запись начнется со смещением на заданное количество фрагментов, без выхода за пределы файла. Аргумент BEEP обусловит подачу звукового сигнала абоненту для обозначения начала операции записи. Аргумент пауза - это допустимая пауза, в секундах, после которой функция возвращается, даже если не поступили DTMF-коды или не истекло время ожидания. Значению паузы должна предшествовать запись s=. Этот аргумент также необязательный. Возвращаемые значения: -1