Джим Меггелен - 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 времяожидания
