Back to back UserAgent (b2b)

Содержание

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

Описание

Функциональная роль организующая коммутацию между SIP устройствами, путем создания двусторонних диалогов.
Производит маршрутизацию и вызов соответствующих устройств с организацией медиа-потока между ними посредством функциональных ролей mgc и mg.

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

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

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

Параметры

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

Table 2. Параметры
Имя	Тип	Умолчание	Описание
`name`	`str`	required	Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.
`roletype`	`str`	required	Тип функциональной роли. Возможные значения: `"b2b"`.
`iface`	`str`	required	Алиас сетевого интерфейса сервера, на котором будет происходить внутреннее взаимодействие функциональных ролей между собой.
`roleid`	`int`	required	Идентификатор функциональной роли. Уникален для всей системы, независимо от сайта или сервера. Не подлежит изменению. Целое число от `1` до `9999`.
`separate`	`bool`	required	Признак выделения функциональной роли в отдельную ноду.
`udp`	`int`	required	Локальный порт UDP для SIP. Этот же порт одновременно обрабатывает и TCP. Например: `5090`.
`tcp`	`int`	required	Локальный порт TCP для SIP. Если указано значение, отличное от UDP, то будет поднят дополнительно. Например: `5090`.
`trn`	`bool`	`true`	Выключатель логирования SIP-протокола в лог `trn`.
`use_srtp`	`bool`	`false`	По умолчанию при инициации звонков на адреса, подключенные по TLS, отправляется SDP-offer для нешифрованного медиа потока (rtp). С помощью параметра можно для TLS адресов включить режим инициации отправки SDP-offerа с шифрованным медиа-потоком.
`allow_ac_set`	`bool`	`true`	Выключатель режима отправки набора кодеков в ответах на INVITE. `false` – в ответе отправляется не более одного кодека из полученных в Offer SDP. `true` – в ответе может быть отправлено подмножество кодеков из списка полученных в Offer SDP.
`send_reinvite_on_ack`	`bool`	`false`	Выключатель режима отправки re-INVITE инициатору звонка сразу после установки диалога (получен подтверждающий SIP-запрос ACK). Может использоваться для обновления данных на дисплее в случае, если устройства не обрабатывают SIP-заголовок `Remote-Party-Id`. Также может применяться для выравнивания кодеков с целью увеличить вероятность прямой передачи трафика без транскодинга.
`check_by_options_on_limit`	`bool`	`false`	Выключатель режима проверки устройств с помощью отправки SIP-запроса OPTIONS при получении запроса REGISTER, превышающего лимит по лицензии. `false` – отказывать в регистрации; `true` – проверять доступность зарегистрированных устройств, и в случае обнаружения недоступности автоматически заменять регистрацию.
`payloads_audio_offer`	`array<str>`	`["PCMA/8000", "PCMU/8000", "G729/8000", "telephone-event/8000"]`	Список применяемых аудио кодеков. В качестве значения список, содержащий имена кодеков в формате `"Name/Freq"`. Поддерживаются: `PCMU/8000`, `GSM/8000`, `PCMA/8000`, `G722/8000`, `CN/8000`, `G729/8000`, `speex/8000`, `speex/16000`, `speex/32000`, `telephone-event/8000`, `G726-16/8000`, `G726-24/8000`, `G726-32/8000`, `G726-40/8000`, `iLBC/8000`, `opus/48000/2`.
`payloads_video_offer`	`array<str>`	empty	Список используемых для инициации звонка имен видеокодеков case-sensitive. Поддерживаются: `H263/90000`, `H263-1998/90000`, `H264/90000`, `VP8/90000`, `VP9/90000`.
`use_video_transcoding`	`bool`	`false`	Использовать транскодинг видео. `false` – все видео-кодеки из SDP INVITE-запроса, полученного от инициатора, транслируются без изменений в SDP INVITE-запросов на вызываемые устройства. В этом случае система не применяет ни свои знания о кодеках, ни транскодинг, икодек неизвестен системе, то прямая трансляция тем не менее остается возможной. `true` – все видео-кодеки приводятся в соответствии с известными системе видео-кодеками, система предлагает вызываемой стороне все известные ей кодеки (с фильтром из payloads_video_offer), и при несовпадении выбранных устройствами кодеков осуществляется транскодинг на видео-стриме.
`record_ivr`	`bool`	`false`	Выключатель записи диалогов с IVR. При указании `false` медиа-трафик звонков в IVR, включая очереди, принудительно не записывается, вне зависимости от установок правил записи.
`record_conf`	`bool`	`false`	Выключатель записи диалогов с конференциями. При указании `false` медиа-трафик звонков в конференц-комнаты принудительно не записывается, вне зависимости от установок правил записи.

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

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

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

Пример узла

{
    "name": "b2bua1",
    "roletype": "b2b",
    "iface": "eth0",

    "roleid": 10,
    "separate": true,
    "udp": 5090,
    "tcp": 5090,

    "send_reinvite_on_ack": false,
    "allow_ac_set": false,
    "check_by_options_on_limit": true,
    "record_conf": false,
    "record_ivr": false
 }

См. также

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