- Главная
- Руководства
- index.m3u8 объяснение
Что такое index.m3u8? [Полное руководство 2026]
Разберитесь в master-плейлисте, который управляет вариантами HLS-потока.
index.m3u8 — это master-плейлист в HLS. Он указывает на варианты разного качества, чтобы плеер мог менять поток под текущую сеть и сохранять плавное воспроизведение.
Содержание
- Определение и роль index.m3u8
- Структура и формат файла
- Отличия от других m3u8-плейлистов
- Практическое применение
- Как найти и использовать index.m3u8
- FAQ
Определение и роль index.m3u8
Файл служит точкой входа в HLS-поток. Он не содержит media segments, а перечисляет sub-playlists с разными битрейтами, разрешениями и кодеками.
- Работает как master playlist, то есть manifest of manifests.
- Включает ABR-выбор для стабильного просмотра.
- Задает bandwidth, resolution, codecs и frame rate.
CDN часто называют master manifest index.m3u8, поэтому его легко найти при анализе трафика и диагностике playback.
Структура и формат файла
index.m3u8 — это UTF-8 текст с директивами HLS.
- #EXTM3U объявляет расширенный M3U playlist.
- #EXT-X-VERSION и #EXT-X-INDEPENDENT-SEGMENTS задают возможности протокола.
- #EXT-X-STREAM-INF описывает вариант через BANDWIDTH, RESOLUTION и CODECS.
- После директивы идет URI media playlist, например 1080p.m3u8.
#EXTM3U
#EXT-X-VERSION:7
#EXT-X-INDEPENDENT-SEGMENTS
#EXT-X-STREAM-INF:BANDWIDTH=5500000,AVERAGE-BANDWIDTH=4800000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2"
1080p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=3200000,AVERAGE-BANDWIDTH=2800000,RESOLUTION=1280x720,CODECS="avc1.64001F,mp4a.40.2"
720p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1600000,AVERAGE-BANDWIDTH=1400000,RESOLUTION=854x480,CODECS="avc1.4d401e,mp4a.40.2"
480p.m3u8#EXT-X-MEDIA описывает альтернативный звук или субтитры. #EXT-X-KEY ссылается на ключи шифрования, позволяя управлять DRM-цепочками из master manifest.
Отличия от других m3u8-плейлистов
- index.m3u8 — master manifest; media playlists вроде 720p.m3u8 перечисляют сегменты.
- Media playlists содержат длительности #EXTINF, а master — только варианты.
- Master может ссылаться на audio, subtitles и I-frame-only renditions.
- Analytics, QoE monitoring и ABR обычно используют метаданные master playlist.
Практическое применение
- Адаптивная доставка видео на Smart TV, в браузерах и мобильных приложениях.
- Live streaming при нестабильной сети.
- Multi-DRM workflows с ротацией ключей и ограничениями по вариантам.
- Мониторинг consistency renditions и encoding ladders.
Как найти и использовать index.m3u8
- Откройте DevTools, вкладку Network, и фильтруйте .m3u8.
- Ищите index.m3u8, master.m3u8 или параметры variant.
- Скопируйте URL в HLS player, FFmpeg или monitoring tool.
- При скачивании сохраняйте DRM/token параметры и при необходимости используйте -protocol_whitelist.
Master playlist быстро показывает отсутствующие renditions, неправильный bitrate ladder или несогласованные codec declarations.
FAQ
- Чем index.m3u8 отличается от других .m3u8?
- Это master playlist, который указывает на variant playlists. Media playlists содержат segment URLs.
- Можно ли воспроизвести index.m3u8 напрямую?
- Да. HLS-compatible player прочитает master manifest и запросит нужный media playlist.
- Безопасно ли делиться index.m3u8 URL?
- Нужно быть осторожным: часто используются signed URLs, DRM и быстро истекающие tokens.
- Всегда ли есть субтитры или multi-audio?
- Нет. Только если encoder создал такие ресурсы.
index.m3u8 — ключ к пониманию HLS topology. Корректная генерация и проверка делают доставку надежной и эффективной.