Total Kontrol/TKT/Предопределённые ID
Предопределённые идентификаторы предусмотрены для того, чтобы обеспечить возможность кастомизации веб-интерфейса без модификации логики управления центрального блока. Идентификаторы строятся по стандартам путей OSC. Кратко - идентификатор состоит из имён контейнеров, разделённых прямым слэшем, например "/контейнер1/контейнер2", контейнер1 в данном случае называется корневым. Имена всех предопределённых корневых контейнеров начинаются с "~".
Содержание
-
1 ~conference - управление конференц-системой
- 1.1 mic - управление микрофонными пультами
- 1.2 mode - режим работы конференц-системы
- 1.3 end - завершение регистрации и голосования
- 1.4 limmic - лимит количества одновременно включенных микрофонных пультов
- 1.5 limreq - лимит количества активных запросов на выступление
- 1.6 timspeak - ограничение времени выступления
- 1.7 timvote - ограничение времени регистрации и голосования
- 1.8 req - управление очередью запросов
- 1.9 attd - количество делегатов, зарегистрировавшихся для участия в голосовании
- 1.10 vote1-vote5 - результаты голосования
- 1.11 voted - общее количество проголосовавших
-
2 ~cam - управление камерой
- 2.1 show - навести камеру на микрофонный пульт
- 2.2 Непосредственное управление камерой
- 2.3 track - автоматическое наведение камеры
- 2.4 prev, next - наведение камеры на включенные микрофоны
- 2.5 select - переключение камер
- 2.6 home - общий вид
- 2.7 homecam - камера общего вида
- 2.8 return - возврат камеры
- 2.9 oper - автонаведение камеры на действия оператора
-
3 Таблица настроек
- 3.1 number - номер микрофона
- 3.2 numbered - микрофон пронумерован
- 3.3 vip - VIP-пульты
- 3.4 link - серия микрофонных пультов
- 3.5 master - устанавливает ведущий микрофонный пульт
- 3.6 camera - камера, снимающая микрофонный пульт
- 3.7 preset - пресет камеры
- 3.8 cam_go - навести камеру
- 3.9 cam_store - сохранить пресет
~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.
home - общий вид
Пресет общего вида конференц-зала. Не реализован.
homecam - камера общего вида
Номер камеры, которая показывает общий вид конференц-зала. Не реализован.
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.