Три шкалы одного эпизода
Игровая минута или показание игровых часов относится к ходу матча. Она может учитывать период, добавленное время, обратный отсчёт или другую форму, принятую в конкретном протоколе.
Таймер записи видео показывает положение кадра в конкретном файле или трансляции. В него могут входить заставка, реклама, перерыв и пауза; поэтому он не равен игровым часам.
Календарное время описывает момент на шкале даты и часового пояса. Для точной записи нужны дата и смещение либо обозначение UTC. Z означает UTC.
| Метка | На какой вопрос отвечает |
|---|---|
| game_clock | Когда эпизод расположен в игровом ходе |
| video_offset | На какой позиции эпизод находится в записи |
| observed_at | Когда запись или сообщение были зафиксированы по календарным часам |
Привязка эпизода к записи
Вымышленный пример: в первом периоде эпизод отмечен в протоколе как «12:34». В видеозаписи он виден на отметке «01:46:20». Запись открыта и зафиксирована 2030-09-08T20:10:00Z.
Расшифровка: «12:34» следует хранить в поле игровых часов вместе с обозначением периода, например «period 1, game_clock 12:34». «01:46:20» — это video_offset, то есть 1 час 46 минут 20 секунд от начала данного видеофайла.
Перевод видеоотметки в секунды: 1 × 3600 + 46 × 60 + 20 = 6380 секунд. Это технически удобно для сортировки фрагментов, но результат 6380 секунд не становится игровой минутой.
Календарная метка 2030-09-08T20:10:00Z описывает момент фиксации записи, а не момент эпизода на поле или площадке. Если начало трансляции неизвестно, календарное время эпизода из video_offset не выводится.
- Запишите период или другую часть матча рядом с игровыми часами.
- Сохраните видеоотметку в формате, применённом в файле, и при необходимости отдельное числовое значение в секундах.
- Укажите, к какому именно видео относится video_offset: полная трансляция, нарезка или другой файл.
- Не вычисляйте календарный момент эпизода без подтверждённого календарного начала соответствующей записи.
Когда нельзя переводить одну шкалу в другую
Если видеозапись начинается до игрового старта или содержит паузы, разность между video_offset и игровыми часами меняется по ходу файла. Одна постоянная поправка для всего видео в таком случае неверна.
Показание «12:34» без названия периода также может быть недостаточным: одинаковое значение способно встретиться в разных частях матча. А значение «01:46:20» без указания файла не идентифицирует эпизод среди других записей.
Лента наблюдений пригодна для хранения эпизодов с источниками. Построчное сравнение протоколов может показать, что временная отметка изменилась, но не устанавливает смысл этой отметки и не определяет правильную версию автоматически.