Превью канала¶

Списку каналов в приложении оператора, EPG и мониторинговой стене нужны картинки: что сейчас в эфире. Для этого у канала есть превью — стример регулярно делает JPEG-кадр и отдаёт его по постоянному адресу. Настраивается в блоке Превью на вкладке Обработка.

Настройте превью¶

Нажмите + Добавить превью и выберите Источник:

Ключевой кадр потока — стример рендерит JPEG из ключевых кадров канала. Поля: Дорожка (видеодорожка, обычно v1), Ширина и Высота (достаточно одной — вторая по пропорциям; ширина по умолчанию 320), Каждые — как часто, в GOP-ах (gop — каждый, 2gop — через один).
HTTP-запрос — стример не рендерит сам, а периодически забирает готовую картинку по URL для HTTP-запроса — так удобно с IP-камерами, умеющими отдавать снапшот.

Галка Хранить превью в DVR дополнительно пишет миниатюры в архив — вместе с записью канала появляется и её визуальная лента.

У канала может быть до десяти превью-дорожек — например, маленькая для списка и покрупнее для карточки канала.

Блок Превью с настроенной дорожкой из ключевых кадров

Заберите картинку¶

Свежий кадр канала отдаётся по адресу:

/streaming/live-preview-jpeg/<имя-канала>

Ответ — обычный JPEG; клиентский интерфейс просто перезапрашивает его с нужной периодичностью:

Кадр, который отдаёт стример

Пока превью у канала не настроены, адрес отвечает 404 — сами по себе миниатюры не рендерятся, это работа, которую нужно включить.

Если картинки нет¶

404. Превью не настроены, канал не в эфире или первый ключевой кадр ещё не пришёл — при Каждые: 2gop и длинном GOP первый кадр может задержаться на десятки секунд.
Картинка есть, но застыла. Источник превью — HTTP-запрос, а камера отдаёт кэшированный снапшот; проверьте URL камеры напрямую.
Дорожка не находится. Поле Дорожка должно называть существующую видеодорожку канала — посмотрите её идентификатор в карточке здоровья источника (обычно v1).