Компонент Запись звука

Описание

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

Table 1. Системные характеристики

Индекс

208

Краткое название

record

Типы сценариев

IVR

Стартовый модуль

r_sip_ivr_script_component_record

Режим

Асинхронный

Иконка

208

Характер разветвления

Разветвляющий, замыкающий

Свойства

Table 2. Свойства
Спецификация Описание

Название: Режим
Код: mode
Усл. видимости: нет
По умолчанию: Синхронная запись

Выбор режима записи.
Возможные варианты:

  • Синхронная запись (syncRecFile, 0) - обычный режим записи в файл с последующей упаковкой в выбранный кодек и возвратом пути к файлу в переменную.

  • Потоковая запись (growingRaw, 1) - режим записи в указанный файл короткими порциями, например для организации потоковой отправки в сервис распознавания речи внешними средствами.

Название: Путь в переменную
Код: pathToVarMode
Усл. видимости: да
По умолчанию: Да

Выключатель сохранения пути к файлу с записью в переменную.

Название: Путь к файлу в переменную
Код: nameVar
Усл. видимости: да
По умолчанию: — 

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

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

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

Название: Путь к файлу
Код: toFilepath
Усл. видимости: да
По умолчанию: — 

Аргумент, указывающий путь к файлу для потоковой записи (растущий файл).
Применяется только в режиме потоковой записи.

Название: Wav-заголовок
Код: addWavHeader
Усл. видимости: да
По умолчанию: Нет

Позволяет добавить wav-заголовок к растущему файлу.
Применяется только в режиме потоковой записи.

В Wav-заголовок прописывается размер, эквивалентный выбранному максимальному времени записи.

Название: Кодек
Код: codec
Усл. видимости: да
По умолчанию: PCMA

Кодек/формат записываемого файла (только для режима синхронной записи). Упаковка производится по окончании записи с помощью микшера.
Возможные варианты:

  • PCM (pcm, '0')

  • PCMA (pcma, '1')

  • PCMU (pcmu, '2')

  • GSM (gsm, '3')

  • MP3 8-bit (mp3_8, '4')

  • MP3 16-bit (mp3_16, '5')

  • MP3 24-bit (mp3_24, '6')

Название: Кодек
Код: codecRaw
Усл. видимости: да
По умолчанию: PCMA

Кодек/формат записываемого файла (только для режима потоковой записи).
Возможные варианты:

  • L16/8000 (pcm8000, '0') - PCM 8000 Hz 16 bit mono.

  • L16/16000 (pcm16000, '1') - PCM 16000 Hz 16 bit mono.

Название: Буфер, мс
Код: bufferDurMs
Усл. видимости: нет
По умолчанию: 250

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

Название: Таймаут, с
Код: recTimeSec
Усл. видимости: нет
По умолчанию: — 

Таймаут записи до автоматического прерывания, в секундах.

Название: Буфер для DTMF
Код: dtmfBuffer
Усл. видимости: нет
По умолчанию: — 

Переменная для сохранения получаемых DTMF-символов.

Название: Очистить буфер DTMF
Код: clearDtmfBuffer
Усл. видимости: да
По умолчанию: Да

Выключатель предварительной очистки буфера DTMF.

Название: Количество символов
Код: maxSymbolCount
Усл. видимости: нет
По умолчанию: — 

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

Название: Символы прерывания
Код: interruptSymbols
Усл. видимости: нет
По умолчанию: — 

Строка, содержащая последовательности символов прерывания через запятую.
После обнаружения на конце буфера DTMF последовательности символов, совпадающей с одной из указанных последовательностей прерывания, производится автоматическое завершение записи и отправка последней порции данных сервису распознавания.
Например, *, 7, 123, 9395.

Название: Вырезать символы прерывания
Код: clearInterrupt
Усл. видимости: да
По умолчанию: Да

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

Название: Прерывать фон (слой) при обнаружении голоса
Код: `stopPlayerIdOnVad

Усл. видимости: нет
По умолчанию: "default"

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

Название: Прерывать при обнаружении тишины
Код: abortOnSilence
Усл. видимости: нет
По умолчанию: Нет

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

Название: Интервал тишины, с
Код: silenceTimeoutSec
Усл. видимости: да
По умолчанию: 2

Аргумент, содержащий время таймаута при обнаружении тишины в секундах. При появлении голоса выше порога чувствительности в течение указанного таймаута, таймер сбрасывается вплоть до обнаружения тишины снова.
В большинстве случаев 2 секунды - комфортный интервал.
Может указываться в формате десятичной дроби, например, '1.6'.

Название: Порог VAD, -дБ
Код: vadThreshold
Усл. видимости: да
По умолчанию: 30

Аргумент, устанавливающий порог VAD. Параметр VAD-детектора.
Указанное значение применяется с отрицательным знаком (в децибеллах) для определения порога отсечения тишины относительно возможного максимума.
Поток анализируется фреймами по 20 мс. Каждый звуковой фрейм на основании порога отсечения рассматривается либо как голос, либо как тишина (средний уровень громкости фрейма).
Таким образом, детектор имеет два состояния: голос и тишина. При переходе между состояниями генерируется событие о переходе в другое состояние. Изначально детектор находится в состоянии тишины.
Генерация сигнала обнаружения голоса происходит в состоянии тишины тогда, когда несколько фреймов подряд являются голосовыми (параметр 'Порог голоса, мс').
Генерация сигнала обнаружения тишины происходит в состоянии голоса тогда, после того, как несколько фреймов подряд признаны тишиной (параметр 'Порог тишины, мс').
При значении 30 детектор лучше определяет тишину, при значении 40 детектор лучше определяет появление голоса.
Выход из компонента происходит по истечении таймаута, указанного в поле Интервал тишины, с, отсчитывая с начала отрезка тишины, обнаруженного детектором из состояния голоса.

Название: Голос, мин. длительность, мс
Код: vadVoiceMinMs
Усл. видимости: да
По умолчанию: 120

Аргумент, устанавливающий минимальную пороговую длительность VAD для генерации сигнала VAD UP.
Параметр VAD-детектора.
Для генерации сигнала необходимо несколько фреймов по 20 мс подряд со средним уровнем выше установленного порога VAD.
Через указанное значение определяется количество фреймов.

Название: Голос, допустимое отклонение, %
Код: vadVoiceTol
Усл. видимости: да
По умолчанию: 20

Аргумент, устанавливающий допустимое отклонение в последовательности голосовых фреймов.
Параметр VAD-детектора.
Например минимальная длительность задана 210 (мс), отклонение 20 (%). Таким образом для сигнализации о наличии голоса будет требоваться последовательность из 11 фреймов, 9 из которых должны быть голосовыми.
Значение 0 означает что все 11 фреймов подряд должны быть голосовыми (иметь средний уровень выше порога VAD).

Название: Тишина, мин. длительность, мс
Код: vadSilenceMinMs
Усл. видимости: да
По умолчанию: 500

Аргумент, устанавливающий минимальную пороговую длительность фреймов с тишиной для генерации сигнала VAD DOWN.
Параметр VAD-детектора.
Для генерации сигнала необходимо несколько фреймов по 20 мс подряд со средним уровнем ниже установленного порога VAD.
Через указанное значение определяется количество фреймов.

Название: Тишина, допустимое отклонение, %
Код: vadSilenceTol
Усл. видимости: да
По умолчанию: 10

Аргумент, устанавливающий допустимое отклонение в последовательности голосовых фреймов.
Параметр VAD-детектора.
Например минимальная длительность задана 210 мс, отклонение 20%. Таким образом для сигнализации о наличии голоса будет требоваться последовательность из 11 фреймов, 9 из которых должны быть голосовыми.
Значение 0 означает что все 11 фреймов подряд должны быть тишиной (иметь средний уровень ниже порога VAD).

Название: Переход
Код: transfer
Усл. видимости: нет
По умолчанию: — 

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

Название: Переход, время
Код: transferTimeout
Усл. видимости: нет
По умолчанию: — 

Компонент, которому передается управление при завершении по таймауту.

Название: Переход, ошибка
Код: transferError
Усл. видимости: нет
По умолчанию: — 

Компонент, которому передается управление при обнаружении ошибки, например неверно задан путь к файлу для потоковой записи.