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`	`1`	Количество каналов в файле после микширования. Доступно для изменения только у форматов `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"
}

См. также

Конфигурация