Conference SIP UserAgent (conf)

Содержание

Описание
Параметры
Пример конфигурации
См. также

Описание

Реализует сервис конференц-связи по SIP.

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

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

Код	`conf`
Режим работы	`Сервис`
Режим резервирования	`Active-Active`
Типы сайтов	`Любые`
Слой	`Бизнес-логика`
Размещение	`Внутренний`
Сохранение и восстановление состояния при перезагрузке	`Нет`
Приложение	`era_sip`

Параметры

Описание столбцов в таблице

Table 2. Параметры
Имя	Тип	Умолчание	Описание
`name`	`str`	required	Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.
`roletype`	`str`	required	Тип роли. Возможные значения: `"conf"`.
`iface`	`str`	required	Алиас сетевого интерфейса сервера, на котором будет происходить внутреннее взаимодействие ролей между собой.
`ext`	`json`	empty	Дополнительные опции роли. Содержит json объект или список.
`enabled`	`bool`	empty	Флаг активности роли. При установке в false роль не участвует в валидации и не запускается.
`roleid`	`int`	required	Идентификатор роли. Уникален для всей системы, независимо от сайта или сервера. Не подлежит изменению. Целое число от `1` до `9999`.
`separate`	`bool`	required	Признак выделения роли в отдельную ноду.
`udp`	`int`	required	Локальный порт UDP для SIP. Этот же порт одновременно обрабатывает и TCP. Например: `5085`. Используется для внутреннего взаимодействия с другими микросервисами системы по протоколу SIP. Поднимается только на локальном интерфейсе, к которому привязана нода. Не должен использоваться другими микросервисами, исполняемыми на том же самом сервере.
`tcp`	`int`	required	Локальный порт TCP для SIP. Если указано значение, отличное от UDP, то будет поднят дополнительно. Например: `5085`. Используется для внутреннего взаимодействия с другими микросервисами системы по протоколу SIP. Поднимается только на локальном интерфейсе, к которому привязана нода. Не должен использоваться другими микросервисами, исполняемыми на том же самом сервере.
`log_cdr`	`bool`	`true`	Выключатель логирования событий в лог `cdr`.
`log_media`	`bool`	`true`	Выключатель логирования медиа-функций `media`.
`log_mgct`	`bool`	`true`	Выключатель логирования протокола взаимодействия с MGC-контроллером в лог `mgct`.
`log_sip`	`bool`	`true`	Выключатель логирования трейса машины состояний диалога в лог `sip`.
`log_trn`	`bool`	`true`	Выключатель логирования SIP-трафика в лог `trn`.
`payloads_audio_offer`	`array<str>`	`["PCMA/8000", "PCMU/8000", "telephone-event/8000"]`	Список имен аудиокодеков, используемых для инициации звонка (вызове плеча). В качестве значения - список, содержащий имена аудио-кодеков в формате `"Name/Freq"`. Поддерживаются следующие кодеки (case-sensitive): `telephone-event/8000`, `PCMU/8000`, `PCMA/8000`, `GSM/8000`, `G722/8000`, `G729/8000`, `CN/8000`, `speex/8000`, `speex/16000`, `speex/32000`, `G726-16/8000`, `G726-24/8000`, `G726-32/8000`, `G726-40/8000`, `iLBC/8000`, `opus/48000/2`. Три основных формата: `PCMA/8000`, `PCMU/8000` и `telephone-event/8000` автоматически добавляются в инициируемые вызовы при любом значении поля.

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

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

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

Пример узла

{
  "name": "conf1",
  "roletype": "conf",
  "iface": "eth0",

  "roleid": 11250,
  "separate": true,
  "udp": 5086,
  "tcp": 5086,

  "log_cdr": true,
  "log_trn": true,
  "log_sip": true,
  "log_media": true,
  "log_mgct": true
}

См. также

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