Total Kontrol/TKT/Предопределённые ID: различия между версиями

Материал из KONANlabs
Перейти к: навигация, поиск
м
Строка 55: Строка 55:
 
== '''timspeak''' - ограничение времени выступления ==
 
== '''timspeak''' - ограничение времени выступления ==
  
Контейнер задаёт ограничение времени выступления. Эта функция пока не реализована применение бессмысленно.
+
Контейнер задаёт ограничение времени выступления. Эта функция пока не реализована, применение бессмысленно.
  
 
== '''timvote''' - ограничение времени регистрации и голосования ==
 
== '''timvote''' - ограничение времени регистрации и голосования ==

Версия 18:56, 4 июля 2019

Предопределённые идентификаторы предусмотрены для того, чтобы обеспечить возможность кастомизации веб-интерфейса без модификации логики управления центрального блока. Идентификаторы строятся по стандартам путей OSC. Кратко - идентификатор состоит из имён контейнеров, разделённых прямым слэшем, например "/контейнер1/контейнер2", контейнер1 в данном случае называется корневым. Имена всех предопределённых корневых контейнеров начинаются с "~".

~conference - управление конференц-системой

Корневой контейнер - ~conference. Контейнеры следующих уровней управляют отдельными параметрами конференц-системы.

mic - управление микрофонными пультами

Для управления используются вложенные контейнеры. Контейнер 3-го уровня select предназначен для выбора микрофонного пульта, которым будет управлять контейнер control (см. ниже). Используется для видимого элемента input. Пример полного ID: /~conference/mic/select.

Контейнер 3-го уровня control предназначен для непосредственного управления микрофонными пультами. Используется для видимого элемента checkbox, для которого должно быть определено 4 состояния:

  • 0 - пульт присутствует в системе и выключен;
  • 1 - пульт присутствует в системе и включён;
  • 2 - пульт присутствует в системе в состоянии запроса на выступление;
  • unavailable - пульт отсутствует в системе.

Пример полного ID: /~conference/mic/control.

Добавлением к контейнеру control 4-го уровня можно реализовать страницу синоптического управления микрофонными пультами (когда каждый пульт, присутствующий в зале представлен отдельным видимым элементом, оператор может видеть полную картину и управлять любым пультом одним нажатием на экран). Пример полного ID для синоптического управления микрофонным пультом №4: /~conference/mic/control/4.

mode - режим работы конференц-системы

Контейнер предназначен для переключения режимов работы конференц-системы. Используется для группы радиокнопок. Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~conference/mode. Допустимы следующие значения:

  • 1 - свободный режим (до 2019 г.);
  • 2 - режим "лимит";
  • 3 - режим "FIFO";
  • 4 - регистрация на голосование;
  • 5 - голосование.

Для радиокнопок режима работы должно быть определено 3 состояния:

  • 0 - кнопка отжата;
  • 1 - кнопка нажата;
  • unavailable - режим недоступен.

Логика центрального блока управляет видимостью радиокнопок режима. В режимах регистрации и голосования все остальные кнопки блокируются, выход из этих режимов осуществляется кнопкой с предопределённым идентификатором /~conference/end (см. ниже).

end - завершение регистрации и голосования

Контейнер завершает режимы регистрации голосования, переводит конференц-систему в режим, предшествовавший началу регистрации или голосования. Используется для элемента pushbutton. Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~conference/end. У видимого элемента должно быть определено 3 состояния:

  • 0 - кнопка отжата;
  • 1 - кнопка нажата;
  • unavailable - кнопка недоступна.

limmic - лимит количества одновременно включенных микрофонных пультов

Контейнер задаёт максимальное количество одновременно включенных пультов. Используется для элемента input. Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~conference/limmic.

limreq - лимит количества активных запросов на выступление

Контейнер задаёт максимальное количество микрофонных пультов, которые могут находиться в очереди на выступление (в состоянии запроса на выступление). Используется для элемента input. Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~conference/limreq.

Логика центрального блока управляет видимостью этого контейнера, также существует предопределённый ID /~conference/lb_limreq для видимого элемента lightbox, видимость которого изменяется синхронно с limreq. Этот видимый элемент может быть использован для создания "подписи" к полю ввода, которая появляется и исчезает вместе с ним.

timspeak - ограничение времени выступления

Контейнер задаёт ограничение времени выступления. Эта функция пока не реализована, применение бессмысленно.

timvote - ограничение времени регистрации и голосования

Контейнер задаёт ограничение времени на регистрацию и голосование. Используется для элемента input. Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~conference/timvote.

req - управление очередью запросов

Логика центрального контроллера формирует "очередь" из микрофонных пультов, которые запросили выступление, но ещё не были включены. Контейнер req содержит вложенные контейнеры для работы с этой очередью.

Контейнер 3го уровня list предназначен для отображения текущей очереди в порядке поступления запросов, используется для элемента lightbox. Текст видимого элемента будет представлять собой номера микрофонных пультов в очереди, разделённых запятыми. Полный ID: /~conference/req/list.

Контейнер 3го уровня accept "принимает" первый в очереди запрос на выступление, т. е., включает микрофонный пульт, запрос от которого пришёл раньше всех. Полный ID: /~conference/req/accept.

Контейнер 3го уровня reject "отклоняет" первый в очереди запрос на выступление, т. е., выводит из режима запроса микрофонный пульт, запрос от которого пришёл раньше всех. Полный ID: /~conference/req/reject.

attd - количество делегатов, зарегистрировавшихся для участия в голосовании

Контейнер предназначен для отображения количества делегатов, зарегистрировавшихся для участия в голосовании. Изменяется в реальном времени в режиме регистрации. Используется для элемента lightbox.

vote1-vote5 - результаты голосования

Контейнеры предназначены для отображения количества делегатов, проголосовавших за каждую из 5 доступных опций голосования. Изменяются в реальном времени в режиме голосования. Используется для элемента lightbox.

voted - общее количество проголосовавших

Контейнеры предназначены для отображения количества делегатов, проголосовавших за какую-либо из доступных опций голосования. Изменяются в реальном времени в режиме голосования. Используется для элемента lightbox.