Воспроизведение
Осуществляет воспроизведение аудио-файла абоненту.
Может инициировать как синхронное воспроизведение, так и фоновое воспроизведение.
Управление фоновым воспроизведением допускает паузы и остановки.
Возобновление воспроизведения возможно с указанной миллисекунды конкретного файла.
Каждый компонент Воспроизведение определяет Слой - некий идентификатор звуковой дорожки. Количество одновременных дорожек может быть до 16. При воспроизведении они микшируются. Для каждого слоя настраиваются независимые режимы воспроизведения.
Режимы воспроизведения
| Режим | Описание |
|---|---|
Файл полностью |
Останавливает все воспроизведения в указанном слое и проигрывает конкретный файл для прослушивания. Файл проигрывается полностью от начала до конца и после этого осуществляется переход на следующий компонент. |
Предпрослушивание |
Останавливает все воспроизведения в указанном слое и проигрывает первые N секунд выбранного файла. По истечению времени проигрывание останавливается и передается управление следующему компоненту |
Файл + дополнительное время |
Останавливает все воспроизведения в указанном слое и проигрывает конкретный файл для прослушивания. Файл проигрывается полностью от начала до конца и после этого делается пауза перед переходом на следующий компонент (например, для ожидания ответа выбора пункта меню) |
Список файлов |
Останавливает все воспроизведения в указанном слое и проигрывает конкретный список файлов для прослушивания. Файлы проигрывается полностью от начала до конца и после этого осуществляется переход на следующий компонент. |
Фоновое воспроизведение |
Определение каталога с файлами или конкретного файла который будет воспроизводится в указанном слое. Переход на следующий элемент осуществляется сразу. |
Остановка фона |
Останавливает проигрывание фонового воспроизведения в указанном слое, если оно было запущено ранее |
Изменить громкость фона |
Изменение громкости фонового воспроизведения в указанном слое. Прерывание проигрывания не будет |
Громкость указывается в целых числах как делитель относительно исходного файла. Допустимые значения - 1,2,3,4,5 и т.д., где 1 = громкость исходного файла, 2 = в 2 раза тише. Если надо планомерно погасить громкость фона, то надо поставить несколько компонент Воспроизведение - Изменить громкость фона с указанием в качестве громкости абсолютные увеличивающиеся значения (между компонентами поставить компонент Пауза в 30-50мс).
|
Файлы воспроизведения
Воспроизведение осуществляется в PCM 8 Кгц Моно. Если файл другого формата, то перед воспроизведением он перекодируется.
| В высоконагруженных IVR сценариях рекомендуется указывать компоненту Воспроизведение только wav файлы в указанном формате. Это сильно снизит загрузку системы на перекодирование. |
Поддерживаемые входные форматы файлов:
-
WAV файлы в кодировках:
PCM Стерео, Моно, 16 бит, 8000, 11025 16000, 22050, 24000, 32000, 44100, 48000 Гц G.711 alaw, ulaw, 8000 Гц MS GSM, 65 бит, 8000 Гц
-
MP3 файлы любой bitrate
-
Другие форматы звуковых файлов не поддерживаются.
Общие Свойства компонента
| Название | Описание |
|---|---|
Слой |
Указание слоя воспроизведения (текстовый идентификатор в рамках сценария) |
Режим |
Выбор одного из режимов. Подробно описано в Режимы воспроизведения выше. Специализированные поля каждого из режимов описаны ниже в Дополнительные свойства компонента |
Буфер для DTMF |
Переменная, куда будут сохраняться полученные DTMF символы. |
Очистить буфер |
|
Количество символов |
Ограничение количества символов DTMF. По достижению будет остановлено воспроизведение и переход на следующий компонент |
Символы прерывания |
Символы или их наборы, которые закончат выполнение текущего компонента. Разделение наборов через пробел или запятую. |
Вырезать символы прерывания |
Выключатель операции удаления символов прерывания из |
Переход |
Следующий Компонент сценария. Переход по умолчанию |
Переход, ошибка |
Следующий Компонент сценария, если возникла ошибка воспроизведения |
Описание |
Описание компонента |
Дополнительные свойства компонента
Режим Файл полностью
Производит воспроизведение аудио-файла с ожиданием его завершения. Если в качестве параметров указан каталог, то производится воспроизведение случайного файла из каталога.
| Название | Описание |
|---|---|
Файл |
Файл для воспроизведения.Может быть выбран в одном из режимов:
|
Громкость |
Делитель громкости исходного файла |
Начало, мс |
Время, с которого необходимо начать проигрывать файл в мс |
Конец,мс |
Время, на котором необходимо закончить проигрывать файл в мс |
Режим Предпрослушивание
Производит воспроизведение с ожиданием его завершения и ограничением по времени воспроизведения.
| Название | Описание |
|---|---|
Файл |
Файл для воспроизведения.Может быть выбран в одном из режимов:
|
Время,с |
Ограничение на время воспроизведения, в сек. |
Начало, мс |
Время, с которого необходимо начать проигрывать файл |
Конец,мс |
Время, на котором необходимо закончить проигрывать файл |
Режим Файл + дополнительное время
Производит воспроизведение с ожиданием его завершения и ожиданием дополнительной паузы. Обычно используется для дополнительного ожидания реакции абонента вводом DTMF символов.
| Название | Описание |
|---|---|
Доп.время,с |
Таймаут дополнительной паузы после завершения воспроизведения, в сек. |
Файл |
Файл для воспроизведения.Может быть выбран в одном из режимов:
|
Начало, мс |
Время, с которого необходимо начать проигрывать файл |
Конец,мс |
Время, на котором необходимо закончить проигрывать файл |
Громкость |
Делитель уменьшения громкости первоначального файла |
Режим Список файлов
Производит воспроизведение последовательного списка файлов.
| Название | Описание |
|---|---|
Файлы (JSON-список) |
Аргумент, содержащий JSON-структуру в виде массива строк, каждая из которых представляет путь к файлу. Файлы воспроизводятся в порядке указания в списке. |
Громкость |
Делитель уменьшения громкости |
Пример
Проиграть три файла подряд. Файлы находятся в директории syn_media().
С помощью Выражения значение аргумента может задаваться так:
"[\""+escape(makepath(syn_media(), "expressions/двести.wav"))+"\", \""+escape(makepath(syn_media(), "expressions/тысяч.wav"))+"\", \""+escape(makepath(syn_media(), "expressions/рублей.wav"))+"\"]"
Режим Фоновое воспроизведение
Добавляет слой и инициирует фоновое воспроизведение в нем, сразу передавая управление следующему компоненту. Если в указанном слое уже производится воспроизведение, то оно автоматически прерывается.
| Название | Описание |
|---|---|
Каталог |
Указать каталог, в котором будут проигрываться все файлы для режима Фоновое воспроизведение. |
Файл |
Файл для воспроизведения.Может быть выбран в одном из режимов:
|
Зацикливать |
Управление режимом непрерывного зацикленного воспроизведения. При воспроизведении через выбор каталога, каждый новый файл выбирается случайно. |
Режим Остановка фона
Производит остановку воспроизведения в указанном слое.
Не имеет специальных настроек
Режим Изменить громкость фона
Производит изменение громкости воспроизводимого в фоне файла на указанном слое.
| Название | Описание |
|---|---|
Громкость |
Делитель уменьшения громкости |
| Чтобы уменьшить громкость, а потом ее восстановить надо |
* Громкость = 4 (уменьшим в 4 раза) * Громкость = 1 (восстановим громкость файла)