Mixer (mix)

Описание

Обеспечивает подготовку, упаковку, сцепку и размещение файлов записей разговоров на основе событий системы. Размещение производится в общем хранилище (Локальные пути - recstore), откуда потом записи разносятся по хранилищам доменов ролью recmover.

Резервируется и масштабируется в режиме Active-Active.

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

Инициирует процесс перемещения записи в доменные хранилища.

Для работы требуется настройка Брокера сообщений.

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

Код

mix

Режим работы

Сервис

Режим резервирования

Active-Active

Типы сайтов

Любые

Слой

Бизнес-логика

Размещение

Внутренний

Сохранение и восстановление состояния при перезагрузке

Нет

Приложение

era_mix

Управляемое приложение

rtx_mixer

Ограничения

  • Образует плотную загрузку процессора в момент проведения микширования. При разделении сервера с другими ролями следует серьезно ограничивать число потоков, которые могут использоваться ролью, иначе возникает риск 100% загрузки процессора на сервере.

  • Микширование проводится в процессе имеющем минимальный приоритет.

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

Параметры

Table 2. Параметры
Имя Тип Умолчание Описание

name

str

required

Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.

roletype

str

required

Тип роли. Возможные значения: "mix".

iface

str

required

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

ext

json

empty

Дополнительные опции роли. Содержит json объект или список.

enabled

bool

empty

Флаг активности роли. При установке в false роль не участвует в валидации и не запускается.

roleid

int

required

Идентификатор роли. Уникален для всей системы, независимо от сайта или сервера.
Нельзя изменить после присвоения. Целое число от 1 до 9999

separate

bool

required

Признак выделения роли в отдельную ноду.

recstorageid

str

required

Алиас каталога на сервере для хранения записей разговоров.
Если каталог не существует, он будет создан.
При работе роли recmover записи из общего хранилища переносятся в доменные хранилища. По умолчанию хранилищем записей домена выступает подкаталог общего каталога хранения записей.
В зависимости от того, настроен ли перенос записей в доменные хранилища за пределами кластера (например в S3-хранилище), размещение записей в каталоге может быть кратковременным, либо долговременным с накоплением.
Формат значения: alias://paths/<ALIAS_NAME>.

cachefolder

str

empty

Алиас каталога на сервере для размещения служебных файлов микшера.
Если каталог не существует, он будет создан.
По умолчанию: "/var/lib/era/_workdir/<NODE_NAME>"

channels

int

2

Количество каналов в файле после микширования.
Доступно для изменения только у форматов mp3 и pcm.
Возможные значения:

  • 1 – моно, * 2 – стерео.

encoding

str

"mp3"

Формат в который будет производиться упаковка файла аудио-записи после микширования.
Возможные значения: "mp3", "pcm", "pcma", "pcmu", "gsm".

maxevents

int

8

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

samplerate

int

8000

Частота дискретизации.
Возможно изменять только для форматов mp3 и pcm.
Возможные значения для mp3 и pcm: 8000, 16000, 32000.

Пример конфигурации

Управление конфигурацией производится в приложении, доступном для администраторов мастер-домена. Приложение скрывает полное содержание конфигурации, однако тем не менее оно доступно через API.

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

Пример узла
{
  "name": "mix1",
  "roletype": "mix",
  "iface": "eth0",

  "roleid": 11200,
  "separate": false,

  "recstorageid": "main4",

  "channels": "2",
  "encoding": "mp3",
  "samplerate": "8000"
}

См. также