HLS-плеєр: перевірити M3U8-стрім онлайн

Що показує плеєр

HLS (HTTP Live Streaming) нарізає відео на короткі файли й перелічує їх у текстовому плейлисті — .m3u8. Плеєр завантажує плейлист, потім сегменти один за одним звичайним HTTPS. Тому HLS грає в браузері й через CDN, а RTMP — ні.

Майстер-плейлист перелічує кілька варіантів того самого стріму з різною роздільністю й бітрейтом; плеєр обирає один і перемикається, коли змінюється з’єднання. Медіаплейлист перелічує сегменти одного варіанта. Список якості в показниках відображає варіанти майстер-плейлиста; у медіаплейлиста він один.

Плейлист прямого ефіру постійно росте й не має тегу кінця; плейлист запису закінчується #EXT-X-ENDLIST. Цільова тривалість — найдовший сегмент, який обіцяє сервер. Плеєри стартують приблизно за три таких сегменти від краю ефіру, тож із 6-секундними сегментами глядач відстає на ~18 секунд, ще до затримки енкодера.

Чому стрім, що грає деінде, не грає в браузері

• CORS. Браузер дозволяє сторінці читати файл з іншого сайту, лише якщо той сервер надсилає Access-Control-Allow-Origin. Десктопні плеєри на кшталт VLC і ffplay цього не перевіряють, тому грають стрім, який ця сторінка не може.
• Змішаний вміст. HTTPS-сторінка не може завантажити стрім за http://. Віддавайте плейлист і сегменти через HTTPS.
• Прострочені або закриті адреси. Підписані адреси мають токен, що спливає, а деякі CDN перевіряють Referer. 403 тут зазвичай означає одне з двох.
• Кодеки. Відео H.264 зі звуком AAC грає в кожному сучасному браузері. HEVC, AV1 і деякі аудіокодеки залежать від браузера й пристрою.

Стримінгові платформи працюють навпаки: ваш енкодер надсилає RTMP на YouTube, Twitch чи Kick, а вони перетворюють його на HLS для глядачів. Їхні сторінки перегляду — не .m3u8-посилання, а внутрішні плейлисти підписані й прив’язані до власних плеєрів, тож тут вони не заграють.

Як читати файл M3U8

.m3u8 — звичайний текст: відкрийте його у вкладці браузера чи текстовому редакторі. Майстер-плейлист називає по медіаплейлисту на кожен варіант якості з тегами, за якими плеєр обирає між ними:

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=2500000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2"
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=6000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2"
1080p/index.m3u8

Як зробити HLS-стрім для перевірки

Якщо потрібен власний стрім, FFmpeg зробить його з будь-якого відеофайлу. Ця команда відтворює файл у реальному часі й тримає вікно ефіру з шести 4-секундних сегментів:

ffmpeg -re -i input.mp4 \
  -c:v libx264 -preset veryfast -b:v 3000k -g 60 -keyint_min 60 -sc_threshold 0 \
  -c:a aac -b:a 128k \
  -f hls -hls_time 4 -hls_list_size 6 -hls_flags delete_segments \
  stream.m3u8

Для відео 30 fps -g 60 ставить ключовий кадр кожні 2 секунди, а -sc_threshold 0 не додає зайвих ключових кадрів на зміні сцен, тож кожен 4-секундний сегмент починається чисто. Приберіть -re і додайте -hls_playlist_type vod, щоб отримати плейлист запису. Віддавайте папку через HTTPS із заголовком CORS і правильними типами вмісту, наприклад у nginx:

location /hls/ {
    add_header Access-Control-Allow-Origin * always;
    types {
        application/vnd.apple.mpegurl m3u8;
        video/mp2t ts;
    }
}

Без заголовка браузери на інших сайтах, і ця сторінка теж, відмовляються читати стрім, а VLC його все одно грає.