Участник (participant)

Описание

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

В частности, абонентом может являться IVR сценарий, который записывает то, что ему открывает настроенная топология.

Ограничения

  • Является дочернем композитным объектом сущности селекторного совещания. Удаляется вместе с ним.

  • При добавлении через API один объект может представлять собой группу контактов (номер "group#<CODE>", где <CODE> – код группы контактов) и автоматически разворачиваться в несколько абонентов, входящих в нее.

Поля

Структура сущности
{
  "id": uuid,
  "name": str,
  "number": str,
  "state": str,
  "hold": bool,
  "is_hand_raised": bool,
  "mic": bool,
  "spk": bool,
  "recall": bool,
  "topology_type": str,
  "video_out": bool,
  "video_cell": int,
  "ext": {}
}
Table 1. Поля
Спецификация Описание

Поле: id
Режим: inout
Тип: uuid
По умолчанию: generated

Идентификатор. Может быть задан при создании, иначе генерируется системой «R».

Поле: name
Режим: in
Тип: str
По умолчанию: empty

Имя абонента

Поле: number
Режим: in
Тип: str
По умолчанию: empty

Телефонный номер абонента для вызова из селекторного совещания.

Поле: state
Режим: out
Тип: str
По умолчанию: required

Состояние абонента.

Поле: hold
Режим: out
Тип: bool
По умолчанию: false

Состояние удержания

Поле: is_hand_raised
Режим: inout
Тип: bool
По умолчанию: false

Состояние поднятой руки

Поле: mic
Режим: in
Тип: bool
По умолчанию: true

Выключатель микрофона участника

Поле: spk
Режим: in
Тип: bool
По умолчанию: true

Выключатель динамика участника

Поле: recall
Режим: in
Тип: bool
По умолчанию: false

Выключатель режима автоматического повторного вызова при разрыве или неудачном вызове.

Поле: video_out
Режим: in
Тип: bool
По умолчанию: false

Выключатель видео в сторону участника.

Поле: video_cell
Режим: in
Тип: int
По умолчанию: 0

Номер ячейки для отображения участника в селекторном видео. 0 - участник не отображается.

Поле: topology_type
Режим: in
Тип: str
По умолчанию: required

Роль абонента в селекторном совещании для упрощенного управления топологией.

  • listener – Слушатель. Слышит всех выступающих.

  • speaker – Выступающий. Слышит других выступающих и всех ассистентов.

  • assistant – Ассистент. Слышит всех выступающих.

Применяется при установленном режиме управления топологией селекторного совещания: abonent.

Поле: ext
Режим: inout
Тип: object
Составное поле

Позволяет расширять состав произвольными ключами и значениями

См. также

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

  • sel проводит управление селекторными совещаниями.

  • conf проводит непосредственное управление конференцией как SIP UA.

  • mg проводит обслуживание медиа-контекста конференции, добавляет/удаляет терминейшены.