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

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

Сбой.

0

Успешная запись.

SAY ALPHA

SAY ALPHA номер коды_выхода

Проговаривает заданную строку символов, возвращаясь досрочно в случае получения по каналу заданных DTMF-кодов.

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

-1

Ошибка или разрыв соединения.

0

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SAY DATE

SAY DATE дата коды_выхода

Проговаривает дату, заданную аргументом дата, возвращаясь досрочно в случае получения по каналу заданных DTMF-кодов. дата - это количество секунд, прошедших с 00:00:00 по Гринвичу (Coordinated Universal Time, UTC) 1 января 1970 года.

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

-1

Ошибка или разрыв соединения.

0

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SAY DATETIME

SAY DATETIME датавремя коды_выхода [формат] [часовойпояс]

Проговаривает дату и время, заданные аргументом датавремя, возвращаясь досрочно в случае получения по каналу заданных DTMF-кодов. датавремя - это количество секунд, прошедших с 00:00:00 по Гринвичу 1 января 1970 года. Необязательный аргумент формат - это формат, в котором должно проговариваться время. (Полное описание опций формата можно найти в файле voicemail.conf.) По умолчанию формат принимает значение ABdY digits/at' IMp. Допустимые значения аргумента часовойпояс можно найти по адресу /usr/share/zoneinfo/. По умолчанию значение агрумента часовойпояс принимается равным часовому поясу по умолчанию сервера Asterisk. Возвращаемые значения: -1

Ошибка или разрыв соединения.

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SAY DIGITS

SAY DIGITS номер коды_выхода

Проговаривает заданную строку цифр, возвращаясь досрочно в случае получения по каналу заданных DTMF-кодов.

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

-1

Ошибка или разрыв соединения.

0

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SAY NUMBER

SAY NUMBER номер коды_выхода

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

-1

Ошибка или разрыв соединения.

0

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SAY PHONETIC

SAY PHONETIC строка коды_выхода

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

Ошибка или разрыв соединения.

0

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SAY TIME

SAY TIME время коды_выхода

Проговаривает время, указанное параметром время, возвращаясь досрочно в случае получения по каналу любого из заданных DTMF-ко- дов. время - это количество секунд, прошедших с 00:00:00 по Гринвичу 1 января 1970 года.

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

-1

Ошибка или разрыв соединения.

0

Воспроизведение завершено без прерывания кодом выхода.

значение

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

SEND IMAGE

SEND IMAGE изображение

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

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

-1

Ошибка или разрыв соединения.

0

Изображение отправлено или канал не поддерживает отправку изображения.

SEND TEXT

SEND TEXT "текст_для_отправки"

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

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

-1

Ошибка или разрыв соединения.

Текст отправлен или канал не поддерживает отправку текста.

SET AUTOHANGUP

SET AUTOHANGUP время

Обусловливает автоматическое разъединение связи по каналу по истечении количества секунд, заданного параметром время. Конечно, разрыв может произойти и раньше. Задавая для параметра время значение 0, можно отключить возможность autohangup (автоматическое разъединение) для данного канала. Возвращаемое значение: 0

Возможность автоматического разъединения установлена.

SET CALLERID

SET CALLERID номер

Меняет идентификатор вызывающего абонента текущего канала. Возвращаемое значение:

1

Идентификатор вызывающего абонента задан.

SET CONTEXT

SET CONTEXT контекст

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

0

Контекст задан.

SET EXTENSION

SET EXTENSION добавочныйномер

Меняет добавочныйномер, в который перейдет выполнение после выхода из приложения AGI. Возвращаемое значение:

0

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

SET MUSIC ON

SET MUSIC ON [on|off] [класс]

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

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

0

Всегда возвращает 0.

SET PRIORITY

SET PRIORITY приоритет

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

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

0

Приоритет задан.

SET VARIABLE

SET VARIABLE имяпеременной значение

Задает или обновляет значение переменной, заданной параметром имя- переменной. Если переменной не существует, она создается.

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

1

Переменная задана.

STREAM FILE

STREAM FILE имяфайла коды_выхода [фрагмент_смещения]

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

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

0

Воспроизведение завершено, коды введены не были.

-1

Ошибка или разрыв соединения.

значение

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

TDD MODE

Активирует и отключает возможность взаимодействия со слуховыми аппаратами (Telecommunications Devices for the Deaf, TDD) для этого канала.

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

0

Канал не поддерживает TDD.

1

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

VERBOSE

VERBOSE сообщение уровень

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

Всегда возвращает 0.

WAIT FOR DIGIT

WAIT FOR DIGIT времяожидания