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

Материал из KONANlabs
Перейти к: навигация, поиск
Строка 111: Строка 111:
 
*1 - автонаведение включено.
 
*1 - автонаведение включено.
  
== '''prev''' и '''next''' - наведение камеры на включенные микрофоны ==
+
== '''prev''', '''next''' - наведение камеры на включенные микрофоны ==
  
 
Используются для элементов [[Total_Kontrol/TKT/%D0%A4%D0%BE%D1%80%D0%BC%D0%B0%D1%82_XML_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0#.D0.92.D0.BE.D0.B7.D0.B2.D1.80.D0.B0.D1.82.D0.BD.D0.B0.D1.8F_.D0.BA.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0_.28pushbutton.29|pushbutton]]. Наводят камеру на предыдущий/следующий включенный микрофон в порядке их включения. Должны быть определены 3 видимых состояния:
 
Используются для элементов [[Total_Kontrol/TKT/%D0%A4%D0%BE%D1%80%D0%BC%D0%B0%D1%82_XML_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0#.D0.92.D0.BE.D0.B7.D0.B2.D1.80.D0.B0.D1.82.D0.BD.D0.B0.D1.8F_.D0.BA.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0_.28pushbutton.29|pushbutton]]. Наводят камеру на предыдущий/следующий включенный микрофон в порядке их включения. Должны быть определены 3 видимых состояния:

Версия 19:27, 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. Полный ID: /~conference/attd.

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

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

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

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

~cam - управление камерой

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

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

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

Непосредственное управление камерой

6 контейнеров 2го уровня, осуществляющих прямое управление поворотными камерами. Используются для элементов pushbutton:

  • left - поворот влево
  • right - поворот вправо
  • up - поворот вверх
  • down - поворот вниз
  • zoomin - приближение
  • zoomout - отдаление

Вложенные контейнеры не предусмотрены, пример контейнера для кнопки "вверх": /~cam/up.

track - автоматическое наведение камеры

Включает/выключает автоматическое наведение камеры на включенный микрофон. Используется для элемента checkbox. Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~cam/track.

Должны быть определены 2 видимых состояния:

  • 0 - автонаведение выключено;
  • 1 - автонаведение включено.

prev, next - наведение камеры на включенные микрофоны

Используются для элементов pushbutton. Наводят камеру на предыдущий/следующий включенный микрофон в порядке их включения. Должны быть определены 3 видимых состояния:

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

select - переключение камер

Логика центрального контроллера, кроме управления поворотными камерами, осуществляет автоматическое переключение на нужную камеру, если камер в системе более одной. Для ручного выбора камеры, транслируемой в систему видеоконференцсвязи, предусмотрен контейнер select. Используется для группы радиокнопок. Может быть использован для элемента input, для выбора камеры путём ввода номера.

Вложенные контейнеры не предусмотрены, единственный допустимый ID - /~cam/select.