Обработка форм в приложении Ajax

Приложение Ajax для отправки содержимого формы на сервер использует JavaScript. Если выполнен асинхронный запрос, JavaScript-код не ожидает ответа сервера. Это также означает, что пользователи могут продолжать работать со страницей даже в том случае, если в фоновом режиме выполняется запрос. Это может представлять опасность, из-за чего, возможно, до завершения запроса потребуется ограничить некоторые действия. Броузер по умолчанию не обеспечивает визуальной индикации выполнения запроса в фоновом режиме. За информирование пользователя о выполнении запроса отвечаете вы. Вот код для передачи содержимого полей имени пользователя (username) и пароля (password) через Ajax:

Метод getElementById() читает значения полей имени пользователя и пароля. Затем создается объект XMLHttpRequest, с помощью которого эти значения отправляются назад на сервер. Заметьте, что тип используемого объекта зависит от того, какой броузер применяют пользователи: Internet Explorer 7, 5 или Mozilla/Firefox. Довольно просто написать код, обрабатывающий все эти ситуации, или использовать библиотеку, подобную Prototype, для реализации независимости от платформы. Имя пользователя и пароль кодируются в URL и отправляются на сервер. Вызов xmlHttp.onreadystatechange регистрирует обработчик для обработки результата, возвращаемого сервером. Данный код реализует только запрос XMLHttp и указывает броузеру вызвать функцию dosomething() при получении ответа от сервера. Вот функция dosomething(), которая обрабатывает этот ответ:

}

Перед выполнением каждого последующего этапа XMLHttp-за- проса убедитесь в завершении предыдущего (успешном или со сбоем).

Эта функция вызывается при любом изменении состояния HTTP-за- проса. Выражение if сохраняет ответ, только если параметр readyState запроса имеет значение 4, свидетельствующее о завершении запроса. Теперь переменная JavaScript login_response (ответ на регистрацию) содержит ответ страницы регистрации.

Но этот фрагмент мало похож на код, готовый к производственной эксплуатации. В частности, упрощенная обработка имени пользователя и пароля подходит для тестирования, но будет представлять серьезную проблему для безопасности в производственной системе, даже если приложение используется только в закрытой сети. Для реализации более надежной и безопасной обработки паролей рекомендуется применять представленную ранее систему запрос/ответ. Больше информации о написании веб-приложений на Ajax предлагает книга Бретта Мак- Лафлина (Brett McLaughlin) «Head Rush Ajax» (издательство O'Reilly).

Инфраструктура Prototype

Prototype (http://prototypejs.org) - это инфраструктура JavaScript, выпущенная под лицензией типа MIT. Prototype может чрезвычайно упростить разработку Ajax-приложения. Она предоставляет много способов сделать код более коротким и ясным. Например, в функции

submitform вызов document.getElementById() может быть заменен функцией $(). Аналогично, вызов value для получения содержимого DOM-эле- мента можно заменить вызовом $F(). Таким образом, document.getElemen tById("username").value становится просто $F('username'); в результате получаем намного более простой и удобный для чтения код. Prototype также позволяет выполнять элегантные XMLHttp-запросы. С помощью объекта Prototype Ajax функцию submitform() можно переписать следующим образом:

Этот код не только намного короче, теперь в веб-страницы не придется включать специальный код для каждого броузера. Prototype берет на себя заботу о различиях между Mozilla/Firefox и версиями Internet Explorer. Более того, она выполняет проверку параметра readyState запроса, поэтому больше нет необходимости в этом ужасном выражении if. Prototype имеет массу встроенных функций, некоторые из них активно используются в инфраструктуре Asterisk. Обсуждать их здесь нет возможности, но более подробную информацию можно найти в разделе «Short Cuts» книги «Prototype Quick Reference» Скотта Реймонда

(Scott Raymond) и «Prototype and Scriptaculous: Taking the Pain Out of JavaScript» Криса Ангуса (Chris Angus), обе книги изданы в O'Reilly.

Настройка GUI

Рассмотрев разные части, формирующие основу Asterisk GUI, мы располагаем всем необходимым для исследования самого GUI и его настройки соответственно собственным нуждам. Asterisk GUI можно найти по следующему адресу: http://localhost:8088/asterisk/static/ config/cfgbasic.html.

Взглянув на рис. 11.1, вы можете подумать, что Asterisk GUI - это просто еще один из множества существующих графических пользовательских интерфейсов Asterisk. Но это абсолютно не так. Этот GUI не просто позволяет настраивать себя, он практически умоляет сделать это. В данном разделе обсуждается, как можно настраивать GUI и использовать AJAM для создания собственных расширений к GUI. Чтобы извлечь из этой информации максимальную пользу, необходимо обладать базовыми знаниями по HTML и JavaScript. Домашняя страница GUI называется cfgbasic.html. Все остальные страницы загружаются в окно iframe, содержащееся на странице cfgbasic.html. По умолчанию cfgbasic.html загружает home.html в основном окне.

Большинство изменений GUI в конечном счете связаны с изменением файла cfgbasic.html, который формирует окно регистрации.

Рис. 11.1. Скриншот Asterisk GUI

Как добавить в GUI новую вкладку

В качестве примера настройки Asterisk GUI создадим новую вкладку, отображающую содержимое файла extensions.conf. Сначала необходимо создать файл и поместить его в папку /var/lib/asterisk/static-html/ config. В данном примере назовем файл test.html:

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

Первая строка указывает броузеру загрузить библиотеку Prototype. Вторая - загрузить файл astman.js, в котором содержится большая часть кода для взаимодействия с интерфейсом Manager. Далее описываем функцию localAjaxinit. Сначала функция localAj axinit указывает родителю этой страницы (в данном случае файлу cfgbasic.html) выполнить функцию loadscreen, передавая в нее эту страницу как параметр. Таким образом, основное окно GUI загрузит нашу новую страницу test.html в iframe. Следующее, что мы делаем в функции localAjaxinit, - используем функцию make request. Функция определена в файле astman.js и очень упрощает выполнение запросов к веб-серверу[109]. Первый параметр функции makerequest определяет тип выполняемого запроса. Он может принимать следующие значения:

Использует действие GetConfig для извлечения конфигурации из конфигурационного файла, заданного во втором параметре.

'u'

Использует действие UpdateConfig для обновления конфигурации в конфигурационном файле, заданном во втором параметре. Третий

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

Если в качестве первого параметра функции makerequest заданы одинарные кавычки, будет отправлено специальное действие, определенное в третьем параметре.

Четвертый параметр - это функция обратного вызова, которая будет вызываться в ответ на запрос Ajax.

Примеры использования makerequest

Возьмем в качестве примера следующий фрагмент кода. Он демонстрирует три разных способа использования функции makerequest. В первом случае мы получаем конфигурационные данные из файла users.conf. Во втором - обновляем musiconhold. conf и меняем значение настройки random в классе default. И последнее (по порядку, но не по значимости) - вызываем действие Ping. В каждом случае задается функция обратного вызова t, которая просто заменяет содержимое переменной div ответом, полученным в результате Ajax-вызова.

makerequest( 'g', 'users.conf', '' ,

function(t) { $('ExtensionsDotConf'). innerHTML = "

" + t + "

makerequest( 'u', 'musiconhold.conf',

'&Action-000000=update&Cat-000000=default&Var-000000=random&Value- 000000=yes' ,

function(t) { $('ExtensionsDotConf').innerHTML = "

" + t + "

makerequest( '', '', 'action=Ping' ,

function(t) { $('ExtensionsDotConf').innerHTML = "

" + t + "

Все остальное содержимое test.html - это просто HTML-код с элементом div, в котором будут размещены конфигурационные данные после их получения. Обратите внимание, что тег HTML-кода имеет атрибут onload, который обусловливает выполнение броузером функции localAjaxinit сразу же по завершении загрузки страницы.

Теперь, когда новая страница создана, необходимо отредактировать файл cfgbasic.html, чтобы добавить эту страницу как панель GUI. Откройте файл cfgbasic.html, найдите JavaScript-функцию returnpanels и вставьте этот код в список панелей в том месте, где вы хотите разместить свою панель:

newpanel( ["Test", "test.html", "Test"]); Теперь перезагрузите GUI в своем броузере. Слева должна появиться новая вкладка Test (Проверка), и после щелчка по ней будут отображаться значения конфигурации для файла extensions.conf. Это всего лишь малая часть того, что можно рассказать об интерфейсе AJAM и Asterisk GUI, но данный пример служит только для того, чтобы продемонстрировать вам, как просто вводить новую функциональность в GUI. В следующем примере будет показано, как легко выводить в GUI настройки из конфигурационных файлов.

Вывод настроек конфигурации в GUI

Как говорилось ранее, одно из уникальных преимуществ Asterisk GUI по сравнению с другими графическими интерфейсами для Asterisk в том, что он обновляет существующие конфигурационные файлы, предпринимая при этом специальные меры для предотвращения перезаписи или удаления каких-либо дополнительных настроек, которые могут присутствовать в конфигурационных файлах. Чтобы продемонстрировать ту простоту, с которой можно предоставлять новые настройки в GUI, добавим в GUI простой флажок, обеспечивающий возможность задавать настройку nat в файле users.conf.

Если открыть GUI и щелкнуть по вкладке Users (Пользователи), GUI загрузит файл users.html в iframe. Откроем afqk users.html (обычно располагающийся в gfgrt /var/lib/asterisk/static-http/config) и начнем изменять его, чтобы добавить наш флажок.

Сначала посмотрим в начало файла, где описана переменная fieldnames (имена полей). Эта переменная содержит список всех имен полей, которые будут заданы на данной странице GUI. Просто добавьте nat в конец списка или вставьте следующую строку прямо под текущим описанием fieldnames.

fieldnames.push('nat'); Таким образом мы сообщаем Asterisk GUI о том, что хотим иметь возможность видеть, а также задавать значение nat. Однако, чтобы увидеть или задать значение, необходимо добавить элемент в HTML-фор- му. Для этого найдите в файле users.html флажок IAX и добавьте следующие строки между ним и флажком CTI.

NAT

Просто перезагрузите страницу - вот и все. Всего несколько дополнительных строк кода - и мы можем выводить настройку nat в GUI. Проще быть не может!

Занимаясь формированием Asterisk GUI, вы, вероятно, обнаружите, что отладка кода Ajax и JavaScript порой может вызывать некоторые трудности. Мы настоятельно рекомендуем использовать расширение для Mozilla/Firefox под названием Firebug, которое существенно упрощает задачу по отладке Ajax, JavaScript и HTML. Его можно найти по адресу http://www.getfirebug.com. Существует также упрощенная версия для Internet Explorer, известная как Firebug Lite, которую можно скачать на том же веб-сайте.

Дополнительная информация

В данной главе были представлены Asterisk GUI и инфраструктура AJAM. Мы рассмотрели модель работы GUI и то, как его можно изменять. Дополнительную информацию по разработке графического интерфейса для Asterisk можно найти в руководстве для разработчиков GUI (GUI Developers Guide) по адресу http://asterisknow.org/developers/gui-guide.

По договору между издательством «Символ-Плюс» и Интернет-магазином «Books.Ru - Книги России» единственный легальный способ получения данного файла с книгой ISBN 978-5-93286-128-8, название «Asterisk™: будущее телефонии, 2-е издание» - покупка в Интернет-магазине «Books.Ru - Книги России». Если Вы получили данный файл каким-либо другим образом, Вы нарушили международное законодательство и законодательство Российской Федерации об охране авторского права. Вам необходимо удалить данный файл, а также сообщить издательству «Символ-Плюс» (piracy@symbol.ru), где именно Вы получили данный файл.12

Интеграция с реляционной базой данных

Ничто так не раздражает, как хороший пример.

- Марк Твен

Введение

В данной главе мы собираемся исследовать вопросы интеграции некоторых функций Asterisk и системы управления базами данных (СУБД). Для работы с Linux доступно несколько СУБД, но мы решили ограничить наше обсуждение PostgreSQL. Мы прекрасно понимаем, что MySQL - тоже чрезвычайно популярная СУБД, но надо было остановиться на какой-то одной, и наш опыт работы с PostgreSQL перевесил чашу весов в ее пользу. Фактически будет обсуждаться ODBC-коннек- тор, поэтому, если ваша база данных поддерживает работу через ODBC, содержание данной главы будет вам полезным.

Интеграция Asterisk с базами данных - один из основополагающих элементов, обеспечивающих возможность включения Asterisk в большую распределенную систему. Используя мощь базы данных, динамически меняющиеся данные могут переносить информацию по массиву систем Asterisk. Наш последний фаворит среди функций Asterisk - func_odbc, которая будет рассмотрена в данной главе позже. Не только развернутые системы Asterisk используют реляционные базы данных; понимание того, как работать с ними, открывает сундук с сокровищами, полный новых способов разработки решений для сетей связи.

Установка СУБД PostgreSQL

Первое, что надо сделать, - это установить сервер базы данных Post- greSQL[110].

# yum install -y postgresql-server

Затем запускаем базу данных; первая инициализация займет несколько секунд:

# service postgresql start

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

# su - postgres $ createuser -P

Enter name of user to add: asterisk Enter password for new user: Enter it again:

Shall the new role be a superuser? (y/n) n Shall the new user be allowed to create databases? (y/n) y Shall the new user be allowed to create more new users? (y/n) n CREATE USER

По умолчанию PostgreSQL не слушает TCP/IP-соединение, которое будет использовать Asterisk. Необходимо внести изменения в файл /var/ lib/pgsql/data/postgresql.conf, чтобы Asterisk могла устанавливать IP- соединения с базой данных. Для этого просто удалим символ комментария перед параметрами tcpip_socket и port. Не забудьте изменить значение tcpip_socket с false на true. tcpip_socket = true max_connections = 100

# примечание: увеличение max_connections стоит

# выделения примерно 500 байтов совместно

# используемой памяти на каждое соединение,

# кроме памяти, выделяемой под shared_buffers

# и max_locks_per_transaction. #superuser_reserved_connections = 2 port = 5432

Теперь редактируем файл /var/lib/pgsql/data/pg_hba.conf, чтобы обеспечить возможность только что созданному пользователю asterisk устанавливать соединения с сервером PostgreSQL через TCP/IP. В конце файла замените все под комментарием # Разместите здесь свою фактическую конфигурацию следующим[111]:

host all asterisk 127.0.0.1 255.255.255.255 md5 local all asterisk trust

Теперь можно создать базу данных, которая будет использоваться в данной главе. Мы собираемся создать базу данных asterisk и задать в качестве владельца нашего пользователя asterisk. $ createdb --owner=asterisk asterisk CREATE DATABASE

Выйдя из учетной записи postgres и вернувшись в административную учетную запись, перезапустите сервер PostgreSQL: $ exit

# service postgresql restart

Наше соединение с сервером PostgreSQL через TCP/IP можно проверить следующим образом:

# psql -h 127.0.0.1 -U asterisk Password:

Welcome to psql 7.4.16, the PostgreSQL interactive terminal.

Type: \copyright for distribution terms \h for help with SQL commands \? for help on internal slash commands \g or terminate with semicolon to execute query \q to quit

asterisk=>

Повторно проверьте свою конфигурацию, как было показано ранее, если получена следующая ошибка, которая свидетельствует о том, что соединение через TCP/IP не разрешено:

psql: could not connect to server: Connection refused

Is the server running on host "127.0.0.1" and accepting TCP/IP connections on port 5432?

(psql: невозможно установить соединение с сервером: В соединении отказано

Сервер работает на хосте "127.0.0.1" и принимает TCP/IP-соедине- ния через порт 5432?)

Установка и конфигурация ODBC

ODBC-коннектор - это уровень обобщения баз данных, который делает возможным взаимодействие Asterisk с разнообразными СУБД без необходимости создания специального коннектора для каждой отдельно взятой базы данных, которую должна поддерживать Asterisk. Это устраняет необходимость в затратах усилий на разработку и обслуживание кода. Имеется некоторое негативное влияние на производительность, потому что между Asterisk и базой данных вводится дополнительный уровень приложений, однако его можно смягчить надлежащим проектированием, и это стоит выполнить, если необходимо обеспечить мощную и гибкую функциональность баз данных в системе Asterisk.

Прежде чем устанавливать коннектор в Asterisk, необходимо установить ODBC в самой Linux. Чтобы установить драйверы ODBC, просто выполним следующую команду:

# yum install -y unixODBC unixODBC-devel libtool-ltdl libtool-ltdl-devel

В главе 3 можно найти таблицу с пакетами, которые должны быть установлены.

Необходимо установить пакет unixODBC-devel, потому что Asterisk использует его для создания модулей ODBC, которые будут применяться в данной главе.

Убедитесь в наличии сконфигурированного ODBC-драйвера PostgreSQL в файле /etc/odbcinst.ini. Он должен выглядеть примерно так:

[PostgreSQL]

Description = ODBC for PostgreSQL Driver = /usr/lib/libodbcpsql.so

Setup = /usr/lib/libodbcpsqlS.so

FileUsage = 1

Убедитесь, что система видит драйвер, выполнив приведенную ниже команду. Если все хорошо, она должна возвратить имя метки используемой СУБД PostgreSQL. # odbcinst -q -d

[PostgreSQL]

Далее сконфигурируем файл /etc/odbc.ini, используемый для создания коннектора, который Asterisk будет применять для ссылки на эту конфигурацию. Если когда-то в будущем понадобится изменить базу данных или что-то еще, просто надо будет внести изменения в этот файл, не меняя ссылок в Asterisk[112].

Убедимся, что мы можем соединяться с нашей базой данных, используя приложение isql. Приложение isql не будет осуществлять соединение как пользователь с правами администратора (root) и должно выполняться под учетной записью владельца базы данных. Поскольку владельцем базы данных asterisk в PostgreSQL является пользователь asterisk, необходимо создать учетную запись Linux с таким же именем. В главе 14 эта учетная запись будет использоваться для запуска Asterisk от лица пользователя, не имеющего прав администратора.

# su - asterisk

$ echo "select 1" | isql -v asterisk-connector

+ +

| Connected! |

| sql-statement

| help [tablename]

| quit |

+ +

SQL> + +

| 'column? + +

I 1

+ +

SQLRowCount returns 1 1 rows fetched $ exit

После установки, конфигурации и проверки unixODBC, необходимо повторно скомпилировать Asterisk, чтобы модули ODBC были созданы и установлены. Вернитесь в папку исходного кода Asterisk и запустите сценарий ./configure, чтобы система знала, что unixODBC установлен.

# cd /usr/src/asterisk-1.4

# make distclean

# ./configure

# make menuselect

# make install

Практически все, о чем говорится в данной главе, включено по умолчанию. Выполнив команду make menuselect, убедитесь, что модули, связанные с ODBC, активированы. Сюда относятся cdr_odbc, func_odbc, func_realtime, pbx_realtime, res_config_ odbc, res_odbc. Для хранения голосовой почты в базе данных, совместимой с ODBC, не забудьте выбрать пункт ODBC STORAGE (ХРАНИЛИЩЕ ODBC) в меню Voicemail Build Options (Опции сборки голосовой почты). Чтобы убедиться в существовании модулей, загляните в папку /usr/lib/asterisk/modules/.

Конфигурация res_odbc

для обеспечения доступа к базе данных

Конфигурация ODBC-коннекторов выполняется в файле res_odbc.conf, располагающемся в папке /etc/asterisk. Файл res_odbc.conf задает параметры, которые будут использоваться различными модулями Asterisk для соединения с базой данных[113].

Внесем изменения в файл res_odbc.conf:

[asterisk]

enabled => yes

dsn => asterisk-connector

username => asterisk

password => welcome

pooling => no

limit => 0

pre-connect => yes

Опция dsn указывает на соединение с базой данных, которое мы конфигурировали в файле /etc/odbc.ini, а опция pre-connect говорит Asterisk открыть и обслуживать соединение с базой данных при загрузке модуля res_odbc.so. Это снижает некоторые издержки, которые возникли бы при многократном повторном установлении и разрыве соединения с базой данных.

Сконфигурировав res_odbc.conf, запустите Asterisk и проверьте соединение с базой данных с помощью CLI-команды odbc show:

*CLI> odbc show Name: asterisk DSN: asterisk-connector Pooled: no Connected: yes

Использование архитектуры реального времени

Архитектура реального времени Asterisk (Asterisk Realtime Architecture, ARA) - это метод хранения конфигурационных файлов (которые при обычных обстоятельствах располагались бы в папке /etc/asterisk) и их конфигурационных опций в таблице базы данных. Существует два типа архитектур реального времени: статическая и динамическая. Статический вариант аналогичен традиционному методу чтения конфигурационного файла, за исключением того что чтение данных осуществляется из базы данных. Метод динамической реализации архитектуры реального времени используется для таких элементов, как объекты user и peer (SIP, IAX2) и голосовая почта, которые загружают и обновляют информацию по мере необходимости. Изменение в статической информации требует перезагрузки текстового файла сразу после внесения в него изменений, но динамическая информация запрашивается Asterisk по мере необходимости и не требует перезагрузки. Архитектура реального времени настраивается в файле extconfig.conf, располагающемся в папке /etc/asterisk. Этот файл указывает Asterisk, что брать из базы данных и откуда именно, что обеспечивает возможность загружать некоторые файлы из базы данных, а другие - из стандатных конфигурационных файлов.

Статическая архитектура реального времени

Статическая архитектура реального времени используется, если требуется загрузить конфигурацию, которая обычно размещается в конфигурационных файлах в папке /etc/asterisk, из базы данных. Те же правила, которые применяются к плоским[114] файлам в системе, действуют и при использовании статической архитектуры реального времени. Например, требование выполнить команду перезагрузки из интерфейса командной строки Asterisk или перезагрузить модуль, связанный с конфигурационным файлом (то есть выполнить команду module reload chan_sip. so).

При использовании статической архитектуры реального времени мы указываем Asterisk, какие файлы хотим загрузить из базы данных, используя в файле extconfig.conf следующий синтаксис:

; /etc/asterisk/extconfig.conf filename.conf => драйвер,базаданных[,таблица]

Если имя таблицы не задано, Asterisk будет использовать имя файла.

Использование директивы preload

Большинство файлов можно загружать посредством статической архитектуры реального времени, но несколько файлов не могут быть загружены при использовании этого метода. Это файлы asterisk. conf, extconfig.conf и logger.conf. Кроме того, файлы manager.conf, cdr.conf и rtp.conf не могут загружаться из статической архитектуры реального времени, если драйверы подключения к базе данных не были загружены до запуска основного ядра Asterisk (потому что архитектура реального времени должна загрузить конфигурационные файлы до того, как модуль начнет читать свою конфигурацию). Поскольку в данной главе используется ODBC, в modules.conf пришлось бы добавить следующие строки: ; /etc/asterisk/modules.conf preload => res_odbc.so preload => res_config_odbc.so

Модуль статической архитектуры реального времени читает настройки статических файлов из базы данных, используя особым образом форматированную таблицу. В PostgreSQL таблица для статической архитектуры реального времени создается с помощью следующего запроса:

CREATE TABLE ast_config (

id serial NOT NULL,

cat_metric int4 NOT NULL DEFAULT 0,

var_metric int4 NOT NULL DEFAULT 0,

filename varchar(128) NOT NULL DEFAULT ''::character varying, category varchar(128) NOT NULL DEFAULT 'default'::character varying, var_name varchar(128) NOT NULL DEFAULT ''::character varying, var_val varchar(128) NOT NULL DEFAULT ''::character varying, commented int2 NOT NULL DEFAULT 0, CONSTRAINT ast_config_id_pk PRIMARY KEY (id)

)

WITHOUT OIDS;

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

cat_metric

Значимость категории в рамках файла. Чем ниже значение, тем выше в файле располагается категория (см. врезку «Несколько слов о значениях»).

var_metric

Значимость элемента в рамках категории. Чем ниже значение, тем выше в списке располагается элемент. Применяется, например, для определения порядка расположения кодеков в файле sip.conf или iax.conf, когда требуется, чтобы disallow=all шел первым (значение 0), за ним - allow=ulaw (значение 1), а далее - allow=gsm (значение 2) (см. врезку «Несколько слов о значениях»).

filename

Имя файла, которое модуль в обычных условиях читал бы с жесткого диска системы (то есть musiconhold.conf, sip.conf, iax.conf и т. д.).

category

Имя раздела файла, такое как [general], но не надо сохранять его в базу данных в квадратных скобках.

var_name

Опция, располагающаяся слева от знака равенства (то есть disallow - это var_name в выражении disallow=all). var_val

Значение опции, располагающееся справа от знака равенства (то есть all - это var_val в выражении disallow=all).

commented

Любое отличное от 0 значение будет рассматриваться так, как если бы перед ним в плоском файле стояла точка с запятой (то есть оно было бы закоммментировано).

Несколько слов о значениях

Значения в статической архитектуре реального времени используются для управления порядком, в котором объекты читаются в память. cat_metric и var_metric можно рассматривать как исходные номера строк в плоском файле. Больший cat_metric обрабатывается первым, потому что Asterisk выполняет сопоставление категорий снизу вверх (вот почему порядок пользователей и равноправных участников может иметь значение в файле sip.conf или iax.conf). Меньший var_metric в рамках категории обрабатывается первым, потому что Asterisk будет обрабатывать порядок опций в категории сверху вниз (например, чтобы обеспечить обработку disallow=all первым, для него в рамках категории должно быть задано меньшее значение, чем для allow).

Возьмем простой файл, который можно загрузить из статической архитектуры реального времени, musiconhold.conf file. Начнем с его перемещения во временную папку:

# cd /etc/asterisk

# mv musiconhold.conf musiconhold.conf.old

Чтобы удалить классы из памяти, необходимо перезапустить Asterisk. После этого, выполнив команду moh show classes, можно убедиться в отсутствии классов: *CLI> restart now *CLI> moh show classes *CLI>

Итак, давайте вернем класс [default] в Asterisk, но теперь загрузим его из базы данных. Установим соединение с PostgreSQL и выполним следующие запросы INSERT:

INSERT INTO ast_config (filename,category,var_name,var_val) VALUES ('musiconhold.conf','general','mode','files'); INSERT INTO ast_config (filename,category,var_name,var_val) VALUES ('musiconhold.conf','general','directory','/var/lib/asterisk/moh'); Убедиться в том, что значения внесены в базу данных, можно, выполнив запрос SELECT:

asterisk=# select filename,category,var_name,var_val from ast_config;

filename | category | var_name | var_val + + +

musiconhold.conf | general | mode | files musiconhold.conf | general | directory| /var/lib/asterisk/moh (2 rows)

И теперь, чтобы указать Asterisk, что необходимо брать данные для musiconhold.conf из базы данных, осталось внести в файл extconfig. conf, находящийся в папке /etc/asterisk, всего одно изменение. Добавим следующую строку в конец файла extconfig.conf и сохраним его:

musiconhold.conf => odbc,asterisk,ast_config Подключимся к консоли Asterisk и выполним перезагрузку: *CLI> module reload

Теперь, выполнив команду moh show classes, можно убедиться, что наши классы для воспроизведения музыки во время ожидания загружаются из базы данных:

*CLI> moh show classes

Class: general

Mode: files

Directory: /var/lib/asterisk/moh

И вот, пожалуйста; musiconhold.conf загружается из базы данных. Точно так же можно организовать загрузку из базы данных других плоских файлов!

Динамическая архитектура реального времени

Динамическая система реального времени используется для загрузки часто изменяющихся объектов: пользователей и равноправных участников SIP/IAX2, очередей и их членов и сообщений голосовой почты. Поскольку эта информация в системе может или меняться, или регулярно дополняться новыми записями, использование мощи базы данных позволит нам загружать ее по мере необходимости.

Все настройки архитектуры реального времени описываются в файле /etc/asterisk/extconfig.conf, но динамическая архитектура реального времени имеет строго определенные конфигурацонные имена, такие как sippeers. Описание равноправного участника SIP (SIP peer) выполняется в следующем формате: ; extconfig.conf

sippeers => драйвер,базаданных[,таблица] Имя таблицы является необязательным параметром. Если он не задан, Asterisk будет использовать предопределенное имя (то есть sippeers) как имя таблицы для поиска данных. В нашем примере для хранения информации равноправных участников SIP будет использоваться таблица ast_sip peers.

Помните, что у нас имеются и равноправные участники SIP (SIP peer), и пользователи SIP (SIP user); peer - это конечные точки, которым мы отправляем вызовы, а user направляют вызовы нам. friend - это сокращенная запись, определяющая оба типа конечных точек.

Таким образом, чтобы сконфигурировать Asterisk на загрузку всех равноправных SIP-участников из базы данных в режиме реального времени, необходимо записать примерно следующее:

; extconfig.conf

sippeers => odbc,asterisk,ast_sipfriends Чтобы также загружать наших SIP-пользователей из базы данных, задаем следующее:

sipusers => odbc,asterisk,ast_sipfriends

Вероятно, вы обратили внимание, что и для sippeers, и для sipusers используется одна и та же таблица. В ней есть поле типа (точно так же, как если бы тип был определен в файле sip.conf), поэтому для извлечения информации мы можем задавать тип user, peer или friend. При описании таблицы для пользователей и равноправных участников необходимо как минимум следующее:

В обязательных полях port, regseconds и ipaddr Asterisk сохраняет регистрационную информацию равноправного участника, чтобы знать, куда направлять вызов. Предполагается, что хост является dynamic; однако, если бы равноправный участник был static, нам пришлось бы заполнять поле ipaddr самостоятельно. Поле port является необязательным. Если для него используется стандартный порт, указанный в разделе [general], поле regseconds остается пустым. Для SIP-друга можно определить множество других опций, таких как ID вызывающего абонента. Чтобы добавить эту информацию, требуется просто вставить дополнительный столбец callerid в таблицу. Другие опции, которые могут быть определены для соединения SIP типа friend, можно найти в файле sip.conf.sample.

Хранение записей параметров вызовов

Записи параметров вызовов (Call Detail Records, CDR) содержат информацию о вызовах, прошедших через систему Asterisk. Более подробно они обсуждаются в главе 13. Хранение CDR - один из самых популярных примеров использования баз данных в Asterisk, потому что в этом случае с CDR проще работать (например, можно отслеживать несколько систем Asterisk в одной таблице).

Создадим в нашей базе данных таблицу для хранения CDR. Зарегистрируемся на сервере PostgreSQL с помощью приложения psql: # psql -U asterisk -h localhost asterisk

Password:

И создадим таблицу asterisk_cdr:

asterisk=> CREATE TABLE asterisk_cdr (

id bigserial NOT NULL, calldate timestamptz,

Задание параметра systemname для глобальных уникальных идентификаторов

CDR состоят из уникального идентификатора и нескольких полей информации о вызове (включая источник и канал назначения, продолжительность вызова, приложение, выполняемое последним, и т. д.). В кластере серверов Asterisk теоретически возможно дублирование уникальных идентификаторов, поскольку каждая система Asterisk учитывает только саму себя. Чтобы решить эту проблему, можно автоматически добавлять идентификатор системы в начало уникального ID. Для этого введем дополнительную опцию в файл /etc/asterisk/asterisk.conf и зададим идентификатор для каждого из серверов: [options]

systemname=toronto

clid varchar(80), src varchar(80), dst varchar(80), dcontext varchar(80), channel varchar(80), dstchannel varchar(80), lastapp varchar(80), lastdata varchar(80), duration int8, billsec int8, disposition varchar(45), amaflags int8, accountcode varchar(20), uniqueid varchar(40), userfield varchar(255),

CONSTRAINT asterisk_cdr_id_pk PRIMARY KEY (id)

)

WITHOUT OIDS;

Убедиться в том, что таблица создана, можно с помощью команды \dt (describe tables):

asterisk=> \dt asterisk_cdr

List of relations

Schema | Name | Type | Owner + + +

public | asterisk_cdr | table | asterisk (1 row)

Далее конфигурируем Asterisk на хранение ее CDR в базе данных. Это выполняется в файле /etc/ asterisk/cdr_odbc.conf с помощью следующих настроек:

[global]

dsn=asterisk-connector

username=asterisk password=welcome loguniqueid=yes table=asterisk_cdr

Если Asterisk уже запущена, из интерфейса командной строки Asterisk выполняем команду module reload cdr_odbc.so. Также можно просто ввести reload, чтобы выполнить полную перезагрузку. *CLI> reload

Проверим статус CDR. Для этого введем следующую команду и найдем в выводе строку CDR registered backend: ODBC:

*CLI> cdr status

CDR logging: enabled CDR mode: simple

CDR registered backend: cdr-custom

CDR registered backend: cdr_manager

CDR registered backend: ODBC

Теперь выполним вызов через сервер Asterisk, а потом проверим наличие данных о нем в таблице asterisk_cdr. Самый простой способ протестировать вызов - использовать CLI-команду Asterisk console dial (предполагается, что имеется звуковая карта и установлен модуль chan_oss). Однако для выполнения тестового звонка можно использовать любой имеющийся в распоряжении метод: *CLI> console dial 100@default

-- Executing [100@default:1] Playback("OSS/dsp", "tt-weasels") in new stack -- Playing 'tt-weasels' (language 'en')

Затем установим соединение с базой данных и выполним запрос SELECT для проверки наличия данных в таблице asterisk_cdr. Также можно выполнить команду SELECT * FROM asterisk_cdr;, но в этом случае будет возвращено намного больше данных: # psql -U asterisk -h localhost asterisk Password:

asterisk=> SELECT id,dst,channel,uniqueid,calldate FROM asterisk_cdr;

id | dst | channel | uniqueid | calldate

---+ + + +

1 | 100 | OSS/dsp | toronto-1171611019.0 | 2007-02-16 02:30:19-05 (1 rows)

Ощутим могущество func_odbc: система «горячих столов»

Функция диалплана func_odbc является, наверное, самой замечательной и мощной в Asterisk. Она позволяет создавать и применять довольно простые функции диалплана для извлечения и использования информации из баз данных непосредственно в диалплане. Ее можно использовать в очень многих случаях, например для управления пользователями или обеспечения возможности совместного использования динамической информации в рамках кластера серверов Asterisk.

func_odbc позволяет описывать SQL-запросы и присваивать им имена функций. В результате создаются специальные функции, которые получают свои результаты, выполняя запросы к базе данных. Взаимосвязи между именами создаваемых функций и выражениями SQL, которые они должны выполнять, описываются в файле func_odbc.conf. Используя именованные функции в диалплане, можно извлекать и обновлять значения в базе данных.

Хотя применение внешнего сценария для взаимодействия с базой данных (из которой создается плоский файл для Asterisk) имеет свои преимущества (если база данных дает сбой, система будет продолжать функционировать и сценарий просто не будет обновлять файлы до восстановления соединения с базой данных), основной недостаток в этом случае в том, что любые изменения, вносимые вами для пользователя, остаются недоступными, пока не будет выполнен сценарий обновления. Возможно, это не является большой проблемой для маленьких систем, но в больших системах ожидание вступления в силу внесенных изменений может привести к неприятностям, таким как прерывание активного вызова на время загрузки или синтаксического разбора большого файла. Ослабить негативные эффекты можно, применяя систему баз данных с дублированием. В версии Asterisk, следующей за 1.4 (в настоящее время эта версия готовится к выпуску[115]) синтаксис файла func_odbc.conf изменится не сильно, но обеспечит возможность в случае отказа перейти к другой СУБД. Таким образом, можно будет кластеризовать серверную часть базы данных, используя отношение ведущий-ведущий (pgcluster; Slony-II) или систему дублирования ведущий-ведомый (Slony-I).

Чтобы вы получили правильное представление о рассматриваемом далее материале, представьте себе дагвудовский сэндвич[116]. Можно ли описать всю гамму впечатлений от такого блюда, только представив изображение помидора или помахав перед носом кусочком сыра? Вряд ли. С этой же проблемой мы сталкиваемся, пытаясь придумать хороший пример, объясняющий, в чем мощь func_odbc. Поэтому мы решили «приготовить сэндвич полностью». Рецепт довольно сложен, но, попробовав этот сэндвич, вы не захотите ничего другого. Для нашего примера мы решили реализовать то, что, по нашему мнению, могло бы иметь практическое применение. Представим небольшую компанию, в отделе продаж которой насчитывается пять человек и им приходится делить между собой два рабочих стола. Это не так ужасно, как может показаться, потому что эти ребята большую часть времени находятся в разъездах и проводят в офисе максимум один день в неделю.

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

Решением в такой ситуации, как правило, является использование так называемой системы «горячих столов» (hot-desking). Мы реализовали такую функцию для вас, чтобы продемонстрировать мощь func_odbc. Начнем с простого и создадим два настольных телефона в файле sip.conf.

; sip.conf

; ПОЛЬЗОВАТЕЛИ СИСТЕМЫ "ГОРЯЧИХ СТОЛОВ"

[desk_1]

type=friend

host=dynamic

secret=my_special_secret

context=hotdesk

qualify=yes

[desk_2]

type=friend

host=dynamic

secret=my_special_secret

context=hotdesk

qualify=yes

; КОНЕЦ ОПИСАНИЯ ПОЛЬЗОВАТЕЛЕЙ "ГОРЯЧИХ СТОЛОВ" Это два настольных телефона, звонки на которые обрабатываются в контексте [hotdesk] файла extensions.conf. Если вы хотите, чтобы эти устройства на самом деле работали, конечно, понадобится задать соответствующие параметры в самих устройствах, но это все рассматривалось в главе 4.

Для файла sip.conf это все. У нас уже есть два кусочка хлеба, но это еще не сэндвич.

Теперь давайте настроим базу данных (предполагаем, что коннектор ODBC базы данных создан и работает, как описывалось в предыдущих разделах данной главы). Сначала подключимся к консоли базы данных следующим образом: # su - postgres

$ psql -U asterisk -h localhost asterisk

Password:

Затем, используя следующий фрагмент кода, создадим таблицу: CREATE TABLE ast_hotdesk (

id serial NOT NULL, extension int8,first_name text, last_name text, cid_name text, cid_number varchar(10), pin int4, context text,

status bool DEFAULT false, "location" text,

CONSTRAINT ast_hotdesk_id_pk PRIMARY KEY (id)

)

WITHOUT OIDS;

После этого заполняем базу данных следующей информацией (некоторые значения изменятся лишь после выполнения диалплана, но мы приводим их здесь для примера). В консоли PostgreSQL выполните такие команды:

asterisk=> INSERT INTO ast_hotdesk ('extension', 'first_name', 'last_name', 'cid_name', 'cid_number', 'pin', 'context', 'location') \ VALUES (1101, 'Leif', 'Madsen', 'Leif Madsen', '4165551101', '555', 'longdistance', 'desk_1');

Повторите предыдущую строку и введите собственные значения VALUES для всех записей, которые вы желаете видеть в базе данных. Данные таблицы ast_hotdesk можно увидеть, выполнив простой запрос SELECT из консоли PostgreSQL:

asterisk=> SELECT * FROM ast_hostdesk; в результате чего будет получен примерно такой вывод:

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

Прежде чем вы начнете писать программу, обращаем ваше внимание, что весь текст примера можно найти в приложении G. Хотя мы рекомендуем разобрать весь пример вместе с нами по шагам, в приложении вы можете увидеть его целиком (и скопировать его код, если у вас есть электронная версия данной книги).

В файле extensions.conf мы собираемся создать контекст [hotdesk]. Для начала определим шаблонный добавочный номер, который обеспечит возможность пользователям регистрироваться в системе:

; extensions.conf ; функция "горячих столов" [hotdesk]

; Регистрация "горячего стола"

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

Когда агент по продажам занимает рабочий стол, он регистрируется, набирая собственный добавочный номер. В этом случае шаблоном 110[1-5] определены номера от 1101 до 1105. Так же просто можно задать менее жесткое ограничение, используя шаблон 11XX (разрешая номера в диапазоне от 1100 до 1199). Этот добавочный номер использует func_odbc для выполнения поиска с помощью функции диалплана HOTDESK_INFO() (созданием которой мы вскоре займемся). Эта специальная функция (описываемая в файле func_odbc.conf) реализует SQL-вы- ражение и возвращает все, что извлекает из базы данных. Новая функция HOTDESK_INFO() будет определена в файле func_odbc.conf следующим образом:

[INFO]

prefix=HOTDESK

dsn=asterisk

read=SELECT ${ARG1} FROM ast_hotdesk WHERE extension = '${ARG2}' Лишь несколько строк, а так много всего. Давайте быстренько рассмотрим все это, прежде чем двигаться дальше.

Прежде всего, параметр prefix необязательный. Если prefix не задан, Asterisk добавляет в имя функции (в данном случае INFO) префикс ODBC, то есть эта функция будет названа ODBC_INFO(). Такое имя не очень хорошо описывает назначение функции, поэтому полезно задавать префикс, который поможет связать ODBC-функции с задачами, ими выполняемыми. В данном случае мы выбрали имя HOTDESK, то есть данная специальная функция будет названа HOTDESK_INFO.

Атрибут dsn указывает Asterisk, какое из описанных в файле res_odbc. conf соединений использовать. Поскольку в res_odbc.conf может быть сконфигурировано несколько соединений, мы задаем здесь, какое именно должно использоваться. На рис. 12.1 показано отношение между различными настройками файлов и то, как они последовательно ссылаются друг на друга для соединения с базой данных.

Рис. 12.1. Отношения между func_odbc.conf, res_odbc.conf, /etc/odbc.ini (unixODBC) и соединение с базой данных

Затем описываем SQL-запрос с помощью атрибута read (чтение). Существует два разных формата вызова функций диалплана: один - для извлечения информации, а другой - для ее записи. Атрибут read используется, когда функция H0TDESK_INF0() вызывается в формате для извлечения данных (и можно выполнить отдельное SQL-выражение с атрибутом write (запись); формат для атрибута write обсуждается в данной главе несколько позже).

Для чтения значений из этой функции в диалплане используется следующий формат:

exten => s,n,Set(RETURNED_VALUE=${H0TDESK_INF0(status,1101)}) Это обеспечит возвращение значения, расположенного в столбце status (статус) базы данных, для которого значение столбца extension (добавочный номер) равно 1101. Переданные в функцию H0TDESK_INF0() значения столбца status и 1101 помещаются в SQL-запрос, заданный для атрибута read, и обозначаются как ${ARG1} и ${ARG2}. Если была передана третья опция, она будет доступна как ${ARG3}.

Убедитесь, что передаваемые данные достаточно уникальны и обеспечивают возвращение только одной строки. Если возвращается несколько строк, Asterisk будет видеть только первую из них. Для PostgreSQL можно ограничить возвращаемые данные одной строкой, добавив в конец SQL-запроса LIMIT 1, но это не очень хорошая практика и она не рекомендуется к применению. Чуть дальше в этом разделе мы увидим, как использовать PostgreSQL-функции LIMIT и OFFSET для перебора нескольких строк данных!

Использование функции ARRAY()

В нашем примере используется два отдельных вызова базы данных и получаемые в результате значения присваиваются двум переменным канала (${E}_STATUS и ${E}_PIN). Это было сделано с целью упростить пример:

exten => _110[1-5],n,Set(${E}_STATUS=${HOTDESK_INFO(status,${E})}) exten => _110[1-5],n,Set(${E}_PIN=${HOTDESK_INFO(pin,${E})})

В качестве альтернативы можно было бы возвращать несколько столбцов и сохранять их в разных переменных, используя функцию диалплана ARRAY() (массив). Если SQL-запрос в файле func_ odbc.conf определен так:

read=SELECT pin,status FROM ast_hotdesk WHERE extension = '${E}' с помощью функции ARRAY() можно в одном обращении к базе данных сохранять каждый столбец данных строки в собственной переменной:

exten => _110[1-5],n,Set(ARRAY(${E}_PIN,${E}_STATUS)=${HOTDES K_INFO(${E})})

После выполнения SQL-запроса возвращенное значение (если таковое имеется) присваивается переменной канала RETURNED_VALUE (возвращенное значение).

Итак, в первых двух строках следующего фрагмента кода мы передаем значение status и значение, содержащееся в переменной ${E} (например, 1101) в функцию HOTDESK_INFO(). Затем эти два значения замещаются в SQL-запросе на ${ARG1} и ${ARG2} соответственно, SQL-запрос выполняется, а возвращенное значение присваивается переменной канала ${E}_STATUS.

Итак, теперь закончим шаблонный добавочный номер:

exten => _110[1-5],n,Set(${E}_STATUS=${HOTDESK_INFO(status,${E})}) exten => _110[1-5],n,Set(${E}_PIN=${HOTDESK_INFO(pin,${E})}) exten => _110[1-5],n,GotoIf($[${ISNULL(${${E}_STATUS})}]?invalid_user,1) ; check if ${E}_STATUS is NULL

exten => _110[1-5],n,GotoIf($[${${E}_STATUS} = 1]?logout,1:login,1) Присвоив значение столбца status переменной ${E}_STATUS (если был набран добавочный номер 1101, имя переменной было бы 1101_STATUS), проверяем, было ли возвращено значение из базы данных (контроль ошибок). Для этой проверки используем функцию ISNULL(). Последняя строка фрагмента кода проверяет статус телефона, и, если в текущий момент он зарегистрирован, будет выполнен его выход из системы. Если он еще не зарегистрирован, управление перейдет к добавочному номеру login c приоритетом 1 в рамках того же контекста[117].

В следующей после 1.4 версии (в настоящее время готовящейся к выпуску) с выражениями, выполняемыми readsql, можно будет использовать переменную канала ${0DBCR0WS}. GotoIf() можно заменить примерно следующим:

exten => _110[1-5],n,GotoIf($[${0DBCR0WS} < 0]?invalid_user,1)

Добавочный номер login выполняет несколько начальных проверок, чтобы убедиться в достоверности введенного агентом кода. Мы предоставляем три попытки для ввода правильного пин-кода. Если все три ввода недействительны, вызов направляется на добавочный номер login_fail (неудачная регистрация) (который будет написан позже).

exten => login,1,No0p() ; задаем исходное значение счетчика

exten => login,n,Set(PIN_TRIES=0) ; задаем максимальное число попыток регистрации

exten => login,n,Set(MAX_PIN_TRIES=3)

exten => login,n(get_pin),No0p() ; увеличиваем счетчик попыток ввода пин-кода exten => login,n,Set(PIN_TRIES=$[${PIN_TRIES} + 1]) exten => login,n,Read(PIN_ENTERED|enter-password|${LEN(${${E}_PIN})}) exten => login,n,GotoIf($[${PIN_ENTERED} = ${${E}_PIN}]?valid_login,1) exten => login,n,Playback(invalid-pin)

exten => login,n,GotoIf($[${PIN_TRIES} <=${MAX_PIN_TRIES}]?get_pin:login_fail,1) Если введен соответствующий пин-код, проверяем регистрационное имя с помощью добавочного номера valid_login (действительное регистрационное имя). Сначала используем переменную CHANNEL (канал), чтобы выяснить, с какого телефона выполняется звонок. Обычно значение переменной имеет примерно такой вид: SIP/desk_1-ab4034c. Поэтому с помощью функции CUT() сначала отбрасываем часть строки SIP/, а оставшееся значение присваиваем переменной L0CATI0N (местоположение). Затем убираем часть строки -ab4034c, а оставшуюся строку, desk_1, присваиваем переменной L0CATI0N. exten => valid_login,1,No0p()

; отбрасываем технологию канала, а оставшуюся строку сохраняем в переменной ; L0CATI0N

exten => valid_login,n,Set(L0CATI0N=${CUT(CHANNEL,/,2)}) ; отбрасываем уникальный идентификатор и сохраняем оставшуюся строку

; в переменной LOCATION

exten => valid_login,n,Set(LOCATION=${CUT(LOCATION,-,1)}) Используем еще одну специальную функцию HOTDESK_CHECK_PHONE_ LOGINS(), созданную в файле func_odbc.conf, для проверки, не зарегистрирован ли по этому телефону какой-то другой пользователь. Если количество ранее зарегистрированных пользователей больше 0 (их не может быть больше 1, но мы все равно проводим проверку и сброс для всех вариантов), функция выполняет логику добавочного номера logout_login (отмена регистрации регистрационного имени). Если никто из агентов не был зарегистрирован ранее, обновляем статус регистрации для этого пользователя с помощью функции HOTDESK_ STATUS():

exten => valid_login,n,Set(ARRAY(USERS_LOGGED_IN)=${HOTDESK_CHECK_PHONE_ LOGINS(${LOCATION})})

exten => valid_login,n,GotoIf($[${USERS_LOGGED_IN} > 0]?logout_login,1) exten => valid_login,n(set_login_status),NoOp()

Задаем для телефона статус '1' - здесь и происходит регистрация ПРИМЕЧАНИЕ: здесь надо экранировать запятую, потому что в приложении Set() есть аргументы

exten => valid_login,n,Set(HOTDESK_STATUS(${E})=1\,${LOCATION}) exten => valid_login,n,GotoIf($[${ODBCROWS} < 1]?error,1) exten => valid_login,n,Playback(agent-loginok) exten => valid_login,n,Hangup()

Создаем в файле func_odbc.conf функцию для записи следующим образом:

[STATUS]

prefix=HOTDESK

dsn=asterisk

write=UPDATE ast_hotdesk SET status = '${VAL1}', location = '${VAL2}' WHERE extension = '${ARG1}'

Ее синтаксис очень похож на синтаксис read, обсуждаемый ранее в данной главе, но есть несколько новшеств, поэтому рассмотрим их, прежде чем двигаться дальше.

Первое, на что вы, возможно, обратили внимание, - теперь в SQL-запросе есть переменные и ${VALx}, и ${ARGx}. Они содержат значения, передаваемые нами в функцию из диалплана. В данном случае имеется две переменных VAL и одна переменная ARG, которые были заданы из диалплана посредством такого выражения: Set(HOTDESK_STATUS(${E})=1\,${LOCATION})

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

Обратите внимание, что данный синтаксис немного отличается от синтаксиса функции для чтения. Это говорит Asterisk о том, что необходимо выполнять запись (тот же синтаксис, что и в других функциях диа- лплана).

Значение переменной ${E} передается в функцию H0TDESK_STATUS(), возвращаемое значение которой затем будет доступно в SQL-выражении в файле func_odbc.conf как переменная ${ARG1}. После этого передаем два значения: 1 и ${L0CATI0N}. Они доступны SQL-запросу в переменных ${VAL1} и ${VAL2} соответственно.

Как упоминалось ранее, если бы перед тем, как зарегистрироваться в системе, нам пришлось отменить регистрацию одного или более агентов, мы бы реализовывали это с помощью добавочного номера logout_ login. В данном фрагменте диалплана для перебора всех строк базы данных и внесения необходимых изменений будет использоваться приложение While(). Скорее всего, цикл будет выполнен только один раз, но это хороший пример того, как можно обновлять или проводить синтаксический разбор множества строк базы данных: exten => logout_login,1,No0p()

; для всех пользователей, зарегистрированных для данного устройства, задать

; статус "незарегистрирован"

exten => logout_login,n,Set(R0W_C0UNTER=0)

exten => logout_login,n,While($[${R0W_C0UNTER} < ${USERS_L0GGED_IN}]) Переменная ${USERS_L0GGED_IN} была задана ранее функцией H0TDESK_ CHECK_PH0NE_L0G INS(), которая присвоила ей значение 1 или больше. Мы сделали это, подсчитав количество измененных строк:

; func_odbc.conf [CHECK_PH0NE_L0GINS] prefix=H0TDESK dsn=asterisk

read=SELECT C0UNT(status) FR0M ast_hotdesk WHERE status = '1' AND location = '${ARG1}'

Затем с помощью функции H0TDESK_L0GGED_IN_USER() получаем добавочный номер зарегистрированного пользователя. Переменная L0CATI0N содержит значение desk_1, обозначающее устройство, которое мы хотим проверить, а ${R0W_C0UNTER} содержит номер итерации цикла. Оба эти значения передаются как аргументы функции диалплана. Результат затем присваивается переменной WH0 (кто):

exten => logout_login,n,Set(WH0=${H0TDESK_L0GGED_IN_USER(${L0CATI0N}, ${R0W_C0UNTER})})

Далее функция H0TDESK_L0GGED_IN_USER() извлекает из базы данных строку, соответствующую итерации цикла, которую мы пытаемся обработать:

[L0GGED_IN_USER]

prefix=H0TDESK

dsn=asterisk

read=SELECT extension FR0M ast_hotdesk WHERE status = '1' AND location = '${ARG1}' 0RDER BY id LIMIT '1' 0FFSET '${ARG2}'

Теперь, когда известен добавочный номер, данные для которого требуется изменить, выполняем запись в функцию HOTDESK_STATUS() и присваиваем 0 столбцу status для строки, в которой добавочный номер соответствует значению переменной ${WHO} (то есть 1101). Завершаем цикл с помощью EndWhile() и возвращаемся к добавочному номеру valid_login в приоритет с меткой set_login_status (как обсуждалось ранее):

exten => logout_login,n,Set(HOTDESK_STATUS(${WHO})=0) ; отмена регистрации телефона

exten => logout_login,n,Set(ROW_COUNTER=$[${ROW_COUNTER} + 1]) exten => logout_login,n,EndWhile()

exten => logout_login,n,Goto(valid_login,set_login_status) ; возвращаемся к процессу регистрации

Все остальное должно быть достаточно понятным (если что-то неясно, вернитесь к главам 5 и 6). Затруднения может вызвать только прием с использованием переменной канала ${ODB CROWS}, которая задается функцией HOTDESK_STATUS(). Она сообщает, сколько строк было изменено в результате SQL-запроса UPDATE (обновить). Мы предполагаем, что это значение равно 1. Если значение ${ODBCROWS} меньше 1, мы рассматриваем это как ошибку и обрабатываем соответствующим образом: exten => logout,1,NoOp()

exten => logout,n,Set(HOTDESK_STATUS(${E})=0) exten => logout,n,GotoIf($[${ODBCROWS} < 1]?error,1) exten => logout,n,Playback(silence/1&agent-loggedoff) exten => logout,n,Hangup()

exten => login_fail,1,NoOp()

exten => login_fail,n,Playback(silence/1&login-fail) exten => login_fail,n,Hangup()

exten => error,1,NoOp()

exten => error,n,Playback(silence/1&connection-failed) exten => error,n,Hangup()

exten => invalid_user,1,NoOp()

exten => invalid_user,n,Verbose(1|Hot Desk extension ${E} does not exist)

exten => invalid_user,n,Playback(silence/2&invalid)

exten => invalid_user,n,Hangup()

Также включаем контекст hotdesk_outbound, который будет обрабатывать наши исходящие звонки после регистрации агента в системе:

include => hotdesk_outbound Контекст hotdesk_outbound преимущественно следует тем же принципам и правилам, которые обсуждались ранее, поэтому не будем рассматривать его слишком подробно. Фактически контекст [hotdesk_ outbound] будет обрабатывать все номера, набираемые с настольных телефонов. Сначала задаем переменную LOCATION, используя переменную CHANNEL, затем определяем, какой добавочный номер (агент) зарегистрировался в системе, и сохраняем его в переменную WHO. Если значение этой переменной NULL, отклоняем исходящий звонок. Если значение переменной не NULL, с помощью функции H0TDESK_INF0() получаем информацию об агенте и сохраняем ее в нескольких переменных канала CHANNEL. Сюда входит и контекст для обработки звонка, где выполняется переход (с помощью функции Goto()) в заданный для нас контекст (который управляет нашим исходящим доступом). Если попытаться набрать номер, не обрабатываемый нашим контекстом (или одним из промежуточных контекстов - то есть контекст international содержит переход в контекст long distance, который, в свою очередь, содержит переход в local), выполняется встроенный добавочный номер i, который воспроизводит для вызывающего абонента сообщение о невозможности такого действия и отсоединяет его:

[hotdesk_outbound]

exten => _X.,1,No0p()

exten => _X.,n,Set(L0CATI0N=${CUT(CHANNEL,/,2)})

exten => _X.,n,Set(L0CATI0N=${CUT(L0CATI0N,-,1)})

exten => _X.,n,Set(WH0=${H0TDESK_PH0NE_STATUS(${L0CATI0N})})

exten => _X.,n,GotoIf($[${ISNULL(${WH0})}]?no_outgoing,1)

exten => _X.,n,Set(${WH0}_CID_NAME=${H0TDESK_INF0(cid_name,${WH0})})

exten => _X.,n,Set(${WH0}_CID_NUMBER=${H0TDESK_INF0(cid_number,${WH0})})

exten => _X.,n,Set(${WH0}_C0NTEXT=${H0TDESK_INF0(context,${WH0})})

exten => _X.,n,Goto(${${WH0}_C0NTEXT},${EXTEN},1)

[international]

exten => _011.,1,No0p()

exten => _011.,n,Set(E=${EXTEN})

exten => _011.,n,Goto(outgoing,call,1)

exten => i,1,No0p()

exten => i,n,Playback(silence/2&sorry-cant-let-you-do-that2) exten => i,n,Hangup()

include => longdistance

[longdistance]

exten => _1NXXNXXXXXX,1,No0p()

exten => _1NXXNXXXXXX,n,Set(E=${EXTEN})

exten => _1NXXNXXXXXX,n,Goto(outgoing,call,1)

exten => _NXXNXXXXXX,1,Goto(1${EXTEN},1)

exten => i,1,No0p()

exten => i,n,Playback(silence/2&sorry-cant-let-you-do-that2) exten => i,n,Hangup()

include => local

[local]

exten => _416NXXXXXX,1,No0p()

exten => _416NXXXXXX,n,Set(E=${EXTEN})

exten => _416NXXXXXX,n,Goto(outgoing,call,1) exten => i,1,NoOp()

exten => i,n,Playback(silence/2&sorry-cant-let-you-do-that2) exten => i,n,Hangup()

Если звонок может быть выполнен, он направляется на обработку в контекст [outgoing], где с помощью функции CALLERID() задаются имя и номер для ID вызывающего абонента. После этого вызов передается по SIP-каналу с помощью service_provider, который был создан в файле sip.conf. [outgoing]

exten => call,1,NoOp()

exten => call,n,Set(CALLERID(name)=${${WHO}_CID_NAME}) exten => call,n,Set(CALLERID(number)=${${WHO}_CID_NUMBER}) exten => call,n,Dial(SIP/service_provider/${E}) exten => call,n,Playback(silence/2&pls-try-call-later) exten => call,n,Hangup()

Наш service_provider в файле sip.conf мог бы выглядеть примерно так:

[service_provider] type=friend

host=switch1.service_provider.net

username=my_username

fromuser=my_username

secret=welcome

context=incoming

canreinvite=no

disallow=all

allow=ulaw

И это все! Полностью диалплан, используемый для реализации возможности «горячих столов», можно увидеть в приложении G. Мы только что рассмотрели столько всего, что можно реализовать с помощью func_odbc! Теперь вы понимаете, почему нас так восторгает эта функция?!

Обратная совместимость func_odbc

С Asterisk 1.4 можно использовать версию func_odbc, созданную для обеспечения обратной совместимости, которая применяет немного другой формат конфигурации. Это позволяет использовать множество DSN-соединений с разными базами данных, а также применять переменную канала ${ODBCROWS} для SQL-запросов read (SELECT). Загрузить версию func_odbc для обратной совместимости и установить ее (что приведет к перезаписи существующего файла func_odbc.c) можно так:

# cd /usr/src/

# svn co http://svncommunity.digium.com/svn/func_odbc/1.4 ./func_odbc-1.4

# cp func_odbc-1.4/func_odbc.c ./asterisk-1.4/funcs

# cp: overwrite \/asterisk-1.4/funcs/func_odbc.c'? y

• cd asterisk-1.4

• make install

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

• read станет readsql.

• write станет writesql.

• dsn станет readhandle и writehandle (для отдельных строк в базе данных для чтения и записи).

• Может быть перечислено несколько (до 5) readhandle и writehandle, в порядке предпочтения, для выполнения перехода в случае невозможности соединения с основным обработчиком.

• prefix останется неизменным.

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

Реализация голосовой почты с использованием ODBC

Asterisk может сохранять голосовую почту в базе данных, используя ODBC-коннектор. Это полезно в кластеризованной среде, когда требуется отделить данные голосовой почты от локальной системы, чтобы обеспечить возможность доступа к одним и тем же данным нескольким серверам Asterisk. Конечно, необходимо учесть, что в этом случае происходит централизация части Asterisk и необходимо предпринять меры для защиты этих данных, такие как регулярное резервное копирование и, возможно, кластеризация серверной части базы данных с помощью дублирования. Для PostgreSQL существует несколько хороших проектов, реализующих это: PGcluster (http://pgfoundry.org/projects/pgcluster/) и Slony-I (http://gborg.postgresql.org/project/slony1 /projdisplay.php).

Asterisk хранит голосовую почту в большом двоичном объекте (Binary Large Object), или BLOB. При извлечении данных она извлекает информацию из BLOB и временно сохраняет ее на жестком диске, пока сообщение воспроизводится для пользователя. Затем, когда пользователь удаляет сообщение голосовой почты, Asterisk удаляет BLOB и соответствующие записи из базы данных. Многие СУБД, такие как MySQL, имеют встроенную поддержку объектов BLOB, но для использования этой функциональности в PostgreSQL необходимо предпринять несколько дополнительных шагов, что будет рассмотрено в данном разделе. После этого вы сможете записывать, воспроизводить и удалять данные голосовой почты из базы данных так, как если бы они хранились на локальном жестком диске.

Данный раздел базируется на предыдущих разделах данной главы, посвященных конфигурации. Если вы еще не сделали этого, прежде чем двигаться дальше, обязательно выполните рекомендации разделов «Установка СУБД PostgreSQL» и «Установка и конфигурация ODBC». Выполняя действия, описанные в разделе «Установка и конфигурация ODBC», убедитесь, что активировали опцию ODBS STORAGE (ХРАНИЛИЩЕ ODBS) в разделе Voicemail Build Options (Опции сборки голосовой почты) окна выбора компонентов сборки.

Создание типа большого объекта

PostgreSQL необходимо показать, как работать с большими объектами. Сюда относится и создание триггера для очистки данных при удалении из базы данных записи, которая ссылается на большой объект. Установим соединение с базой данных из консоли как пользователь asterisk:

# psql -h localhost -U asterisk asterisk

Password:

Чтобы создать большой объект, выполним следующий сценарий в консоли PostgreSQL:

CREATE FUNCTION loin (cstring) RETURNS lo AS 'oidin' LANGUAGE internal IMMUTABLE STRICT;

CREATE FUNCTION loout (lo) RETURNS cstring AS 'oidout' LANGUAGE internal IMMUTABLE STRICT;

CREATE FUNCTION lorecv (internal) RETURNS lo AS 'oidrecv' LANGUAGE internal IMMUTABLE STRICT;

CREATE FUNCTION losend (lo) RETURNS bytea AS 'oidrecv' LANGUAGE internal IMMUTABLE STRICT;

CREATE TYPE lo ( INPUT = loin, OUTPUT = loout, RECEIVE = lorecv, SEND = losend,

INTERNALLENGTH = 4, PASSEDBYVALUE );

CREATE CAST (lo AS oid) WITHOUT FUNCTION AS IMPLICIT;

CREATE CAST (oid AS lo) WITHOUT FUNCTION AS IMPLICIT;

Для создания функции будем использовать процедурный язык Postgre- SQL, называемый pgSQL/PL. Эта функция будет вызываться из триггера, который выполняется при любом изменении или удалении записи из таблицы, применяемой для хранения голосовой почты. Таким образом, происходит очистка данных и в базе данных не остается висячих (несвязанных) строк:

CREATE FUNCTION vm_lo_cleanup() RETURNS "trigger" AS $$ declare

msgcount INTEGER; begin

-- raise notice 'Starting lo_cleanup function for large object with old

%',old.recording;[118]-- Если это действие обновления, но поле BLOB (lo) не было изменено,

не делаем ничего if (TG_OP = 'UPDATE') then if ((old.recording = new.recording) or (old.recording is NULL)) then raise notice 'Not cleaning up the large object table, as recording has not changed';[119]return new; end if; end if;

if (old.recording IS NOT NULL) then SELECT INTO msgcount COUNT(*) AS COUNT FROM voicemessages WHERE recording = old.recording; if (msgcount > 0) then

raise notice 'Not deleting record from the large object table, as object is still referenced';[120]return new; else

perform lo_unlink(old.recording); if found then

raise notice 'Cleaning up the large object table';[121]return new; else

raise exception 'Failed to cleanup the large object table';[122]return old; end if; end if;

else

raise notice 'No need to cleanup the large object table, no recording on old row';[123]return new; end if; end$$

LANGUAGE plpgsql;

Мы собираемся создать таблицу voicemessages (сообщения голосовой почты), в которой будет храниться информация голосовой почты:

CREATE TABLE voicemessages (

uniqueid serial PRIMARY KEY, msgnum int4, dir varchar(80), context varchar(80), macrocontext varchar(80), callerid varchar(40), origtime varchar(40), duration varchar(20), mailboxuser varchar(80), mailboxcontext varchar(80), recording lo, label varchar(30), "read" bool DEFAULT false

);

И теперь надо связать триггер с этой вновь созданной таблицей, чтобы выполнять очистку при любом внесении изменения или удалении из таблицы voicemessages:

CREATE TRIGGER vm_cleanup AFTER DELETE OR UPDATE ON voicemessages FOR EACH ROW EXECUTE

PROCEDURE vm_lo_cleanup();

Конфигурация voicemail.conf для ODBC-хранилища

Чтобы сделать возможным хранение голосовой почты с использованием ODBC, файл voicemail.conf не придется подвергать очень большим изменениям. Фактически в него надо добавить всего три строки! Как правило, в разделе [general] файла voicemail.conf описывается несколько типов форматов, однако нам необходимо определить всего один. Формат wav49 - это формат записи WAV-файлов со сжатием, которые должны воспроизводиться как в настольных системах Linux, так и в Microsoft Windows.

Опция odbcstorage указывает на имя, заданное в файле res_odbc.conf (если вы внимательно читали данную главу, это было имя asterisk). Опция odbctable ссылается на таблицу, в которую должна сохраняться информация голосовой почты. В примерах данной главы использовалась таблица voicemessages:

[general] format=wav49 odbcstorage=asterisk odbctable=voicemessages

Для голосовой почты можно создать отдельный контекст или использовать контекст по умолчанию:

[default]

1000 => 1000,J.P. Wiser

Теперь подключаемся к консоли Asterisk и выгружаем, а затем повторно загружаем модуль app_voicemail.so:

*CLI> module unload app_voicemail.so == Unregistered application 'VoiceMail' == Unregistered application 'VoiceMailMain' == Unregistered application 'MailboxExists' == Unregistered application 'VMAuthenticate'

*CLI> module load app_voicemail.so

Loaded /usr/lib/asterisk/modules/app_voicemail.so => (Comedian Mail (Voicemail System))

== Registered application 'VoiceMail' == Registered application 'VoiceMailMain' == Registered application 'MailboxExists' == Registered application 'VMAuthenticate' == Parsing '/etc/asterisk/voicemail.conf': Found

И проверяем успешность загрузки нового почтового ящика:

*CLI> voicemail show users for default Context Mbox User Zone NewMsg

default 1000 J.P. Wiser 0

Тестирование голосовой почты с использованием ODBC

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

[odbc_vm_test]

exten => 100,1,Voicemail(1000@default) ; оставляем сообщение голосовой почты exten => 200,1,VoicemailMain(1000@default) ; извлекаем сообщение голосовой

; почты

После обновления файла extensions.conf не забудьте перезагрузить диалплан:

*CLI> dialplan reload Можно или включить (с помощью выражения include) контекст odbc_ vm_test в контекст, доступный существующему пользователю, или создать отдельного пользователя для тестирования. Если выбран второй вариант, нового SIP-пользователя можно описать в файле sip.conf следующим образом (при условии, что телефон подключен к локальной сети LAN): [odbc_test_user] type=friend secret=supersecret context=odbc_vm_test host=dynamic qualify=yes disallow=all allow=ulaw allow=gsm

Не забудьте перезагрузить SIP-модуль:

*CLI> module reload chan_sip.so и убедиться в том, что SIP-пользователь существует: *CLI> sip show users like odbc_test_user

Username Secret Accountcode Def.Context ACL NAT

odbc_test_user supersecret odbc_vm_test No RFC3581

Затем задаем для телефона или клиента имя пользователя odbc_test_ user и пароль supersecret, а потом звоним на добавочный номер 100, чтобы оставить сообщение голосовой почты. В случае успеха вы должны увидеть примерно следующее:

-- Executing VoiceMail("SIP/odbc_test_user-10228cac", "1000@default") in new stack

-- Playing 'vm-intro' (language 'en') -- Playing 'beep' (language 'en') -- Recording the message -- x=0, open writing: /var/spool/asterisk/voicemail/default/1000/tmp/dlZunm format: wav49, 0x101f6534 -- User ended message by pressing # -- Playing 'auth-thankyou' (language 'en') == Parsing '/var/spool/asterisk/voicemail/default/1000/INBOX/msg0000.txt': Found

Теперь можно снова использовать приложение psql и убедиться, что запись в базу данных действительно осуществляется:

# psql -h localhost -U asterisk asterisk

Password:

С помощью запроса SELECT проверим наличие некоторых данных в таблице voicemessages:

localhost=# SELECT id,dir,callerid,mailboxcontext, recording FROM voicemessages;

id | dir | callerid | mailboxcontext | recording —+ + + +

1 | /var/spool/asterisk/ | +18005551212 | default | 47395

voicemail/default/1000/INBOX (1 row)

Если запись была помещена в базу данных, должна быть возвращена соответствующая строка. Вы заметите, что в столбце recording имеется номер (он, скорее всего, будет отличаться от приведенного здесь), который на самом деле является идентификатором большого объекта, хранящегося в системной таблице. Давайте проверим существование большого объекта в этой системной таблице с помощью команды lo_ list:

localhost=# \lo_list Large objects

ID | Description +

47395 | (1 row)

Проверяем, соответствует ли ID объекта в таблице voicemessages указанному в системной таблице больших объектов. Также можно извлечь информацию из базы данных и сохранить ее на жестком диске, чтобы воспроизвести и убедиться, что сообщение было сохранено правильно: localhost=# \lo_export 47395 /tmp/voicemail-47395.wav lo_export

Теперь проверьте аудиозапись, используя свое любимое приложение для работы с аудиоданными, например приложение play: # play /tmp/voicemail-47395.wav

Time: 00:06.22 [00:00.00] of 00:00.00 ( 0.0%) Output Buffer: 298.36K Done.

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

*CLI>

-- Executing VoiceMailMain("SIP/odbc_test_user-10228cac", "1000@default")

in new stack -- Playing 'vm-password' (language 'en') -- Playing 'vm-youhave' (language 'en') -- Playing 'digits/1' (language 'en') -- Playing 'vm-INB0X' (language 'en') -- Playing 'vm-message' (language 'en') -- Playing 'vm-onefor' (language 'en') -- Playing 'vm-INB0X' (language 'en') -- Playing 'vm-messages' (language 'en') -- Playing 'vm-opts' (language 'en') -- Playing 'vm-first' (language 'en') -- Playing 'vm-message' (language 'en') == Parsing '/var/spool/asterisk/voicemail/default/1000/INB0X/msg0000.txt': Found

Заключение

В данной главе мы рассмотрели несколько областей интеграции Asterisk с реляционной базой данных. Это полезно для систем, в которых необходимо реализовать масштабирование через кластеризацию нескольких серверов Asterisk, работающих с общей централизованной информацией, или когда требуется создавать внешние приложения для изменения информации без перезагрузки системы (то есть без необходимости изменения плоских файлов).13

Управление системой Asterisk

Это не будет рассматриваться в книге. Исходный код тоже должен на что-то сгодиться, в конце концов.

- Ларри Уолл

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

Запись параметров вызовов

Даже без всяких указаний Asterisk предполагает, что вы хотите сохранять информацию CDR¹.

По умолчанию Asterisk создает CSV-файл и помещает его в папку /var/log/asterisk/cdr-csv/². На первый взгляд в этом файле ничего не

CDR (Call Detail Record) - запись параметров вызова. В телекоммуникационной сфере это файл, содержащий информацию о работе оборудования, такую как идентификатор источника звонка, идентификатор назначения, длительность и стоимость каждого звонка, общее время работы за тарифицированный период, оставшееся время и списанная за данный период сумма. Формат CDR определяется телекоммуникационным оператором или программой. Некоторые программы позволяют конфигурирование формата CDR пользователем. - Примеч. науч.ред.

Файл в формате с разделяющими запятыми (Comma Separated Values, CSV) - общепринятый метод представления данных в текстовом файле. CSV-файл можно открыть в любом текстовом редакторе, но большинство программ обработки крупноформатных таблиц и баз данных также будут читать такие файлы и правильно разбивать их на строки и столбцы.

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

accountcode

Присваивается, если оно задано для канала в конфигурационном файле канала (то есть в sip.conf). Код счета задается для каждого канала. Это значение можно также менять из диалплана, задавая

CDR(accountcode).

Полученный идентификатор вызывающего абонента (строка, 80 символов).

Вызываемый добавочный номер.

dcontext

Вызываемый контекст.

clid

Идентификатор вызывающего абонента с текстом (80 символов).

channel

Используемый канал (80 символов).

dstchannel

Вызываемый канал, если требуется (80 символов).

lastapp

Последнее приложение, если требуется (80 символов).

lastdata

Данные последнего приложения (аргументы, 80 символов).

start

Начало звонка (дата/время).

answer

Ответ на звонок (дата/время).

end

Окончание звонка (дата/время).

duration

Общая продолжительность в системе, в секундах (целое число), от набора номера до разъединения.

Если вас удивляет, почему такая простая на вид вещь считается чем-то особенным, вспомните, что многие традиционные офисные АТС не обладают такой встроенной возможностью. Для этих систем даже для того, чтобы просто фиксировать данные вызовов, не обрабатывая их, необходимо приобретать оборудование сторонних производителей. Asterisk просто сохраняет их. Никаких мучений. Никаких затрат. Никаких шуток.

billsec

Общее время вызова, в секундах (целое число), от ответа до разъединения.

disposition

Что произошло с вызовом (возможные значения - ANSWERED, NO ANSWER, BUSY). amaflags

Какие флаги использовать (DOCUMENTATION, BILL, IGNORE и т. д.), задаются для каждого канала в отдельности, как accountcode. AMA расшифровывается как Automated Message Accounting (автоматизированные учетно-расчетные операции услуг связи). AMA-флаги являются стандартными (предположительно) в отрасли. userfield

Определенное пользователем поле, максимум 255 символов.

Хранение CDR в базе данных

CDR также могут храниться в базе данных. В настоящее время Asterisk поддерживает СУБД SQLite, PostgreSQL, MySQL и unixODBC, но в данной книге рассматривается только ODBC (см. главу 12). Многие предпочитают хранить CDR в базе данных, чтобы управлять счетами и ресурсами с помощью запросов.

Работа с журналами регистрации

В ходе работы Asterisk формирует события, которые будут обусловливать создание записи или в основных системных журналах регистрации, или в собственных файлах журнала Asterisk. В сильно загруженной системе (или системе, в которой возникла существенная проблема) эти файлы могут быстро достигать очень больших размеров. Если включить отладку, процессы, участвующие в записи файлов журнала, могут начать оказывать влияние на производительность системы. По умолчанию Asterisk будет просто наращивать эти файлы до тех пор, пока жесткий диск не будет полностью заполнен. К счастью, Linux предоставляет утилиты для реализации чередования файлов журнала (чтобы ни один из файлов не разрастался слишком сильно), а также удаления старых файлов журнала (что не даст засорить ими систему).

Утилита logrotate обычно запускается операционной системой раз в день¹. К сожалению, без специального сценария, который проинс-Подробнее о работе с утилитой logrotate и настройке ее параметров можно узнать с помощью команды man logrotate. - Примеч. науч.ред.

труктирует logrotate, как работать с Asterisk, файлы журнала Asterisk будут разрастаться без всякого контроля. Чтобы этого не произошло, необходимо настроить параметры для Asterisk в специальном файле в папке /etc/logrotate.d. Этот файл должен будет сменить текущий файл журнала и послать Asterisk инструкции о необходимости смены журнала Asterisk (что заставит ее прекратить использовать теперь уже устаревший журнал и сформировать новый файл).

Создадим новый файл /etc/logrotate.d/asterisk и поместим в него следующие строки:

/var/log/asterisk/* /var/log/asterisk/cdr-csv {

missingok

sharedscripts

monthly

rotate 12

postrotate

asterisk -rx "logger rotate" > /dev/null 2> /dev/null

endscript }

Этот файл указывает утилите logrotate чередовать журналы Asterisk каждый месяц, сохраняя их в течение 12 месяцев. По завершении этого периода утилита сообщает Asterisk, что все файлы журнала были использованы (это заставит Asterisk создать новые файлы журнала и начать записывать информацию в них). Мы выбрали эти значения произвольно, вы можете назначить собственные соответственно своим нуждам.

Выполнение Asterisk под учетной записью пользователя, не обладающего правами администратора

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

Запустить Asterisk под учетной записью пользователя, не обладающего правами администратора, не так уж сложно, но требует нескольких

дополнительных шагов. Кроме того, отладка может привести в уныние, если не понимать принцип распределения прав доступа в Linux. Но с точки зрения безопасности это стоит затраченных усилий. Мы собираемся запустить Asterisk под учетной записью пользователя asterisk, поэтому необходимо сначала создать этого пользователя в нашей системе. Следующие команды будут выполняться под учетной записью администратора. Мы скажем, когда перейти к использованию учетной записи asterisk, которую собираемся сейчас создать:

# adduser -c "Asterisk PBX" asterisk

# passwd asterisk

Теперь, создав пользователя asterisk, переключимся на этого пользователя, под учетной записью которого будем выполнять все остальные команды. Как только мы переключились на пользователя asterisk с помощью команды su[124], можно загружать копию Asterisk через SVN, FTP или WGET, компилировать и устанавливать ее. В следующем примере мы собираемся взять копию Asterisk из хранилища SVN.

1.4.5 - текущая выпущенная версия на момент написания данной книги. Пока книга готовилась к публикации, могла выйти новая версия, поэтому проверьте последнюю версию на веб-сайте Asterisk. Другими словами, не надо бездумно вводить 1.4.5 в своем коде, копируя наши примеры. Выясните, какова текущая версия, и используйте ее.

# su - asterisk

$ svn co http://svn.digium.eom/svn/asterisk/tags/1.4.5 asterisk-1.4.5 $ cd asterisk-1.4.5

$ ./configure --prefix=$HOME/asterisk-bin --sysconfdir=$HOME/asterisk-bin

--localstatedir=$HOME/asterisk-bin $ make menuselect $ make install

Выполняя сценарий ./configure с флагом --prefix, мы указываем системе установить двоичные компоненты в подпапку asterisk-bin папки $HOME[125]. Флаг --sysconfdir указывает системе, куда поместить конфигурационные файлы, а флаг --localstatedir - куда установить дополнительные файлы, например звуковые. Главное здесь то, что, поскольку загрузка, компиляция и установка выполняются от лица пользователя asterisk, все, что создается, будет закреплено за этим пользователем и будет иметь права, предоставленные этому пользователю. Теперь можно установить файлы примеров, тоже в папку $HOME/ asterisk-bin/asterisk:

$ make samples

Выполним тестовый запуск Asterisk с помощью следующей команды:

$ ./asterisk-bin/sbin/asterisk -cvvv Обычно Asterisk должна выполняться как сервис. Во время установки команда make config устанавливает сценарии инициализации. К сожалению, этого не произойдет, если вы зарегистрированы как пользователь asterisk, потому что только пользователь root имеет право изменять команды запуска системы. Кажется, что надо зарегистрироваться как root, перейти к папке /home/asterisk/asterisk-1.4.5 и снова выполнить команду make config (теперь с правами, которые позволят действительно ее выполнить). И проблема решена, не так ли? Да, но не совсем. Если вы выполните команду service asterisk start, система сообщит, что не может найти asterisk. Знаете, почему? Потому, что сценарий инициализации считает, что исполняемый файл asterisk должен быть установлен в /usr/sbin, где он должен был бы находиться, если бы мы установили asterisk под учетной записью root. Итак, мы должны сообщить сценарию инициализации, где искать asterisk и сценарий safe_asterisk:

# ln -s /home/asterisk/asterisk-bin/sbin/asterisk /usr/sbin/asterisk

# ln -s /home/asterisk/asterisk-bin/sbin/safe_asterisk /usr/sbin/safe_asterisk

Поскольку наш сценарий инициализации использует сценарий safe_ asterisk и по умолчанию пытается запустить Asterisk под учетной записью администратора, необходимо изменить сценарий safe_asterisk, указав ему запускать Asterisk под учетной записью пользователя, не обладающего правами администратора. Итак, откроем сценарий safe_ asterisk в своем любимом текстовом редакторе и найдем переменную

ASTARGS (это примерно 78-я строка). Вставим в кавычки -U asterisk:

#

# Don't fork when running "safely"[126]

#

ASTARGS="-U asterisk" Пойдем дальше и запустим Asterisk, выполнив команду service asterisk start. С помощью команды ps убедимся, что Asterisk запущена под учетной записью пользователя asterisk:

# service asterisk start

# ps aux | grep asterisk

503 30659 0.0 1.8 26036 8692 pts/2 Sl 15:07 0:00 /home/asterisk/asterisk-bin/sbin/asterisk -U asterisk -vvvg -c

Фактически 503 - это наш пользователь asterisk; проверяем это, заглянув в файл /etc/passwd: # cat /etc/passwd

asterisk:x:503:503:Asterisk PBX:/home/asterisk:/bin/bash Выполним перезагрузку системы, чтобы убедиться, что все идет, как надо. Помните, что многие операции, осуществляемые с Asterisk, могут предполагать ее выполнение под учетной записью администратора, поэтому необходимо следить за возможными ошибками, касающимися ограниченных прав доступа. Ваш процесс Asterisk может считать себя суперпользователем, но мы немножко подрезали ему крылышки.

Зачем создавать проблемы? Суть в том, что если какое-либо слабое место системы безопасности Asterisk[127] обеспечит кому-либо доступ к серверу через учетную запись asterisk, его возможности в системе будут ограничены правами данной учетной записи. Если Asterisk выполняется под учетной записью root, нарушение правил безопасности обеспечивает злоумышленнику полный контроль над вашей системой.

Настройка голосовых сообщений системы

Благодаря своей практически безграничной гибкости Asterisk можно менять голосовые сообщения системы. Это очень просто объяснить, но, как правило, сложно хорошо выполнить.

Основной дистрибутив включает 300 голосовых сообщений системы, плюс еще 600 в дополнении asterisk-sounds. Если вы задумали настроить их все, необходимо иметь или кучу денег, или массу времени. Звукотехнику рекомендуется обеспечить нормализацию всех записей до -3 дБ и их корректное начало и завершение (с соответствующей паузой в начале и конце сообщения).

Имея в распоряжении готовые записи, применить их легко - просто замените файлы в папке /var/lib/asterisk/sounds теми, которые вы создали.

Голос

Если вас интересует, кто является «голосом» Asterisk, то ее зовут Эллисон Смит (Allison Smith). Она может записать специальные сообщения и для вашей системы.

Это мощная концепция, потому что очень немногие офисные АТС предоставляют возможность использовать один и тот же голос и в собственных, и в системных сообщениях. Эллисон - «голос» сообщений системы как на английском, так и на испанском языках.

Также доступны сообщения на французском. «Голосом» французского Asterisk является Джун Уоллак (June Wallack) из Montreal's own (она также озвучивает сообщения на безупречном английском[128], если вы захотите, чтобы сообщения на обоих языках были записаны одним голосом).

Чтобы узнать, как получить собственные голосовые сообщения, посетите веб-сайт Digium по адресу http://www.digium.com/products/ voice.

В качестве альтернативы можно записать сообщения самостоятельно и поместить их любую папку по своему выбору. В приложениях Playback() или Background() можно указывать полный путь к звуковым файлам или любую подпапку /var/lib/asterisk/sounds/.

Обратите внимание, что стандартные звуки Asterisk записаны в формате GSM. Хранить их в этом формате целесообразно, только если система будет взаимодействовать со множеством каналов, использующих кодек GSM). Конечно, файлы в формате GSM занимают меньше места на жестком диске, но, на наш взгляд, дополнительная нагрузка на ЦП для их преобразования (не говоря уже о более низком качестве звука в целом) делает нежелательным применение GSM. При использовании файлов без сжатия (таких, как .wav, .ulaw или .alaw) ЦП не придется так напряженно работать. И как дополнительный приз - лучшее качество звучания сообщений.

Запись звука из диалплана

Удивительно, но один из самых простых способов получить записи приличного качества - не с помощью ПК с невообразимым ПО для редактирования, а через телефонный аппарат. На это есть масса причин, но самое важное то, что телефон, как правило, обеспечивает запись без фонового шума (такого, как белый шум, создаваемый оборудованием отопления, вентиляции и кондиционирования воздуха) и с постоянным уровнем громкости. Это небольшое дополнение в диалплан позволит без труда создавать записи, которые будут помещаться в папку /tmp/ вашей системы (где их можно переименовать, а затем перенести в любое другое место):

exten => _66XX,1,Wait(2)

exten => _66XX,n,Record(/tmp/prompt${EXTEN:2}:wav) exten => _66XX,n,Wait(1)

exten => _66XX,n,Playback(/tmp/prompt${EXTEN:2}) exten => _66XX,n,Wait(2) exten => _66XX,n,Hangup()

Данный фрагмент кода обеспечит возможность звонить на номера от 6600 до 6699 и записывать сообщения в папку /tmp/ под именами от prompt00.wav до prompt99.wav. После завершения записи (о чем вы сообщите, нажав кнопку #) ваше сообщение будет воспроизведено и соединение завершится.

Не забудьте перенести свои сообщения из папки /tmp/ в папку для звуковых файлов Asterisk. Чтобы диалплан оставался понятным, присвойте файлам prompt более осмысленные имена. Например:

mv /tmp/prompt00.wav /var/lib/asterisk/sounds/custom/welcome-message.wav

Музыка во время ожидания

Любая широко распространенная система АТС предлагает возможность воспроизведения музыки во время ожидания ответа. В этом вопросе Asterisk предоставляет широкое поле для творчества. Сегодня все хорошо знакомы с музыкальным форматом MP3 и использование MP3-файлов в качестве источника музыки во время ожидания представляет большой интерес. Конечно, это кажется хорошей идеей, но есть некоторые вопросы, над которыми, по нашему мнению, следует задуматься:

• MP3-файлы чрезвычайно сложны, и их декодирование налагает серьезную нагрузку на ЦП. Если имеется много каналов, извлекающих музыку из системы (например, иногда люди любят слушать

музыку по телефону или сразу несколько абонентов ожидают ответа информационно-справочной службы), требования к ЦП сильно возрастают, что связанно с необходимостью воспроизведения хранящихся МР3-файлов. Компьютер, который в других условиях обеспечивал бы нужды системы, может оказаться непригодным.

• Современные жесткие диски могут хранить большие объемы данных, поэтому, вероятно, нет никакой причины беспокоиться о сокращении пространства, занимаемого звуковыми файлами. Сжатие звука имеет смысл с точки зрения передачи по сетям (МР3-файл намного меньше и удобнее для скачивания, чем эквивалентный ему файл в формате .wav), но в рамках системы на самом деле неважно, сколько места занимают эти файлы.

• При использовании МР3-файлов обычно возникают проблемы с лицензированием. ;-)

Учитывая все это, рекомендуем преобразовать используемые музыкальные файлы в собственный формат различных кодеков, которые поддерживает ваша система. Например, если для внутренних телефонов поддерживается plaw и G.729 в VoIP-сетях, музыку лучше хранить в обоих форматах, чтобы Asterisk не приходилось выполнять перекодировки для воспроизведения музыки в этих каналах. Мы часто используем в своих системах общедоступную музыку (или музыку, лицензированную Creative Commons). Музыка Creative Commons

Свободно распространяемая музыка

Многие не знают, что воспроизведение музыки во время ожидания требует специальной лицензии, даже если вы используете музыку с приобретенного вами CD или передаваемую по радио. Во избежание недоразумений мы рекомендуем вам использовать только музыку, предлагаемую в музыкальной индустрии, которая не обременена никакими видами лицензий. Существует множество веб-сайтов, на которых можно найти музыку, лицензированную так, что она подходит для использования в качестве музыки во время ожидания. Мы нашли два таких сайта: http://en.wikipedia.0rg/wiki/Wikipedia:S0und/list и http:// www.opsound.org/.

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

Чтобы найти больше свободно распространяемой музыки, выполните поиск по словам Creative Commons music (музыка Creative Commons).

часто поступает в формате ogg-Vorbis (который концептуально аналогичен MP3, но несовместим с ним). Чтобы воспроизводить файлы .ogg или .mp3 в системе Asterisk, необходимо преобразовать их в формат, с которым может работать Asterisk. Для этого сделаем следующее:

• Убедимся, что установлена утилита SoX (Sound eXchange). Если нет, выполняем следующую команду для ее установки:

$ yum install sox

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

$ wget http://upload.wikimedia.org/wikipedia/commons/6/62/PachelbelX27s_Canon.ogg

• Теперь надо преобразовать эту запись из формата ogg-Vorbis в более подходящий для Asterisk формат:

$ sox Pachelbel\'s_Canon.ogg -r 8000 -c 1 -s -w moh1.wav resample -ql *-i

Возможно, понадобится также скорректировать амплитуду з помощью опции -V.

JA*

Итак, мы взяли исходный файл, преобразовали его в WAV-файл, подходящий для Asterisk[129] и сохранили получившийся в результате файл как moh1.wav.

• Практически все сделано. Осталось только создать папку для постоянного хранения новых файлов (/tmp, конечно, не место для них):

$ mkdir /var/lib/asterisk/mohwav и перенести их туда: $ mv *.wav /var/lib/asterisk/mohwav

• Поскольку мы разместили наши музыкальные файлы в другой папке, а не в той, куда Asterisk устанавливает свои образцы музыки, необходимо внести изменения в конфигурационный файл, чтобы отразить это. Редактируем файл /etc/asterisk/musiconhold.conf следующим образом:

[default] mode=files

directory=/var/lib/asterisk/mohwav random=yes

Скажем несколько слов о том, какую музыку использовать. Это будет зависеть от того, какое впечатление вы желаете произвести на своих абонентов. Независимо от вашего выбора, следует помнить, что:

• Люди на самом деле не хотят ждать, поэтому обычно они не планируют слишком долго оставаться в таком состоянии. Это означает, что нет особого смысла давать им прослушивать серьезные музыкальные произведения. Их мысли сейчас заняты другим, и у них не будет времени проникнуться этой музыкой.

• Телефонная система не обеспечивает качества, необходимого для точного воспроизведения звуков. Низкие басы обычно звучат ужасно, а высокие частоты воспринимаются просто как шум. Музыка должна быть простой, тогда ей, скорее всего, обеспечено хорошее звучание.

• Музыкальные предпочтения различных людей очень разнообразны, и, хотя может показаться хорошей идеей охватить широкий диапазон стилей, такая эклектичная музыкальная подборка вызовет скорее раздражение, чем расположение.

Классическая музыка удовлетворяет всем перечисленным выше критериям, и ее легко достать. Также она обладает превосходным звучанием (и не без основания!), так что это наиболее приемлемый выбор, хотя, следует признать, под эту музыку не хочется пуститься в пляс. В пакете для скачивания Asterisk вместе с исходным кодом имеется три композиции, лицензированных для использования с Asterisk. Эти композиции являются лишь образцами. Поскольку их только три, они быстро надоедят людям, которые будут часто вам звонить. Только в кошмарном сне можно себе представить, что Asterisk обязана своим

Случайный выбор музыки во время ожидания

В традиционной офисной АТС музыка во время ожидания поступает из одного источника. В один момент времени все слышат одну и ту же музыку, и даже если никого нет в режиме ожидания, музыка все равно воспроизводится. В Asterisk музыка не воспроизводится, если в ней нет необходимости, и каждому вызывающему абоненту предоставляется собственный источник музыки. Если бы Asterisk просто начинала воспроизводить композиции в том порядке, в каком их находит, для каждого вызова, переведенного в режим ожидания, всегда проигрывалась бы одна и та же мелодия с начала. Чтобы смоделировать традиционное поведение при задержке вызова, Asterisk может (и обычно должна) быть настроена на воспроизведение музыки в случайном порядке. Это означает, что система будет случайным образом выбирать файл для воспроизведения. Если в каталоге музыки во время ожидания достаточно различных композиций, можно свести к минимуму вероятность того, что тот, кто звонит вам часто, будет вынужден постоянно слушать одну и ту же мелодию.

всемирным успехом радости людей от прослушивания одних и тех же трех мелодий при ожидании ответа на звонок. Поэтому мы написали этот раздел.

Заключение

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

14

Попурри

На 90% задачи уходит 90% времени, а на оставшиеся 10% уходит еще 90% времени.

- Правило девяносто к десяти

Самым сложным при создании данной книги было выбрать не то, о чем писать, а то, о чем не будет возможности рассказать. Теперь, когда базовые вопросы рассмотрены, вы готовы к тому, чтобы услышать правду: мы вовсе не научили вас всему тому, что необходимо знать об Asterisk.

Теперь, пожалуйста, поймите, что это не потому, что мы не хотели дать все самое лучшее, а лишь из-за того, что Asterisk безгранична (во всяком случае, нам так кажется).

В данной главе мы хотим дать вам почувствовать вкус некоторых диковинок, которые Asterisk приберегла для вас. Практически каждый раздел этой главы мог бы стать отдельной книгой (и они станут книгами, если Asterisk добьется того успеха, который мы ей предвещаем).

Festival

Festival - популярный механизм речевого воспроизведения текста с открытым исходным кодом. Основная идея использования Festival с Asterisk заключается в том, что диалплан может передавать тело текста в Festival, который будет «читать» этот текст вызывающему абоненту. Вероятно, самое очевидное применение Festival - чтение электронной почты вслух, когда вы в дороге¹.

Настройка и подготовка Festival к работе с Asterisk

В настоящее время существует два способа использования Festival с Asterisk. Первый (самый простой) метод, без доработки и повторной компиляции Festival, - загрузить в конфигурационный файл Festival следующий текст (festival.scm обычно располагается в папке /etc/ или /usr/share/festival/):

(define (tts_textasterisk string mode) "(tts_textasterisk STRING MODE)

Apply tts to STRING. This function is specifically designed for use in server mode so a single function call may synthesize the string. This function name may be added to the server safe functions."[130]

(let ((wholeutt (utt.synth (eval (list 'Utterance 'Text string))))) (utt.wave.resample wholeutt 8000) (utt.wave.rescale wholeutt 5) (utt.send.wave.client wholeutt)))

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

Второй (и более традиционный) способ - скомпилировать Festival со специальным патчем для Asterisk (располагающимся в подпапке contrib/ папки исходного кода Asterisk).

Информация по обоим методам имеется в файле README.festival, который находится в подпапке contrib/ папки исходного кода Asterisk. Для любого метода вам придется изменить список доступа Festival в файле festival.scm. Просто выполните поиск по слову localhost и замените его полным доменным именем своего сервера.

Оба метода настраивают Festival так, чтобы он мог правильно взаимодействовать с Asterisk. Настроив Festival, необходимо запустить сервер Festival. После этого можно вызывать приложение Festival() из диалплана.

Конфигурация Asterisk для работы с Festival

Конфигурационный файл Asterisk, обеспечивающий настройки для работы с Festival, называется festival.conf, что вполне логично. В этом файле задаются имя хоста и порт используемого сервера Festival, а также некоторые настройки для кэширвания речи, генерируемой Festival. Для большинства установок (если вы собираетесь запускать Festival на своем сервере Asterisk) прекрасно подходят настройки по умолчанию.

Запуск сервера Festival

Чтобы запустить сервер Festival для отладки, просто выполните команду festival с аргументом --server: [root@asterisk ~]# festival --server Убедившись в том, что сервер Festival работает и не отклоняет ваших соединений, можно запустить Festival, введя следующее: [root@asterisk ~]# festival_server 2>&1 >/dev/null &

Вызов Festival из диалплана

Теперь, когда Festival сконфигурирован и сервер Festival запущен, организуем его вызов в простом диалплане:

exten => 123,1,Answer()

exten => 123,2,Festival(Asterisk and Festival are working together)

Перед вызовом Festival() всегда должно быть вызвано приложение Answer(), чтобы гарантировать установление соединения по каналу.

Когда Asterisk соединяется с Festival, на терминале, с которого был запущен сервер Festival, должен появиться такой вывод:

[root@asterisk ~]# festival --server

Еще один способ использования Festival с Asterisk

Некоторые участники сообщества разработчиков Asterisk сообщают о том, что им удалось передать текст в утилиту Festival text2wave и воспроизвести в Asterisk результирующий WAV-файл. Например, это можно сделать так:

exten => 124,1,Answer()

exten => 124,2,System(echo "Это проверка Festival" | /usr/bin/text2wave -scale 1.5 -F 8000 -o /tmp/festival.wav) exten => 124,3,Playback(/tmp/festival) exten => 124,4,System(rm /tmp/festival.wav) exten => 124,5,Hangup()

Этот метод также позволяет вызывать другие механизмы речевого воспроизведения текста, такие как популярный речевой механизм производства компании Cepstral (http://www.cepstral.com), который является недорогой коммерческой производной Festival с очень приятными голосами. Для этого примера будем считать, что Cepstral установлен в папку /usr/local/cepstral/: exten => 125,1,Answer()

exten => 125,2,System(/usr/local/cepstral/bin/swift -o /tmp/swift.wav

"Это проверка Cepstral")

exten => 125,3,Playback(/tmp/swift)

exten => 125,4,System(rm /tmp/swift.wav)

exten => 125,5,Hangup()

Появление следующего вывода означает, что в список доступа в файле festival.scm не был добавлен хост, вследствие чего соединение было отклонено:

[root@asterisk ~]# festival --server

server Sun May 1 18:30:52 2005 : Festival server started on port 1314 client(1) Sun May 1 18:32:32 2005 : rejected from asterisk.localdomain not in access list

Файлы вызовов

Файлы вызовов позволяют создавать вызовы в оболочке Linux. Эти мощные события запускаются путем размещения файла .call в папке /var/spool/asterisk/outgoing/. Фактически имя файла не имеет значения, но хорошей практикой является давать ему информативное имя и заканчивать его расширением .call.

Когда файл вызова появляется в папке исходящих вызовов, Asterisk практически немедленно начинает действовать согласно содержащимся в нем инструкциям[131].

Файлы вызовов записываются в следующем формате. Сначала определяем, куда будем звонить:

Channel: канал

Можно задать время ожидания ответа на звонок (по умолчанию 45 с), время между повторными попытками дозвониться и максимальное число попыток. Если параметр MaxRetries (максимальное число попыток) опущен, выполняется только одна попытка вызова:

WaitTime: число RetryTime: число MaxRetries: число

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

Context: имя-контекста Extension: добавочный номер Priority: приоритет

В качестве альтернативы можно задать только приложение и передавать аргументы в него:

Application: Playback() Data: hello-world

Далее задаем Caller ID (ID звонящего) исходящего звонка:

CallerID: Asterisk 800-555-1212

Задаем переменные канала следующим образом:

SetVar: john=Zap/1/5551212 SetVar: sally=SIP/1000

и добавляем код учетной записи CDR:

Account: документация

Нельзя создавать файл вызова из папки, в которой находится очередь. Asterisk активно отслеживает подкачку и попытается захватить файл даже еще до того, как он будет закончен! Файлы вызовов должны создаваться в какой-то другой папке, потом в той же папке создается копия этого файла и эта копия с помощью команды mv перемещается в папку подкачки. Заметьте, что мы назвали команду mv, не cp. Это важно, потому что процесс копирования в Linux реализован таким образом, что файл появляется в папке назначения еще до того, как он оказывается там полностью. В противоположность этому, использование операции mv не позволит файлу появиться в папке назначения до полного завершения операции перемещения. При копировании очень велика вероятность того, что Asterisk начнет читать файл до того, как он весь будет перенесен туда, что приведет к непредвиденным результатам.

DUNDi

Если бы возникли опасения, что Марк Спенсер может исчерпать свой запас интересных идей, система Distributed Universal Number Discovery (DUNDi) с легкостью пресекла бы их. DUNDi является такой же революционной разработкой, как и Asterisk. Лучшее определение дано на веб-сайте DUNDi (http://www.dundi.com): «DUNDi™ - это одноранговая система для поиска интернет-шлюзов в сервисы телефонии. В отличие от традиционных централизованных сервисов (таких, как необыкновенно простой и лаконичный стандарт ENUM; http://www.faqs.org/rfc/ rfc2916.txt), DUNDi является полностью распределенным и вообще не имеет никакой централизованной службы». DUNDi - это в некотором роде протокол маршрутизации для VoIP.

Как работает DUNDi

DUNDi можно рассматривать как большую телефонную книгу, которая позволяет запрашивать у равноправных участников сети альтернативный VoIP-маршрут к добавочному номеру или телефонному номеру PSTN.

Например, предположим, вы подключены к сети DUNDi-test (это бесплатная и открытая сеть, которая обеспечивает звонки на традиционные номера PSTN). Вы спрашиваете своего друга Боба, знает ли он, как связаться с номером 1-212-555-1212, к которому у вас нет прямого доступа. Боб отвечает: «Я не знаю, как позвонить на этот номер, но сейчас спрошу у своей подружки Салли (которая является равноправным участником сети)».

Боб спрашивает Салли, не знает ли она, как связаться с требуемым номером, и она отвечает: «С этим номером можно связаться по адресу IAX/ dundi:очень_длинный_пароль@имяхоста/добавочный номер». Боб сохраняет этот адрес в своей базе данных и передает вам информацию о том, как связаться с 1-800-555-1212 через VoIP, предоставляя альтернативный метод достижения той же цели по другой сети. Поскольку Боб сохранил найденную информацию, он сможет предоставлять ее всем равноправным участникам сети, которые будут запрашивать этот же номер у него позже, таким образом, им не придется продолжать свои поиски. Это способствует снижению нагрузки на сеть и сокращает время ответа для часто запрашиваемых номеров. (Однако следует отметить, что DUNDi создает циклически сменяющийся ключ, таким образом, хранящаяся информация остается действительной лишь ограниченный период времени.)

DUNDi выполняет поиск динамически или с помощью выражения switch => в вашем файле extensions.conf, или используя приложение DUNDiLookup(). DUNDi доступен только в Asterisk версии 1.2 и выше.

DUNDi-протокол может использоваться и в локальной сети. Скажем, вы администратор системы Asterisk в очень большой корпорации и желаете упростить процесс управления добавочными номерами. В этой ситуации мог бы использоваться DUNDi, обеспечивая возможность нескольким серверам Asterisk (предположительно расположенным в разных офисах компании и объединенным в одноранговую сеть) выполнять динамические поиски VoIP-адресов добавочных номеров в сети.

Конфигурация Asterisk для использования с DUNDi

Для работы с DUNDi необходимо сконфигурировать три файла: dundi. conf, extensions.conf и iax.conf[132]. Файл dundi.conf управляет аутентификацией равноправных участников, которым мы разрешаем выполнять поиск в нашей системе. Этот файл также содержит список равноправных участников сети, которым мы можем направлять свои запросы поиска. Поскольку на одном сервере могут выполняться несколько разных сетей, для каждого равноправного участника необходимо определить собственный раздел и затем сконфигурировать сети, в которых ему разрешено выполнять поиски. Кроме того, необходимо определить, каких равноправных участников мы желаем использовать для осуществления поисков.

Общее пиринговое соглашение

Общее пиринговое соглашение, или General Peering Agreement (GPA), - это имеющее обязательную юридическую силу лицензионное соглашение, разработанное для предотвращения злоупотреблений с протоколом DUNDi. Перед подключением к группе DUNDi-test необходимо подписать GPA. GPA используется для защиты членов группы и для установления между ними доверительных отношений. Обязательным требованием группы DUNDi-test является указание полной и точной контактной информации в файле dundi.conf, чтобы остальные участники одноранговой группы могли связаться с вами. GPA можно найти в подпапке doc/ папки исходного кода Asterisk.

Общая конфигурация

Раздел [general] файла dundi.conf содержит параметры, относящиеся к общим вопросам работы клиента и сервера DUNDi:

; конфигурационный файл DUNDi

[general]

department=IT

organization= toronto.example.com

locality=Toronto

stateprov=ON

country=CA

email=support@toronto.example.com phone=+19055551212

; Задаем адрес привязки и номер порта. ПО умолчанию - 4520

;bindaddr=0.0.0.0

port=4520

entityid=FF:FF:FF:FF:FF:FF ttl=32

autokill=yes ;secretpath=dundi

Идентификатор объекта, заданный entityid, вообще должен быть адресом управления доступом к устройству (Media Access Control, MAC) интерфейса компьютера. По умолчанию в качестве идентификатора объекта используется первый Ethernet-адрес сервера, но его можно переопределить с помощью entityid, если ему присвоен MAC-адрес какого- то принадлежащего вам устройства. Рекомендуется использовать MAC-адрес основного внешнего интерфейса. С помощью этого адреса другие равноправные участники будут идентифицировать вас.

Поле Time To Live (ttl) определяет длину цепочки равноправных участников, от которых мы желаем получать ответы, и используется для прерывания циклов опроса. При каждой передаче запроса вниз по цепочке участников до тех пор, пока запрашиваемый номер не будет найден, значение поля TTL увеличивается на единицу, точно так же как это происходит с полем TTL пакета ICMP (Internet Control Message Protocol - межсетевой протокол контрольных сообщений, используемый для отладки и мониторинга в IP-сетях). Поле TTL также определяет максимальную продолжительность (в секундах) ожидания ответа.

Если вам необходимо найти номер, вашим равноправным участникам сети рассылается исходный запрос (называемый DPDISCOVER) об этом номере. Если вы не получаете подтверждение приема (ACK) своего запроса (DPDISCOVER) в течение 2000 мс (время, достаточное только для передачи сигнала) и параметр autokill имеет значение yes, Asterisk разошлет равноправным участникам сообщение CANCEL (отменить). (Заметьте, что подтверждение приема необязательно является ответом на запрос; это лишь подтверждение того, что участник получил запрос.) Назначение autokill - предотвращение задержек поиска из-за хостов с большим временем ожидания. Кроме опций yes и no, можно также задавать время ожидания в миллисекундах.

Модуль pbx_dundi создает циклически сменяющийся ключ и сохраняет его в локальной базе данных Asterisk (AstDB). Имя ключа secret хранится в семействе dundi. Значение ключа можно увидеть с помощью команды database show в консоли Asterisk. Семейство базы данных может быть переопределено опцией secretpath (путь к базе ключей).

Создание отображающихся контекстов

Файл dundi.conf определяет контексты DUNDi, отображаемые в контексты диалплана в файле extensions.conf. Контексты DUNDi - это способ описания особых и отдельных групп служб каталогов. Контексты раздела отображения указывают на контексты файла extensions.conf, управляющего номерами, информацию о которых вы предоставляете. При создании равноправного участника вы должны определить, по каким отображающимся контекстам он может выполнять поиск. Делается это с помощью выражения permit (у каждого равноправного участника может быть несколько выражений permit). Отображающиеся контексты связаны с контекстами диалплана в том смысле, что они являются границей зоны безопасности для ваших равноправных участников. Информация о телефонных номерах должна предоставляться в следующем формате:

<код_страны><код_города><префикс><номер> Например, полный североамериканский номер был бы представлен так:14165551212.

Все отображающиеся контексты DUNDi принимают форму

dundi_контекст => локальный_контекст,вес,технология,местоназначения[,опции]] Приведенная ниже конфигурация создает отображающийся контекст DUNDi, который мы будем использовать для предоставления группе DUNDi-test информации о наших локальных телефонных номерах. Обратите внимание, что все это должно располагаться в одной строке: dundi-test => dundi-local,0,IAX2,dundi:${SECRET}@toronto.example.com/ ${NUMBER},nounsolicited,nocomunsolicit,nopartial

В этом примере отображающийся контекст - это dundi-test. Он указывает на контекст dundi-local в файле extensions.conf (предоставляющий список телефонных номеров, звонки с которых он обрабатывает). Для номеров офисной АТС вес равен нулю (соединение выполняется напрямую). Вес номера, отличный от 0, свидетельствует о наличии нескольких переходов или путей на маршруте достижения места назначения. Это значение может быть полезно при получении нескольких ответов на один поиск; предпочтительным будет путь с меньшим весом. Если мы можем ответить на запрос поиска, наш ответ будет содержать метод, с помощью которого другой конец линии сможет соединиться с системой. Сюда относится используемая технология (такая, как IAX2, SIP, H.323 и т. д.), имя пользователя и пароль, по которым выполняется аутентификация, хост, на который следует отправлять ау- тентификационную информацию, и наконец добавочный номер. Asterisk предоставляет несколько сокращенных записей, что позволяет создавать «шаблон», по которому можно построить наши ответы. В шаблоне могут использоваться следующие переменные канала: ${SECRET}

Замещается шаблоном, хранящимся в локальной AstDB.

${NUMBER}

Запрашиваемый номер.

Обычно безопаснее статически конфигурировать имя хоста, I а не использовать переменную $ 11PADDR j. Переменная $ 11PADDR j иногда предоставляет адрес в частном пространстве 1Р-адре- сов, недоступном из Интернета.

Описание равноправных участников DUNDi

Равноправные участники DUNDi описываются в файле dundi.conf и идентифицируются уникальным MAC-адресом второго уровня интерфейса удаленной системы. Файл dundi.conf - это то место, где мы определяем, в каком контексте выполнять поиск для равноправных участников, запрашивающих поиск, и каких равноправных участников мы хотим использовать при выполнении поиска для конкретной сети:

[00:00:00:00:00:00] ; Удаленный офис

model = symmetric

host = montreal.example.com

inkey = montreal

outkey = toronto

include = dundi-test

permit = dundi-test

qualify = yes

dynamic=yes

Идентификатор удаленного равноправного участника (MAC-адрес) заключается в квадратные скобки ([]). inkey и outkey - это пара ключей (открытый и закрытый), используемых для аутентификации. Пары ключей генерирует сценарий astgenkey, располагающийся в подпапке ./asterisk/contrib/scripts/ папки исходного кода. Не забывайте использовать флаг -n, чтобы не приходилось создавать пароли при каждом запуске Asterisk:

# cd /var/lib/asterisk/keys

# /usr/src/asterisk/contrib/scripts/astgenkey -n toronto Полученные в результате ключи, toronto.pub и toronto.key, будут помещены в папку /var/lib/asterisk/keys/. Файл toronto.pub - это открытый ключ, который должен быть отправлен веб-серверу, чтобы он был доступен всем участникам, с которым вы желаете установить одноранговую связь. При установлении одноранговой связи вы можете передать равноправным участникам открытый ключ, доступный по протоколу HTTP, который они могут поместить в свои папки /var/lib/ asterisk/keys/.

${IPADDR}

IP-адрес для соединения.

После загрузки ключей необходимо повторно загрузить модули res_ crypto.so и pbx_dundi.so в Asterisk:

*CLI> module reload res_crypto.so

-- Reloading module 'res_crypto.so' (Cryptographic Digital Signatures)

-- Loaded PRIVATE key 'toronto'

-- Loaded PUBLIC key 'toronto'

*CLI> module reload pbx_dundi.so

-- Reloading module 'pbx_dundi.so' (Distributed Universal Number Discovery (DUNDi))

== Parsing '/etc/asterisk/dundi.conf': Found Затем в файле iax.conf создаем пользователя dundi, чтобы обеспечить возможность соединения с вашей системой Asterisk. После аутентификации вызова запрашиваемый добавочный номер передается в контекст dundi-local файла extensions.conf, где выполняется его обработка.

Обеспечение возможности удаленных соединений

Вот описание канала типа user для пользователя dundi:

[dundi] type=user

dbsecret=dundi/secret

context=dundi-local

disallow=all

allow=ulaw

allow=g726

Вместо использования статического пароля Asterisk повторно создает пароль каждые 3600 с (1 ч). Это значение сохраняется в /dundi/secret базы данных Asterisk и предоставляется посредством переменной $ {SECRET}, описанной в отображающемся контексте в файле dundi.conf. Увидеть текущие ключи для всех равноправных участников, включая свои локальные открытый и закрытый ключи, можно, выполнив команду show keys в интерфейсе командной строки Asterisk.

Запись context=dundi-local определяет контекст в extensions.conf, в который направляются прошедшие авторизацию вызывающие абоненты. Оттуда мы можем обрабатывать звонок, точно так же как делали бы это в диалплане любого другого входящего соединений.

Конфигурация диалплана

Файл extensions.conf определяет, информацию о каких номерах вы предоставляете и что делаете с вызовами, адресованными им. Контекст dundi-local выполняет две задачи:

• Управляет номерами, информацию о которых мы предоставляем. Они указаны в отображающемся контексте dundi в файле dundi.conf.

• Определяет то, что должно быть сделано с вызовом, указанным в описании пользователя dundi в iax.conf.

Для предоставления информации о диапазонах номеров и управления входящими вызовами используется мощная возможность сопоставления с шаблонами, доступная в диалплане. В следующем диалплане предоставляется информация только о номере +1-416-555-1212, но так же просто можно применить сопоставление с шаблоном для предоставления информации о диапазоне номеров или добавочных номеров: [dundi-local]

exten => 14165551212,1,NoOp(dundi-local: Number advertisement and incoming)

exten => 14165551212,n,Answer()

exten => 14165551212,n(call),Dial(SIP/1000)

exten => 14165551212,n,Voicemail(u1000)

exten => 14165551212,n,Hangup()

exten => 14165551212,n(call)+101,Voicemail(b1000)

exten => 14165551212,n,Hangup()

Альтернативные методы хранения голосовой почты

Обычный способ хранения голосовой почты Asterisk - простая запись сообщения в файл, размещаемый на локальном жестком диске в папке /var/spool/asterisk/voicemail. Этот метод хорош для простых офисных АТС, но в больших распределенных сетях или окружениях, в которых желательна более тесная интеграция с внешними приложениями, потребуются более сложные методы хранения.

Хранение голосовой почты на IMAP-сервере

Уже довольно долгое время телефонная отрасль обещает предоставить возможность хранения голосовых сообщений вместе с обычными сообщениями электронной почты. Это называется универсальной системой передачи и обработки сообщений (Unified Messaging), и хотя большинство офисных АТС сегодня предлагают такую систему в том или ином виде, обычно ее лицензирование и реализация очень дороги.

Естественно, Asterisk отбрасывает все эти глупости и просто позволяет интегрировать ящик голосовой почты в среду IMAP. Хранение голосовой почты на IMAP-сервере обеспечивает несколько преимуществ. После прослушивания по телефону сообщение голосовой почты переводится в состояние read (прочитано) на IMAP-сервере. Это означает, что клиентское почтовое приложение также отметит это сообщение как прочитанное. Аналогичным образом, если сообщение прослушивается из клиентского почтового приложения, система голосовой почты отключает сигнал уведомления о наличии непрочитанного сообщения на всех телефонах, закрепленных за этим почтовым ящиком. Удаление сообщения в одном месте обеспечит его удаление везде. Таким образом, однажды удаленное сообщение действительно уничтожается. Такова универсальная система передачи и обработки сообщений, «священный грааль» интеграции голосовой и электронной почты, но Asterisk скромно предпочитает не акцентировать на этом особое внимание. Интеграция с IMAP по-прежнему является новой функциональностью, поэтому для ее активации необходимо кое-что добавить. Первым делом для работы с IMAP-сервером Asterisk необходимо установить IMAP- клиент. Подойдет практически любой IMAP-сервер (даже Exchange Server). Авторы лично протестировали поддержку голосовой почты по протоколу IMAP с IMAP-серверами Courier-IMAP и Dovecot. IMAP- сервер физически может располагаться на одном компьютере с установленной Asterisk или находиться в другой части земного шара. Чтобы иметь возможность доступа к IMAP-серверу, Asterisk требует наличия библиотеки IMAP-клиента. Эта библиотека является бесплатным IMAP-клиентом под именем c-client, созданным в Вашингтонском университете. Чтобы установить c-client, надо просто перейти в свою папку /usr/src и выполнить следующие команды:

# wget ftp://ftp.cac.washington.edu/mail/imap.tar.Z

Это обеспечит загрузку исходного кода. Извлеките его из архива следующим образом:

# tar zxvf imap.tar.Z

Обратите особое внимание на имя папки, создаваемой этой командой, поскольку оно, вероятно, изменится к тому времени, когда вы будете читать данную книгу. Пока книга готовилась к выходу, имя папки менялось четыре раза. Последним было /usr/src/imap-2006h.

Перейдите в созданную папку и выполните команду

# make lrh IP6=4

Это обеспечит компиляцию всего, что необходимо Asterisk для использования библиотек IMAP-клиента[133].

Теперь необходимо повторно скомпилировать Asterisk с возможностями IMAP. Понадобится перейти в ту папку, в которой располагаются исходные файлы Asterisk (к примеру, /usr/src/asterisk), и выполнить следующую команду:

# /configure --with-imap=/usr/src/imap-2006h

Теперь необходимо повторно выполнить команду make menuconfig, чтобы включить IMAP-хранилище в компиляцию. В разделе Voicemail Build Options (Параметры создания голосовой почты) выберите параметр IMAP STORAGE (ХРАНИЛИЩЕ IMAP) и нажмите кнопку x, чтобы сохранить изменения и выйти. Теперь при компиляции Asterisk будет выполнена и сборка модуля IMAP. Очевидно, что следующий шаг - повторная компиляция и установка Asterisk. Для этого просто выполните в вашем терминале следующую команду:

# make && make install

Итак, модуль скомпилирован и установлен. Пришло время его сконфигурировать.

Добавим несколько строк в раздел [general] файла voicemail.conf, хранящегося в папке /etc/asterisk:

imapserver=localhost

imapport=143

expungeonhangup=yes

authuser=vmail

authpassword=vmailsecret

imapfolder=Voicemail

Поскольку Dovecot доступен в хранилище пакетов CentOS, установить небольшой IMAP-сервер для обработки виртуальных пользователей (голосовой почты) на сервере Asterisk просто:

# yum install dovecot

Обеспечим активацию поддержки IMAP в файле /etc/dovecot.conf, раскомментировав строку protocols, чтобы она выглядела следующим образом:

protocols = imap imaps Активировав поддержку IMAP, создадим учетную запись пользователя для сохранения почты:

# groupadd vmail

# useradd vmail -g vmail -s /bin/true -c "asterisk voicemail user" -p vmailsecret -d /var/spool/asterisk/imap-voicemail vmail

# chown -R vmail.vmail /var/spool/asterisk/imap-voicemail

Теперь перезапустим Dovecot и Asterisk - и все должно быть готово.

# service dovecot restart

# service asterisk restart

Поздравляем! Вы успешно установили базовую поддержку голосовой почты IMAP в Asterisk! Однако это лишь верхушка айсберга. Имея хранилище голосовой почты, работающее по протоколу IMAP, можно без труда реализовать совместно используемую (например, по отделам) голосовую почту с помощью совместно используемых IMAP-папок. Многие компании уже имеют совместно используемую по отделам электронную почту, так что совместно используемый ящик голосовой почты - весьма естественное и логичное развитие технологии. При наличии IMAP-хранилища голосовой почты каждый сотрудник может работать с несколькими ящиками голосовой почты, не смешивая личные и рабочие сообщения. С точки зрения Asterisk в конфигурации нет ничего необычного; вы просто вызываете приложение VoiceMail() с указанием желаемого почтового ящика и контекста и обеспечиваете, чтобы совместно используемая IMAP-папка была включена в список папок почтового клиента служащего отдела.

Наконец, вместо глобального IMAP-пользователя Asterisk может быть реализована авторизация для каждого почтового ящика в отдельности (то есть каждый ящик голосовой почты аутентифицируется как отдельный пользователь). Asterisk поддерживает это с помощью опций imapuser и imapsecret в индивидуальных описаниях ящиков голосовой почты:

[imapvoicemail]

# => 1234,Sue's Mailbox,,,imapuser=sue@example.tld|imapsecret=suesimapsecret

# => 5555,Bob's Mailbox,,,imapuser=bob@example.tld|imapsecret=bobsimapsecret

В этом конкретном примере, если сообщение оставлено в почтовом ящике IMAP 100 контекста imapvoicemail, Asterisk будет проходить аутентификацию на IMAP-сервере как sue@example.tld, используя в качестве пароля suesimapsecret. Аналогично, если сообщение оставлено в почтовом ящике 101 того же контекста голосовой почты, будут использоваться соответственно bob@example.tld и bobimapsecret.

Хранение голосовой почты в базе данных ODBC

На всякий случай повторяю, что голосовая почта также может храниться в базе данных посредством ODBC-коннектора. Этому посвящена глава 12!

Asterisk и Jabber (XMPP)

Jabber - на самом деле первоначальное имя протоколов IETF XMPP (RFC 3920-3923). Поскольку имя Jabber, несомненно, лучше, чем XMPP, оно и закрепилось. Этот протокол изначально разрабатывался для обеспечения децентрализованной, общедоступной инфраструктуры обмена сообщениями и контроля присутствия, поддерживающей открытые стандарты. Она поддерживает доставку сообщений в автономном режиме и шифрование и «доросла» до голосовых сообщений, которые поддерживает Asterisk.

Интересно отметить, что вначале Jabber рассматривался как конкурент протокола SIMPLE, основывающегося на SIP. XMPP разработан как более универсальный протокол и, конечно, на основе XML. Asterisk можно сконфигурировать на использование XMPP в нескольких видах. XMPP может выступать в роли инфраструктуры контроля присутствия (например, добавочный номер 205 не отвечает или занят) или инфраструктуры обмена голосовыми сообщениями JINGLE для полной поддержки телефонной связи с другими сервисами, такими как Google Talk.

В отличие от других сетей обмена сообщениями, таких как MSN и Yahoo!, XMPP децентрализована. Кто угодно может иметь свой собственный Jabber-сервер и выполнять на нем любое количество сервисов. Сообщения отправляются практически так же, как сообщения электронной почты: используемый Jabber-сервер связывается с Jabber-сер- вером другого человека и устанавливается прямое соединение. Если этот человек не в сети, сообщение сохраняется, и, когда он регистрируется на своем Jabber-сервере, выполняется доставка всех хранящихся сообщений. Учитывая возможность шифрования (протокол XMPP поддерживает TLS), неудивительно, что многие коммерческие организации переходят к реализации внутренних сетей обмена сообщениями с использованием этого замечательного протокола. И Asterisk может органично интегрироваться в эти сети связи.

Заключение

Вот и все, что мы собирались рассказать в данной главе, но это далеко не все, что вы можете узнать об Asterisk. Надеемся, вы начинаете осознавать, насколько велики возможности Asterisk.

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

Asterisk - будущее телефонии

Сначала они не замечают вас, потом осмеивают, затем начинают бороться и наконец - проигрывают.

- Махатма Ганди

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

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

Проблемы традиционной системы телефонной связи

Чаще всего создателем телефона называют Александра Грэхема Белла, но на самом деле во второй половине 19 века десятки умов работали над задачей передачи голоса по телеграфным линиям. Эти люди в большинстве своем были ребятами с деловой жилкой, жаждущими создать продукт, который помог бы им сколотить состояние.

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

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

Культурные различия очевидны. Телекоммуникационные технологии стремятся к закрытости, запутанности и дороговизне, тогда как сетевые технологии, как правило, открыты, хорошо задокументированы и конкурентоспособны.

Закрытость мышления

Если сравнивать культуру телекоммуникационной отрасли с Интернетом, иногда сложно поверить, что они имеют родство. Интернет был создан энтузиастами, тогда как индивидуальное участие в разработке PSTN невозможно себе представить. Это «клуб для избранных»; членство в нем доступно не каждому¹.

Международный союз телекоммуникаций (International Telecommunication Union, ITU), несомненно, демонстрирует такой тип закрытого мышления. Тот, кто хочет прикоснуться к его знаниям, должен быть готов заплатить за них. Членство требует подтверждения квалификации, и вам придется заплатить тысячи долларов за доступ к его библиотеке публикаций.

Хотя ITU - организация, санкционированная ООН и отвечающая за международную связь, многие протоколы VoIP (SIP, MGCP, RTP, STUN) вышли не из священных стен ITU, а были ратифицированы IETF (который публикует все свои стандарты абсолютно бесплатно и принимает на рассмотрение любые проекты спецификаций интернет-протоколов).

Открытые протоколы, такие как SIP, могут иметь тактическое преимущество над ITU-протоколами, например H.323, благодаря доступности. Хотя H.323 популярен среди поставщиков услуг связи как базовый VoIP-протокол, попробуйте найти терминалы на базе H.323. Новые продукты чаще всего поддерживают SIP.

Успех открытого подхода IETF не остался незамеченным могущественным ITU. Не так давно на веб-сайте ITU появилась возможность бесплатно скачать до трех документов[134]. Очевидно, что идея открытости появилась в их умах. Недавние заявления ITU свидетельствуют о желании достичь «большей вовлеченности в ITU гражданского общества и академического мира». Г-н Хоулинь Чжао (Houlin Zhao), директор Бюро по стандартизации телекоммуникаций (Telecommunication Standardization Bureau, TSB) ITU, верит, что «ITU должен предпринять шаги, которые способствовали бы этому»[135].

План достижения этой открытости неясен, но ITU начинает осознавать неизбежное.

Что касается Asterisk, она охватывает и прошлое, и будущее: доступна поддержка H.323, хотя сообщество преимущественно отказалось от H. 323 в пользу IETF-протокола SIP и любимчика сообщества Asterisk IAX.

Несоблюдение стандартов

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

ISDN-протоколы - классический пример этому. Развертывание ISDN было (и во многом остается и сейчас) болезненным и дорогим предприятием, поскольку каждый производитель решил реализовать его немного по-своему. ISDN мог бы обеспечить появление масштабной общедоступной сети передачи данных на 10 лет раньше создания Интернета. К сожалению, из-за цены, сложности и проблем совместимости ISDN не пошел дальше передачи голоса и лишь в редких случаях используется для транспортировки видео или данных теми людьми, кто готов платить. ISDN довольно широко распространен (особенно в Европе и в Северной Америке в реализациях крупных АТС), но он и близко не реализует те возможности, которые мог бы.

По мере все большего распространения VoIP необходимость в ISDN исчезнет.

Длительные циклы выпуска новых версий

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

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

Такие длительные циклы выпуска просто недопустимы в современном мире средств связи для бизнеса. Для Интернета распространение новых идей может быть вопросом нескольких недель, и их внедрение занимает очень короткий промежуток времени. Все остальные технологии должны адаптироваться к этим изменениям, это касается и систем связи.

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

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

Нежелание расстаться с прошлым и раскрыть объятия будущему

Традиционные телекоммуникационные компании утратили связь со своими клиентами. Необходимость введения дополнительных возможностей, кроме базовых функций телефона, отчетливо ясна, но идея того, что именно пользователь должен выбирать эту функциональность, еще не нашла понимания.

Сегодня люди имеют практически неограниченную гибкость во всех других формах связи. Они просто не способны понять, почему услуги телефонной связи не могут быть настолько гибкими, как того обещает данная отрасль в течение уже столь долгих лет. Идея гибкости не близка индустрии связи и, вероятно, не станет таковой до тех пор, пока продукты с открытым исходным кодом, такие как Asterisk, не изменят сути этой отрасли. Это революция, подобная той, начало которой намеренно положили Linux и Интернет более 10 лет назад (и невольно начала IBM, создав ПК за 15 лет до этого). В чем заключается эта революция? В выводе на свободный рынок оборудования и программного обеспечения для телефонии и обеспечении возможности распространения систем телефонной связи, предназначенных для различных потребностей.

Смена взглядов и понятий

В своей статье «Open Source Paradigm Shift» (http://tim.oreilly.com/ articles/paradigmshift_0504.html) Тим О'Рейлли (Tim O'Reilly) говорит о смене взглядов и понятий, которая произошла в сфере разработки технологий (это касается как оборудования, так и ПО)¹. О'Рейлли выделяет три направления: превращение ПО в товар, сотрудничество, обеспечиваемое сетевыми средствами, и возможность гибкой настройки ПО (ПО как услуга). Эти три концепции дают основания полагать, что время систем телефонной связи с открытым исходным кодом пришло.

Перспектива телефонии с открытым исходным кодом

Все лучшие программы начинаются с решения проблем их автора.

- Эрик С. Раймонд «Собор и базар»

В своей книге «Собор и базар» Эрик С. Раймонд объясняет, что «при достаточном количестве глаз все дефекты всплывают на поверхность». Причина, по которой разработка ПО с открытым исходным кодом обеспечивает такое устойчивое качество, проста: недостаткам просто невозможно укрыться.

Проблема, которую решает Asterisk

В эпоху разработки собственных баз данных и веб-сайтов люди не только устали постоянно слышать, что их система телефонной связи «не может обеспечить этого», они просто открыто не верят в это. Изощренные потребности пользователей в сочетании с ограничениями технологии привели к рождению особого типа творчества: специалисты связи, как участники соревнования в передаче «Супервойны на свалке», пытаются создать функциональные устройства из груды плохо сочетающихся компонентов.

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

Следующий раздел во многом является интерпретацией статьи О'Рейлли. Чтобы проникнуть в суть этих идей, настоятельно рекомендуем прочитать оригинальную статью.

не обойтись, и это существенно уменьшит ценность такой системы, потому что она не сможет полностью удовлетворить ваши нужды. Тот факт, что пользователю могут быть необходимы лишь 5 из 500 функций, не учитывается, и желание пользователя иметь 5 недоступных функций, отвечающих требованиям его деятельности, отвергается как необоснованное[136]. Пока гибкость не станет нормой, телекоммуникация останется в прошлом веке, несмотря на все технологии VoIP в мире.

Asterisk решает именно эту проблему, и решает ее так, как могут немногие системы телефонной связи. Это чрезвычайно разрушительная технология, в большей мере потому, что она основывается на принципах, находящих свое подтверждение снова и снова: «мир с закрытым исходным кодом не может выиграть эволюционную гонку у сообществ, придерживающихся стратегии открытого исходного кода, которые имеют возможность вложить в решение проблемы на порядки больше времени работы квалифицированных специалистов»[137].

Открытая архитектура

Одним из камней преткновения традиционных систем связи было откровенное нежелание сотрудничать друг с другом. Телекоммуникационные гиганты существуют более ста лет. Принцип закрытых узкоспециализированных систем настолько проник в их культуру, что даже попытки соответствовать стандартам подорваны их желанием обогнать конкурентов, добавив хотя бы одну такую функцию, которую больше никто не поддерживает. Чтобы увидеть пример подобного мышления, достаточно взглянуть на VoIP-продукты, предлагаемые сегодня телекоммуникационной отраслью. Несмотря на заявленное соблюдение стандартов, идея о том, чтобы действительно предоставить возможность подключения телефона Cisco к коммутатору Nortel или интеграции системы голосовой почты Avaya через протокол IP с офисной АТС Siemens, даже не обсуждается.

В компьютерной отрасли все иначе. Двадцать лет назад при покупке IBM-сервера для взаимодействия с ним необходимы были IBM-сеть и IBM-терминалы. Сейчас IBM-сервер, скорее всего, сможет соединяться с терминалами Dell по сети Cisco (и работать под управлением ОС Linux, кроме всего прочего). Можно привести массу подобных примеров. Если бы любая из этих компаний заявила, что мы можем использовать их продукты только с тем, на что они нам укажут, ей пришлось бы уйти с рынка.

Телекоммуникационная отрасль переживает такие же изменения, но не торопится принять их. Asterisk, с другой стороны, очень спешит не только принять изменения, но активно использовать их. IP-телефоны Cisco, Nortel, Avaya и Polycom (и это далеко не полный список) были успешно подключены к системам Asterisk. Сегодня в мире нет другой офисной АТС, которая могла бы похвастать этим. Ни одной. Мощь Asterisk - в открытости.

Соответствие стандартам

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

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

Мгновенный ответ на новые технологии

После посещения первого мероприятия, посвященного тестированию совместимости SIP (SIP Interoperability Test, SIPIT), Марк Спенсер за несколько дней создал для Asterisk элементарный, но рабочий блок, обеспечивающий возможность взаимодействия с библиотекой SIP Stack. Это было еще до того, как SIP стал предпочтительным протоколом в мире VoIP, но Марк разглядел его ценность и потенциал и обеспечил готовность Asterisk к его использованию.

Такое умение предвидеть и гибкость типичны в сообществе разработчиков продуктов с открытым исходным кодом (и очень нетипичны для больших корпораций).

Полное энтузиазма сообщество

Каждый день в рассылку Asterisk-users (пользователи Asterisk) приходит множество электронных писем. У этой рассылки более 10 000 подписчиков. Такая поддержка сообщества является просто неслыханной для мира узкоспециализированных телекоммуникаций, тогда как в мире открытого исходного кода это норма. Ожидалось, что первое мероприятие AstriCon привлечет внимание 100 человек, пришло около 500 (желающих было намного больше, но они просто не смогли присутствовать). Такая поддержка сообщества, несомненно, гарантирует успех продукта с открытым исходным кодом.

Что уже возможно

Итак, что можно сделать, используя Asterisk? Давайте рассмотрим кое-что из того, что уже предлагается.

Шлюз для традиционной офисной АТС

Asterisk может быть фантастическим мостом от старой офисной АТС в будущее. Ее можно разместить перед АТС как шлюз (и выводить пользователей за границы офисной АТС при необходимости) или за АТС как периферийный сервер приложений. Можно даже сделать и то и другое одновременно, как показано на рис. 15.1.

Рис. 15.1. Asterisk в качестве шлюза офисной АТС

Вот некоторые функции из тех, что можно реализовать: Сохранить старую офисную АТС, но перейти на IP

Компании, потратившие в последние несколько лет огромные суммы на приобретение узкоспециализированного оборудования офисных АТС, хотят вырваться из тюрьмы ограничений, но не могут смириться с мыслью о том, что придется избавиться от своего оборудования, работающего неэффективно. Нет проблем. Asterisk может решить любые задачи, от замены системы голосовой почты до предоставления возможности введения пользователей, поддерживающих IP, сверх номинальной емкости системы.

Найди меня, следуй за мной

Предоставьте офисной АТС список номеров, по которым можно с вами связаться, - и она будет звонить по ним при поступлении вызова на ваш DID (Direct Inward Dialing, то есть телефонный номер). Рис. 15.2 иллюстрирует эту технологию.

Звонки по VoIP

Рис. 15.2. Найди меня, следуй за мной

Если можно установить соединение по телефонной линии между офисной АТС Asterisk и старой офисной АТС, Asterisk может обеспечить доступ к сервисам VoIP, тогда как старая офисная АТС продолжает соединяться с внешним миром, как обычно. При использовании в качестве шлюза Asterisk просто надо эмулировать функции PSTN - и старая офисная АТС даже не будет знать, что что-то изменилось. На рис. 15.3 показано, как можно использовать Asterisk для обеспечения поддержки VoIP в устаревшей офисной АТС.

Рис. 15.3. Поддержка VoIP в устаревшей офисной АТС

Доступный IVR

Многие путают интерактивный автоответчик (Interactive Voice Response, IVR) с обычным автоответчиком (Automated Attendant, AA). Поскольку изначально IVR использовался как автоответчик, это неудивительно. Тем не менее понятие IVR в телефонии намного шире, чем просто автоответчик. AA является, так сказать, средством для перенаправления вызывающего абонента на добавочный номер и встроен в большинство узкоспециализированных систем голосовой почты. Но функционал IVR может быть намного большим.

Системы IVR обычно не просто дороги по цене, их конфигурирование очень трудоемко. Для специальной системы IVR обычно требуется возможность соединения с внешней базой данных или приложением. Asterisk - пожалуй, идеальный IVR, поскольку в ней заложена возможность соединения с базами данных и приложениями на самом глубоком уровне.

Вот несколько примеров относительно простых IVR, для создания которых можно использовать систему Asterisk: Получение прогноза погоды

Используя Интернет, можно получать прогноз погоды в текстовом виде со всего мира сотнями способов. Если взять эти отчеты и обработать специальным синтаксическим анализатором (сценарий Perl, вероятно, мог бы с этим справиться), эту информацию можно сделать доступной для диалплана. Фонотека Asterisk уже имеет все необходимые голосовые сообщения, поэтому не составит труда создать интерактивное меню для воспроизведения текущих метеорологических прогнозов для любой точки земного шара. Математические программы

Эд Гай (Ed Guy, архитектор сети FWD (Free World Dialup - бесплатные звонки по всему миру) Пулвера) представил на конференции AstriCon 2004 небольшую математическую программу, которую создал для своей дочери. На ее написание ушло не более часа. Она представляла ряд математических вопросов, ответы на которые вводились посредством номеронабирателя телефона. После ответа на все вопросы система сообщала оценку. Реализация такого предельно простого Asterisk-приложения в любой офисной АТС на закрытой платформе стоила бы десятки тысяч долларов, если вообще могла бы быть выполнена. Подробнее об этом рассказывается в главе 9. Как это часто бывает, то, что просто для Asterisk, практически невозможно или чрезвычайно дорого в любой другой системе IVR. Распределенные IVR

Цена узкоспециализированной системы IVR такова, что, если компания, имеющая множество торговых точек, хочет обеспечить функциональность IVR, для обработки транзакций она вынуждена перенаправлять абонентов на центральный сервер. С Asterisk становится возможным распространить приложение на все серверы и, таким образом, обрабатывать запросы локально. Буквально тысячи маленьких систем Asterisk, развернутых в торговых точках по всему миру, могли бы обеспечивать функциональность IVR так, как не способна ни одна другая система. И не нужно никаких удаленных переадресаций на центральный сервер IVR или используемых специально для этой цели гигантских магистральных каналов - больше возможностей за меньшие деньги. Это три довольно простых примера того, на что потенциально способна Asterisk.

Конференц-залы

Эта маленькая возможность в конце концов станет одной из самых потрясающих функций Asterisk. В сообществе разработчиков Asterisk конференц-залы используются для разных целей все чаще:

• Небольшим компаниям необходим простой способ обеспечить возможность деловым партнерам собраться и обсудить некоторые вопросы.

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

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

Бытовая автоматизация

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

Контроль за детьми

Родители, желающие контролировать няню (или детей, оставшихся дома одних), могут звонить в контекст добавочного номера, защищенный паролем. После аутентификации будет устанавливаться двусторонняя аудиосвязь со всеми IP-телефонами в доме - это позволит маме и папе слышать, что там происходит. Жутко? Да, но интересная идея тем не менее.

Блокировка телефонов

Уходите на ночь? Не хотите, чтобы няня висела на телефоне? Нет проблем! Небольшое изменение диалплана - и можно звонить только на телефоны экстренного вызова, ваш мобильный телефон и в пиццерию. Попытки позвонить на любой другой телефон приведут к воспроизведению записи «Мы платим вам за присмотр за нашими детьми, а не за ваши личные звонки».

Очень коварно, правда?

Управление системой сигнализации

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

Как насчет того, чтобы установить временное ограничение на звонки своих детей? Чтобы использовать телефон, они должны ввести свой код доступа. Дополнительные минуты можно зарабатывать, выполняя работу по дому, за хорошие оценки, выставив за дверь этого надоедливого бездельника с ужасной прической, - идея ясна? Как только они потратили все свои минуты... щелк... телефоном можете пользоваться только вы.

С помощью Caller ID (ID звонящего) можно управлять и входящими звонками. «Донни, это отец Сьюзи. Она больше не хочет тебя видеть, поскольку решила немного поднять планку своих стандартов. И еще, тебе не мешало бы подстричься».

Будущее Asterisk

Мы полюбили Интернет и за богатство содержимого, и за дешевизну, и, что, вероятно, еще более важно, за то, что он позволяет нам самим решать, как общаться. По мере расширения его возможностей по переносу различных все более богатых форм медиа-данных мы будем использовать его чаще и чаще. Как только Интернет обеспечит доставку голоса с качеством, сравнимым с тем (или лучшим), что предоставляет PSTN, телефонной компании придется менять сферу деятельности. PSTN прекратит свое существование и станет не более чем еще одним протоколом связи, предоставляемым Интернетом. Как это произошло с большей частью Интернета, технологии с открытым исходным кодом обеспечат такое превращение.

Обработка речи

Мечта о том, чтобы наши технические изобретения разговаривали с нами, старше, чем сам телефон. Каждая новая ступень в развитии технологии порождала новую волну активных экспериментов. Как правило, результаты не соответствовали ожиданиям, вероятно, потому, что, как только машина начинает говорить то, что кажется разумным, большинство людей действительно начинают верить в ее разумность. Люди, создающие программы и обслуживающие компьютеры, осознают ограниченность их возможностей и, таким образом, допускают некоторые недостатки таких систем. Все остальные просто хотят, чтобы их компьютеры и программное обеспечение работали. Количество умственных усилий, которые пользователь должен приложить при взаимодействии с компьютером, обратно пропорционально объему умственных затрат, вложенных командой разработки. За простыми интерфейсами стоят сложные проектные решения.

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

Festival

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

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

Распознавание речи

Если преобразование текста в речь - это «космическая технология», то распознавание речи - это научная фантастика.

На самом деле распознавание речи возможно с довольно высоким качеством, но, к сожалению, обычно для этого необходимо обеспечить соответствующие условия, и это совсем не те условия, которые предлагает телефонная сеть. Даже идеальное PSTN-соединение обеспечивает минимально допустимый предел качества для точного распознавания речи. Добавьте сюда VoIP-соединения со сжатием или потерей качества или сотовый телефон - и вы обнаружите намного больше ограничений, чем преимуществ.

Asterisk сейчас имеет готовый полностью речевой API, так что внешние компании (или даже проекты с открытым исходным кодом) могут подключать свои механизмы распознавания речи к Asterisk. Одна компания, сделавшая это, - LumenVox. Используя ее механизм распознавания речи вместе с Asterisk, можно за рекордно короткое время создать управляемые голосом меню и системы IVR! Больше информации можно найти по адресу http://www.lumenvox.com.

Высокая точность воспроизведения голоса

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

Если вы когда-нибудь звонили на CNN, разве не приятно было услышать сладкозвучный голос Джеймса Эрла Джонса, говорящий: «Это CNN», - вместо какой-то электронной записи с металлическим звуком. И если вы полагаете, что голос Эллисон Смит[138] звучит в телефоне хорошо, вам стоит поговорить с ней лично!

В будущем мы ожидаем - и добьемся этого, - что наше оборудование связи будет обеспечивать высокоточное воспроизведение голоса. Asterisk начиная с версии 1.4 предоставляет ограниченную поддержку кодека G.722. По мере того как все больше производителей оборудования начнут встраивать поддержку высокоточного воспроизведения голоса в свои устройства для VoIP, будет расширяться его поддержка в Asterisk, что сделает качество звонков выше, чем в PSTN.

Видео

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

Проблема видеоконференц-связи

Идея видеоконференц-связи витала в воздухе с момента появления электронно-лучевой трубки. Телекоммуникационная отрасль десятилетиями обещала предоставить устройство видеоконференц-связи в каждый дом.

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

Почему мы любим видеконференц-связь

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

Почему видеоконференц-связь, возможно, никогда полностью не заменит аудиосвязь

Необходимо решить несколько проблем, и не все они находятся в технической плоскости.

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

Также все возможности визуального контакта по видеосвязи ничего не стоят, если фокальные точки собеседников не располагаются на одной линии с камерами. Если вы будете смотреть в камеру, ваша аудитория будет видеть, что вы смотрите на них, но вы не будете видеть их. Если вы будете смотреть на свой экран, чтобы увидеть того, с кем разговариваете, камера будет показывать, что вы смотрите куда-то в сторону, не на аудиторию. Это создает впечатление отчужденности. Возможно, если бы видеофон мог быть спроектирован, как TelePromptR, где камера располагалась за экраном, не создавалось бы впечатление такой неестественности. В данных условиях не хватает чего-то с точки зрения психологии. Видео прекращает быть диковинкой.

Беспроводная связь

Поскольку Asterisk полностью поддерживает VoIP, поддерживается и функция беспроводной связи.

Wi-Fi

Wi-Fi станет решением для обеспечения мобильности в рамках офиса для VoIP-телефонов. Эта технология уже достаточно зрелая. Самая большая помеха - стоимость телефонных трубок. Но эта ситуация обещает улучшиться, поскольку рост конкуренции по всему миру приводит к снижению цен.

Wi-MAX

Мы так смело делаем свои многочисленные предсказания, поэтому не побоимся заявить, что технология Wi-MAX стала началом конца традиционных сетей сотовой телефонной связи.

При наличии беспроводного доступа в Интернет в большинстве населенных пунктов какой смысл в дорогой сотовой связи?

Универсальная система передачи и обработки сообщений

Это рекламировалось телефонной индустрией годами, но внедрение проходит намного медленнее, чем предсказывалось. Универсальная система передачи и обработки сообщений - это концепция совмещения систем голосовых и текстовых сообщений. Теперь их не надо объединять искусственно, поскольку Asterisk уже обрабатывает их одинаково.

Даже просто взглянув на этот термин и увидев слова «универсальная» и «передача и обработка сообщений», можно понять, что интеграция электронной и голосовой почты должна быть только началом. Универсальная система передачи и обработки сообщений, чтобы оправдать свое название, должна делать намного большее.

Возможно, необходимо определить «передачу и обработку сообщений» как связь, которая происходит не в режиме реального времени. Иначе говоря, при отправке сообщения вы предполагаете, что ответ может поступить через мгновение, несколько минут, часов или даже дней. Вы формулируете то, что хотите сказать, и ожидается, что ваша аудитория даст ответ.

Сравните это с разговором, происходящим в реальном времени. Говоря по телефону, вы ожидаете ответа не более нескольких секунд. В 2002 году Тим О'Рейлли сделал доклад под названием «Watching the Alpha Geeks: OS X and the Next Big Thing» (http://www.macdevcenter. com/pub/a/mac/2002/05/14/oreilly_wwdc_keynote.html), в котором рассказывал о передаче IRC через механизм речевого воспроизведения текста. Можно представить и обратное: позволяя нам присоединяться к IRC или системе мгновенных сообщений по Wi-Fi-телефону, наша Asterisk- АТС обеспечивает преобразование речи в текст и опять в речь.

Равноправный информационный обмен

Поскольку сети-монополисты, в числе которых PSTN, сдали позиции таким поддерживаемым сообществами пользователей сетям, как Интернет, придет время, когда понадобится обеспечить возможность их соединения. Хотя традиционные поставщики услуг предпочли бы, чтобы существующая модель была перенесена в новую систему, скорее всего, телефонные звонки станут не более чем еще одним интернет- приложением.

Но проблема остается: как сохранить телефонный план нумерации, который уже стал настолько привычным и удобным?

E.164

ITU определил план нумерации в своей спецификации E.164. Если вы когда-нибудь использовали телефон для звонков по PSTN, можете с уверенностью заявлять, что знакомы с концепцией нумерации по E.164. До появления общедоступного VoIP никто не заботился о E.164, кроме телефонных компаний. В этом просто не было необходимости. Теперь, когда звонки путешествуют из PSTN в Интернет и бог знает куда еще, на E.164 необходимо обратить внимание.

ENUM

В ответ на эту проблему IETF профинансировал рабочую группу по разработке протокола отображения телефонных номеров Telephone Number Mapping (ENUM), целью которой было объединение номеров E.164 со службой доменных имен (Domain Name System, DNS). Идея ENUM разумна, но для достижения успеха необходима поддержка со стороны телекоммуникационной отрасли. Однако желание сотрудничать никогда не входило в число добродетелей этой отрасли, поэтому проект ENUM потерпел неудачу.

e164.org

Ребята с e164.org пытаются обеспечить успех ENUM. Можно зарегистрироваться на этом сайте, зарегистрировать свой номер телефона и сообщить системе альтернативные методы, по которым возможно связаться с вами. Это означает, что кто-то, кому известен ваш номер телефона, сможет позвонить вам по VoIP, поскольку DNS-зона e164.org предоставит информацию об IP-адресе и протоколе, необходимую, чтобы связаться с вами.

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

DUNDi

Распределенный универсальный каталог номеров (DUNDi) - это открытый протокол маршрутизации, разработанный для обслуживания динамических таблиц маршрутизации, которые предназначены для соединения между совместимыми системами (больше информации можно найти в главе 14). Хотя в настоящее время Asterisk является единственной офисной АТС, поддерживающей DUNDi, открытость этого стандарта позволяет реализовать его кому угодно. DUNDi имеет огромный потенциал, но он еще находится в начальной стадии развития, не стоит упускать это из виду.

Проблемы

Как и любое стоящее начинание, Asterisk столкнется с проблемами. Давайте кратко рассмотрим, какого рода трудности это могут быть.

Слишком много изменений, слишком мало стандартов

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

Спам по VoIP

Да, он грядет. Всегда были люди, которые верили, что они имеют право доставлять неудобства и беспокоить других в своей погоне за наживой. Средства борьбы с этим находятся на стадии разработки, но только время покажет, насколько эффективными они будут.

Страх, неопределенность и сомнение

Отрасль находится на стадии перехода от игнорирования к осмеянию. Если Ганди прав, можно ожидать скорой войны.

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

Искусственное создание узких мест

Ширятся слухи, что крупные операторы сети телекоммуникаций начнут вмешиваться в трафик VoIP, помечая и отдавая предпочтение трафику своих VoIP-сервисов, предоставляемых за дополнительную плату, и, самое худшее, выявляя и устраняя любой VoIP-трафик, сформированный сервисами, которые не были ими санкционированы. Кое-что из этого уже происходит: поставщики сервисов блокируют в своих сетях прохождение определенного трафика, объясняя это выполнением неких общественных функций (например, блокирование популярных сервисов общего доступа к файлам для защиты нас от пиратства). В США Федеральная комиссия по связи (ФКС) заняла четкую позицию по данному вопросу и оштрафовала компании, замеченные в таких действиях. В остальном мире правоохранительные органы не всегда так благосклонны к VoIP.

Очевидно лишь то, что сообщество и Сеть найдут способы обойти преграды, как они всегда это делали.

Нормативно-правовые войны

Недавно вышедший в отставку руководитель Федеральной комиссии по связи США Майкл Пауэлл (Michael Powell) сделал подарок, который, возможно, изменит путь развития революции VoIP. Вместо того чтобы делать попытки регулирования VoIP как телекоммуникационного сервиса, он поддержал идею о том, что VoIP представляет совершенно новый способ связи и требует собственного правового поля, в котором будет развиваться.

VoIP станет регламентируемым, но не везде как сервис телефонной связи. Вот некоторые из возможных норм: Наличие информации для экстренных служб

Одна из характеристик традиционной сети PSTN - она не меняет своего местоположения. Это очень полезно для экстренных служб, поскольку они могут определить местоположение вызывающего абонента, определив адрес телефонной сети, из которой поступил звонок. Распространение сотовых телефонов сильно усложнило ситуацию, поскольку сотовый телефон не имеет определенного адреса. Он может подключиться к любой сети и зарегистрироваться на любом сервере. Если телефон не предоставляет информации о своем физическом местоположении, вызов экстренной службы с него не обеспечит никаких данных о том, где находится звонящий. VoIP создает аналогичные проблемы.

Отслеживание звонков для правоохранительных органов

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

Эти меры уже применяются в США: взимание штрафов с сетевых провайдеров, которые пытаются фильтровать трафик на основании содержимого.

Что касается регулирования, здесь Asterisk выступает в роли и ангела, и беса одновременно: ангела - потому, что помогает бедным, а беса - потому, что обеспечивает богатейшие возможности хакерам и спаме- рам как никто другой. Регулирование телефонии с открытым исходным кодом частично может определяться уровнем саморегулируемости сообщества разработчиков. Такие концепции, как DUNDi, которые включают процессы, направленные против распространения спама, являются превосходным началом. С другой стороны, такие идеи, как подделка идентификатора вызывающего абонента, - готовая площадка для злоупотреблений.

Качество и класс предоставляемых услуг передачи данных

Реальность такова, что Интернет на базе TCP/IP обеспечивает негарантированное обслуживание. Из-за этого пока невозможно сказать, как стремительно растущий VoIP-трафик реального времени повлияет на общую производительность Сети. В настоящее время превышение имеющейся полосы пропускания магистральной сети таково, что обеспечивает приемлемое качество даже в условиях негарантированного обслуживания. Однако мы не раз убеждались, что какая бы большая полоса пропускания ни была предоставлена, мы всегда найдем ей применение. DSL-соединения 1 Мб, немыслимого пять лет назад, сегодня едва хватает.

Наверное, следствие закона Мура[139] будет применимо и к пропускной способности Сети. Вопрос качества услуг может стать неактуальным по причине способности Сети предоставлять необходимую производительность без какой-либо специальной обработки. Организации, требующие более высоких уровней надежности, могут предпочесть отдельно оплачивать более качественные услуги. Возможно, эру поминутной оплаты междугородных соединений сменит эпоха помиллисекунд- ной оплаты за связь с гарантированной низкой задержкой или за каждую долю процентов сокращения потери пакетов. Сервисы, предоставляемые за дополнительную плату, предлагают уровень надежности с пятью девятками[140], что традиционные телефонные компании всегда преподносят как аргумент в свою пользу против VoIP.

Сложность

Открытые системы требуют новых подходов к проектированию решения. Дешевизна оборудования и ПО еще не означает, что таким же дешевым будет и решение. Asterisk не является стандартным ПО, готовым к использованию; его надо спроектировать и собрать, а затем и обслуживать. Поскольку базовое ПО бесплатно и цены на оборудование будут формироваться на основании конъюнктуры рынка, справедливости ради следует отметить, что для высокоспециализированной системы стоимость настройки будет составлять значительную часть цены решения. Во многих случаях из-за высокой сложности и гибкости конфигурации эта составляющая больше, чем она была бы для традиционной офисной АТС.

Обычно основное правило такое: если это может быть сделано в диал- плане, проектирование системы займет примерно столько же времени, как и проектирование любой традиционной офисной АТС с аналогичными функциями. Для всего, что сверх этого, оценить время, необходимое для построения системы, можно только исходя из опыта. Здесь еще многому надо учиться.

Возможности

Телефония с открытым исходным кодом создает неограниченные возможности. Вот некоторые из наиболее привлекательных.

Частные телекоммуникационные сети, выполненные на заказ

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

Доступность

Каждый может сделать свой вклад в будущее связи. Теперь любой владелец старенького ПК стоимостью 200 долларов в состоянии создать систему связи с настолько развитой логикой, что она может конкурировать с самыми дорогими узкоспециализированными системами. Даже если оборудование не готово к производственной эксплуатации, нет такой причины, по которой ПО не было бы таковым. Это одна из причин, по которой закрытые системы ожидают трудные времена конкуренции. То огромное число людей, которые имеют доступ к необходимому оборудованию, не идет ни в какое сравнение с количеством членов закрытого клуба.

Решения, размещаемые на ресурсах поставщиков услуг, сложность которых сравнима со сложностью корпоративных веб-сайтов

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

Реальная интеграция технологий связи

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

Телефония с открытым исходным кодом ставит телефонную связь в один ряд с другими информационными технологиями. Наконец можно приступить к собственно реализации задачи по интеграции электронной почты, голоса, видео и всего, что только можно представить, по гибким транспортным сетям (как проводным, так и беспроводным) в ответ на нужды пользователя, а не по прихоти монополий. Добро пожаловать в будущее телекоммуникаций!

A

Каналы VoIP

Каналы VoIP в Asterisk представляют средство соединения с протоколами, которые они поддерживают. Для использования протокола необходим конфигурационный файл, где содержатся общие параметры, описывающие, как система обрабатывает протокол, а также специальные параметры для каждого канала (или устройства), которые будут упоминаться в диалплане. В данном приложении подробно рассматриваются конфигурационные файлы протоколов IAX и SIP.

IAX

Конфигурационный файл IAX (iax.conf) содержит всю конфигурационную информацию, необходимую Asterisk для создания и управления каналами, работающими по протоколу IAX. Разделы файла отделены заголовками, сформированными словом, заключенным в квадратные скобки ([]). Имя в скобках будет именем канала за одним исключением: раздел [general] не является каналом, это область, где определяются глобальные параметры протокола.

В данном разделе рассматриваются различные общие и специальные настройки канала, определяемые в файле iax.conf. Мы опишем каждый параметр, а затем приведем пример его использования. Некоторые опции могут иметь несколько действительных аргументов. Список этих аргументов, разделенных символом вертикальной черты (|), приводится рядом с опцией. Например, запись bandwidth=low|medium|high означает, что параметр bandwidth принимает в качестве аргумента одно из значений: low, medium или high.

Комментарии можно вставлять в любом месте файла iax.conf. Текст комментария начинается с точки с запятой (;). Все, что располагается справа от точки с запятой, будет проигнорировано обработчиком Asterisk. Комментарии могут использоваться достаточно активно.

Общие настройки IAX

Первой незакомментированной строкой в файле iax.conf должен быть заголовок [general]. Параметры в этом разделе будут применяться ко всем соединениям, использующим данный протокол, если не определено другое в описании конкретного канала. Поскольку некоторые из этих настроек могут определяться для канала индивидуально, меткой (глобальный) мы обозначили настройки, которые всегда глобальны, а меткой (канал) - те, которые могут задаваться для каждого канала в отдельности. Если параметр задается в разделе [general], его не надо определять для каждого канала; его значение становится значением по умолчанию. Помните, что определение параметра в разделе [general] не запрещает задавать ему другое значение для конкретного канала; это просто делает данное значение значением по умолчанию. Также нельзя забывать, что отсутствие задания этих параметров может в некоторых случаях приводить к использованию системных значений по умолчанию.

Вот параметры, которые могут быть сконфигурированы: accountcode (канал)

Код учетной записи может определяться для каждого пользователя. Если задан, этот код учетной записи будет присваиваться записи вызова, если не задан код учетной записи конкретного пользователя. Заданное имя accountcode будет использоваться как имя файла в формате CSV в папке /var/log/asterisk/cdr-csv/, где хранятся записи параметров вызовов (Call Detail Records, CDRs) для соединений типа user/peer/friend:

accountcode=iax-имяпользователя adsi (канал)

Поддержка ADSI (Analog Display Services Interface - интерфейс сервисов для аналогового дисплея) может быть активирована только при наличии совместимого с ADSI телекоммуникационного оборудования на стороне клиента (CPE-оборудования): adsi=yes|no allow и disallow (канал)

Могут быть разрешены или запрещены определенные кодеки, что позволяет разработчику системы задавать перечень используемых кодеков. allow и disallow также могут быть определены для канала отдельно. Помните, что выражения allow в разделе [general] будут распространяться на все каналы, для которых не переопределено disallow=all. Согласование кодеков ведется в порядке их задания.

Лучшей практикой считается определять disallow=all, а затем в выражениях allow явно задавать каждый кодек, который вы желаете использовать. Если ничего не задано, предполагается allow=all:

disallow=all allow=ulaw allow=gsm allow=ilbc

amaflags (канал)

Система автоматической регистрации сообщений (Automatic Message Accounting, AMA) описана в наборе документов компании Telcordia, зарегистрированных как FR-AMA-1. Эти документы определяют стандартные механизмы формирования и передачи CDR. Можно задать один из четырех флагов AMA, который будет применяться ко всем IAX-соединениям:

am flags=default|omit|billing|documentation authdebug (глобальный)

Можно свести до минимума объем записи параметров аутентификации, отключив его с помощью authdebug=no. Запись параметров аутентификации активирована по умолчанию, если не отключена явно:

authdebug=no autokill (глобальный)

Чтобы максимально сократить опасность зависания в условиях недоступности хоста, можно задать для параметра autokill значение yes, тогда любое новое соединение будет разорвано при отсутствии подтверждения ACK в течение 2000 мс. (Очевидно, что это не рекомендуется для хостов с большой задержкой.) Вместо yes можно указать время ожидания в миллисекундах перед тем, как будет принято решение о недоступности равноправного участника сети. Параметр autokill задает время ожидания для всех равноправных участников, работающих по протоколу IAX2, но с помощью команды qualify его можно сконфигурировать для каждого равноправного участника в отдельности: autokill=1500 bandwidth (канал)

bandwidth - это сокращенная запись, которая поможет избежать применения disallow=all и множества выражений allow для задания используемых кодеков. Допустимыми опциями являются:

high

Допускаются все медиа-кодеки (G.723.1, GSM, plaw, alaw, G.726, ADPCM, slinear, LPC10, G.729, Speex, iLBC).

medium

Допускаются все кодеки, кроме slinear, plaw и alaw.

low

Допускаются все медиа-кодеки, кроме G.726 и ADPCM. bandwidth=low|medium|high bindport и bindaddr (глобальные)

Эти необязательные параметры позволяют задавать IP-интерфейс и порт, которые будут принимать IAX-соединения. Если они опущены, будет задан порт 4569, и все IP-адреса системы Asterisk будут принимать входящие IAX-соединения. Если задано несколько адресов привязки, IAX-соединения будет принимать только заданный интерфейс[141]. Использование вместо адреса 0.0.0.0 указывает Asterisk слушать все интерфейсы: bindport=4569 bindaddr=192.168.0.1

codecpriority (канал)

Опция codecpriority определяет, какие параметры при входящем вызове будут иметь преимущество при согласовании кодеков. Если этот параметр задан в разделе [general], выбранные опции будут наследоваться всеми пользовательскими настройками в конфигурационном файле канала; однако их можно задавать в отдельных пользовательских параметрах для более тонкой настройки. Если значения заданы и в [general], и в пользовательских разделах, настройки пользователя переопределяют настройки раздела [general]. Если этот параметр не задан, значение по умолчанию - host. К допустимым опциям относятся: caller

Вызывающая сторона имеет приоритет над хостом.

host

Хост имеет приоритет над вызывающей стороной.

disabled

Предпочтения кодеков не учитываются; это поведение по умолчанию, если не определены предпочтения кодеков.

reqonly

Предпочтения кодеков игнорируются, и вызовы принимаются, только если запрашиваемый кодек доступен:

codecpriority=caller|host|disabled|reqonly

delayreject (глобальный)

Если по IAX-каналу поступает ошибочный пароль, это обеспечит задержку отправки сообщений отказа REGREQ или AUTHREP, что поможет защититься от атак с подбором паролей. Время задержки - 1000 мс: delayreject=yes|no forcejitterbuffer (канал)

Поскольку Asterisk пытается соединить каналы (конечные точки) напрямую, конечным точкам обычно позволено самостоятельно выполнять буферизацию входящих сообщений, которая будет компенсировать задержки. Однако, если конечные точки имеют слабую реализацию такой буферизации, можно заставить Asterisk выполнять ее всегда, независимо от условий. Чтобы принудительно активировать буферизацию входящих сообщений для компенсации задержки, необходимо задать forcejitterbuffer=yes: forcejitterbuffer=yes iaxthreads и iaxmaxthreads (глобальные)

Настройка iaxthreads определяет число вспомогательных потоков IAX, создаваемых при запуске для обработки соединений по протоколу IAX.

Настройка iaxmaxthreads определяет максимальное число дополнительных вспомогательных потоков IAX, которые могут быть созданы для обработки большого объема IAX-трафика:

iaxthreads=10 iaxmaxthreads=100

jitterbuffer (канал)

Неустойчивая синхронизация (Jitter) означает непостоянство задержки между поступлениями пакетов. Пакеты отправляются с конечного устройства с постоянной скоростью и практически постоянной задержкой между отправками. Однако при прохождении пакетов по Интернету задержка между ними может изменяться; из-за этого в место назначения пакеты поступают нерегулярно и, возможно, даже не в том порядке.

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

Буфер, компенсирующий задержки, обрабатывает только данные, поступающие с дальнего конца соединения. Данные, передаваемые вами, не будут затронуты, поскольку за компенсацию задержек в своих входящих соединениях отвечает дальний конец соединения.

Активация буфера, компенсирующего задержки, выполняется строкой jitterbuffer=yes:

jitterbuffer=yes|no

language (канал)

Задает флаг языка для всего, что вы определяете. Глобальный язык по умолчанию - английский. Заданный язык отправляется каналом как элемент информации. Он также используется такими приложениями, как SayNumber(), при выборе соответствующего файла для воспроизведения. Не забывайте, что все остальные языки, кроме английского, не устанавливаются в системе явно, поэтому ваша задача - сконфигурировать систему так, чтобы гарантировать правильную обработку задаваемых языков: language=en mailboxdetail (глобальный)

Если для mailboxdetail задано значение yes, пользователю вместо простого отчета о наличии новых и старых сообщений отправляется количество новых/старых сообщений. Параметр mailboxdetail также может быть задан для каждого равноправного участника сети отдельно:

mailboxdetail=yes maxjitterbuffer (канал)

Этот параметр используется для задания максимального размера буфера, компенсирующего задержки, в миллисекундах. Не задавайте maxjitterbuffer слишком большое значение, это приведет к ненужному увеличению вашего времени ожидания: maxjitterbuffer=500 maxjitterinterps (канал)

Максимальное количество пустых кадров вставки, которое должен возвратить подряд буфер, компенсирующий задержки. Поскольку некоторые клиенты не передают кадры CNG/DTX для обозначения паузы в разговоре, буфер, компенсирующий задержки, будет воспринимать такое количество пустых кадров как начало паузы. Это предотвращает появление искажений при длительной паузе: maxjitterinterps=70 maxregexpire и minregexpire (канал)

Задают в секундах максимальный и минимальный временные интервалы для истечения срока действия регистрации: maxregexpire=7S0 minregexpire=60

mohinterpret (канал)

Эта опция определяет, какой класс музыки во время ожидания должен воспроизводиться по этому каналу, если в диалплане для канала нет выражения Set(CHANNEL(musicclass)=fl»6ow), определяющего класс музыки, и одноранговый канал, удерживающий вызов, не предлагает класса музыки.

Если эта опция имеет значение passthrough, для оповещения вместо локального воспроизведения музыки во время ожидания всегда будет передаваться сообщение ожидания. Эта опция может быть задана глобально или для каждого пользователя либо равноправного участника сети в отдельности: mohinterpret=default mohsuggest (канал)

Эта опция определяет, какой класс музыки во время ожидания (как определено в файле musiconhold.conf) должен предлагаться одноранговому каналу, когда этот канал переводит равноправного участника сети в режим ожидания. Он может быть задан глобально или для каждого пользователя либо равноправного участника сети в отдельности: mohsuggest=default nochecksums (глобальный)

Если этот параметр задан, Asterisk деактивирует вычисление контрольных сумм UDP пакетов и не будет проверять контрольные суммы UDP от систем, поддерживающих эту функцию: nochecksums=yes regcontext (канал)

Задавая контекст, содержащий некоторые команды, можно сконфигурировать Asterisk на выполнение ряда действий при регистрации равноправного участника сети на вашем сервере. Эта опция используется в сочетании с regexten, определяющей, какой добавочный номер должен быть выполнен. Если параметр regexten не задан, в качестве добавочного номера используется имя равноправного участника. Asterisk будет динамически создавать и уничтожать для добавочного номера NoOp в приоритете 1. Все действия, которые будут выполняться при регистрации, должны начинаться с приоритета 2. Может быть задано несколько regexten, разделенных символом &. regcontext задается для каждого равноправного участника или глобально: regcontext=зарегистрированные-телефоны regexten (канал)

Опция regexten используется в сочетании с regcontext для определения добавочного номера, выполняемого в заданном контексте. Если опция regexten не задана явно, в качестве добавочного номера для сопоставления используется имя равноправного участника сети:

regexten=мойтелефон resyncthreshold (канал)

Порог ресинхронизации используется для восстановления синхронизации буфера, компенсирующего задержки, если после получения нескольких кадров выявлено существенное отклонение, при условии что отклонение было обусловлено путаницей с временными метками. Порог ресинхронизации определяется как замеренная флуктуация¹ плюс значение resyncthreshold в миллисекундах: resyncthreshold=1000 rtautoclear (глобальный)

Этот параметр определяет, должна ли Asterisk автоматически завершать действие регистрации соединений типа friend, созданных «на лету», по тому же графику, как если бы они были зарегистрированы обычным способом. Если задано значение yes, по истечении срока действия регистрации friend исчезнет из конфигурации до следующей регистрации. Если задано целое значение, регистрация будет действительна в течение этого количества секунд, а не обычного срока действия регистрации: rtautoclear=yes|no|количествосекунд rtcachefriends (глобальный)

Если rtcachefriends включен, Asterisk будет кэшировать соединения типа friend, регистрирующиеся в режиме реального времени, точно так же, как если бы они поступали из iax.conf. Это часто помогает в таких вопросах, как оповещение о непросмотренных сообщениях для равноправных участников сети, зарегистрировавшихся в режиме реального времени: rtcachefriends=yes|no rtignoreregexpire (глобальный)

Если для параметра rtignoreregexpire задано значение yes и срок регистрации равноправного участника сети, зарегистрировавшегося в режиме реального времени, истек (на основании срока действия регистрации), Asterisk продолжит использовать IP-адрес и порт, хранящиеся в базе данных: rtignoreregexpire=yes|no rtupdate (глобальный)

Если задано значение yes, Asterisk обновит при регистрации IP-ад- рес, порт вызова и срок действия регистрации равноправного участника сети. Значение по умолчанию - yes: rtupdate=yes|no tos (глобальный)

Asterisk может задавать в IP-заголовке биты типа обслуживания (Type of Service, TOS), чтобы способствовать повышению производительности в маршрутизаторах, которые учитывают TOS-биты при определении маршрутов. Допустимыми являются такие значения: CS0, CS1, CS2, CS3, CS4, CS5, CS6, CS7, AF11, AF12, AF13, AF21, AF22, AF23, AF31,

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

AF32, AF33, AF41, AF42, AF43 и ef (expedited forwarding - срочная пересылка). Также для TOS-битов может использоваться числовое значение.

Больше информации можно найти в файле doc/ip-tos.txt в папке исходного кода Asterisk. trunk (канал)

Функция объединения каналов IAX2 позволяет Asterisk отправлять голосовые данные (в виде мини-кадров) из нескольких каналов под одним заголовком. Сокращение дополнительных издержек делает протокол IAX2 более эффективным при отправке нескольких потоков в одну конечную точку (обычно на другой сервер Asterisk): trunk=yes|no trunkfreq (канал)

trunkfreq используется для управления частотой отправки сообщений по магистральному каналу. Задается в миллисекундах. Сообщения отправляются вместе с командой trunk=yes: trunkfreq=20 trunktimestamps (канал)

Определяет, должна ли Asterisk посылать временные метки для каждого отдельного подкадра, входящего в состав магистрального кадра (trunk frame). При передаче этих временных меток немного увеличивается требуемая полоса пропускания (менее чем на 1 Кбит/с

Извлечение информации диалплана с удаленного сервера Asterisk

Asterisk может извлекать информацию диалплана с другого сервера Asterisk, используя выражение switch =>. Когда это происходит, драйвер IAX-канала Asterisk должен дождаться ответа от удаленного сервера, прежде чем сможет продолжать выполнение всех остальных связанных с IAX процессов. Это доставляет особенно много неприятностей, когда имеется множество вложенных выражений switch: если выражение switch указывает на несколько серверов, результат может возвратиться с ощутимой задержкой.

Если для глобальной опции iaxcompat задано значение yes, при осуществлении поиска switch Asterisk будет порождать отдельный поток. Использование этого потока позволяет драйверу IAX-канала продолжать выполнение других процессов, пока поток ожидает ответа. Эта опция обусловливает небольшие потери производительности: iaxcompat=yes|no

на вызов), но они гарантируют надежную передачу временных меток кадров из конца в конец. Если оба конца всех ваших магистральных каналов направляются прямо в TDM и значение trunkfreq равно длине кадра используемого кодека, вероятно, можно опустить этот параметр. Получатель также должен поддерживать эту функцию, хотя необязательно, чтобы она была у него активирована: trunktimestamps=yes|no

Регистрация на других серверах с помощью выражений register

Выражение регистрации register => используется для регистрации вашего сервера Asterisk на удаленном сервере. Это позволяет удаленному концу соединения знать ваше местонахождение на случай, если вы сконфигурированы с динамическим IP-адресом. Заметьте, что выражения register используются, только если вы сконфигурированы на удаленном конце как равноправный участник сети и когда host=dynamic. Основной формат выражения register:

register => имяпользователя: пароль@удаленный-хост пароль является необязательным параметром (если не сконфигурирован в удаленной системе).

В качестве альтернативы можно задать RSA-ключ, заключив его имя[142]в квадратные скобки ([]):

register => имяпользователя:[имя-rsa-ключа]@удаленный-хост По умолчанию запросы register будут посылаться через порт 4569. Их можно направить на другой порт, явно задав его:

register => имяпользователя:пароль@удаленный-хост:1234

Описания IAX-каналов

Теперь, когда определены общие настройки, можно приступать к описанию каналов. Если предполагается принимать анонимные IAX-вы- зовы, рекомендуется создать гостевой канал. Это очень распространенный способ связи в сообществе Asterisk. Прежде чем решить, что это не для вас, подумайте о том, что, если вы хотите предоставить кому-либо возможность связи с вами через IAX (без конфигурации специальной учетной записи), он должен соединяться как гость. Эта учетная запись, в сущности, становится вашим «телефонным номером по протоколу IAX». Описание гостевого канала должно выглядеть примерно так: [guest] type=user context=incoming callerid="Incoming IAX Guest"

Несомненно, спамеры найдут способ доступа к этим адресам, но в ближайшем обозримом будущем это не представляет проблемы. В долгосрочной перспективе, вероятно, будет использоваться DUNDi (больше информации об этом вы найдете в главе 14).

Если требуется принимать вызовы из сети Free World Dialup, в Asterisk есть предопределенный защитный ключ, который гарантирует невозможность для анонимных соединений сымитировать звонок Free World Dialup. Для этого потребуется настроить канал iaxfwd:

[iaxfwd] type=user context=incoming auth=rsa

inkeys=freeworlddialup Если имеются ресурсы, опубликованные в сети DUNDi, в файле iax. conf должен быть описан соответствующий пользователь:

[dundi] type=user

dbsecret=dundi/secret context=dundi-incoming

Если имеются устройства, работающие по протоколу IAX (такие, как IAXy), или IAX-пользователи на удаленном сервере, возможно, вы захотите обеспечить их собственным описанием пользователя, посредством которого они будут соединяться с системой.

Допустим, на удаленном сервере имеется пользователь, для которого решено определить IAX-канал типа user. Назовем этого гипотетического пользователя sushi. Описание этого канала может быть примерно таким:

[sushi] type=user

context=local_users

auth=md5,plaintext,rsa

secret=wasabi

transfer=no

jitterbuffer=yes

callerid="Happy Tempura" <(800) 555-1234>

accountcode=seaweed

deny=0.0.0.0/0.0.0.0

permit=192.168.1.100/255.255.255.0

language=en

Входящие звонки от этого пользователя будут поступать в контекст local_users и передавать системе Caller ID (ID звонящего) Happy Tempura <(800) 555-1234>. Система ожидает от этого пользователя аутентификации с использованием простого текстового пароля или алгоритмов MD5 и RSA, поскольку предоставлен пароль wasabi и звонок поступил с IP- адреса 192.168.1.100. Всем звонкам, поступившим по этому каналу,

Аутентификация по протоколу IAX

IAX предоставляет механизмы аутентификации для обеспечения достаточного уровня безопасности между конечными точками. Это не означает, что аудиоинформацию нельзя захватить и декодировать, но свидетельствует о том, что можно более тщательно управлять правами доступа к вашей системе. В IAX-ка- налах поддерживается три уровня безопасности. Опция auth определяет, какой метод аутентификации используется в канале: plaintext, md5 или rsa.

Параметр plaintext в IAX обеспечивает очень низкий уровень защиты. Хотя он разрешает соединение с каналом только при условии введения правильного пароля, но тот факт, что пароль хранится в файле iax.conf как простой текст и передается и принимается в таком же незашифрованном виде, делает этот метод аутентификации очень ненадежным.

md5 обеспечивает большую безопасность сетевого соединения, однако по-прежнему в файле iax.conf на обоих концах соединения должен быть задан текстовый secret. Вот как происходит аутентификация в данном случае: сервер А запрашивает соединение с сервером В, который, в свою очередь, отвечает запросом на авторизацию, включающим сгенерированный случайным образом номер. Сервер А генерирует хеш MD5, используя значение, заданное в поле secret файла iax.conf, и случайный номер, полученный от сервера В. Этот хеш возвращается в ответе на запрос на авторизацию, и сервер В сравнивает его с локально сгенерированным хешем. Если хеши совпадают, предоставляется разрешение на доступ.

Метод rsa обеспечивает самый высокий уровень безопасности. Чтобы использовать RSA-аутентификацию, каждый конец соединения с помощью сценария astgenkey, обычно находящегося в папке /usr/src/asterisk/contrib/scripts/, должен создать пару ключей - открытый и закрытый. После этого открытый ключ передается на дальний конец. Каждый конец соединения в свое описание канала должен включить открытый ключ противоположного конца, используя для этого параметры inkeys и outkey. RSA-ключи хранятся в папке /var/lib/asterisk/keys/. Открытым ключам присваиваются имена имя.риЬ; закрытым ключам - имя. key. Закрытые ключи должны быть зашифрованы по алгоритму 3DES[143].

будет присваиваться код учетной записи seaweed. Поскольку для параметра transfer (переадресация) задано значение no, медиа-поток этого канала всегда будет проходить через Asterisk; он не может быть перенаправлен на другой IAX-узел.

Если вы сами являетесь удаленным узлом и вам необходимо устанавливать соединения с другим узлом, главный узел был бы определен для вас как равноправный участник (peer):

[sashimi_platter]

type=peer

username=sushi

secret=wasabi

host=192.168.1.101

qualify=yes

trunk=yes

peer вызывается из диалплана с помощью приложения Dial(), в которое передается имя, указанное в квадратных скобках. Если равноправный участник требует от вас аутентификации с использованием имени пользователя, имя пользователя и секрет можно задать в полях username и secret.

Помните, аутентификация входящего звонка от пользовате-0% ля, заданного в iax.conf, должна выполняться с использовани- Л * ем имени, заданного в квадратных скобках. Однако если ™ Asterisk сама вызывает внешнего равноправного участника сети, имя пользователя, используемое при аутентификации, можно задать с помощью настройки username.

Для описания host используется или запись IP-адреса с точками-разделителями, или полное доменное имя (fully qualified domain name, FQDN). Задавая параметр qualify=yes, можно определить задержку соединения между вами и удаленным хостом и проверку, активен ли он. Чтобы свести до минимума количество издержек при поступлении множества звонков к одному равноправному участнику сети, их можно объединить (trunk).

Объединение каналов является уникальной возможностью IAX. Благодаря ей между двумя большими сайтами можно устанавливать множество одновременных VoIP-соединений. Объединение каналов, предоставляемое IAX, обеспечивает сокращение количества переносимой служебной информации за счет загрузки в каждый сигнальный пакет аудиоданных нескольких параллельных вызвов[144]. Чтобы активировать

Рис. A.1. Объединение каналов деактивировано

Рис. A.2. Объединение активировано

объединение для канала, необходимо задать для него параметр trunk=yes в файле iax.conf.

На рис. А.1 показан канал с отключенной возможностью объединения, а на рис. А.2 - канал, для которого эта возможность активирована.

Параметры канала

Теперь рассмотрим параметры канала:

callerid

С помощью параметра callerid можно задать рекомендуемый строковый Caller ID (ID звонящего) для каналов типа user или peer. Если для user задано значение в поле Caller ID, всем звонкам, поступающим по этому каналу, будет присвоен этот Caller ID, независимо от того, что посылает вам дальний конец соединения. Если Caller ID задан для peer, вы посылаете запрос дальнему концу на использование его как вашего идентификатора (хотя не располагаете средствами, чтобы проконтролировать это). Если вы хотите, чтобы вызывающие абоненты могли использовать собственные Caller ID (то есть для гостей), убедитесь, что значение в поле callerid не задано: callerid=John Smith <(800) 555-1234> defaultip

Настройка defaultip дополняет host=dynamic. Если хост еще не зарегистрирован на вашем сервере, вы будете пытаться отправлять сообщения по указанному здесь IP-адресу по умолчанию:

defaultip=192.168.1.101

inkeys

Опция inkeys может использоваться для аутентификации пользователя с помощью RSA-ключа. Чтобы связать с описанием канала типа user более одного RSA-ключа, имена ключей записываются через

двоеточие (:). Для подтверждения допустимости соединения может использоваться любой из заданных ключей. Inkey - это открытый ключ, который вы раздаете своим пользователям:

inkeys=сервер_один:сервер_два

mailbox

Если в описании канала вы связываете с peer почтовый ящик, сервис голосовой почты будет посылать сигналы индикации ожидающего сообщения (Message Waiting Indication, MWI) узлам на конце этого канала. Если номер почтового ящика обрабатывается в другом контексте голосовой почты, не default, его можно описать как почто- выйящик@контекст. Чтобы связать несколько почтовых ящиков с одним peer, используется несколько выражений mailbox: mailbox=1000@internal

outkey

Опция outkey может использоваться для аутентификации канала peer с помощью RSA-ключа. Для исходящей аутентификации может использоваться только один RSA-ключ. Outkey не распространяется; это ваш закрытый ключ:

outkey=закрытый_ключ

qualify

Для параметра qualify может быть задано значение yes, no или время в миллисекундах. Если задается qualify=yes, удаленным равноправным участникам периодически будут посылаться сообщения PING для определения, доступны ли они, и установления величины задержки между ответами. Равноправные участники будут отвечать сообщениями PONG. Равноправный участник будет признан недоступным в случае непоступления ответа в течение 2000 мс (изменить это значение по умолчанию можно, задав для параметра qualify время ожидания ответа в миллисекундах).

qualifyfreqok и qualifyfreqnotok

Эти две настройки используются для определения частоты, с какой Asterisk будет отправлять сообщения PING равноправному участнику сети, если задан параметр qualify. Параметры qualifyfreqok и qualifyfreqnotok определяют частоту проверки возможности установления соединения с удаленным участником, когда он находится в состоянии OK и не в состоянии OK соответственно.

qualifysmoothing

Для параметра qualifysmoothing может быть задано значение yes или no. Если он активирован, Asterisk будет брать среднее из двух последних значений времени подтверждения возможности соединения. Это помогает не допустить появления равноправных участников, отмеченных как LAGGED (с запаздыванием), особенно в сети с потерями.

sendani

В сети PSTN с SS7 для идентификации вызывающего абонента используется автоматическое определение номера (Automatic Number Identification, ANI). Пользователю предоставляется Caller ID (ID звонящего). Caller ID формируется из ANI, поэтому их легко спутать. Блокировка Caller ID приводит к установлению флага конфиденциальности для ANI, но базовой сети все равно известен источник вызова: sendani=yes

ANI используется уже некоторое время. Его первоначальным назначением было доставка на входящую станцию номера абонента, выполняющего междугородный звонок, для которого выставляется счет. В отличие от Caller ID, ANI не требует SS7, поскольку может передаваться с помощью DTMF. Также ANI не может быть заблокирован.

transfer

Параметру transfer может быть присвоено значение yes, no или mediaonly. Если задано yes, Asterisk, если может, будет выполнять переадресацию вызова с целью сократить путь пакета между двумя конечными точками. (Очевидно, что это не будет возможным, если Asterisk придется выполнять перекодировку или преобразование между протоколами или если состояние сети не обеспечивает возможности соединения двух конечных точек напрямую.) Если задано значение no, Asterisk не будет пытаться переадресовать вызов.

Если задано значение mediaonly, Asterisk будет пытаться переадресовывать медиа-поток так, чтобы он проходил непосредственно между двумя конечными точками, но обмен служебными сигналами (сообщения установления и разрыва соединения) по-прежнему будет проходить через Asterisk. Это полезно, потому что гарантирует правильность записей параметров вызовов даже несмотря на то, что переносимые данные больше не проходят через сервер Asterisk.

SIP

Как и для IAX, конфигурационный файл SIP (sip.conf) содержит информацию о конфигурации для каналов, работающих по протоколу SIP. Заголовки описаний каналов формируются словом, заключенным в квадратные скобки ([ ] ), опять же, за исключением раздела [general], в котором задаются глобальные параметры SIP. Не скупитесь на комментарии в файле sip.conf. Текст комментария начинается с точки с запятой; все, что располагается справа от нее, будет проигнорировано.

Общие параметры SIP

В разделе [general] файла sip.conf должны использоваться следующие опции:

allowexternalinvites

Если задано значение no, эта настройка деактивирует отправку сообщений INVITE и REFER нелокальным доменам. Смотрите настройку

domain.

allowexternalinvites=yes|no allowguest

Если задано значение no, этот параметр запрещает гостевые SIP-со- единения. По умолчанию они разрешены. SIP обычно требует аутентификацию, но можно принимать вызовы от пользователей, которые не поддерживают аутентификацию (то есть для которых не задано значение в поле secret). Некоторые SIP-устройства (такие, как Cisco Call Manager v4.1) не поддерживают аутентификацию, поэтому они не смогут устанавливать соединения, если задано allowguest=no: allowguest=no|yes allowoverlap

Если задано значение no, деактивирован набор в режиме наложения:

allowoverlap=no|yes allowsubscribe

Разрешает или запрещает внешним устройствам подписываться на получение информации о состоянии добавочного номера (заданное в приоритете hint). Значение по умолчанию - yes:

allowsubscribe=yes|no

allowtransfers

Значение no деактивирует переадресацию для всех SIP-вызовов, кроме тех, для которых она активирована специально:

allowtransfers=no|yes

alwaysauthreject

Если эта опция активирована, любое отклонение INVITE или REGISTER Asterisk будет сопровождать сообщением 401 Unauthorized, а не предоставлять вызывающему абоненту информацию о наличии соответствующего user или peer для этого запроса:

alwaysauthreject=no|yes

autodomain

Задайте для этой опции значение yes, тогда Asterisk будет добавлять имя локального хоста и локальные IP-адреса в список доменов:

autodomain=yes|no

bindaddr и bindport

Эти необязательные параметры позволяют задавать IP-интерфейс и порт, на которые вы желаете принимать SIP-соединения. Если данные параметры опущены, будет задан порт 5060 и все IP-адреса вашей системы Asterisk будут принимать входящие SIP-соединения. Если задано несколько адресов привязки, соединения будут слушать только эти интерфейсы. Значение 0.0.0.0 указывает Asterisk слушать все интерфейсы: bindaddr=0.0.0.0 bindport=5060 buggymwi

Эта настройка позволяет Asterisk отправлять уведомления об ожидающих сообщениях на определенные SIP-телефоны Cisco, прошивка которых не обеспечивает полной поддержки индикации ожидающих сообщений, описанной в документации RFC для Интернета. Активируйте эту опцию, чтобы не получать сообщения об ошибках при отправке MWI-сообщений на телефоны с таким недостатком: buggymwi=no|yes callevents

Задайте значение yes, если вы хотите, чтобы SIP формировал события интерфейса Manager. Это важно при наличии внешних программ, использующих интерфейс Asterisk Manager, таких как Flash Operator Panel:

callevents=yes

checkmwi

Эта опция определяет интервал времени по умолчанию, в секундах, между проверками почтовых ящиков для равноправных участников:

checkmwi=30

compactheaders

Для параметра compactheaders можно задать значение yes или no. Если задано yes, для SIP-заголовков будет использоваться компактный формат. Это может потребоваться, когда размер SIP-заголовка больше максимального размера передаваемого блока данных (Maximum Transmission Unit, MTU) ваших IP-заголовков, что приводит к фрагментации IP-пакета. Не используйте эту опцию, если не знаете, что делаете:

compactheaders=yes|no defaultexpiry

Задает срок действия SIP-регистрации по умолчанию, в секундах, для входящих и исходящих регистраций. Клиент обычно задает это значение при первой регистрации, поэтому значение по умолчанию будет использоваться, только если клиент не задал собственное значение. Если вы регистрируетесь на другом сервере агента пользователя (User Agent Server, UAS), этот срок регистрации будет передан на дальний конец:

defaultexpiry=300

directrtpsetup

Эта настройка конфигурирует прямое установление соединения в реальном масштабе времени между двумя конечными точками без необходимости повторного обмена сообщениями INVITE.

directrtpsetup=yes|no

На момент написания данной книги параметр directrtpsetup все еще считается экспериментальным, и поэтому вы не должны активировать его, если полностью не осознаете последствий этого действия. Эта опция не будет работать для видеосессий и в случаях, когда вызываемая сторона посылает полезную нагрузку RTP и FMTP-заголовки в ответе 200 OK, что не соответствует запросу INVITE вызывающего абонента.

domain

Определяет домен по умолчанию для данного сервера Asterisk. Если определен этот параметр, Asterisk допускает отправку сообщений INVITE и REFER только нелокальным доменам. Получить список локальных доменов можно с помощью CLI-команды sip show domains:

domain=example.com

dumphistory

Для параметра dumphistory можно задать значение yes или no, чтобы активировать или деактивировать вывод отчета по истории SIP в конце диалогового окна SIP. SIP-история записывается в канал протоколирования DEBUG:

dumphistory=yes|no

externhost

Параметр externhost принимает в качестве аргумента полное имя домена. Если Asterisk выполняется за NAT, SIP-заголовок, как правило, будет использовать внутренний IP-адрес, присвоенный серверу. Если вы зададите эту опцию, Asterisk будет периодически выполнять DNS-поиск по имени хоста и замещать внутренний IP-адрес на тот, который был возвращен в результате DNS-поиска: ex.ternhost=my.hostname.tld

В системах, находящихся в производственной эксплуатации, не рекомендуется использовать externhost, потому что в случае изменения IP-адреса сервера в SIP-заголовках будет указываться неверный IP-адрес вплоть до следующего поиска. Вместо этого рекомендуется использовать параметр externip.

externip

Параметр externip в качестве аргумента принимает IP-адрес. Если Asterisk выполняется за NAT, SIP-заголовок будет использовать внутренний IP-адрес, заданный для сервера. Удаленный сервер не будет знать, как вернуться к этому адресу; поэтому он должен быть заменен действительным маршрутизируемым адресом: externip=216.239.39.104 externrefresh

Если используется externhost, externrefresh определяет, сколько времени, в секундах, должно пройти между DNS-поисками:

externrefresh=30

g726nonstandard

Этот параметр может быть задан при общении с равноправными участниками, которые ошибочно используют неверную кодировку для кодека G.726. Эта настройка указывает Asterisk использовать порядок упаковки по протоколу AAL2, а не RFC3551, если равноправный участник согласовывает использование кодека G726-32. Обычно это противоречит спецификации RFC3551, поскольку равноправный участник должен согласовывать использование AAL2- G726-32. Эта опция может понадобиться в случае применения устройства Sipura или Grandstream: g726nonstandard=yes ignoreregexpire (глобальный)

Если параметр ignoreregexpire имеет значение yes, Asterisk может выполнить одно из двух действий для:

Равноправных участников, создаваемых не в режиме реального времени

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

Равноправных участников, создаваемых в режиме реального времени

Когда равноправный участник извлекается из хранилища реального времени, его регистрационная информация будет использоваться независимо от истечения ее срока действия; если срок ее действия истек, в то время как равноправный участник, созданный в режиме реального времени, все еще находится в памяти (из-за кэширования или по другим причинам), информация не будет удалена из хранилища реального времени: ignoreregexpire=yes|no

jbenable

Активирует использование RTP-буфера, компенсирующего задержки, на принимающей стороне SIP-канала. Значение по умолчанию - no. Активированный буфер, компенсирующий задержки, будет использоваться, только если отправляющая сторона может создавать неустойчивую синхронизацию, а принимающая сторона ее не допускает. SIP-канал допускает неустойчивую синхронизацию; таким образом, компенсирующий задержки буфер на принимающей стороне будет использоваться, только если он активирован и задано его принудительное использование: jbenable=yes|no jbforce

Обусловливает принудительное использование RTP-буфера, компенсирующего задержки, на принимающей стороне SIP-канала. Значение по умолчанию - no:

jbforce=yes|no

jbimpl

Эта настройка используется для задания типа используемого буфера, компенсирующего задержки: fixed (фиксированный) или adaptive (адаптивный). Если используется буфер fixed, его размер всегда будет равен тому, который определен параметром jbmaxsize. Если задан буфер adaptive, его размер будет меняться вплоть до максимального, определенного параметром j bmax size. Значение по умолчанию - fixed.

jbimpl=fixed|adaptive

jblog

Определяет, активирована или нет запись в журнал кадров буфера, компенсирующего задержки. Значение по умолчанию - no:

jblog=yes|no

jbmaxsize

Задает максимальный размер буфера, компенсирующего задержки, в миллисекундах:

jbmaxsize=200

jbresyncthreshold

Переходит на временные метки кадров, из-за которых произошла рассинхронизация буфера, компенсирующего задержки. Полезно для улучшения качества голоса, переданного со скачкообразными/ прерывистыми временными метками, которые обычно поступают с экзотических устройств и программ. Значение по умолчанию - 1000:

jbresyncthreshold=1000

limitonpeers

Эта настройка указывает Asterisk применять ограничения по количеству вызовов только к равноправным участникам. Это улучшит уведомление о допустимом количестве вызовов и статусе для устройств типа type=friend, потому что будет контролироваться предельное число вызовов peer и не будут создаваться отдельные счетчики для частей user и peer канала friend: limitonpeers=yes|no localnet

Параметр localnet используется для указания Asterisk, какие IP- адреса считать локальными, чтобы адрес в SIP-заголовке мог транслироваться в заданный в externip или чтобы можно было выполнять поиск IP-адреса по externhost. IP-адреса должны задаваться в нотации CIDR (Classless InterDomain Routing - бесклассовая междоменная маршрутизация): localnet=192.168.1.0/24 localnet= 172.16.0.0/16

matchexterniplocally

Определяет, что Asterisk должна подставлять настройку externip или externhost, только если она совпадает с вашей настройкой localnet. Активировать эту опцию потребуется только для сетей с очень необычными настройками: matchexterniplocally=yes|no maxexpiry

Задает максимальный срок, в секундах, действия регистрации равноправного участника:

maxexpiry=3600

minexpiry

Задает минимально допустимую продолжительность, в секундах, регистрации или подписки:

minexpiry=60

notifymimetype

Принимает в качестве аргумента строку, определяющую тип MIME (Multipurpose Internet Mail Extensions - многоцелевые почтовые расширения в Интернете), используемый для индикации ожидающего сообщения в SIP-сообщении NOTIFY. Чаще всего для этого поля применяется настройка text/plain, хотя в случае необходимости может использоваться и другое значение: notifymimetype=text/plain notifyringing

Определяет, должна ли Asterisk уведомлять подписчиков о состоянии RINGING:

notifyringing=yes|no

notifyhold

Определяет, должна ли Asterisk уведомлять подписчиков о состоянии HOLD:

notifyhold=yes|no

pedantic

Для параметра pedantic может быть задано значение yes или no. Значение yes активирует медленную, педантичную проверку для телефонов, которым она необходима, таких как Pingtel, и более строгое соответствие SIP RFC. С целью повышения производительности строгий контроль соответствия SIP RFC обычно не проводится: pedantic=yes

realm

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

realm=myserver.example.com

recordhistory

Можно задать для recordhistory значение yes или no, чтобы активировать или отключить запись SIP-истории для всех каналов:

recordhistory=yes|no

registerattempts

Определяет для Asterisk количество попыток исходящих регистра- ций. Значение по умолчанию - 0, что означает бесконечное число попыток.

registerattempts=0

registertimeout

Определяет, как часто Asterisk должна выполнять попытку повторно зарегистрироваться на других устройствах:

registertimeout=30

relaxdtmf

Для параметра relaxdtmf можно задать значение yes или no. Значение yes обусловит ослабление выявления DTMF-сигналов. Оно должно использоваться, если Asterisk испытывает трудности по определению наличия DTMF в SIP-канале. Обратите внимание, что это может приводить к «ложным срабатываниям», когда Asterisk ошибочно определяет наличие DTMF-сигнала при его отсутствии: relaxdtmf=yes|no rtautoclear (глобальный)

Определяет, должна ли Asterisk автоматически завершать действие регистрации соединений типа friend, созданных «на лету», по тому же графику, как если бы они зарегистрировались в обычном режиме. Если задано значение yes, по истечении срока действия регистрации friend исчезнет из конфигурации до следующей регистрации. Если задано целое значение, регистрация будет действительна в течение этого количества секунд, а не в течение обычного срока действия регистрации:

rtautoclear=yes|no|количествосекунд rtcachefriends (глобальный)

Если rtcachefriends включен, Asterisk будет кэшировать соединения типа friend, регистрирующиеся в режиме реального времени, точно так же, как если бы они поступали из iax.conf. Это часто помогает в таких вопросах, как оповещение о непросмотренных сообщениях для равноправных участников сети, зарегистрировавшихся в режиме реального времени: rtcachefriends=yes|no rtsavesysname (глобальный)

Определяет, должна ли Asterisk сохранять имя системы в базе данных реального времени в момент регистрации: rtsavesysname=yes|no rtupdate (глобальный)

Если задано значение yes, Asterisk будет обновлять IP-адрес, порт вызова и срок регистрации при регистрации равноправного участника сети. Значение по умолчанию - yes: rtupdate=yes|no

sipdebug

Определяет, должна ли включаться отладка SIP с того момента, когда Asterisk загружает драйвер SIP-канала:

sipdebug=yes|no

sendrpid

Определяет, должна ли Asterisk посылать заголовок Remote-Party-ID (идентификатор удаленной стороны):

sendrpid=yes|no

srvlookup

SRV-записи DNS - это средство задания логических разрешимых адресов, по которым с вами можно связаться. Позволяет перенаправлять вызовы в разные точки без необходимости изменения логического адреса. Использование SRV-записей открывает доступ ко многим преимуществам DNS, тогда как их отключение лишает вас возможности размещать SIP-вызовы на основании доменных имен.

В настоящее время поддержка SRV-записей в Asterisk не- i сколько неэффективна. Если возвращено несколько SRV-за- ¹ писей, Asterisk будет использовать только первую из них.

Настоятельно рекомендуется использование DNS-поиска SRV-за- писей. Чтобы активировать его, задайте srvlookup=yes в разделе [general] файла sip.conf:

srvlookup=yes

t1min

Это минимальное время на передачу и подтверждение приема для сообщений, отправленных к контролируемым хостам, в миллисекундах. Значение по умолчанию - 100 мс.

t1min=100

subscribecontext

Ограничивает количество запросов SUBSCRIBE (подписаться) к заданному контексту. Полезно, например, если необходимо ограничить количество подписок на внутренние добавочные номера. Эта опция также может быть задана для каждого пользователя или равноправного участника сети отдельно: subscribecontext=internal t38pt_udptl

Если для t38pt_udptl задано значение yes, активирована возможность транзитной пересылки факсов по протоколу T.38 (UDPTL) в вызовах от SIP к SIP при условии, что обе стороны поддерживают T.38. Чтобы передача факсов была возможна, эта настройка должна быть активирована в разделе [general] для всех устройств. Затем ее можно деактивировать для каких-то отдельных устройств: t38pt_udptl=yes|no

Транзитная пересылка факсов по протоколу T.38 возможна только при вызовах от SIP к SIP, при этом не используются локальные каналы или каналы агента. Asterisk в настоящее время не может начинать или завершать передачу факсов по протоколу T.38; она может только выполнять транзитную пересылку UDPTL с одного устройства на другое.

tos_sip,tos_audio и tos_video

Asterisk может задавать биты TOS в IP-заголовке, чтобы улучшить производительность маршрутизаторов, которые учитывают биты TOS при определении маршрутов. Настройки tos_sip, tos_audio и tos_video управляют TOS-битами для SIP-сообщений, аудио- и видеоданными RTP соответственно. Допустимые значения: CS0, CS1, CS2, CS3, CS4, CS5, CS6, CS7, AF11, AF12, AF13, AF21, AF22, AF23, AF31, AF32, AF33, AF41, AF42, AF43 и ef (срочная пересылка). Также в качестве TOS- битов можно использовать числовое значение.

Больше информации можно найти в файле doc/ip-tos.txt в папке исходного кода Asterisk.

trustrpid

Определяет, должна ли Asterisk доверять значению в заголовке

Remote-Party-ID:

trustrpid=yes|no useragent

Параметр useragent принимает в качестве аргумента строку, определяющую значение поля useragent в SIP-заголовке. Значение по умолчанию - asterisk:

useragent=Asterisk PBX v1.4

usereqphone

Опция usereqphone указывает Asterisk добавлять ;user=phone в SIP URI, содержащие действительный номер телефона: usereqphone videosupport (оба)

Параметру videosupport можно задать значение yes или no. Если активирована общая поддержка видео, ее можно отключить для отдельного равноправного участника сети, но ее нельзя активировать для одного равноправного участника сети, если она не активирована в разделе [general]: videosupport=yes|no vmexten

Эта опция задает добавочный номер диалплана для доступа к ящику голосовой почты, который будет передан в разделе Message-Account сообщения MWI NOTIFY. Задавайте эту опцию, если ваше SIP-устройс- тво поддерживает настройку Message-Account. Значение по умолчанию - asterisk: vmexten=8500

Настройки SIP-канала

После рассмотрения глобальных параметров SIP обсудим параметры канала. Они могут быть определены для пользователя, равноправного участника сети или для обоих (что указывается в скобках): accountcode (для обоих)

Код учетной записи может определяться для каждого пользователя. Если задан, этот код учетной записи будет присваиваться записи вызова, когда не задан код учетной записи конкретного пользователя. Заданное имя accountcode будет использоваться как имя файла в формате CSV в папке /var/log/asterisk/cdr-csv/, где хранятся CDR для пользователей/равноправных участников сети/друзей: accountcode^lax-имяпользователя

allow и disallow (для обоих)

Могут быть разрешены или запрещены определенные кодеки, что позволяет разработчику системы задавать перечень используемых кодеков. allow и disallow также могут быть определены для канала отдельно. Помните, что выражения allow в разделе [general] будут распространяться на все каналы, для которых не переопределено disallow=all. Согласование кодеков ведется в порядке их задания. Лучшей практикой считается определять disallow=all, а затем с помощью выражений allow явно задавать каждый кодек, который вы желаете использовать. Если ничего не задано, предполагается, что allow=all: disallow=all allow=ulaw allow=gsm allow=ilbc

amaflags (для обоих)

Система автоматической регистрации сообщений (Automatic Message Accounting, AMA) описана в документации компании Telcordia, в разделе FR-AMA-1. Эти документы определяют стандартные механизмы формирования и передачи CDR. Можно задать один из четырех флагов AMA (default, omit, billing или documentation), который будет применяться ко всем SIP-соединениям: amaflags=documentation callerid (для обоих)

С помощью параметра callerid можно задать рекомендуемый строковый Caller ID (ID звонящего) для каналов типа user или peer. Если для user задано поле Caller ID, всем звонкам, поступающим по этому каналу, будет присвоен этот Caller ID независимо от того, что посылает вам дальний конец соединения. Если оно задано для peer, вы посылаете запрос дальнему концу на использование этого Caller ID как вашего идентификатора (хотя не располагаете средствами, чтобы проконтролировать это). Если вы хотите, чтобы вызывающие абоненты могли использовать собственные Caller ID (то есть для гостей), убедитесь, что поле callerid не задано: callerid=John Smith <(800) 555-1234> callgroup и pickupgroup (для обоих)

Параметр callgroup используется для назначения описания канала одной или более группам. Опция pickupgroup может использоваться в сочетании с этим параметром, чтобы обеспечить возможность ответа на звонок на данный телефон с другого добавочного номера. Опция pickupgroup используется для определения, вызовы каких групп вызовов может принимать канал, - каналу предоставляется возможность отвечать на вызовы другого канала, если он входит в ту же группу pickupgroup, что и группа вызовов вызываемого канала. По умолчанию перехватить вызовы удаленных добавочных номеров можно, набрав *8 (это можно настроить в файле features.conf):

callgroup=1,3-5 pickupgroup=1,3-5

callingpres (для обоих)

Задает публикацию Caller ID для данного пользователя/равноправного участника сети. Эта настройка принимает одну из следующих опций:

allowed_not_screened

Публикация разрешена, экранирование учетных данных не производится.

allowed_passed_screen

Публикация разрешена, экранирование разрешено.

allowed_failed_screen

Публикация разрешена, экранирование запрещено.

allowed

Публикация разрешена, сетевой номер.

prohib_not_screened

Публикация запрещена, экранирование учетных данных не производится.

prohib_passed_screen

Публикация запрещена, экранирование разрешено.

prohib_failed_screen

Публикация запрещена, экранирование запрещено.

prohib

Публикация запрещена, сетевой номер.

unavailable

Номер недоступен.

=yes|no canreinvite (для обоих)

SIP-протокол пытается соединить конечные точки напрямую. Однако Asterisk должна оставаться на линии передачи между конечными точками, если необходимо определять наличие DTMF (более подробную информацию можно найти в главе 4): canreinvite=no context (для обоих)

Контекст задается в описании канала, чтобы входящие звонки направлялись в соответствующий контекст в extensions.conf, где осуществляется их обработка (см. главы 4 и 5). Для любого канала, соединяющегося с сервером Asterisk, должен быть задан контекст, в который он будет направлен. Контекст обязателен для любого описания канала типа user; если контекст не задан, входящие звонки будут направляться в контекст default:

context=incoming

Необходимо знать о необычном сценарии, который потребует задания контекста для peer. Когда по SIP-каналу поступает вызов, он сначала пытается найти соответствующее описание user (согласно имени пользователя, заданному в квадратных скобках, и паролю). Если он не может найти ни одного подходящего пользователя, он ищет соответствие среди peer по IP- адресу, с которого поступил вызов. Поскольку обычно peer не имеют контекстов, такой вызов в итоге поступит в контекст default. Хотя это будет работать, контекст default не следует использовать для обработки входящих звонков. Выход - определить контекст для каждого peer, который может обрабатывать входящие звонки. Чтобы поэкспериментировать с этим, можете позвонить на свой номер в службе Free World Dialup; вызов вернется прямо к вам.

defaultip (равноправный участник)

Настройка defaultip дополняет host=dynamic. Если хост еще не зарегистрирован на вашем сервере, вы будете пытаться отправлять сообщения по указанному здесь IP-адресу по умолчанию:

defaultip=192.168.1.101 deny (для обоих)

С помощью опции deny можно задавать конкретные IP-адреса и диапазоны. Чтобы ограничить доступ для диапазона IP-адресов, используется маска подсети, например deny=192.168.1.0/255.255.255.0. Также можно запретить все адреса, задав deny=0.0.0.0/0.0.0.0, а затем с помощью команды permit разрешить доступ только определенным адресам. Помните о влиянии на безопасность, которое оказывает данная настройка (см. также permit): deny=0.0.0.0/0.0.0.0 disallow (для обоих) См. allow.

dtmfmode (для обоих)

Параметру dtmfmode могут быть присвоены значения inband, rfc2833 или info. DTMF-коды могут быть отправлены или в полосе частот (как часть аудиопотока), или вне полосы (как сигнальная информация) с помощью методов RFC 2833 или INFO. Метод inband работает надежно только при использовании кодека без сжатия, такого как G.711, plaw или alaw. Рекомендуемым является метод rfc2833; однако некоторые устройства, например производимые компанией Grandstream, поддерживают метод info: dtmfmode=rfc2833

В Asterisk 1.4 был введен DTMF-сигнал переменной длительности (Variable Length DTMF), чтобы Asterisk имела возможность сообщать дальнему концу соединения верную длительность нажатия кнопки на телефоне, подключенном к входящему каналу (согласно RFC 2833 IETF). Более старые системы Asterisk не понимают параметра переменной длины. В старых системах Asterisk DTMF-сигнал, доставляемый через RFC 2833, может быть неправильно интерпретирован, что приводит к странным эффектам, например, в сеансах передачи голосовой почты. Если требуется, чтобы настройка rfc2833 была реализована, как в более старой версии (до 1.4), необходимо добавить опцию rfc2833compensate=yes в описание peer в файле sip.conf, который определяет порядок обмена информацией с вашей системой Asterisk версии до 1.4.

fromdomain (равноправный участник)

Позволяет задавать домен в поле From: SIP-заголовка. Может требоваться некоторыми поставщиками сервисов для аутентификации: fromdomain=my.hostname.tld fromuser (равноправный участник)

Позволяет задавать имя пользователя для аутентификации. Обычно используется имя, заключенное в квадратные скобки в описании канала, но оно может быть переопределено с помощью опции fromuser. Это позволяет обращаться к описанию канала по имени, отличному от того, которое используется для аутентификации: fromuser=john_smith host (равноправный участник)

Конфигурирует хост, с которым должен соединяться данный равноправный участник сети. Используйте полное доменное имя: host=remote.hostname.tld incominglimit (для обоих)

Эта опция ограничивает общее число одновременных звонков для равноправного участника сети или пользователя. Задает максимальное число одновременных исходящих звонков для равноправного участника сети или максимальное число входящих звонков для пользователя. incominglimit=3 insecure (для обоих)

При получении сообщения INVITE от удаленного ресурса Asterisk пытается аутентифицировать строку символов перед знаком @ в строке INVITE, полученную в SIP-заголовке с именем описания канала из sip.conf. Если удаленный конец связи является агентом пользователя, его аутентификация будет проводиться исходя из описания user. Однако, если удаленный конец является прокси-сервисом SIP, он будет аутентифицироваться по записи peer. Когда вызовы поступают от такого провайдера, как Free World Dialup, который выступает в роли прокси для удаленной стороны, фактически вызывающей вас, этот провайдер не может принимать вызов от лица конечной точки. Поскольку было бы непрактичным конфигурировать аутентификацию для каждого FWD-пользователя и поскольку FWD не может отвечать на сообщения 407 Proxy Authentication Required (Необходима аутентификация на прокси), требуется альтернативный способ разрешения приема звонков от этих абонентов. Задавая insecure=invite, вы определите, какому каналу peer ищется соответствие при сравнении IP-адреса или имени хоста и номера порта с предоставленными в поле Contact SIP-заголовка опциями host и port в sip.conf. Если соответствие найдено, исходное сообщение INVITE не станет требовать аутентификации и звонок будет разрешен.

При наличии большого количества конечных точек за NAT-уст- ройством необходимо активировать параметр insecure=port, чтобы выполнять сопоставление только по IP-адресу. Чтобы не предъявлять требование на аутентификацию во входящем INVITE для peer, задайте insecure=invite,port: insecure=invite language (для обоих)

Задает флаг языка для всего, что вы определяете. Глобальный язык по умолчанию - английский. Заданный язык отправляется каналом как элемент информации. Он также используется такими приложениями, как SayNumber(), чтобы выбрать соответствующий файл для воспроизведения. Не забывайте, что все остальные языки, кроме английского, не устанавливаются в системе явно, поэтому ваша задача конфигурировать систему так, чтобы гарантировать правильную обработку задаваемых языков: language=en mailbox (равноправный участник)

Если в описании канала вы связываете mailbox с peer, сервис голосовой почты будет посылать MWI-сигналы узлам на конце этого канала. Если номер почтового ящика обрабатывается в другом контексте голосовой почты, не default, его можно описать как почтовыйящик@ контекст. Чтобы связать несколько почтовых ящиков с одним peer, используется несколько выражений mailbox: mailbox=1000@internal maxcallbitrate (для обоих)

Задает максимальную скорость передачи данных для отдельного звонка от конкретного пользователя или к конкретному равноправному участнику сети. Значение по умолчанию - 384 Кбит/с: maxcallbitrate=384 md5secret (для обоих)

Если вы не хотите использовать простые текстовые пароли в файлах sip.conf, с помощью md5secret можно сконфигурировать хеш MD5, который будет использоваться для аутентификации. Чтобы сгенерировать хеш MD5 из консоли Linux, используйте следующую команду:

# echo -n "username: realm:secret" | md5sum Не забудьте использовать флаг -n, иначе echo добавит \n в конец строки; тогда символ перевода строки будет учтен при вычислении хеша MD5, что приведет к созданию неверного хеша. Если не задана опция realm (обсуждаемая в списке общих параметров SIP), будет принята область действия по умолчанию - asterisk. Если в одном описании канала заданы параметры и md5secret, и secret, последний будет проигнорирован:

md5secret=0bcbe762982374c276fb01af6d272dca mohinterpret (канал)

Эта опция определяет, какой класс музыки во время ожидания должен воспроизводиться по данному каналу, если в диалплане для канала нет выражения Set(CHANNEL(musicclass)=fl»6on), определяющего класс музыки, и канал типа peer, поддерживающий вызов, не предлагает класса музыки.

Эта опция может быть задана глобально или для каждого пользователя либо равноправного участника сети в отдельности: mohinterpret=default mohsuggest (канал)

Эта опция определяет, какой класс музыки во время ожидания (как определено в musiconhold.conf) должен предлагаться каналу типа peer, когда этот канал переводит равноправного участника сети в режим ожидания. Он может быть задан глобально или для каждого пользователя или равноправного участника сети в отдельности: mohsuggest=default musicclass (для обоих)

Эта опция задает класс музыки во время ожидания по умолчанию: musicclass=classical nat (для обоих)

Для параметра nat может быть задано значение yes, no или never. Если задано yes, Asterisk игнорирует IP-адрес в заголовках SIP и SDP и отвечает на адрес и порт, указанные в IP-заголовке. Опция never предназначена для устройств, которые не могут обрабатывать поле rport в SIP-заголовке, такое как Uniden UIP200: nat=yes|no|never permit (для обоих)

См. deny. pickupgroup (для обоих) См. callgroup.

port (равноправный участник)

Этот параметр может использоваться для задания порта, по которому будут слушаться SIP-сигналы, если вы хотите использовать для этого нестандартный порт. (Порт по умолчанию для обмена сигналами по протоколу SIP - 5060.) port=5060 progressinband (для обоих)

Для параметра progressinband может быть задано значение yes, no или never, чтобы определить, должна ли Asterisk самостоятельно генерировать звуковой сигнал вызова для вызываемого абонента. Обычно Asterisk использует для информирования о поступлении вызова несколько методов, таких как 183 Session Progress, 180 Ringing, 486 Busy и т. д. Если задано progressinband=yes, Asterisk будет генерировать тональные сигналы для обозначения поступления вызова по каналу:

progressinband=yes|no|never promiscredir (для обоих)

Для параметра promiscredir могут быть заданы значения yes или no. Обычно при переадресации звонка на телефон Asterisk использует локальный канал (например, local/ 18005551212@pee r). Если задан параметр promiscredir=yes, Asterisk будет использовать SIP-канал, который позволяет переадресовывать вызовы на удаленные серверы: promiscredir=yes|no

Обратите внимание, что, если Asterisk выполняет переадресацию к самой себе, когда promiscredir=yes, система получит сообщение INVITE со своим Caller ID (ID звонящего) и выявит замыкание на саму себя. SIP не может выполнять замкнутые звонки, поэтому канал будет уничтожен.

qualify (равноправный участник)

Для параметра qualify может быть задано значение yes, no или время в миллисекундах. Если задается параметр qualify=yes, удаленным равноправным участникам периодически будут посылаться сообщения NOTIFY для определения, доступны ли они, и установления величины задержки между ответами. Равноправный участник будет признан недоступным в случае непоступления ответа в течение 2000 мс (изменить это значение по умолчанию можно, задав для параметра qualify время ожидания ответа в миллисекундах). Используйте эту опцию в сочетании с nat=yes, чтобы поддерживать канал через NAT-устройство активным: qualify=yes|no|количествосекунд regcontext (равноправный участник)

Задавая контекст, содержащий некоторые команды, можно сконфигурировать Asterisk на выполнение ряда действий при регистрации равноправного участника сети на вашем сервере. Эта опция используется в сочетании с regexten, определяющей, какой добавочный номер должен быть выполнен. Если параметр regexten не задан, в качестве добавочного номера используется имя равноправного участника. Asterisk будет динамически создавать и уничтожать для добавочного номера NoOp в приоритете 1. Все действия, которые следует выполнять при регистрации, должны начинаться с приоритета 2. Может быть задано несколько параметров regexten, разделенных символом &. regcontext задается для каждого равноправного участника или глобально:

regcontext=зарегистрированные_равноправныеучастники regexten (равноправный участник)

Опция regexten используется в сочетании с regcontext для определения добавочного номера, выполняемого в заданном контексте. Если regexten не задана явно, в качестве добавочного номера для сопоставления используется имя равноправного участника сети: regexten=1000 rtpholdtimeout (равноправный участник)

Принимает в качестве аргумента целое число, задается в секундах. Прерывает звонок, если RTP-данные не поступили в течение заданного времени ожидания. Значение rtpholdtimeout должно быть больше значения rtptimeout (см. также rtptimeout): rtpholdtimeout=120 rtpkeepalive (равноправный участник)

Определяет, как часто Asterisk должна посылать сообщения проверки активности установленного соединения в RTP-потоке, в секундах. Значение по умолчанию - нуль. Это означает, что Asterisk не будет посылать сообщения проверки активности RTP. rtpkeepalive=45 rtptimeout (равноправный участник)

Принимает в качестве аргумента целое число, соответствующее времени, в секундах, через которое Asterisk прервет вызов в случае непоступления RTP-данных. rtptimeout=60 secret (для обоих)

Задает пароль, используемый для аутентификации: secret=welcome setvar (для обоих)

Задает переменную канала, которая будет доступна с момента создания канала с равноправным участником или пользователем и уничтожена по завершении звонка. Например, чтобы задать переменную канала foo со значением bar, используйте следующую запись: setvar=foo=bar

username (равноправный участник)

Поле username позволяет выполнять попытки соединения с равноправным участником до того, как он зарегистрировался в вашей системе. При регистрации SIP-устройство сообщает Asterisk, какой SIP URI использовать для связи с ним. Имя пользователя используется в сочетании с defaultip для создания SIP URI в заголовке SIP- сообщения INVITE. Это может пригодиться для выполнения вызова после перезагрузки. Конечные точки не будут пытаться повторно зарегистрироваться на сервере до истечения срока их регистрации, поэтому вы не будете знать их местоположений. Для нединамических хостов потребуется, чтобы имя пользователя было задано, поскольку оно используется для создания имени пользователя для авторизации:

username=john_smith

B

Справочник по приложениям

Приложения являются основными функциональными элементами диалплана. И приложения, и функции, описанные в приложении F, выполняют некоторые операции с каналом, но функции просто возвращают значения, которые могут быть использованы приложениями. Очень немногие приложения по-прежнему просто возвращают значения, но они, вероятно, будут признаны устаревшими в будущих версиях, их заменят функции диалплана.

Необходимо помнить о некоторых особенностях приложений. Во-первых, они могут завершаться нормально и аварийно. Практически всегда аварийное завершение выполняется, когда приложение выявляет разрыв соединения по каналу (или, если не выявляет, диалплан обнаружит это несколько позже). Приложение также может завершиться аварийно, когда необходимо указать диалплану на то, что некоторое условие не удовлетворено и что необходимо выполнить принудительный разрыв соединения. Во всех остальных случаях приложение будет завершаться нормально, а это свидетельствует о том, что выполнение должно продолжиться в следующем приоритете диалплана. Часто при необходимости переопределить поведение приложения, обусловливающее разрыв соединения, для него создают оболочку TryExec(). В данном справочнике часто встречается описание метка. Это сокращенная запись для описания точки диалплана, будь то просто приоритет, добавочный номер и приоритет или контекст, добавочный номер и приоритет. Обратите внимание, что, если текстовая метка определена для конкретного приоритета, приоритет может быть заменен этой текстовой меткой в любом из упомянутых случаев. Больше информации и пример можно найти в описании приложения GotoIf().

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

AddQueueMember()

Динамически добавляет участников в очередь для заданной очереди вызовов

AddQueueMember(имяочереди[, интерфейс[, приоритет,[опция ,[имяучастник.а]]]])

Динамически добавляет заданный интерфейс в существующую очередь под именем имяочереди, которое определено в файле queues.conf. Если задан, приоритет определяет для очередей приоритет данного участника. Участники вызываются в порядке увеличения приоритетов. По завершении выполнения приложение AddQueueMember() задает переменную канала AQMSTATUS.

Переменной AQMSTATUS будет присвоено одно из следующих значений:

ADDED

MEMBERALREADY NOSUCHQUEUE

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

Если аргументу опция задано значение j, Asterisk не может добавлять интерфейс в указанную очередь и существует приоритет n + 101 (где n - номер текущего приоритета), вызов перейдет в этот приоритет. Посредством аргумента имяучастника может быть задано имя участника очереди. Таким образом, это имя будет использоваться в записях queue_ log и событиях интерфейса Asterisk Manager, что упростит идентификацию агента при формировании отчетов:

; добавляем SIP/3000 с приоритетом 1 в очередь techsupport exten => 123,1,AddQueueMember(techsupport,SIP/3000,1)

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

Queue(), RemoveQueueMember(), PauseQueueMember(), UnpauseQueueMember(), AgentLogin(), queues.conf

ADSIProg()

Загружает ADSI-сценарий в телефон, поддерживающий ADSI

ADSIProg(сценарий)

Программирует телефон, поддерживающий Analog Display Services Interface (ADSI), с помощью заданного сценария. Если сценарий не задан, используется сценарий по умолчанию, asterisk.adsi. Для сценария указывается относительный путь из папки конфигурации Asterisk (обычно это /etc/asterisk/). Также можно указать полный путь к сценарию.

Для получения CPE ID и другой информации от своего ADSI-телефона используйте приложение GetCPEID():

; программируем ADSI-телефон с помощью сценария telcordia-l.adsi exten => 123,1,ADSIProg(telcordia-1.adsi)

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

GetCPEID(), adsi.conf

AgentCallbackLogin()

Регистрация агента с возможностью обратного вызова

AgentCallbackLogln([НомерАгентa][,[опции][,[добaвочныйномер]@контекст]])

Разрешает агенту вызовов, идентифицированному параметром Номер- Агента, регистрироваться в системе очереди вызовов, что позволяет при поступлении вызова для этого агента выполнять обратный вызов к нему.

При поступлении вызова для этого агента Asterisk звонит на заданный добавочный номер (с необязательным контекстом).

Аргумент опции может содержать букву s, что означает скрытую авторизацию:

регистрируется в скрытом режиме как агент номер 42 и определяет, что при поступлении вызова для этого агента Asterisk будет звонить на добавочный номер 123 в контексте internal exten => 123,1,AgentCallbackLogin(42,s,123@internal)

Это приложение является устаревшим, его функциональность замещена логикой диалплана на AEL, размещенного в файле doc/queues-with-callbackmembers.txt в папке исходного кода Asterisk.

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

Queue(), AgentLogin(), AddQueueMember(), RemoveQueueMember(), PauseQueueMember(), UnpauseQueueMember(), AGENT, agents.conf, queues.conf

AgentLogin()

Регистрация агента вызовов в системе

AgentLogin([НомерАгента][, опции])

Регистрирует текущего вызывающего абонента в системе очереди вызовов как агента обработки вызовов (он может быть идентифицирован параметром НомерАгента). После регистрации агент может принимать вызовы и будет слышать звуковой сигнал в линии при поступлении нового вызова. Агент может прервать текущий вызов, нажав кнопку со звездочкой (*). Если НомерАгента не задан, вызывающему абоненту будет предложено ввести свой номер агента. Агенты описаны в файле agents.conf.

Аргумент опции может содержать букву s, что означает скрытую авторизацию:

; регистрируем в скрытом режиме вызывающего абонента как ; агента номер 42, как определено в agents.conf exten => 123,1,AgentLogin(42,s)

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

Queue(), AddQueueMember(), RemoveQueueMember(), PauseQueueMember(), UnpauseQueueMember(), AGENT, agents.conf, queues.conf

AgentMonitorOutgoing()

Регистрирует исходящие вызовы агента

AgentMonitorOutgoing([опции])

Регистрирует все исходящие вызовы, производимые агентом обработки вызовов.

Это приложение пытается выяснить ID агента, выполняющего исходящий вызов, на основании сравнения Caller ID (ID звонящего) текущего интерфейса и глобальной переменной, заданной приложением AgentCallbackLogin(). Таким образом, оно должно использоваться только в сочетании (и после него!) с приложением AgentCallbackLogin(). Для записи вызовов оно использует не приложение Monitor(), а функции для записи разговоров модуля chan_agent. Это означает, что процедура записи вызовов должна быть правильно сконфигурирована в файле agents.conf. По умолчанию записанные звонки сохраняются в папке /var/spool/ asterisk/monitor/. Это можно переопределить с помощью параметра savecallsin в файле agents.conf.

Если Caller ID и/или ID агента на найден, это приложение передаст управление приоритету n + 1, если он существует (где n - текущий приоритет). Если это не переопределено какой-либо опцией, возвращается 0. Аргумент опции может включать одно или более из следующих значений:

d

В случае ошибки и отсутствия добавочного номера n + 101 приложение возвращает -1.

c

Меняет Call Detail Record (Запись параметров вызова) таким образом, что источник вызова записывается как Агент/id_агента.

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

; записываем исходящие звонки для этого агента и меняем ; CDR, чтобы отразить то, что звонок выполняется агентом exten => 123,1,AgentMonitorOutgoing(c)

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

AgentCallbackLogin(), agents.conf

AGI()

Выполняет совместимое с AGI приложение

[E]AGI(прогрaммa[, аргументы])

Выполняет для текущего канала совместимую с Asterisk Gateway Interface программу. AGI-программы обеспечивают возможность внешним программам (которые могут быть написаны практически на любом языке программирования) управлять каналом связи путем воспроизведения аудиофайлов, чтения DTMF-сигналов и т. д. Asterisk обменивается информацией с AGI-программой с помощью стандартных потоков ввода вывода STDIN и STDOUT. Заданные аргументы передаются в AGI-программу.

В качестве программы должен быть задан исполняемый файл из базовой файловой системы. Путь к программе должен вести в папку AGI Asterisk, по умолчанию это /var/lib/asterisk/agi-bin/. Если необходимо выполнить AGI, когда не существует ни одного канала (как для добавочного номера h), используйте приложение DeadAGI(). Если требуется выполнять AGI удаленно, используется приложение FastAGI().

Если вы хотите выполнять доступ к входящему аудиопотоку из своей AGI-программы, вместо AGI() используйте приложение EAGI(). Тогда входящий аудиопоток может читаться в дескриптор файла 3. Если происходит преждевременный разрыв соединения, процессу, запущенному командой AGI, будет послан сигнал HUP, извещающий о завершении соединения. Если ваша программа не перехватит этот сигнал, она будет завершена. Это поведение можно переопределить, задав для переменной канала AGISIGHUP значение 0: ; вызываем демонстрационную AGI-программу exten => 123,1,AGI(agi-test) exten => 123,2,EAGI(eagi-test)

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

DeadAGI(), FastAGI(), главу 9

AlarmReceiver()

Предоставляет поддержку для получения сигналов с панели охранной или пожарной сигнализации

AlarmReceiver()

Эмулирует приемник сигналов тревоги и позволяет Asterisk принимать и декодировать специальные данные панелей пожарной и/или охранной сигнализации. На данный момент поддерживается только формат Ademco Contact ID.

Будучи вызванным, приложение AlarmReceiver() подтвердит установление связи с панелью сигнализации, будет принимать события, проверять их достоверность, подтверждать их и сохранять до тех пор, пока панель не разорвет соединение. Как только панель разорвет соединение, приложение будет выполнять строку команд, заданную настройкой eventcmd в файле alarmreceiver.conf, и передавать события на стандартный ввод приложения. Файл alarmreceiver.conf также содержит настройки синхронизации DTMF и громкости тонов подтверждения приема. ; настраиваем Asterisk, чтобы она отвечала на вызовы ; поддерживаемой панели пожарной сигнализации exten => s,1,AlarmReceiver()

Надежность этого приложения не гарантируется, поэтому не полагайтесь на него без всестороннего тестирования. Используя это приложение без тестирования, вы подвергаете свою жизнь и собственность большой опасности.

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

alarmreceiver.conf

AMD()

Выявление автоответчика

AMD([initialSilence[,greeting[,afterGreetingSilence[,totalAnalysisTime[, minimumUordien gth[,betweenUordsSilence[, maximumNumberOfUords[, silenceThreshold]]]]]]]])

Это приложение пытается установить наличие автоответчика на основании шаблонов синхронизации. Это приложение обычно используется исходящими вызовами, берущими начало или в файлах вызовов, или в интерфейсе Asterisk Manager. Приложение сообщает, какой тип вызова был выявлен, задавая переменной AMDSTATUS одно из следующих значений: MACHINE (машина)

Считается, что вызываемая сторона является автоответчиком. HUMAN (человек)

Считается, что вызываемая сторона является человеком, а не автоответчиком.

NOTSURE (не уверен)

Приложение не смогло определить, является ли вызываемая сторона человеком или автоответчиком.

HANGUP (разрыв)

В процессе определения произошел разрыв соединения. Приложение AMD() также указывает в переменной канала AMDCAUSE причину, на основании которой делается заключение, обозначенное в переменной AMDSTATUS. Для переменной AMDCAUSE будет задано одно из следующих значений: TOOLONG-общее_время

INITIALSILENCE-продолжительность_паузы-начальная_пауза HUMAN-продолжительность_паузы-пауза_после_приветствия MAXWORDS-количество_слов-максимальное_число_слов LONGGREETING-продолжительность_разговора-приветствие Все параметры данного приложения помогают настроить его так, чтобы оно могло более эффективно оценивать разницу между человеком и автоответчиком. Если параметры не переданы в это приложение, Asterisk прочитает значения по умолчанию, описанные в amd.conf. К этим параметрам относятся:

initialSilence (начальная пауза)

Максимальная продолжительность паузы перед приветствием. Если это значение превышено, для переменной AMDSTATUS будет задано значение MACHINE.

greeting (приветствие)

Максимальная продолжительность приветствия. Если превышена, для переменной AMDSTATUS будет задано значение MACHINE.

afterGreetingSilence (пауза после приветствия)

Максимальная пауза после обнаружения приветствия. Если превышена, для переменной AMDSTATUS будет задано значение MACHINE.

totalAnalysisTime (общее время анализа)

Максимальное время, предоставляемое алгоритму для принятия решения о том, является ли вызываемая сторона человеком или автоответчиком. minimumWordLength (минимальная длина слова)

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

Минимальная пауза после слова, чтобы считать следующий аудиосигнал новым словом.

maximumNumberOfWords (максимальное число слов)

Максимальное число слов в приветствии. Если это значение превышено, для переменной AMDSTATUS будет задано значение MACHINE.

silenceThreshold (пороговая продолжительность паузы) Чувствительность алгоритма при выявлении паузы.

; Используем алгоритм выявления автоответчика. Если ; вызываемая сторона является человеком, устанавливаем ; соединение с Бобом. В противном случае воспроизводим ; сообщение и разрываем соединение exten => 123,1,Answer() exten => 123,n,AMD()

exten => 123,n,GotoIf($["${AMDSTATUS}" = "HUMAN"]?human:machine) exten => 123,n(machine),WaitForSilence(2000) exten => 123,n,Playback(asterisk-friend) exten => 123,n,Hangup()

exten => 123,n(human),Verbose(3, We've got a human on the line!)

exten => 123,n,Playback(transfer)

exten => 123,n,Dial(SIP/bob)

exten => 123,n,Playback(im-sorry)

exten => 123,n,Hangup()

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

WaitForSilence()

Answer()

Устанавливает соединение, если по каналу поступает вызов

Answer([задержка])

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

Если нет веских оснований не делать этого, Answer() рекомендуется использовать для канала перед вызовом всех остальных приложений. Существует несколько ключевых приложений, которые требуют, чтобы перед их выполнением было выполнено приложение Answer(). В противном случае они могут работать некорректно: exten => 123,1,Answer(750) exten => 123,n,Playback(tt-weasels)

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

Hangup()

AppendCDRUserField()

Добавляет значение в поле пользователя записи Call Detail Record

AppendCDRUserField( .значение)

Добавляет значение в поле пользователя записи Call Detail Record (CDR). Поле пользователя часто используется для хранения произвольных данных о вызове, которые не подходят для всех остальных полей:

; задаем в поле пользователя значение 'abcde' exten => 123,1,SetCDRUserField(abcde) ; теперь добавлям в конец 'xyz' exten => 123,1,AppendCDRUserField(xyz)

Это приложение было признано устаревшим и заменено CDR- функцией.

exten => 123,1,Set(CDR(userfield)=${CDR(userfield)}12345)

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

SetCDRUserField(), ForkCDR(), NoCDR(), ResetCDR(), CDR

Authenticate()

Требует от вызывающего абонента введения правильного пароля для продолжения выполнения

Authenticate(пaроль[,опции[, максимумсимволов]])

Требует от вызывающего абонента ввести заданный пароль, чтобы продолжать выполнение следующего приоритета диалплана. Authenticate() дает вызывающему абоненту три попытки для правильного введения пароля. Если за эти три попытки вызывающий абонент так и не смог ввести правильный пароль, выполняется разрыв соединения.

Если пароль начинается с символа /, он трактуется как файл, содержащий список действительных паролей (по одному в строке). Пароли также могут храниться в базе данных Asterisk (AstDB); см. опцию d ниже. Параметр максимумсимволов задает максимальное число символов, которое может ввести вызывающий абонент. Если этот параметр не задан, приложение будет принимать неограниченное число символов и станет ожидать от вызывающего абонента нажатия кнопки # после введения кода аутентификации.

Может быть задана одна или несколько опций из следующего списка:

a

Присваивает CDR-полю accountcode, а переменной канала ACCOUNTCODE - значение введенного пароля.

d

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

j

Поддерживает переход к приоритету n + 101 в случае неудачной аутентификации.

m

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

r

Удаляет ключ базы данных после успешного входа (действительна только с опцией d).

; вынуждаем вызывающего абонента ввести пароль,

; прежде чем выполнять остальные действия,

; и сохраняем введенный пароль в CDR-поле 'accountcode'

exten => 123,1,Answer()

exten => 123,n,Authenticate(1234,a)

exten => 123,n,Playback(pin-number-accepted)

exten => 123,n,SayDigits(${ACCOUNTCODE})

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

VMAuthenticate(), DISA(), главу 6

Background()

Воспроизводит файл, принимая при этом сигналы тонального набора (DTMF)

Background(имяфайла1[&имяфайла2...][,опции[, язык]])

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

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

Допустимыми опциями являются следующие:

s

Сообщение воспроизводиться не будет, если канал находится не в состоянии «соединен» (то есть еще не получен ответ на вызов). Если s задана, приложение будет возвращаться сразу же, как только канал окажется не в состоянии «соединен».

n

Не отвечать на вызов до воспроизведения заданного файла. Без этой опции ответ на вызов будет произведен автоматически перед воспроизведением звука. Не все каналы поддерживают воспроизведение сообщений до ответа на вызов.

m

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

Аргумент язык может использоваться для задания языка воспроизводимого приглашения, если он отличается от используемого языка канала.

exten => 123,1,Answer()

exten => 123,2,Background('exter-ext-of-person');

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

ControlPlayback(), WaitExten(), BackgroundDetect(), TIMEOUT

BackgroundDetect()

Воспроизводит файл в фоновом режиме и выявляет разговор

BackgroundDetect(имяфайла[, sil[,min[, max]]])

Аналогично Background(), но пытается выявить разговор.

Во время воспроизведения файла выполняется отслеживание аудиосигналов во входящем потоке. Если период отсутствия тишины длится больше min миллисекунд, но еще меньше max миллисекунд и за ним следует пауза продолжительностью как минимум sil миллисекунд, воспроизведение звука прерывается и выполнение переходит в добавочный номер talk (разговор), если таковой доступен.

Если не заданы, параметры sil, min и max по умолчанию принимают значения 1000 мс, 100 мс и бесконечное количество соответственно.

exten => 123,1,BackgroundDetect(tt-monkeys) exten => 123,2,Playback(im-sorry) exten => talk,1,Playback(yes-dear)

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

Playback(), Background()

Busy()

Обозначает состояние занятости канала

Busy([времяожидaния])

Указывает каналу обозначить состояние «занято», а затем ожидает, когда пользователь повесит трубку или разрыва соединения по истечении времени ожидания (заданного необязательным параметром вре- мяожидания в секундах).

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

способ оповещения вызывающего абонента о состоянии занятости. Можно использовать Playtones(busy) для воспроизведения сигнала «занято».

exten => 123,1,Playback(im-sorry) exten => 123,2,Playtones(busy) exten => 123,3,Busy()

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

Congestion(), Progress(), Playtones(), Hangup()

ChangeMonitor()

Меняет имя файла для записи разговора по каналу

ChangeMonitor(базовое_имяфайла)

Меняет имя записанного файла для канала, созданного приложением Monitor(). Это приложение не оказывает никакого эффекта, если на канале не производится запись разговора. Аргумент базовое_имяфайла - это новое базовое имя файла, которое должно использоваться для записи разговора в канале.

; начинаем запись разговора в данном канале, ; используя базовое имя файла 'sample' exten => 123,1,Monitor(sample) ; меняем базовое имя файла на 'example' exten => 123,2,ChangeMonitor(example)

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

Monitor(), StopMonitor(), MixMonitor()

ChanIsAvail()

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

ChanIsAvall(технология1/ресурс1[&технолоигя2/ресурс2...][, опции])

Проводит проверку на определение доступности какого-либо из запрашиваемых каналов. Это приложение также задает следующие переменные каналов:

AVAILCHAN

Имя доступного канала, включая номер сеанса вызова, используемого для проведения проверки.

AVAILORIGCHAN

Каноническое имя канала, используемое для его создания, то есть имя канала без номера сеанса.

AVAIiSTATUS

Код статуса канала.

Если задана опция s (означающая state - состояние), Asterisk будет считать используемый канал недоступным, даже если он может принять другой вызов.

Если задана опция j и не доступен ни один из запрашиваемых каналов, выполнение переходит в приоритет n + 101 (где n - текущий приоритет), если этот приоритет существует.

; проверяет, доступны ли каналы Zap/1 и Zap/2 exten => 123,1,ChanIsAvail(Zap/1&Zap/2) ; выводит имя доступного канала в CLI Asterisk exten => 123,2,Verbose(0,${AVAILORIGCHAN})

Г~ ¹ Это приложение работает некорректно для каналов MGCP.

ChannelRedirect()

Перенаправляет канал в новую точку диалплана

ChannelRedirect(кaнaл,[[контекст,]добaвочныйномер,]приоритет)

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

; Перенаправляет SIP/Bob к музыке во время ожидания

; при наборе добавочного номера 123

exten => 123,1,ChannelRedirect(SIP/Bob,124,1)

exten => 124,1,Answer()

exten => 124,2,MusicOnHold()

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

Transfer()

ChanSpy()

Слушает разговор в канале и может посылать сигналы в вызывающий канал

ChanSpy([префикскaнaлa[,опции]])

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

При прослушивании канала могут осуществляться следующие действия:

• Набор # циклически меняет уровень громкости.

• Набор * заставит приложение перейти к прослушиванию следующего доступного канала.

• Набор последовательности символов, завершенный нажатием кнопки #, создает имя канала (которое будет добавлено после префикска- нала). Например, если запустить ChanSpy(Zap), а затем в процессе прослушивания набрать символы 42#, начнется прослушивание канала Zap/42.

Параметр опции может содержать нуль или более следующих опций:

b

Прослушивать только соединенные каналы.

g(группа)

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

^q

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

r[(базовоеимя)]

Записывает разговор, ведущийся по каналу, в папку очереди для записей разговоров (обычно это /var/spool/asterisk/monitor). Необязательное базовоеимя задает базовое имя файла для записей, значение по умолчанию - chanspy.

v([значение])

Настраивает громкость прослушиваемого аудиосигнала. Значение должно быть в диапазоне от 4 до -4. Отрицательное значение сделает звук тише, тогда как положительное - громче.

w

Режим шепота. Позволяет прослушивающему каналу «говорить» с прослушиваемым каналом. При этом ни один другой соединенный канал не сможет слышать этот разговор.

W

Закрытый режим шепота. Позволяет прослушивающему каналу «говорить» с прослушиваемым каналом без возможности слышать аудиосигнал из прослушиваемого канала.

; Прослушиваем каналы Zap в режиме шепота exten => 123,1,ChannelSpy(Zap,w)

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

ExtenSpy()

Congestion()

Устанавливает состояние перегрузки канала

Congestion([времяожидания])

Указывает каналу индицировать перегрузку, а затем ожидает, когда пользователь повесит трубку или разрыва соединения по истечении времени ожидания (заданного необязательным параметром времяожида- ния в секундах).

Это приложение сигнализирует о перегрузке только на дальний конец соединения; оно фактически не воспроизводит тональный сигнал перегрузки линии абоненту. Для воспроизведения сигнала перегрузки используйте приложение Playtones(congestion).

При использовании данной команды без времени ожидания возникает риск того, что канал задержится в этом состоянии. В этом нет необходимости, когда вы просто хотите проинформировать пользователя о перегруженности канала. Используйте приложение Playtones(congestion), чтобы абонент услышал сигнал «занято» повышенной частоты, а затем выполните Hangup().

Всегда завершается аварийно:

; для Caller ID 555-1234 всегда воспроизводить ; сигнал перегруженности линии

exten => 123,1,GotoIf($[${CALLERID(num)} = 5551234]?5:2)

exten => 123,2,Playtones(congestion)

exten => 123,3,Congestion(3)

exten => 123,4,Hangup()

exten => 123,5,Dial(Zap/1)

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

Busy(), Progress(), Playtones(), Hangup()

ContinueWhile()

Выполняет перезапуск цикла While()

ContinueWhile()

Возвращается к началу цикла While() и повторно вычисляет условное выражение.

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

While(), ExitWhile()

ControlPlayback()

Воспроизводит файл с возможностью ускоренной перемотки вперед и назад

ControlPlayback(файл[,skipms[, ff [, rew[,stop[, pause[, restart[, опции]]]]]]])

Воспроизводит указанный файл (без расширения файла), предоставляя при этом пользователю возможность перемещаться по файлу вперед и назад, нажимая кнопки ff и rew. По умолчанию можно использовать кнопки * и # для перемотки файла назад и вперед соответственно. Опция skipms определяет, на сколько секунд записи вперед или назад выполняется переход при каждом нажатии кнопки ff или rew. Если задан аргумент stop, приложение будет останавливать воспроизведение при нажатии кнопки stop.

Также может быть задан аргумент pause, который определяет, что при нажатии кнопки pause воспроизведение файла будет приостановлено. При повторном нажатии кнопки pause воспроизведение файла возобновится.

Если задан параметр restart, то при нажатии определенной кнопки воспроизведение файла будет начато сначала.

Если для параметра опции задано значение j и указанного файла не существует, приложение переходит в приоритет n + 101, если таковой присутствует (где n - номер текущего приоритета).

Приложение ControlPlayback() по завершении выполнения задает значение для переменной канала CPLAYBACKSTATUS. Переменной CPLAYBACK STATUS будет присвоено одно из следующих значений: SUCCESS (успех)

USERSTOPPED (остановлен пользователем) ERROR (ошибка)

; позволяет вызывающему абоненту управлять ; воспроизведением этого файла

exten => 123,1,ControlPlayback(tt-monkeys\3000\#\*\5\0)

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

Playback(), Background(), Dictate(),

DateTime()

Проговаривает дату и/или время в указанном пользователем формате

DateTime([unixtime[, часовойпояс[, формат]]])

Если задан параметр unixtime, приложение проговаривает эти дату и время. В противном случае оно проговаривает текущие дату и время. Если задан часовойпояс, дата и время вычисляются соответственно этому часовому поясу. В противном случае используется зональная настройка сервера Asterisk. Если задан параметр формат, дата и время будут проговариваться соответственно этому формату. (Подробнее о формате даты и времени можно узнать из образца файла voicemail.conf.)

; проговаривает текущую дату и время

; в нескольких часовых поясах

exten => 123,1,DateTime(,America/New_York)

exten => 123,2,DateTime(,America/Chicago)

exten => 123,3,DateTime(,America/Denver)

exten => 123,4,DateTime(,America/Los_Angeles)

DBdel()

Удаляет ключ из AstDB

DBdel(семейство/ключ)

Удаляет ключ, заданный параметром ключ, из семейства ключей семейство в AstDB.

Это приложение является устаревшим и заменено функцией

DB_DELETE().

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

DB_DELETE(), DBdeltree(), DB

Dbdeltree()

Удаляет семейство или дерево ключей из AstDB

DBdeltree(семейство[/деревоключей])

Удаляет заданное семейство или деревоключей из AstDB.

; создает пару записей в AstDB exten => 123,1,DBput(test/blue) exten => 123,2,DBput(test/green) ; теперь удаляем семейство ключей test exten => 123,3,DBdeltree(test)

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

DB_DELETE(), DBdel(), DB

DeadAGI()

Выполняет AGI-совместимый сценарий для «мертвого» (разъединенного) канала

DeadAGI(программа, аргументы)

Выполняет AGI-совместимую программу для «мертвого» (разъединенного) канала. AGI позволяет Asterisk запускать внешние программы, написанные практически на любом языке программирования, для управления каналом связи, воспроизведения аудиофайлов, чтения DTMF-сигналов и т. д. посредством обмена информацией по AGI-про- токолу по STDIN и STDOUT. Аргументы, заданные параметром аргументы, будут переданы в программу.

Это приложение было написано специально для «мертвых» каналов, поскольку обычный AGI-интерфейс не работает корректно, если канал разъединен.

Чтобы получить список всех доступных команд AGI, используйте команду интерфейса командной строки show agi.

exten => h,1,DeadAGI(agi-test)

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

AGI(), FastAGI()

Dial()

Пытается соединить каналы

Dlal(технология/имяпольгзователя:пароль(Фимяхоста/добавочныйномер[&технология2/peer2. . . ] [,времяожидания-ответа[, флаги[, URi]]])

Позволяет соединять все возможные типы каналов[145]. Dial() - самое важное приложение в Asterisk; наверняка вы периодически будете возвращаться к этому разделу.

Для приложения Dial() приемлем любой действительный тип каналов (такие, как SIP, IAX2, H.323, MGCP, Local или Zap), но то, какие параметры необходимо будет передать для канала, зависит от информации, которая требуется каналу данного типа для работы. Например, SIP-ка- налу для соединения понадобится сетевой адрес и пользователь, тогда как Zap-канал потребует телефонный номер.

Когда задается сетевой тип канала, в качестве опций Dial() могут передаваться хост назначения (имя или IP-адрес), имя пользователя, пароль и удаленный добавочный номер или можно указать имя записи канала в соответствующем файле .conf; тогда вся необходимая информация должна поступать из этого файла. Имя пользователя и пароль можно заменить именем, указанным в квадратных скобках ([]) в конфигурационном файле канала. Имя хоста является необязательным.

Вот действительное выражение Dial:

exten => s,1,Dial(SIP/sake:arigato@thathostoverthere.tld)

Такая запись аналогична предыдущей:

exten => s,1,Dial(SIP/some_SIP_friend) но будет работать, только если в sip.conf есть канал [some_SIP_friend], описание которого включает fromuser=sake, password=arigato и host= thathostoverthere.tld.

Часто добавочный номер указывается после адреса:

exten => s,1,Dial(IAX2/user:pass@otherend.com/500) Таким образом мы указываем дальнему концу соединения направить вызов на добавочный номер 500 в том же контексте, в который поступил вызов. Необязательно указывать добавочный номер в Dial(), поскольку может использоваться информация конфигурационного файла канала удаленного конца соединения или удаленный сервер передаст вызов на добавочный номер s в контексте, в котором поступил вызов. В конечном счете, дальний конец соединения управляет тем, что происходит с вызовом; вы можете только запрашивать определенную обработку. Если не задан параметр времяожидания-ответа, канал будет совершать вызов неопределенно долго. Это не всегда плохо, поэтому не надо полагать, что это обязательный параметр; просто знайте, что «неопределенно долго» может означать «очень долго». Параметр времяожидания-отве- та задается в секундах и всегда следует за адресной информацией: exten => s,1,Dial(IAX2/user:pass@otherend.com/500,времяожидания-ответа) Мощь приложения Dial() во многом определяется флагами. Они указываются после адреса и времени ожидания:

exten => s,1,Dial(IAX2/user:pass@otherend.com/500,60,флаги)

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

exten => s,1,Dial(IAX2/user:pass@otherend.com/500,,флаги)

Для приложения Dial() могут использоваться следующие флаги:

A( x )

Воспроизводится приветствие для вызываемой стороны; x - имя звукового файла, используемого в качестве приветствия.

C

Выполняется сброс записи Call Detail Record для звонка. Поскольку в CDR выставляется время ответа (Answer()) на звонок, вероятно, вы захотите сбросить запись CDR, чтобы пользователю не приходилось оплачивать время, прошедшее до вызова приложения Dial().

d

Пользователь может набирать одноразрядный добавочный номер в процессе ожидания ответа на звонок. Тогда звонок перейдет на

этот добавочный номер (или в текущем контексте, или, если производится выход, в контексте, заданном переменной EXITCONTEXT).

D([ вызываемый ][: вызывающий ])

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

f

Caller ID (ID звонящего) вызывающей стороны принудительно устанавливается как добавочный номер, связанный с каналом, с помощью подсказки диалплана. Часто это используется, когда провайдер разрешает задавать в качестве Caller ID только выделенные для вас номера. Например, при наличии PRI флаг f использовался бы для переопределения любого заданного локально Caller ID для SIP- телефона.

^g

Выполнение диалплана продолжается в текущем контексте, если вызываемый абонент вешает трубку.

G( контекст " добавочныйномер " приоритет )

Когда ответ на звонок получен, вызывающая сторона переводится в заданный приоритет, а вызываемая сторона - в заданный приоритет + 1. В сочетании с этой опцией не могут использоваться никакие дополнительные опции, определяющие операции после ответа.

h

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

H

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

i

Asterisk будет игнорировать все попытки перенаправить вызов для данной попытки вызова.

Asterisk будет переходить в приоритет n + 101 в случае занятости запрашиваемых каналов (где n - текущий приоритет).

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 (недействительные аргументы)

В приложение Dial() были переданы недействительные аргументы.

; набираем семизначный номер по Zap-каналу 4 exten => 123,1,Dial(Zap/4/2317154)

; набираем тот же номер, но на этот раз дозвон будет ; осуществляться только в течение 10 с, ; после чего будет продолжено выполнение диалплана exten => 124,1,Dial(Zap/4/2317154,10)

exten => 124,2,Playback(im-sorry) exten => 124,3,Hangup()

; набираем тот же номер, но на этот раз без времени ; ожидания, и используем флаги t, T и m exten => 125,1,Dial(Zap/4/2317154,,tTm)

; набираем добавочный номер 500 на удаленном хосте ; (по протоколу IAX), используя заданные ; имя пользователя и пароль

exten => 126,1,Dial(IAX2/username:password@remotehost/500)

; набираем номер, но ограничиваем звонок 5 мин ; (300 000 мс), начинаем предупреждать вызывающего ; абонента через 4 мин (240 000 мс) разговора ; и повторяем предупреждение каждые 30 с (30 000 мс) exten => 127,1,Dial(Zap/4/2317154,,L[300000:240000:30000])

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

RetryDial()

Dictate()

Виртуальный диктофон

Dictate([базовая_папка[, имяфайла]])

Это приложение обеспечивает возможность записи и воспроизведения файлов, аналогично традиционному диктофону. Параметр базовая_папка определяет папку, в которую Asterisk будет сохранять записываемые файлы. Если она не задана, по умолчанию файлы сохраняются в подпап- ку dictate папки очереди Asterisk (как задано в файле asterisk.conf).

Если задан параметр имяфайла, он будет использоваться при записи файла. Если он не задан, Asterisk предложит вызывающему абоненту ввести числовое имя файла.

Asterisk записывает файлы без сжатия, без заголовков, в формате signed-linear. Если потребуется преобразовать файл в другой формат, можно использовать внешнюю утилиту, такую как sox, или применить команду file convert из интерфейса командной строки Asterisk.

Приложение Dictate() имеет два основных режима: режим записи и режим воспроизведения. Для переключения режимов вызывающий абонент может нажать кнопку 1. В обоих режимах кнопка 0 используется для вызова справочной системы. Кнопка * служит для приостановки или продолжения записи либо воспроизведения. Кнопка # позволяет вызывающему абоненту выбрать новое имя файла. В режиме записи можно использовать кнопку 8, чтобы стереть всю запись и начать заново.

В режиме воспроизведения кнопка 7 обеспечивает перемотку на несколько кадров назад, а кнопка 8 - перемотку на несколько кадров вперед. Кнопка 2 используется для переключения скорости воспроизведения (1х, 2х, 3х или 4х).

; начинаем диктовку и сохраняем файлы в папке /tmp/dictate exten => 123,1,Dictate(/tmp/dictate)

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

Playback(), Background(), ControlPlayback()

Directory()

Предоставляет справочник набираемых добавочных номеров

Directory(vm-к.онтек.с^, контекст-набора[,опции]])

Предоставляет пользователям справочник добавочных номеров, которые они могут выбирать по имени абонента. Список имен и добавочных номеров можно найти в файле voicemail.conf. Аргумент vm-контекст является обязательным; он определяет используемый контекст voicemail.conf. Аргумент контекст-набора - это контекст, используемый для выполнения звонков абонентам. Если не задан, по умолчанию принимается значение vm-контекст. Если для аргумента опции задано значение f, Asterisk будет искать соответствующий номер в справочнике на основании имени, указанного в файле voicemail.conf, а не фамилии абонента. Если задана опция e, кроме имени абонента, Asterisk будет выполнять поиск также и по добавочному номеру.

Если пользователь вводит 0 (нуль) и в текущем контексте есть добавочный номер o (или строчная буква о), управление вызовом перейдет в этот добавочный номер. Введение * обеспечит аналогичный выход, но только в добавочный номер a, что очень похоже на поведение Voicemail(). exten => *,1,Directory(default,incoming) exten => #,1,Directory(default,incoming,f) exten => 9,1,Directory(default,incoming,fe)

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

voicemail.conf

DISA()

Direct Inward System Access (Прямой внутрисистемный доступ): позволяет внешним абонентам выполнять исходящие звонки

DISA(пароль[, контекст[, callerid[, почтовыйящик.[@утк.онтек.ст]]]]) DISA(файл-пароля[, callerid[, почтовыйящик[@утконтекст]]])

Позволяет внешним абонентам получать «внутренний» тональный сигнал системы и совершать вызовы с АТС так, как будто они являются ее локальными пользователями. Абоненту предоставляется тональный сигнал, после чего он должен ввести свой секретный код и нажать в конце кнопку #. Если секретный код правильный, абонент услышит тональный сигнал системы и сможет выполнять звонки.

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

Аргумент пароль - это числовой секретный код, который абонент должен ввести, чтобы получить возможность выполнять исходящие звонки. Используя этот синтаксис, все абоненты данного добавочного номера будут применять один пароль. Чтобы абоненты могли использовать DISA() без пароля, напишите вместо пароля строку no-password (пароль не нужен).

Аргумент контекст определяет контекст, в котором абонент будет набирать номер. Если контекст не задан, по умолчанию приложение DISA() использует контекст disa.

Аргумент callerid определяет новую строку Caller ID, которая будет использоваться для исходящего звонка.

Аргумент почтовыйящик - это номер почтового ящика (и необязательный контекст голосовой почты, утконтекст) голосовой почты. Если в указанном ящике голосовой почты есть новые сообщения, вызывающий абонент будет слышать прерывистый тональный сигнал. Кроме того, можно использовать альтернативный синтаксис и передавать вместо аргументов пароль и контекст имя глобального файла паролей. В каждой строке файла может содержаться или секретный код, или секретный код и контекст, разделенные символом вертикальной черты (| ). Если контекст не задан, приложение по умолчанию использует контекст disa.

Если регистрация абонента прошла успешно, приложение проводит синтаксический разбор набранного номера в заданном контексте:

; позволяем внешним абонентам звонить на номера 1-800, ; если они знают секретный код. Задаем им Caller ID, чтобы ; создать впечатление, что они звонят из компании [incoming]

exten => 123,1,DISA(4569,disa,"Company ABC" <(234) 123-4567>) [disa]

exten => _1800NXXXXXX,1,Dial(Zap/4/${EXTEN})

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

Authenticate(), VMAuthenticate()

DumpChan()

Выводит информацию о вызывающем канале в консоль

DumpCha.n([минимaльный_уровень_детaльности])

Выводит на экран информацию о вызывающем канале, а также список всех переменных канала. Если задан параметр минимальный_уровень_де- тальности, вывод отображается, только когда текущий уровень детальности сообщений такой же или выше.

Если задано несколько переменных канала, DumpChan() покажет только первые 1024 символа списка переменных вашего канала.

exten => s,1,Answer() exten => s,2,DumpChan()

exten => s,3,Background(enter-ext-of-person)

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

NoOp(), Verbose()

EAGI()

См. AGI().

Echo()

Воспроизводит вызывающему абоненту то, что он говорит

Echo()

Возвращает звуковой сигнал из канала назад в канал. Это приложение часто используется для тестирования задержки и качества голоса VoIP- линии. Вызывающий абонент может нажать кнопку #, чтобы выйти.

exten => 123,1,Echo()

exten => 123,2,Playback(vm-goodbye)

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

Milliwatt()

EndWhile()

Завершает цикл while

EndWhile()

Возвращается к ранее вызванному приложению While(). Полную информацию о том, как использовать цикл while, можно найти в описании приложения While().

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()

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

While(), ExitWhile(), GotoIf()

Exec()

Динамически выполняет приложение Asterisk

Ex.ec(имяприложения(aргументы))

Позволяет вызывать любое приложение, даже если оно не указано в коде диалплана. Выполняет выход так же, как и базовое приложение, или аварийно, если это приложение не найдено. Значение аргументы передается в вызываемое приложение.

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

exten => 123,1,Set(MYAPP=SayDigits(12345)) exten => 123,2,Exec(${MYAPP})

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

EVAL, TryExec(), ExecIf()

ExecIf()

Выполняет приложение Asterisk по условию

ExecIf(выражение,приложение, аргументы)

Если выражение истинно, выполняет заданное приложение, передавая в него аргументы, и возвращает результат. Больше информации о выражениях Asterisk можно найти в главе 6 или в файле channelvariables. txt в подпапке doc/ папки исходного кода Asterisk. Если выражение ложно, выполнение продолжается со следующего приоритета.

exten => 123,1,ExecIf($[ ${CALLERIDNUM} = 101 ],SayDigits,12345) exten => 123,2,SayDigits(6789)

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

EVAL, Exec(), TryExec()

ExitWhile()

Выполняет выход из цикла While() независимо от того, было удовлетворено условие или нет

ExitWhile()

Завершит цикл While() независимо от того, было ли удовлетворено условие в выражении.

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

While(), ContinueWhile(), EndWhile()

ExtenSpy()

Прослушивает аудиосигнал по добавочному номеру и может (опционально) посылать сигнал в вызывающий канал

ExtenSpy([добавочныйномер@контекст[, опции]])

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

При прослушивании канала могут выполняться следующие действия:

• Набор # циклически меняет уровень громкости.

• Набор * заставит приложение перейти к прослушиванию следующего доступного канала.

Параметр опции может содержать нуль или более следующих опций: b

Прослушивать только соединенные каналы.

g(группа)

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

^q

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

r[(базовоеимя)]

Записывает разговор, ведущийся по каналу, в папку очереди для записей разговоров (обычно это /var/spool/asterisk/monitor). Необязательный аргумент базовоеимя задает базовое имя файла для записей, значение по умолчанию - chanspy.

v([значение])

Настраивает громкость прослушиваемого аудиосигнала. Значение должно быть в диапазоне от 4 до -4. Отрицательное значение сделает звук тише, тогда как положительное - громче.

w

Режим шепота. Позволяет прослушивающему каналу «говорить» с прослушиваемым каналом. При этом ни один другой соединенный канал не сможет слышать этот разговор.

W

Закрытый режим шепота. Позволяет прослушивающему каналу «говорить» с прослушиваемым каналом без возможности слышать аудиосигнал из прослушиваемого канала.

; Прослушиваем каналы, созданные добавочным номером 125 ; в контексте lab

exten => 123,1,ExtenSpy(125@lab,w)

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

ChanSpy()

ExternalIVR()

Обеспечивает сопряжение с внешним IVR-приложением

ExternalIVR(команда[,аргумент1[,аргумент2...]])

Создает процесс для выполнения указанной совместимой с интерфейсом ExternallVR команды и запускает генератор для канала. Список воспроизведения генератора управляет внешним приложением, которое может добавлять и удалять записи посредством простых команд, передаваемых по STDOUT. Внешнее приложение будет получать уведомления обо всех DTMF-событиях, полученных по каналу, а также уведомление о том, что абонент повесил трубку. Приложение не будет принудительно завершаться, когда абонент повесил трубку. Спецификацию интерфейса ExternalIVR можно найти в папке исходного кода Asterisk в файле doc/externalivr.txt.

; Выполняем внешнюю программу IVR, передавая аргумент

exten => 123,1,ExternalIVR(test_program,${MYARGUMENT})

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

AGI()

FastAGI()

Удаленно выполняет совместимый с AGI сценарий

FastAGI(agl://имяхоста[:порт][/сценарий], аргументы)

Выполняет совместимую с AGI программу по сети. Это приложение очень похоже на AGI(), за исключением того что вызывает специально написанный сценарий FastAGI по сетевому соединению. Основные цели использования FastAGI - перенести требующие интенсивной работы ЦП AGI-сценарии на удаленные серверы и сократить время запуска AGI-сце- нария (программа FastAGI выполняется уже до того, как Asterisk соединится с ней).

FastAGI() пытается подключиться прямо к выполняющейся программе FastAGI, которая должна слушать соединения по заданному порту сервера, заданного параметром имяхоста. Если порт не задан, по умолчанию используется порт 4573. Если сценарий задан, он передается в программу FastAGI как переменная agi_network_script (сетевой agi-сцена- рий). Параметр аргументы будет передан в программу.

Пример сценария FastAGI можно найти в папке исходного кода Asterisk agi/fastagi-test. Он должен послужить вам хорошим образцом для написания собственных программ FastAGI.

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

; соединяемся с программой fastagi-test, которая уже ; должна выполняться на локальном компьютере exten => 123,1,Answer() exten => 123,2,FastAGI(agi://localhost)

; соединяемся со сценарием FastAGI на хосте calvin ; через порт 8000 и передаем имя сценария testing ; с аргументом 12345 exten => 124,1,Answer()

exten => 124,2,FastAGI(agi://calvin:8000/testing,12345)

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

AGI(), DeadAGI()

Festival()

Использует механизм речевого воспроизведения текста Festival для чтения текста вызывающему абоненту

Festival^^^, кнопкипрерывания])

Подключается к выполняемому локально серверу Festival, посылает ему текст и воспроизводит результирующий звуковой файл абоненту. Это приложение позволяет вызывающему абоненту нажимать определенную кнопку (заданную параметром кнопкипрерывания), чтобы немедленно прекратить воспроизведение и возвратить значение кнопкипреры- вания. Если для параметра кнопкипрерывания задано значение any (любой), Festival() передаст управление каналом добавочному номеру, введенному пользователем.

Более подробную информацию об использовании Festival с Asterisk можно найти в главе 14 и в файле README.festival, находящемся в подпапке contrib/ папки исходного кода Asterisk. Сервер Festival должен быть запущен до запуска Asterisk, и, прежде чем вызывать Festival(), необходимо ответить каналу, используя приложение Answer().

exten => 123,1,Answer()

exten => 123,2,Festival('This is sample speech from Festival',#)

Flash()

Посылает мгновенное событие сброса в магистральный канал Zap

Flash()

Посылает мгновенное событие сброса в Zap-канал. Это инструмент для тех, кто хочет перадресовывать вызовы и выполнять другие действия, которые требуют мгновенного сброса, через AGI-сценарий. В целом это довольно бесполезное приложение.

В случае успешного выполнения возвращает 0 или -1, если это не магистральный канал Zap.

exten => 123,1,Flash()

FollowMe()

Функциональность «найди меня/следуй за мной»

FollowMe(followmeid[, опции])

Это приложение пытается определить местоположение вызываемого абонента, набирая множество разных номеров последовательно или одновременно, как определено в файле followme.conf. Параметр followmeid идентифицирует раздел файла followme.conf, в котором определено, как должен быть найден этот вызываемый абонент. Параметр опции может содержать нуль или более следующих значений: s

Перед выполнением шагов функции «следуй за мной» воспроизводится сообщение о состоянии на входе.

a

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

n

Воспроизводится сообщение о состоянии «недоступен», если все шаги для установления связи с вызываемым абонентом исчерпаны или вызываемый абонент желает быть недоступным:

exten => 123,1,Answer() exten => 123,2,FollowMe(123,san) exten => 123,3,VoiceMail(123,u)

ForkCDR()

Создает дополнительную запись CDR из текущего вызова

ForkCDR([опции])

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

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

Если задана опция v, все переменные CDR из текущей записи будут унаследованы новой записью CDR.

exten => 123,1,Answer()

exten => 123,2,ForkCDR(v)

exten => 123,3,Playback(tt-monkeys)

exten => 123,4,Hangup()

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

Функция CDR, NoCDR(), ResetCDR()

GetCPEID()

Получает CPE ID от телефона, поддерживающего ADSI

GetCPEID()

Получает CPE ID и другую информацию и отображает ее в консоли Asterisk. Эта информация часто нужна, чтобы правильно настроить в файле zapata.conf операции при неподнятой трубке для телефонов, поддерживающих ADSI.

Возвращает -1 только в случае разрыва связи.

; используем этот добавочный номер, чтобы получить ; необходимую информацию для настройки ADSI-телефонов exten => 123,1,GetCPEID()

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

ADSIProg(), adsi.conf, zapata.conf

Gosub()

Переходит в новую точку, сохраняя адрес возврата

Gosub( контекст, добввочныйномер, приоритет) Gosub(добввочныйномер, приоритет) Gosub(приоритет)

Переходит в заданную точку, аналогично Goto(), за исключением того что Gosub() сохраняет адрес возврата, чтобы вернуться в него позже посредством вызова Return().

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

GosubIf(), Macro(), Goto(), Return(), StackPop()

GosubIf()

Переходит в новую точку по условию, сохраняя адрес возврата

GosubIf(условие?меткаеслиистинно:меткаеслиложно)

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

Слово метка (label) часто используется, чтобы обозначить возможность задать приоритет; добавочный номер и приоритет или контекст, добавочный номер и приоритет. Мы используем слово метка, чтобы не повторять каждый раз все возможные варианты.

; Задаем исходящий Caller*ID по умолчанию, ; если он не задан конкретным каналом.

exten => _NXXXXXX,1,GosubIf($["${CALLERID(num)}" = ""]?setcallerid,1) exten => _NXXXXXX,n,Dial(Zap/g1/${EXTEN})

exten => _1NXXNXXXXXX,1,GosubIf($[„${CALLERID(num)}" = „"]?setcallerid,1)

exten => _1NXXNXXXXXX,n,Dial(Zap/g1/${EXTEN})

exten => setcallerid,1,Set(CALLERID(num)=6152345678)

exten => setcallerid,n,Return

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

Gosub(), Return(), MacroIf(), IF, GotoIf(),

Goto()

Направляет вызов в заданный приоритет, добавочный номер и контекст

Goto([[к.онтек.ст₎]добaвочныйномер₎]приоритет) Goto( именованный_приоритет)

Передает управление текущим каналом в заданный приоритет, при этом могут быть заданы (необязательно) вызываемый добавочныйномер и контекст.

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

exten => 123,1,Answer()

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

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

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

exten => 123,5,Goto(3)

; то же самое, но с использованием именованного приоритета

exten => 124,1,Answer()

exten => 124,2,Set(COUNT=1)

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

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

exten => 124,5,Goto(repeat)

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

GotoIf(), GotoIfTime(), Gosub(), Macro()

GotoIf()

Выполняет переход по условию в заданный приоритет

GotoIf(условие? метка1:метка2)

Направляет вызов в метка1, если условие истинно, или в метка2, если условие ложно. Параметры метка1 и метка2 могут быть опущены (в этом случае просто не выполняется переход при том или ином условии), но не оба одновременно.

В качестве метки может использоваться одно из нижеперечисленного:

• Приоритет, например 10.

• Добавочный номер и приоритет, например 123,10.

• Контекст, добавочный номер и приоритет, например incoming,

123,10.

• Именованный приоритет в рамках того же добавочного номера, например passed.

Все типы меток описаны в данном примере:

[globals]

; присвоим TEST какое-то значение, кроме 101, чтобы ; увидеть, что делает GotoIf(), когда условие ложно TEST=101

[incoming] ; задаем переменную

; переходим в приоритет 10, если ${TEST} равна 101, ; в противном случае переходим в приоритет 20 exten => 123,1,GotoIf($[ ${TEST} = 101 ]?10:20) exten => 123,10,Playback(the-monkeys-twice) exten => 123,20,Playback(tt-somethingwrong)

; то же самое, что было сделано выше, но на этот раз ; зададим добавочный номер и приоритет для каждой метки exten => 124,1,GotoIf($[ ${TEST} = 101 ]?123,10:123,20)

; то же самое, что было сделано выше, но эти метки имеют ; контекст, добавочный номер и приоритет

exten => 125,1,GotoIf($[ ${TEST} = 101 ]?incoming,123,10:incoming,123,20)

; то же самое, что было сделано выше, но на этот раз ; будем переходить в именованные приоритеты exten => 126,1,GotoIf($[ ${TEST} = 101 ]?passed:failed) exten => 126,15(passed),Playback(the-monkeys-twice) exten => 126,25(failed),Playback(the-monkeys-twice)

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

Goto(),GotoIfTime(), GosubIf(), MacroIf()

GotoIfTime()

Выполняет переход по условию на основании времени и дня

GotoIfTime(время,дни_недели,дни_месяца,месяцы?метка)

Выполняет переход в заданный добавочный номер, если текущее время соответствует заданному. Каждый элемент может быть определен или как * (для всех случаев), или как диапазон. Аргументы приложения: время

Диапазоны времени в 24-часовом формате.

дни_недели

Дни недели (mon, tue, wed, thu, fri, sat, sun).

дни_месяца

Дни месяца (1-31).

месяцы

Месяцы (jan, feb, mar, apr и т. д.).

; Если мы открыты, переходим в контекст open ; Мы открыты с 9 утра до 6 вечера ; с понедельника по пятницу

exten => s,1,GotoIfTime(09:00-17:59,mon-fri,*,*?open,s,1)

; Также мы задерживаемся по вторникам и четвергам

exten => s,n,GotoIfTime(09:00-19:59,tue&thru,*,*?open,s,1)

; Также мы открыты с 9 утра до полудня по субботам exten => s,n,GotoIfTime(09:00-11:59,sat,*,*?open,s,1)

; Во все остальное время мы закрыты exten => s,n,Goto(closed,s,1)

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

GotoIf(), IFTIME

Hangup()

Безусловный разрыв связи по текущему каналу

Hangup( код-причина)

Безусловно разъединяет текущий канал. Для удаленного конца соединения будет задан параметр код-причина как причина завершения вызова, если он поддерживается каналом. По умолчанию параметр код-причина принимает значение 16 (нормальное завершение вызова). Допустимые значения параметра код-причина: 16

Нормальное завершение вызова.

17

Занято.

19

Нет ответа.

21

Вызов отклонен.

34

Линия перегружена.

exten => 123,1,Answer()

exten => 123,2,Playback(im-sorry)

exten => 123,3,Hangup()

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

Answer(), Busy(),Congestion()

HasNewVokemail()

Проводит проверку на наличие нового сообщения голосовой почты в указанном ящике голосовой почты

HasNewVoicemail(утящик[@контекст][:папка][, имяпеременной[, опции]])

Приложение было признано устаревшим и заменено функцией VMC0NNK ).

Л ^

Аналогично приложению HasVoicemail(). Это приложение задает для VMSTATUS значение 1 или 0, чтобы обозначить наличие нового (непрослу- шанного) сообщения в ящике голосовой почты, заданном аргументом утящик. Аргумент контекст соответствует контексту голосовой почты, а папка соответствует папке голосовой почты. Если папка голосовой почты не задана, используется папка по умолчанию, INBOX. Если присутствует аргумент имяпеременной, HasNewVoicemail() сохраняет в заданную переменную количество сообщений в заданной папке.

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

; проверяем наличие непрослушанного сообщения ; голосовой почты в INBOX почтового ящика 123 ; в контексте голосовой почты по умолчанию

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

HasVoicemail(), MailboxExists(), VMCOUNT

HasVoicemail()

Показывает, имеются ли сообщения голосовой почты в указанном ящике голосовой почты

HasVoicemail(vmящик[@контекст][:папка][|имяпеременной[, опции]])

Задает значение переменной канала HASVMSTATUS, чтобы информировать о наличии сообщений в ящике голосовой почты утящик. Аргумент контекст соответствует контексту голосовой почты, а папка - папке голосовой почты. Если папка не задана, используется папка по умолчанию, INBOX. Если передается аргумент имяпеременной, приложение сохраняет в этой переменной количество сообщений в указанной папке. Если для аргумента опции задано значение j, Asterisk в случае наличия голосовой почты в заданной папке будет направлять вызов в приоритет n + 101.

; проверяем, есть ли хотя бы одно сообщение ; голосовой почты в INBOX почтового ящика 123 ; в контексте голосовой почты по умолчанию exten => 123,1,Answer()

exten => 123,2,HasVoicemail(123@default,COUNT) exten => 123,3,GotoIf(${VMSTATUS}?1000) exten => 123,4,Playback(vm-youhave) exten => 123,5,Playback(vm-no) exten => 123,6,Playback(vm-messages) exten => 123,1000,Playback(vm-youhave) exten => 123,10O1,SayNumber($COUNT) exten => 123,1002,Playback(vm-messages)

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

HasNewVoicemail(), MailboxExists()

IAX2Provision()

Выполняет подготовку вызывающего IAXy-устройства

IAX2Provlslon([шаблон])

Выполняет подготовку к работе вызывающего устройства IAXy (предполагая, что вызывающий субъект - это IAXy) с использованием заданного шаблона. Если шаблон не задан, используется шаблон по умолчанию. Шаблоны подготовки IAXy описаны в конфигурационном файле iaxprov.conf.

; выполняем подготовку IAXy-устройств с использованием ; шаблона по умолчанию, когда они набирают этот ; добавочный номер

exten => 123,1,IAX2ProviSion(default)

ICES()

Выполняет потоковую передачу аудиоданных на сервер Icecast

ICES([конфигурация])

Выполняет потоковую передачу аудиоданных на сервер Icecast (или

совместимый) с помощью приложения ices.

См. файл-образец config в contrib/asterisk-ices.xml.

exten => 123,1,Answer()

exten => 123,n,ICES(/tmp/my-ices-config.xml)

ImportVar()

Задает переменную на основании переменной канала, полученной от другого канала

ImportVar(новаяпеременная=канал, .значение)

Задает переменной новаяпеременная значение, вычисленное для заданного канала (не текущего канала). Если новаяпеременная начинается с символа _, предполагается простое наследование. Если она начинается с символов _ _, предполагается множественное наследование. ; читаем информацию Caller ID из канала Zap/1 exten => 123,1,Answer()

exten => 123,n,ImportVar(cidinfo=Zap/1,CALLERID(all))

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

Set()

Log()

Протоколирует специальное сообщение из диалплана

Log(уровень| сообщение)

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

DEBUG (отладка)

Сообщение отладки. Обычно не регистрируется в системе, находящейся в производственной эксплуатации.

NOTICE (извещение)

Информационное сообщение. WARNING (предупреждение)

Обстоятельство, которое может быть серьезным, но не является ошибкой.

ERROR (ошибка)

Что-то пошло совсем не так.

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

NoOp(), Verbose()

LookupBlacklist()

Осуществляет поиск имени/номера Caller ID в черном списке

LookupBlacklist([опции])

Это приложение признано устаревшим и заменено приложением GotoIf(${BLACKLIST()}?контекст| добавочныйномер|приоритет)

Выполняет поиск номера Caller ID для активного канала в базе данных Asterisk (в семействе blacklist). Если номер Caller ID обнаружен в черном списке, Asterisk задает для переменной канала LOOKUPBL STATUS значение FOUND (найден). В противном случае для переменной задается значение NOTFOUND (не найден).

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

Чтобы пополнить черный список из CLI Asterisk, введите команду database put blacklist имя / номер.

; направляем номера черного списка в бесконечный цикл, ; в противном случае набираем номер, заданный переменной ; ${JOHN} exten => 123,1,Answer() exten => s,2,LookupBlacklist()

; если номер Caller ID обнаружен в черном списке, переходим к метке goaway exten => 123,n,GotoIf($["${LOOKUPBLSTATUS}" = "FOUND"]?goaway) ; в противном случае продолжаем и звоним Джону exten => 123,n,Dial(${JOHN}) exten => 123,n(goaway),Busy(5) exten => 123,n,Hangup()

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

BLACKLIST

LookupCIDName()

Выполняет поиск имени Caller ID в AstDB

LookupCIDName()

Это приложение было признано устаревшим и заменено приложением Set(CALLERID(имя)=${DB(cidname/${CALLERID(номер)})}).

Использует номер Caller ID активного канала для извлечения имени Caller ID из AstDB (семейство cidname). Это приложение не делает ничего, если по каналу не получен Caller ID. Это полезно, если вы не подписаны на доставку имени Caller ID или хотите менять имена Caller ID для некоторых входящих вызовов.

; ищем информацию Caller ID в AstDB и передаем ее ; на телефон Джейн exten => 123,1,Answer()

exten => 123,2,LookupCIDName() exten => 123,3,Dial(SIP/Jane)

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

DB

Macro()

Вызывает заранее определенный макрос диалплана

Macro( имямакроса, arg1, arg2...)

Выполняет макрос, определенный в контексте macro- имямакроса, переходя в добавочный номер s этого контекста и выполняя каждый шаг. Возвращается после того, как все шаги были выполнены. Вызывающий добавочный номер, контекст и приоритет хранятся в переменных ${MACRO_EXTEN}, ${MACRO_CONTEXT} и ${MACRO_PRIORITY} соответственно. Аргументы arg1, arg2 и т. д. становятся в контексте макроса переменными ${ARG1}, ${ARG2} и т. д.

Macro() завершается аварийно, если на любом из шагов макроса возник сбой или выявлен разрыв соединения. Если по завершении работы макроса задана переменная ${MACRO_OFFSET}, это приложение попытается продолжить выполнение с приоритета MACRO_OFFSET + n + 1, если таковой существует, или с n + 1 в противном случае. (В обоих случаях n означает текущий приоритет.)

Если внутри макроса вызывается приложение Goto() для перехода в контекст вне выполняющегося в настоящий момент макроса, макрос будет завершен, а управление передано в точку, указанную в параметрах Goto().

; определяем макрос для обратного счета

; от заданного значения

[macro-countdown]

exten => s,1,Set(COUNT=${ARG1})

exten => s,2,While($[ ${COUNT} > 0])

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

exten => s,4,Set(COUNT=$[ ${COUNT} - 1 ])

exten => s,5,EndWhile()

; вызываем наш макрос с двумя разными значениями [example]

exten => 123,1,Macro(countdown,10) exten => 124,1,Macro(countdown,5)

На время выполнения макрос становится текущим контекстом. Это означает, что в случае разрыва соединения, например, поиск добавочного номера h будет выполняться в макросе, а не в контексте, из которого этот макрос был вызван. Поэтому в макросе должны быть обязательно описаны все соответствующие добавочные номера (в AEL можно использовать catch).

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

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

MacroExit(), Goto(), Gosub(), главу 6

MacroExclusive()

Выполняет макрос исключительно для одного канала

MacroExclusive(имямакроса[,аргументы])

Выполняет заданный макрос, гарантируя, что одновременно этот макрос выполняется только одним каналом. Если другой канал уже выполняет этот макрос, MacroExclusive() приостановит выполнение данного канала до тех пор, пока тот канал не выйдет из макроса.

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

Macro()

MacroExit()

Явный выход из макроса

MacroExit()

Выполняет явный выход из макроса. Обычно Macro() автоматически завершается, выполнив все приоритеты. MacroExit() обеспечивает возможность завершить макрос раньше.

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

Macro()

MacroIf()

Вызывает заранее определенный макрос по условию

MacroIf(условие?макросеслиистинно, аргументы:макросеслиложно, аргументы)

Вычисляет условие, а затем выполняет макросеслиистинно или макросеслиложно. Во всем остальном, кроме вычисления условия, MacroIf() ведет себя идентично Macro().

; определяем макрос для обратного счета ; от заданного значения [macro-countdown]

exten => s,1,Set(COUNT=${ARG1})

exten => s,2,While($[ ${COUNT} > 0])

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

exten => s,4,Set(COUNT=$[ ${COUNT} - 1])

exten => s,5,EndWhile()

; определяем макрос для прямого счета

; от заданного значения

[macro-countup]

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

exten => s,2,While($[ ${COUNT} < ${ARG1}])

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

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

exten => s,5,EndWhile()

; вызываем наш макрос с двумя разными значениями [example]

exten => 123,1,MacroIf($[ ${foo} < 5 ]?countup,${foo}:countdown,${foo})

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

GotoIf(), GosubIf(), IF, глава 6

MailboxExists()

Выполняет переходы по условию,

если заданный ящик голосовой почты существует

MailboxExists(почтовыйящик[@контекст[, опции]])

Проверяет, существует ли в системе голосовой почты Asterisk почтовый ящик, определенный аргументом почтовыйящик. Если почтовый ящик находится не в контексте голосовой почты default, можно передать контекст для голосовой почты.

Это приложение задает переменную канала VMBOXEXISTSSTATUS. Если почтовый ящик существует, ей будет задано значение SUCCESS (успех). В противном случае она получит значение FAILED (неудача). Если в качестве параметра опции передается опция j, в случае существования почтового ящика, указанного аргументом почтовыйящик, приложение перейдет к приоритету n + 101 (где n - текущий приоритет).

exten => 123,1,Answer()

exten => 123,n,Set(MYMAILBOX=123@default)

exten => 123,n,MailboxExists(${MYMAILBOX})

exten => 123,n,GotoIf($["${VMBOXEXISTSSTATUS}" = "SUCCESS"]?exists)

exten => 123,n,Playback(im-sorry)

exten => 123,n,Hangup()

exten => 123,n(exists),Voicemail(u123)

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

HasVoicemail(), HasNewVoicemail()MeetMe()

Добавляет звонящего в конференцию MeetMe

MeetMe([номерконференции[, опции[, ПИН]]])

Добавляет звонящего в сеанс речевой конференц-связи, обозначенный аргументом номерконференции. Если номер конференции опущен, пользователю будет предложено его ввести.

Если передается аргумент ПИН, звонящий для входа в конференцию должен ввести ПИН-код.

Строка опции может содержать нуль или более символов из следующего списка:

a

Задается режим администрирования.

A

Задается маркированный режим.

b

Выполняется AGI-сценарий, заданный в переменной ${MEETME_AGI_ BACKGROUND}; по умолчанию это conf-background.agi. (Примечание: это не работает для ^-Zap-каналов в той же конференции.)

c

При входе в конференцию нового пользователя анонсируется количество пользователей.

d

Динамически добавляет пользователя в конференцию.

D

Динамически добавляет пользователя в конференцию, предлагая ввести ПИН-код.

e

Выбирается пустая конференция.

E

Выбирается пустая конференция, для входа в которую не требуется вводить ПИН-код.

F

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

Анонсируется вход/выход пользователя с суммарной информацией.

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

Устанавливается режим «только для прослушивания» (можно только слушать, не говорить).

Участник вводится в конференцию с изначально выключенным микрофоном.

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

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

Пользователь может выйти из конференции, нажав кнопку #.

Всегда предлагается ввести ПИН-код, даже если он задан.

Задается скрытый режим. В скрытом режиме Asterisk не подает звуковых сигналов при входе или выходе участников конференции.

Конференция записывается (как ${MEETME_RECORDINGFILE}, используя формат ${MEETME_RECORDINGFORMAT}). Имя файла по умолчанию - meetme-conf-rec-${CONFNO}-{UNIQUEID}, а формат по умолчанию - .wav.

При получении * предоставляется меню (меню пользователя или администратора в зависимости от того, отмечен ли пользователь как администратор).

t

Устанавливается режим «только для разговора» (можно только говорить, но не слушать).

T

Устанавливается выявление говорящего. Asterisk будет передавать в интерфейс Manager события, идентифицирующие канал говорящего. Говорящий также будет обозначен в выводе CLI-команды

meetme list.

w[(количествосекунд)]

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

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

X

Позволяет пользователю выходить из конференции, вводя действительный одноразрядный добавочный номер (задается посредством переменной ${MEETME_EXIT_CONTEXT}) или добавочный номер в текущем контексте, если эта переменная не определена.

1

Не воспроизводить начальное сообщение при входе в конференцию первого участника.

exten => 123,1,Answer()

; добавляем звонящего в конференцию номер 501 с ПИН-кодом 1234 exten => 123,2,MeetMe(501,DpM,1234)

Для обеспечения работы конференц-связи MeetMe должен быть установлен подходящий интерфейс синхронизации Zaptel.

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

MeetMeAdmin(), MeetMeCount()

MeetMeAdmin()

Осуществляет администрирование конференции MeetMe

MeetMeAdmin(номерконференции,команда[, пользователь])

Выполняет указанную команду администрирования MeetMe для заданной конференции. Для некоторых команд можно задать пользователя, для которого должна быть выполнена указанная команда. Команда может принимать одно следующих значений:

e

Исключить пользователя, присоединившегося к конференции последним.

Исключить из конференции указанного пользователя.

K

Исключить из конференции всех пользователей.

Снять блокировку конференции.

Блокировать конференцию.

Включить микрофон заданного пользователя.

Выключить микрофон заданного пользователя.

Включить микрофоны всех участников конференции.

Выключить микрофоны всех участников конференции, не являющихся администраторами.

Сбросить все настройки громкости для заданного пользователя. Сбросить все настройки громкости для всех участников. Уменьшить громкость разговора для всей конференции.

S

Увеличить громкость разговора для всей конференции. Уменьшить громкость разговора для заданного пользователя. Увеличить громкость разговора для заданного пользователя. Уменьшить громкость прослушивания для заданного пользователя.

U

Увеличить громкость прослушивания для заданного пользователя.

Уменьшить громкость прослушивания для всей конференции.

Увеличить громкость прослушивания для всей конференции.

; выключить звук конференции 501 exten => 123,1,MeetMeAdmin(501,N)

; исключить пользователя 1234 из конференции 501 exten => 124,1,MeetMeAdmin(501,k,1234)

Список участников конференции можно получить с помощью CLI-команды Asterisk meetme list или используя интерфейс Asterisk Manager.

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

MeetMe(), MeetMeCount()

MeetMeCount()

Подсчитывает количество пользователей,

принимающих участие в конференции MeetMe

MeetMeCount(номерк.онференции[, переменная])

Воспроизводит количество пользователей, принимающих участие в конференции MeetMe, заданной аргументом номерконференции. Если задана переменная, значение будет сохранено в эту переменную без воспроизведения.

; подсчитываем количество пользователей, принимающих ; участие в конференции 501, и присваиваем это число ; переменной ${COUNT} exten => 123,1,MeetMeCount(501,C0UNT)

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

MeetMe(), MeetMeAdmin()

Milliwatt()

Генерирует тональный сигнал частотой 1000 Гц

Milliwatt()

Это приложение генерирует постоянный тональный сигнал частотой 1000 Гц с уровнем 0 дБм (plaw). Это приложение часто используется для тестирования звуковых характеристик конкретного канала.

; генерируем тональный сигнал частотой 1000Гц exten => 123,1,Milliwatt()

Пожалуйста, обратите внимание, что существует сервис, ис- I пользуемый поставщиками услуг связи для тестирования потерь в линиях и получивший в отрасли название «1000 циклов» . Суть в том, что частота тонального сигнала, передаваемого оборудованием поставщика услуг, на самом деле составляет 1004 Гц, поэтому, если необходимо протестировать потери в аналоговой линии из Asterisk, Milliwatt() может не обеспечить точных результатов.

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

Echo(), Playtones()

MixMonitor()

Записывает разговор по каналу в фоновом режиме, синхронно объединяя оба направления разговора

MixMonitor(имяфайла.ext, опции, команда)

Записывает аудиосигнал в текущем канале в заданный файл. Если в качестве аргумента имяфайла задан полный путь, MixMonitor() использует этот путь; в противном случае создает файл в заданной в asterisk.conf папке для записи разговоров.

Если задана, команда будет выполнена, когда запись будет завершена из-за разрыва соединения или в результате вызова StopMixMonitor(). Параметр опции может содержать нуль или более следующих опций:

a

Разговор дописывается в конец файла, перезаписи файла при этом не происходит.

b

Разговор сохраняется, только если канал соединен.

Сюда не относятся конференции или звуковые файлы, воспроизводимые для каждой соединенной стороны.

v(x)

Громкость прослушивания меняется в x раз (диапазон от -4 до 4).

V(x)

Громкость речи меняется в x раз (диапазон от -4 до 4).

W(x)

Громкость прослушивания и речи меняется в x раз (диапазон от -4 до 4).

; Записываем разговор по каналу

exten => 123,1,MixMonitor(/var/lib/asterisk/sounds/123.wav)

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

Monitor(), StopMixMonitor(), PauseMonitor(), UnpauseMonitor()

Monitor()

Отслеживает (записывает) разговор по текущему каналу

Monitor([формат_файла[:базовыйиг1][, базовое_имяфайла][, опции]])

Начинает запись разговора по каналу. Входные и выходные речевые пакеты канала записываются в файлы до тех пор, пока не будет разорвана связь по каналу или запись не будет остановлена приложением

StopMonitor().

Monitor() принимает следующие аргументы:

формат_файла

Определяет формат файла. Если не задан, по умолчанию используется wav.

базовое_имяфайла

Если задан, меняет используемое имя файла на заданное.

опции

Может быть задана одна опция из двух:

m

Когда запись закончится, выполнить слияние двух файлов, содержащих список приоритетов, в один и удалить их. Если задана переменная ${MONITOR_EXEC}, вместо soxmix будет выполнено указанное в ней приложение, и исходные файлы не будут удалены автоматически. soxmix (или ${MONITOR_EXEC}) принимает три аргумента: два файла приоритетов и имя создаваемого объединенного файла, которое аналогично именам исходных файлов, но без указателей in/out. Если задана переменная ${MONITOR_EXEC_ARGS}, в качестве дополнительных аргументов в ${MONITOR_EXEC} будет передано содержимое. И ${MONITOR_EXEC}, и флаг m можно задать из интерфейса администратора.

b

Не начинать запись, пока канал не будет соединен с другим каналом.

exten => 123,1,Answer() ; записываем разговор по текущему каналу ; и объединяем звуковые каналы в конце записи exten => 123,2,Monitor(wav,monitor_test,mb) exten => 123,3,SayDigits(12345678901234567890) exten => 123,4,StopMonitor()

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

ChangeMonitor(), StopMonitor(), MixMonitor(), PauseMonitor(), UnpauseMonitor()

MorseCode()

Воспроизводит код Морзе

MorseCode(строка)

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

MORSEDITLEN

Длина ТОЧКИ в миллисекундах. Значение по умолчанию - 80 мс.

Длительность всех остальных тональных сигналов и пауз определена в международном стандарте кода Морзе относительно длительности ТОЧКИ, и поэтому все остальные длительности будут настраиваться соответствующим образом.

MORSETONE

Частота, в герцах (Гц), которая будет использоваться. Значение по умолчанию - 800 Гц.

; тире-точка-тире точка-точка точка-точка-точка-точка-тире

; тире-точка-тире точка-точка-тире точка-тире

exten => 123,1,Answer()

exten => 123,2,MorseCode(KI4KUA)

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

SayAlpha(), SayPhonetic()

MP3Player()

Воспроизводит MP3-фaйл или поток

MP3Player(местоположение)

Использует программу mpg123 для воспроизведения вызывающему абоненту файла из заданного местоположения. В качестве местоположения может быть задано или имя файла, или действительный URL. Вызывающий абонент может прекратить воспроизведение, нажав любую кнопку.

Чтобы это приложение работало правильно, должна быть установлена соответствующая версия mpg123. В настоящее время Asterisk лучше всего работает с mpg123-0.59r. Другие версии могут обеспечить результаты, не вполне соответствующие тому, что требуется.

exten => 123,1,Answer()

exten => 123,2,MP3Player(test.mp3)

exten => 123,1,Answer()

exten => 123,2,MP3Player(http://example.com/test.mp3)

MusicOnHold()

Неопределенно долго воспроизводит музыку во время ожидания

MusicOnHold(класс)

Воспроизводит музыку во время ожидания, заданную аргументом класс, соответственно настройкам файла musiconhold.conf. Если аргумент опущен, будет использоваться музыка во время ожидания по умолчанию. Задать класс музыки по умолчанию для канала можно с помощью функции диалплана MUSICCLASS.

; перенаправляем вызовы систем продаж по телефону на этот

; добавочный номер, чтобы занять их

exten => 123,1,Answer()

exten => 123,n,Playback(tt-allbusy)

exten => 123,n,MusicOnHold(default)

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

SetMusicOnHold(), WaitMusicOnHold(), MUSICCLASS

NBScat()

Воспроизводит локальный NBS-поток

NBScat()

Использует программу nbscat8k для прослушивания локального потока NBS (Network Broadcast Sound - широковещательная сетевая передача звука). (Более подробную информацию можно найти в модуле nbs сервера Subversion компании Digium.) Вызывающий абонент может прекратить воспроизведение, нажав любую кнопку. При разрыве соединения возвращает -1. exten => 123,1,Answer() exten => 123,2,NBScat()

NoCDR()

Отключает запись параметров вызовов для текущего звонка

NoCDR()

Отключает запись CDR для текущего звонка.

; не протоколировать звонки на 555-1212

exten => 5551212,1,Answer()

exten => 5551212,2,NoCDR()

exten => 5551212,3,Dial(Zap/4/5551212)

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

AppendCDRUserField(), ForkCDR(), SetCDRUserField()

NoOp()

Не производит никаких действий

NoOp(текст)

Ничего не делает, это просто заполнитель. Данное приложение часто используется как инструмент отладки. Если уровень детальности сообщений ядра Asterisk равен 3 или более, Asterisk обрабатывает и выводит каждую строку диалплана перед ее выполнением. Это означает, что любые аргументы, переданные в приложение NoOp() (в параметре текст), выводятся в консоли. Опытный администратор Asterisk может использовать вывод консоли для отладки диалплана. exten => 123,1,NoOp(CallerID is ${CALLERID})

Нет необходимости заключать текст в кавычки. Если кавычки помещены в круглые скобки, они будут выведены в консоли.

Когда использовать NoOp() и Verbose()

Разница между Verbose() и NoOp() невелика. Приведем здесь некоторые соображения по поводу того, как разобраться, в какой ситуации следует использовать эти приложения. Приложение Verbose() пригодится, если надо что-то вывести в консоль. Используя команду set verbose (с указанием требуемого уровня детальности, от 0 до 4), можно настроить вывод так, чтобы на экране отображались не все операции системы, а лишь те, которые имеют такой же или меньший уровень детальности. (На самом деле можно задать любую детальность. Команда set verbose 999 будет прекрасно работать, но мы не нашли вывода с уровнем детальности выше, чем 4, поэтому на данный момент задавать детальность больше 4 просто не имеет смысла.) Это означает, что можно выводить всевозможную информацию, имеющую отношение к тестируемому разделу кода, без необходимости просматривать другие сообщения системы. Если записать в диалплане следующее:

exten => _X.,n,Verbose(2, ${SOME_VAR}) можно будет в CLI задать детальность 2 или меньше (core set verbose 2) и просматривать вывод различных вызовов Verbose(), но очень мало другой информации.

Подробнее об использовании Verbose() можно будет прочитать в данном приложении ниже, в посвященном ему разделе. При-

ложение NoOp() лучше всего использовать как заполнитель. Например, если в диалплане имеется Goto() с использованием метки приоритета, NoOp() можно применять как точку перехода из этого приложения. Например,

exten => _X.,n(call_forward),NoOp()

является превосходным маркером для указания перехода в ди- алплане в определенную точку. Из этой точки можно продолжать выполнение любой логики, которую требуется применить к этой части добавочного номера (судя по метке, речь идет о пересылке вызова). NoOp() применяется, когда вы не знаете, какие действия придется выполнять за этой меткой, и чтобы гарантированно не менять в коде саму метку. Оно никогда не будет делать ничего другого, кроме как предоставлять точку перехода для Goto(). Поэтому NoOp() можно помещать куда угодно и быть увереннным, что это не станет причиной какого-либо неожиданного поведения.

Если вы ничего не поняли, виною наша неспособность правильно описать ситуацию. Поэкспериментируйте с Verbose() и NoOp() в своем диалплане (их можно использовать где угодно) - и вы быстро разберетесь в том, как они могут помочь (особенно если вы, как и мы, допускаете много синтаксических ошибок).

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

Verbose(), Log()

Page()

Открывает одностороннюю аудиосвязь с несколькими телефонами

Page(технология/канал1[&технология/канал2]&[...][&технология/каналN][\опции])

Размещает исходящие вызовы абонентов в каналах, заданных аргументами технология/канал, и вводит их в конференцию как участников с выключенными микрофонами. Исходный вызывающий абонент помещается в эту конференцию как единственный участник, который может говорить. Когда он покидает конференцию, она уничтожается. Могут быть заданы следующие опции: d

Двусторонняя аудиосвязь. Обеспечивает возможность перечисленным в приложении Page() людям отвечать вызывающему абоненту.

q

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

r

Записывать сообщение. Больше информации можно найти в описании опции r для команды MeetMe.

exten => 123,1,Page(SIP/101&SIP/102&IAX2/iaxy123)

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

MeetMe()

Park()

Выполняет парковку текущего вызова

Park()

Выполняет парковку текущего вызова (обычно в сочетании с контролируемой переадресацией для определения номера парковочного слота). Это приложение всегда регистрируется системой внутренне и не требует явного введения в диалплан, хотя необходимо включить контекст parkedcalls. Настройки парковки задаются в файле features.conf. ; явно паркуем вызывающего абонента include => parkedcalls exten => 123,1,Answer() exten => 123,n,Park()

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

ParkAndAnnounce(), ParkedCall()

ParkAndAnnounce()

Выполняет парковку текущего вызова и объявляет о вызове по

заданному каналу

PaгkAndAnnounce(шаблон, времяожидания, к.анал[, котекст_возврата])

Выполняет парковку текущего вызова в парковочный слот и объявляет о вызове по заданному каналу. Шаблон - это разделенный двоеточиями список файлов, которые должны быть воспроизведены; слово PARKED (припаркован) заменяется номером слота парковки вызова. Аргумент времяожидания - это время в секундах, через которое вызов возвратится в контекст_возврата. Аргумент канал определяет канал, на который необходимо позвонить, чтобы сделать объявление. Console/dsp вызывает консоль. контекст_возврата - это метка в стиле Goto() для возвращения вызова по истечении времени ожидания, которой по умолчанию является приоритет n + 1 (где n - текущий приоритет) в контексте контекст_возврата.

include => parkedcalls exten => 123,1,Answer()

exten => 123,2,ParkAndAnnounce(vm-youhave:a:pbx-transfer:at:vm-extension: PARKED,120,Console/dsp)

exten => 123,3,Playback(vm-nobodyavail) exten => 123,4,Playback(vm-goodbye) exten => 123,5,Hangup()

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

Park(), ParkedCall()

ParkedCall()

Отвечает на припаркованный вызов

ParkedCall(парковочныйслот)

Соединяет вызывающего абонента с припаркованным вызовом, находящимся в парковочном слоте, который обозначен аргументом парковочныйслот. Это приложение всегда регистрируется системой внутренне и не требует явного добавления в диалплан, хотя необходимо включить контекст parkedcalls.

; ответить на вызов, припаркованный ; в парковочном слоте 701 exten => 123,1,Answer() exten => 123,2,ParkedCall(701)

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

Park(), ParkAndAnnounce()

PauseMonitor()

Приостанавливает запись разговора по каналу

PauseMonitor()

Временно приостанавливает отслеживание (запись) текущего канала

exten => 123,1,Answer()

exten => 123,n,Monitor(wav,monitor_test)

exten => 123,n,Playback(demo-congrats)

; временно приостанавливаем запись, пока собираем секретную информацию exten => 123,n,PauseMonitor() exten => 123,n,Read(NEWPASS,vm-newpassword) exten => 123,n,SayDigits(${NEWPASS}) exten => 123,n,UnpauseMonitor() exten => 123,n,Dial(${JOHN})

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

Monitor(),StopMonitor(), UnpauseMonitor()

PauseQueueMember()

Временно блокирует участника обработки очереди входящих вызовов

PauseQueueMember([имяочереди],интерфейс[, опции])

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

Это приложение по завершении выполнения задает для переменной канала PQMSTATUS значение PAUSED (приостановлен) или NOTFOUND (не найден). Если для параметра опции задано значение j и данного интерфейса нет в указанной очереди или если очередь не задана и интерфейса нет ни в одной очереди, выполнение перейдет в приоритет n + 101 (где n - текущий приоритет), если таковой существует. exten => 123,1,PauseQueueMember(,SIP/300) exten => 124,1,UnpauseQueueMember(,SIP/300)

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

UnpauseQueueMember()

Pickup()

Отвечает на звонок с другого телефона

Pickup(добавочныйномер[@контекст][&добавочныйномер2[@контекст2][...])

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

Существует также специальный контекст PICKUPMARK. Если он задан, Pickup будет находить первый вызывающий канал, для которого значение переменной канала PICKUPMARK соответствует значению аргумента

добавочныйномер.

Playback()

Воспроизводит заданный аудиофайл вызывающему абоненту

Playback(имяфайла[&имяфайла2...][, опции])

Воспроизводит заданный посредством аргумента имяфайла файл вызывающему абоненту. Значение имяфайла не должно включать расширения файла, поскольку Asterisk автоматически выберет аудиофайл, преобразование которого пройдет с минимальными затратами. Также может быть включено нуль или более опций. Если задана опция skip (пропустить), сообщение воспроизводится только для канала, находящегося в состоянии «отвечено» (то есть если установлено соединение). При заданной опции skip приложение немедленно возвращается, если канал не соединен. В противном случае, если не задана опция noanswer, канал будет переведен в состояние «отвечено» и после этого будет воспроизведен аудиофайл. (Не все каналы поддерживают воспроизведение сообщений, когда соединение еще не установлено.) Если в качестве одной из опций передана j и указанного файла не существует, это приложение переходит в приоритет n + 101 (где n - текущий приоритет), если таковой существует. exten => 123,1,Answer() exten => 123,n,Playback(tt-weasels)

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

Background(), ControlPlayback()

Playtones()

Воспроизводит набор тонов

Playtones(набортонов)

Воспроизводит набор тонов. После начала воспроизведения тонов выполнение немедленно продолжается со следующего шага. Аргумент набортонов - это или имя тона, определенное в конфигурационном файле indications.conf, или заданный список частот и длительностей. Описание спецификации набора тонов приведено в indications.conf.

Для прекращения воспроизведения тонов используется приложение

StopPlaytones().

; воспроизводить сигнал "занято" в течение двух секунд,

; a затем еще две секунды - сигнал перегрузки линии

exten => 123,1,Playtones(busy)

exten => 123,2,Wait(2)

exten => 123,3,StopPlaytones()

exten => 123,4,Playtones(congestion)

exten => 123,5,Wait(2)

exten => 123,6,StopPlaytones()

exten => 123,7,Goto(1)

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

StopPlaytones(), indications.conf, Busy(), Congestion(), Progress(), Ringing()

PrivacyManager()

Требует от вызывающего абонента ввода номера телефона, если не

получена информация Caller ID

PrivacyManager([maxretries[,minlength[, опции]]])

Если Caller ID (ID звонящего) не получен, это приложение отвечает каналу и просит вызывающего абонента ввести его номер телефона. По умолчанию абоненту дается три попытки.

PrivacyManager() задает для переменной канала PRIVACYMGRSTATUS значение SUCCESS или FAILURE. Если Caller ID поступает по каналу, PrivacyManager() не выполняет никаких действий.

Если для параметра опции задано значение j и вызывающий абонент не смог ввести свой номер Caller ID, обработка вызова продолжится в приоритете n + 101 (где n - текущий приоритет).

Конфигурационный файл privacy.conf меняет функциональность приложения PrivacyManger(). Он содержит следующие две строки: maxretries (максимум попыток)

Задает максимальное число попыток, которое может сделать вызывающий абонент для ввода номера Caller ID (по умолчанию 3).

minlength (минимальная длина)

Задает минимально допустимое количество символов во вводимом номере Caller ID (по умолчанию 10).

Настройки maxretries и minlength также могут быть переданы в приложение в качестве параметров. Параметры, передаваемые в приложение, переопределяют любые настройки в файле privacy.conf.

exten => 123,1,Answer()

exten => 123,n,PrivacyManager()

exten => 123,n,GotoIf($["${PRIVACYMGRSTATUS}" = "FAILURE"]?bad)

exten => 123,n,Dial(Zap/1)

exten => 123,n,Hangup()

exten => 123,n(bad),Playback(im-sorry)

exten => 123,n,Playback(vm-goodbye)

exten => 123,n,Hangup()

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

Zapateller()

Progress()

Служит индикатором хода выполнения вызова

Progress()

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

; предоставляем информацию о ходе выполнения вызывающему ; каналу, ожидаем 5 с, а затем отвечаем на звонок exten => 123,1,Progress() exten => 123,n,Wait(5) exten => 123,n,Answer()

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

Busy(),Congestion(), Ringing(), Playtones()

Queue()

Помещает текущий вызов в заданную очередь вызовов

Queue(имяочереди[, опции[, URL [, переопределитьприветствие[, времяожидания[, Лй!]]]]])