Селекторное совещание (selector)

Содержание

Описание
Ограничения
Поля
См. также
- API
- Функциональные роли

Описание

Дескриптор селекторного совещания.

Селекторное совещание – это особый род аудио-конференции с управляемой топологией. Управление производится ведущим участником через API (из UI-приложения). Участники селекторного совещания вызываются системой.

Запуск селекторного совещания может быть произведен вручную, либо автоматически по расписанию.

Запущенное селекторное совещание может существовать не более 9800 сек. после чего оно будет остановлено и удалено.

Ограничения

После проведения запланированного селекторного совещания оно автоматически выключается, но остается существовать и доступно для повторного запуска.
Сущность управляется и хранится функциональной ролью sel. Не отражает операции модификации в журнале изменений.
Представляет собой одновременно дескриптор и рантайм-объект активной конференции.

Поля

Структура сущности

{
  "id": uuid,
  "state": str,
  "calldurationsec": int,
  "calltimeout": int,
  "timestartutc": date,
  "topology_mode": str,
  "displayname": str,
  "enabled": bool,
  "mediafile": null | str,
  "comment": str,
  "default_mic": bool,
  "default_spk": bool,
  "default_recall": bool,
  "is_video": bool,
  "ext": {}
}

Описание характеристик спецификации

Table 1. Поля
Спецификация	Описание
Поле: `id` Режим: `inout` Тип: `uuid` По умолчанию: generated	Идентификатор. Может быть задан при создании, иначе генерируется системой «R».
Поле: `state` Режим: `inout` Тип: `str` По умолчанию: required	Состояние. модификатора Доступные значения.
Поле: `calldurationsec` Режим: `in` Тип: `int` По умолчанию: `0`	Продолжительность отрезка времени, в течение которого осуществляется вызов участников, в том числе повторный, в секундах. `0` – не ограничено.
Поле: `calltimeout` Режим: `in` Тип: `int` По умолчанию: `35`	Ограничение на продолжительность одного конкретного вызова любого участника.
Поле: `timestartutc` Режим: `in` Тип: `date` По умолчанию: required	Дата и время автоматического сбора конференции, в UTC. Чтобы принудительно запустить селекторное совещание, необходимо назначить значение в прошлом времени.
Поле: `topology_mode` Режим: `in` Тип: `str` По умолчанию: required	Режим управления топологией.
Поле: `displayname` Режим: `in` Тип: `str` По умолчанию: empty	Название селекторного совещания, подставляемое при вызове абонентов в качестве displayname в URI заголовка From SIP-запроса INVITE.
Поле: `enabled` Режим: `in` Тип: `bool` По умолчанию: `false`	Выключатель селекторного совещания.
Поле: `mediafile` Режим: `in` Тип: `str` По умолчанию: str_empty	Имя звукового файла из каталога файлов селекторных совещаний (API `/rest/v1/fs/targets/selector`). Применятся для автоматического предварительного воспроизведения ответившему абоненту перед его подключением в селекторное совещание.
Поле: `comment` Режим: `in` Тип: `str` По умолчанию: str_empty	Произвольный комментарий
Поле: `default_mic` Режим: `in` Тип: `bool` По умолчанию: false	Состояние микрофона для добавляемых участников.
Поле: `default_spk` Режим: `in` Тип: `bool` По умолчанию: `true`	Состояние спикера для добавляемых участников.
Поле: `default_recall` Режим: `in` Тип: `bool` По умолчанию: false	Состояние разрешения автоматического перезвона для добавляемых участников.
Поле: `default_video` Режим: `in` Тип: `bool` По умолчанию: false	Состояние вывода видео для добавляемых участников. Только для `is_video` = `true`.
Поле: `is_video` Режим: `in` Тип: `bool` По умолчанию: false	Медиа-тип селектора. Только аудио (false) или аудио/видео (true).
Поле: `video_mode` Режим: `in` Тип: `str` По умолчанию: "1"	Раскладка участников на видео. Только для `is_video` = `true`.
Поле: `ext` Режим: `inout` Тип: `object` Составное поле	Позволяет расширять состав произвольными ключами и значениями

Состояние селектора

Table 2. Состояние селектора
Значение	Описание
`"initing"`	Инициализация runtime-объекта после создания сущности.
`"connecting"`	Подключение к серверу конференций (функциональная роль conf).
`"online"`	Активно, производится вызов/обслуживание абонентов.
`"waiting"`	Ожидание активации. По расписанию или свойством enabled.
`"error"`	Ошибка, ожидание изменений (свойства объекта, либо появление доступа к конференции).

Режимы работы селектора

Table 3. Режимы работы селектора
Значение	Описание
`"abonent"`	Режим упрощенного управления через селекторные роли абонентов: слушатель (listener), выступающий (speaker), подсказывающий (assistant).
`"direct"`	Режим управления топологией напрямую.

Видео режимы селектора

Table 4. Видео режимы селектора
Значение	Описание
`"1"`	Один участник (один спикер или демонстрация экрана)
`"2x2"`	Четыре участника два на два.
`"3x2"`	Шесть участников три на два.
`"3x3"`	Девять участников три на три.
`"4x3"`	Двенадцать участников четыре на три.
`"4x4"`	Шестнадцать участников четыре на четыре.
`"5x5"`	Двадцать пять участников пять на пять.
`"6x6"`	Тридцать шесть участников шесть на шесть.

См. также

API

Функциональные роли

sel проводит управление селекторными совещаниями.
conf проводит непосредственное управление конференцией как SIP UA.
mg проводит обслуживание медиа-контекста конференции.