Блог

Круглосуточный HLS-канал из готовых видео: что ломает эфир

На этой странице

Линейный канал из VOD-библиотеки просят часто:

  • киноклуб хочет вечерний эфир на своём сайте
  • онлайн-школа хочет повторять лекции круглые сутки
  • бренд хочет крутить ролики на экранах в магазинах

Живого энкодера ни у кого из них нет. Есть только загруженные файлы. При этом им нужно вот что:

  • все зрители видят одно и то же в один момент
  • передача начинается в 20:00
  • рядом с плеером есть блок «сейчас / далее»

HLS — это просто плейлисты из сегментов. Поэтому первая мысль простая: взять сегменты первого ролика, за ними второго, потом третьего. И отдавать их как один live-плейлист, который растёт и никогда не получает #EXT-X-ENDLIST. Плееру всё равно, откуда сегменты, лишь бы шли подряд.

Так работает, пока все ролики одинаковые и программу никто не трогает. Ниже то, на чём у нас всё сломалось на реальной библиотеке, и что мы с этим сделали в канале 24/7 в dodocast.

Наш демо-канал Open Movies 24/7 работает на dodocast: шесть коротких фильмов (открытые фильмы Blender Foundation под CC BY и ролик NASA) идут по кругу длиной 22 минуты, а каждый день в 20:00 UTC начинается передача «Caminandes marathon». Поток открытый, и примеры ниже идут к нему.

Страница демо-канала: что идёт сейчас и далее, круг из 6 роликов (22:04) и передача Caminandes marathon в 20:00 UTC

Мастер-плейлист — контракт на весь сеанс

В live-режиме плеер постоянно перечитывает медиаплейлисты. Мастер-плейлист он читает только один раз, в начале просмотра. Дальше плеер верит тому, что в нём объявлено: качествам, разрешениям, кодекам, группам звука и группам субтитров. Условный пример:

m3u8
#EXTM3U
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="en",NAME="English",DEFAULT=YES,URI="audio/en.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="es",NAME="Español",URI="audio/es.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",URI="subs/en.m3u8"
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2800000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
720p/index.m3u8

С одним роликом этого не замечаешь. В канале каждый ролик, который выходит в эфир во время просмотра, должен совпадать с тем, что объявлено в мастер-плейлисте. Реальная библиотека не совпадает:

  • что-то загружено в 1080p, а что-то только в 720p
  • у одного фильма кадр 2,39:1, у остальных 16:9
  • у другого нет испанской дорожки

Если плеер играет 1080p, а у следующего ролика 1080p нет, плееру нечего скачивать.

Поэтому у канала в dodocast фиксированный формат. Формат задаёт, какие качества канал вещает (от 240p до 1080p), и одно соотношение сторон для всех. Ролик, который не подходит, в программу не попадает. Это лучше, чем оборвать поток всем, кто уже смотрит. Консоль показывает причину:

ПометкаЧто значит
«нет 1080p»У ролика нет качества, которое объявил канал.
«1080p кодируется…»Ролик только что загружен, и 1080p ещё не готово. Ролик подойдёт, когда кодирование закончится.
«шире формата»Кадр ролика шире, чем у канала, например фильм 2,39:1 в канале 16:9.

В CODECS строка avc1.640028 значит H.264, профиль High, уровень 4.0. По этой строке браузер решает, справится ли его декодер с роликом. Если канал объявит только уровень роликов, которые стоят в программе сейчас, более тяжёлый ролик, добавленный позже, может не пойти на части устройств. Поэтому канал объявляет верхний предел с запасом (в консоли это «Запас по уровню кодека»). Ролик, добавленный в эфир на ходу, укладывается в этот предел. Совсем старые устройства высокий объявленный уровень не принимают. Если они важны, запас можно выключить, но тогда возвращается риск с более тяжёлыми роликами.

С группами AUDIO и SUBTITLES так же. Допустим, канал объявил английский и испанский, а у следующего ролика есть только английский. Кто-то должен решить, что услышит зритель, который выбрал испанский. Мы оставили это решение владельцу канала. Владелец задаёт, какие языки канал обещает. Для роликов без этих языков он выбирает один из двух вариантов: подставить основную дорожку ролика или не пускать ролик в эфир. Если вы не объявили субтитры, плеер их не покажет, даже когда они есть у роликов.

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

Правка программы без обрыва

Программа тоже меняется. Люди добавляют новые ролики, убирают старые, переставляют остальные и хотят делать это в эфире. Если правка применяется сразу, зритель посреди одного ролика попадает в случайное место другого.

В dodocast правка публикует новую версию программы. Новая версия вступает в силу на ближайшем стыке роликов. До этого играет прежняя версия. Консоль показывает «Правка ожидает применения · с 21:36» и помечает ролики «добавлено» или «убрано». Зритель просто видит, как начинается следующий ролик.

Вкладка «Программа» демо-канала в эфире: шесть роликов, круг 22:04, ближайшее время выхода каждого ролика

Расписание поверх круга

Программа — это круг, который крутится бесконечно. Но телевидение живёт по часам: марафон в 20:00, лекции по будням в 9:00. Поэтому передачи стоят в сетке над кругом.

Передача — это ролик или целый плейлист в назначенное время: один раз, каждый день или в выбранные дни недели. Передача длится от 1 до 1440 минут. Если материал длиннее, канал его обрезает. Если короче, канал дополняет остаток наполнителем. Передачи не могут накладываться друг на друга.

Время передач задаётся в часовом поясе канала. Поэтому «каждый день в 20:00» остаётся в 20:00 и после перевода часов. Оно не съезжает на час дважды в год.

Ещё нужно было решить, что делает круг, когда передача кончилась. Единственно правильного ответа не нашлось, поэтому это настройка канала:

ВариантПосле передачиКогда подходит
«С начала»Круг начинается заново.короткая программа-заполнитель, которую важно показать целиком
«Продолжать»Круг идёт с того места, где его прервала передача.длинная программа, где повтор начала раздражал бы зрителя
«Как фоновый эфир»Круг всё это время шёл своим чередом. Передача его только перекрыла.канал «как настоящее ТВ», где фон живёт по своим часам

Сетку тоже можно править в эфире. Канал пересчитывает расписание в течение минуты. Зрители видят изменение с ближайшего показа.

Вкладка «Сетка» демо-канала: часовой пояс UTC, «Продолжать» в паузах между передачами, передача Caminandes marathon

EPG и шифрование

Если канал стоит на сайте, рядом почти всегда нужен блок «сейчас в эфире» или программа передач. Канал отдаёт своё текущее состояние и программу в JSON с открытым CORS. Поэтому их можно запрашивать прямо из браузера, и разбирать плеер не нужно. Оба запроса ниже работают с демо-каналом.

Блок «Данные канала в JSON» на вкладке «Обзор» канала в консоли, обе ссылки

Состояние говорит, какой ролик идёт сейчас, какой следующий и когда начнётся ближайшая передача:

bash
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI"

Ответ в сокращении:

json
{
  "title": "Open Movies 24/7",
  "state": "ON",
  "currentItem": { "title": "Wing It!", "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
  "nextItem": { "title": "Big Buck Bunny", "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
  "nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 }
}
Полный ответ
json
{
  "code": "cBlTOROrQI",
  "title": "Open Movies 24/7",
  "description": null,
  "tags": [],
  "state": "ON",
  "serverTimeMs": 1795088315571,
  "itemCount": 6,
  "totalDurationMs": 1324106,
  "encrypted": false,
  "poster": "https://stream.dodocast.com/preview/xOa9tZc7QO/cover.jpg?v=4ed796473e0a3fba01e92351074b25f147caa1eb3c33a090f026009ec0a356e1",
  "currentItem": { "code": "xOa9tZc7QO", "title": "Wing It!", "durationMs": 237894, "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
  "nextItem": { "code": "x10F5HR9Zt", "title": "Big Buck Bunny", "durationMs": 634425, "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
  "currentShow": null,
  "nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 },
  "access": { "type": "PUBLIC", "granted": true, "requiresPassword": false },
  "embedding": { "policy": "ALL", "domains": [] },
  "theme": { "colorPrimary": "indigo", "colorNeutral": "zinc" },
  "watchLayout": "LIVE_STAGE",
  "sources": {
    "mp4": "https://stream.dodocast.com/ch/mp4/cBlTOROrQI/master.m3u8",
    "ts": "https://stream.dodocast.com/ch/ts/cBlTOROrQI/master.m3u8"
  }
}

В примере ниже только этот запрос и hls.js. Плеер играет демо-канал, а блок под ним обновляется, когда кончается ролик.

Открыть живой пример на CodePen →Плеер демо-канала и блок «сейчас / далее» из JSON состояния канала (hls.js, без SDK).

В программе только передачи из сетки, роликов круга в ней нет. По умолчанию она охватывает ближайшие сутки, а с from и to (Unix-время в миллисекундах) может охватить до двух недель. Этот запрос берёт ближайшие семь дней:

bash
FROM=$(date +%s)000; TO=$(( $(date +%s) + 7*86400 ))000
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI/epg?from=$FROM&to=$TO"
Ответ (первые две записи из семи)
json
{
  "code": "cBlTOROrQI",
  "title": "Open Movies 24/7",
  "serverTimeMs": 1795089367508,
  "entries": [
    { "startsAtMs": 1795118400000, "endsAtMs": 1795118820000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] },
    { "startsAtMs": 1795204800000, "endsAtMs": 1795205220000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] }
  ]
}

В Player SDK это уже обёрнуто. getChannelState() возвращает, что сейчас и что дальше, getChannelGuide() возвращает программу до двух недель, а progress() показывает, сколько прошло от текущей передачи.

В одной программе легко оказываются и зашифрованные ролики, и обычные. Если каждый ролик приносит свой ключ, плеер меняет ключи на каждом стыке. Открытый ролик посреди зашифрованного эфира оставляет дыру. Поэтому у канала свой ключ. Канал не учитывает настройки шифрования отдельных видео и шифрует сегменты при отдаче. AES-128 и SAMPLE-AES защищают от простого скачивания. Это не DRM, и на сайте так и написано.

Чего канал пока не умеет

  • принимать живой сигнал с камеры или энкодера
  • вставлять рекламные паузы в эфир (SCTE-35)
  • давать зрителям перематывать канал назад (DVR)

Разовая трансляция в режиме «Премьера» даёт перемотать к своему началу, но не вперёд.

Как всё это выглядит в консоли, видно в обзоре dodocast за 2 минуты. Наш бесплатный HLS-плеер показывает, что внутри любого HLS-потока: качества, CODECS и дорожки. Он играет поток через hls.js или через встроенный плеер браузера, так что их можно сравнить.

Я работаю над dodocast, видеоплатформой для хостинга, каналов 24/7 и трансляций по расписанию. Вопросы о том, как собрать линейный HLS-эфир из VOD, пишите на hello@dodocast.com.

← Все статьи