Files
hockey_new/docs/OPERATOR.md

9.8 KiB
Raw Blame History

Работа оператора

Подготовка эфира

  1. Войдите под своей учётной записью и откройте нужный матч.
  2. На компьютере с vMix запустите Agent и проверьте связь отдельно с сервером и vMix.
  3. Проверьте назначение Agent: свой аккаунт, выбранный матч и нужный проект vMix.
  4. В Mapping выберите сохранённую конфигурацию и проверьте Inputs, имена полей, строки и источники SQL. Сохраните изменения, затем кнопкой ▶/↻ рядом с профилем выберите его для нужного Agent. ✓ обозначает опубликованную текущую версию.
  5. Проверьте тестовое обновление счёта, выбранного игрока, удаления и численного состава. Перед эфиром убедитесь, что на титрах появились ожидаемые данные.

Привязка к Input использует его имя и доступную сохранённую идентичность проекта. Переименование Input и замена GT-полей требуют проверки соответствий Mapping. Номер Input может изменяться при перестановке Inputs.

Несколько участников и матчей

Каждый участник входит в свою учётную запись. Разные матчи должны иметь разные активные назначения Agent; проверяйте имя устройства и матч перед передачей в vMix. Одинаковый шаблон Mapping можно использовать для разных устройств, но актуальный контекст матча и выбранных игроков относится к конкретному каналу.

За каждым Agent закреплена отдельная опубликованная версия связей Mapping. Сохранение шаблона не переключает остальные эфиры: ↻ означает, что появилась новая версия, которую можно явно применить к выбранному Agent. Одновременное сохранение устаревшего черновика выдаёт конфликт версии вместо перезаписи чужих изменений. Удаление шаблона сохраняет уже опубликованные версии на устройствах. SQL-источники остаются общими справочниками: их изменение влияет на все связи, которые используют этот источник. Проверяйте такие изменения вне эфира.

В одном матче оператор управляет общим состоянием, зритель видит обновления. Передавайте управление штатной кнопкой интерфейса. Вкладка зрителя не должна служить резервным операторским окном без передачи прав. Лимит параллельных матчей зависит от БД, источников и оборудования; фиксированного гарантированного числа эта сборка не устанавливает.

Таймеры и удаления

Первый запуск периода задаёт базовое время и запускает native Countdown vMix. Пауза использует PauseCountdown. При ручной правке времени новое значение должно сразу появиться в vMix; переход периода возвращает его настроенную базу. Регулярный период обычно 20:00, овертайм регулярного чемпионата 05:00; плей-офф использует отдельное правило из настроек.

При добавлении удаления проверьте выбранного игрока, тип/длительность штрафа, видимую плашку и численный состав. Снятие отложенного штрафа не должно снимать плашку действующего удаления. Совпадающие/обоюдные штрафы обрабатываются правилами численного состава; не заменяйте их ручным скрытием активного таймера.

Кнопки, последовательности и горячие клавиши настраиваются в редакторе интерфейса. Открытие редактора требует права и PIN; обычный вход открывает рабочий экран. Изменения публикуются отдельно от черновика. Не назначайте одну горячую клавишу нескольким независимым командам управления таймером.

Если данные перестали приходить

Проверьте связь сервера, Agent и vMix, назначение устройства, выбранный матч, состояние Mapping и сообщения об ошибке доставки. Зафиксируйте время, устройство, матч, Input и поле, которое не обновилось. Диагностика должна различать отсутствие данных источника, разрыв Agent и ошибку применения команды в vMix. Сохраните лог до перезапуска. Повторное применение Mapping может восстановить передачу, но скрывает первопричину; сведения о сбое нужны для её проверки.

В BUILD190 значения считаются применёнными только после подтверждения Agent. Временные ошибки безопасных установок текста/изображения/видимости получают ограниченный повтор. После восстановления связи и получения структуры титров синхронизация запускается автоматически. Работающие поля native Countdown при полном обновлении Mapping не перезаписываются.

Журнал программы

Кнопка «Журнал» в верхней панели доступна администратору. Для быстрого просмотра с телефона откройте http://АДРЕС_СЕРВЕРА:8000/logs (либо тот же путь на вашем обычном HTTPS-адресе) и войдите под своей учётной записью администратора.

Выберите «Сегодня», «7 дней», «Этот месяц» или «Все доступные». Можно указать свои даты — конечная дата включается полностью. Время и календарные границы отображаются по Москве. Фильтры позволяют выбрать уровень ошибки, раздел, участника, матч, Agent или найти текст в сообщении и деталях. Порядок «Сначала новые/старые» и переходы по страницам не меняют выбранные фильтры.

«Скачать TXT» создаёт читаемый файл для пересылки и просмотра; JSONL сохраняет структуру событий для технического разбора. Скачивается весь выбранный период, а не только открытая страница. Автообновление каждые 5 секунд включается отдельно и приостанавливается при закрытии журнала/скрытии вкладки или просмотре старой страницы.

Журнал содержит входы/выходы, HTTP-запросы, действия участников с ограниченными деталями, подключения Agent/vMix, отправки и подтверждения команд, обновления источников, исключения и замеры браузера. Пароли, PIN, ключи, токены, cookies, строки подключения БД и параметры SQL исключаются; большие payload ограничиваются. Это эксплуатационный журнал, а не копия всех пакетов/таблиц базы.

Для медленного компьютера найдите раздел browser, событие browser.ready. В деталях есть время ответа сервера, загрузки документа, получения конфигурации и данных, первоначальной отрисовки и общей готовности экрана. Эти значения позволяют сравнить два компьютера в одинаковом матче и сетевых условиях.