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

Материал из KONANlabs
Перейти к: навигация, поиск
Строка 198: Строка 198:
 
= '''~matrix''' - управление матричным переключателем видео =
 
= '''~matrix''' - управление матричным переключателем видео =
  
Корневой контейнер - '''~matrix'''. Элемент с таким ID будет переключать 1й выход матрицы. Контейнер 2го уровня определяет выход матрицы, для которого переключается вход. Контейнер 3го уровня задаёт диапазон выходов (со 2го по 3й), для пакетного переключения. Например, контейнер /~matrix/2/5 будет выбирать вход (один и тот же) для выходов с 2 по 5 включительно.
+
Корневой контейнер - '''~matrix'''. Элемент с таким ID будет переключать 1й выход матрицы. Контейнер 2го уровня определяет выход матрицы, для которого переключается вход. Контейнер 3го уровня задаёт диапазон выходов (со 2го по 3й), для пакетного переключения. Например, контейнер /~matrix/2/5 будет выбирать вход (один и тот же) для выходов 2, 3, 4 и 5.
  
 
Используется для [[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.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0_.D1.80.D0.B0.D0.B4.D0.B8.D0.BE.D0.BA.D0.BD.D0.BE.D0.BF.D0.BE.D0.BA_.28radiogroup.2Fradiobutton.29|группы радиокнопок]].
 
Используется для [[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.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0_.D1.80.D0.B0.D0.B4.D0.B8.D0.BE.D0.BA.D0.BD.D0.BE.D0.BF.D0.BE.D0.BA_.28radiogroup.2Fradiobutton.29|группы радиокнопок]].

Версия 16:20, 21 июля 2019

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

Содержание

~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.

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

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 - управление камерой

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

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.

home - общий вид

Пресет общего вида конференц-зала. Не реализован.

homecam - камера общего вида

Номер камеры, которая показывает общий вид конференц-зала. Не реализован.

homepreset - пресет камера общего вида

Пресет общего вида конференц-зала. Не реализован.

return - возврат камеры

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

  • 0 - выключено;
  • 1 - включено.

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

oper - автонаведение камеры на действия оператора

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

  • 0 - выключено;
  • 1 - включено.

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

Таблица настроек

Таблица сама по себе является предопределённым элементом, к её ID автоматически добавляется корневой контейнер ~table, ID таблицы является контейнером второго уровня. Таблица с ID tab_setup (полный путь /~table/tab_setup) предназначена для индивидуальной настройки поведения каждого микрофонного пульта.

number - номер микрофона

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Предназначен для отображения номера микрофонного пульта, используется для элемента lightbox.

numbered - микрофон пронумерован

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Предназначен для индикации того, что пульт был пронумерован, используется для элемента lightbox, для которого должно быть определено 2 состояния:

  • 0 - выключено;
  • 1 - включено.

vip - VIP-пульты

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Устанавливает статус VIP для микрофонного пульта. Используется для видимого элемента checkbox строки таблицы.

link - серия микрофонных пультов

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Включает/исключает пульт в серию. Используется для видимого элемента checkbox строки таблицы.

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

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Устанавливает номер ведущего пульта для ведомого. Используется для видимого элемента checkbox строки таблицы.

camera - камера, снимающая микрофонный пульт

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Устанавливает номер камеры, которая снимает данный пульт. Используется для группы радиокнопок. Может быть использован для элемента input, для выбора камеры путём ввода номера.

preset - пресет камеры

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Устанавливает номер пресета камеры для микрофонного пульта, соответствующего строке таблицы. Используется для элемента [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.9F.D0.BE.D0.BB.D0.B5_.D0.B2.D0.B2.D0.BE.D0.B4.D0.B0_.28input.29|input]].

cam_go - навести камеру

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Наводит камеру на микрофонный пульт, соответствующий строке таблицы. Используется для элемента pushbutton.

cam_store - сохранить пресет

Предопределённый ID элемента таблицы с предопределённым ID tab_setup. Сохраняет пресет камеры для микрофонного пульта, соответствующего строке таблицы. Используется для элемента pushbutton.

~matrix - управление матричным переключателем видео

Корневой контейнер - ~matrix. Элемент с таким ID будет переключать 1й выход матрицы. Контейнер 2го уровня определяет выход матрицы, для которого переключается вход. Контейнер 3го уровня задаёт диапазон выходов (со 2го по 3й), для пакетного переключения. Например, контейнер /~matrix/2/5 будет выбирать вход (один и тот же) для выходов 2, 3, 4 и 5.

Используется для группы радиокнопок.