Master Playlist 里到底藏了什么？聊聊 M3U8 多码率自适应与广告插入技术

你打开一个 .m3u8 文件，发现里面不是分片列表，而是一堆指向其他 .m3u8 的链接——这是 Master Playlist（主播放列表），现代流媒体的核心调度器。它根据你的网速、屏幕分辨率、设备性能，自动选择最合适的码率档位，让你在网络波动时也能流畅观看。更"精彩"的是，视频平台还在 M3U8 里插入了广告分片、加密密钥、字幕轨道……本文深入拆解 Master Playlist 的完整结构、自适应码率切换算法、以及平台如何利用 M3U8 的扩展标签实现广告插入和内容保护。

TL;DR：Master M3U8 通过 #EXT-X-STREAM-INF 列出多档码率，播放器根据带宽估计算法动态切换。HLS 支持 AES-128、SAMPLE-AES、FairPlay 等多种加密。广告通过 #EXT-X-DISCONTINUITY 插入独立分片。下载工具需要处理 Master→Media 的码率选择、加密分片解密、以及广告分片的识别和跳过。

一、Master Playlist 结构全解析
二、自适应码率（ABR）的算法原理
三、HLS 加密体系：AES-128 与 FairPlay
四、广告插入： discontinuity 与 DATERANGE
五、字幕与多音轨：不止是视频
六、实战：解析 Master M3U8 选择最佳码率下载
七、HLS 与 DASH 的对比
八、合规与温馨提示

一、Master Playlist 结构全解析

1.1 两层结构：Master vs Media

HLS 协议定义了两层 M3U8：

Master Playlist（主播放列表）
├── #EXT-X-STREAM-INF: 1080P  → media-1080p.m3u8
├── #EXT-X-STREAM-INF: 720P   → media-720p.m3u8
├── #EXT-X-STREAM-INF: 480P   → media-480p.m3u8
└── #EXT-X-STREAM-INF: 360P   → media-360p.m3u8

Media Playlist（媒体播放列表）
└── 每个 media-*.m3u8 包含具体的 .ts 分片列表

1.2 一个真实的 Master Playlist 示例

#EXTM3U
#EXT-X-VERSION:7
#EXT-X-INDEPENDENT-SEGMENTS

# 1080P 高清
#EXT-X-STREAM-INF:BANDWIDTH=5800000,AVERAGE-BANDWIDTH=5200000,RESOLUTION=1920x1080,FRAME-RATE=30.000,CODECS="avc1.640028,mp4a.40.2",CLOSED-CAPTIONS="cc1",SUBTITLES="sub1"
1080p/index.m3u8

# 720P 标清
#EXT-X-STREAM-INF:BANDWIDTH=2800000,AVERAGE-BANDWIDTH=2400000,RESOLUTION=1280x720,FRAME-RATE=30.000,CODECS="avc1.4d401f,mp4a.40.2",CLOSED-CAPTIONS="cc1",SUBTITLES="sub1"
720p/index.m3u8

# 480P 流畅
#EXT-X-STREAM-INF:BANDWIDTH=1400000,AVERAGE-BANDWIDTH=1200000,RESOLUTION=854x480,FRAME-RATE=30.000,CODECS="avc1.4d401e,mp4a.40.2",CLOSED-CAPTIONS="cc1",SUBTITLES="sub1"
480p/index.m3u8

# 字幕轨道
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="sub1",NAME="中文",LANGUAGE="zh",URI="subtitles/zh.m3u8"

# 备用音频（多语言）
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio_aac",NAME="English",LANGUAGE="en",URI="audio/en.m3u8"

1.3 关键标签详解

标签	含义	下载策略
`BANDWIDTH`	峰值码率（bps）	选最高值获取最佳画质
`AVERAGE-BANDWIDTH`	平均码率（bps）	更准确的体积估算
`RESOLUTION`	分辨率	按需选择
`FRAME-RATE`	帧率	60fps 优先（运动视频）
`CODECS`	编码格式	检查兼容性
`CLOSED-CAPTIONS`	隐藏字幕组	可选
`SUBTITLES`	字幕组 ID	对应 `#EXT-X-MEDIA`
`#EXT-X-MEDIA`	备用轨道定义	单独下载字幕/音频

1.4 CODECS 字段的解析

avc1.640028 → H.264 High Profile Level 4.0
avc1.4d401f → H.264 Main Profile Level 3.1
avc1.4d401e → H.264 Main Profile Level 3.0
hvc1.2.4.L123.B0 → H.265/HEVC Main Profile Level 4.1
mp4a.40.2 → AAC-LC 音频
mp4a.40.5 → HE-AAC 音频

二、自适应码率（ABR）的算法原理

2.1 播放器如何选择码率

播放器的 ABR 算法是一个经典的在线决策问题：

# 简化的 ABR 决策逻辑
class ABRController:
    def __init__(self):
        self.buffer_level = 0       # 缓冲区时长（秒）
        self.current_bitrate = 0    # 当前码率
        self.throughput = 0         # 估计带宽

    def select_bitrate(self, available_bitrates, measured_throughput):
        """基于缓冲区和吞吐量选择码率"""
        # 策略 1：保守选择（避免卡顿）
        safe_bitrate = measured_throughput * 0.8

        # 策略 2：缓冲区充足时激进选择
        if self.buffer_level > 30:  # 缓冲超过30秒
            safe_bitrate = measured_throughput * 1.2

        # 策略 3：缓冲区不足时快速降级
        if self.buffer_level < 5:
            safe_bitrate = measured_throughput * 0.5

        # 选择不超过安全值的最优码率
        selected = max(
            [b for b in available_bitrates if b <= safe_bitrate],
            default=available_bitrates[0]
        )
        return selected

2.2 主流的 ABR 算法流派

算法	原理	优点	缺点
基于速率	根据历史下载速度预测	简单直接	网络波动大时画质频繁切换
基于缓冲	根据缓冲区水位调节	切换平滑	启动阶段保守
BOLA	基于 Lyapunov 优化	理论最优	实现复杂
Pensieve	强化学习	自适应学习	需要训练

2.3 对下载的影响

对于下载工具，不需要实时切换——直接选最高码率即可。但要注意：

最高 BANDWIDTH 不一定等于最佳画质：有些平台对高清档位用了更好的编码参数
RESOLUTION 相同但 BANDWIDTH 不同：优先选高码率的那个
有 AVERAGE-BANDWIDTH 就用它估算体积，比 BANDWIDTH 更准确

三、HLS 加密体系：AES-128 与 FairPlay

3.1 AES-128 加密

最常见的 HLS 加密方式：

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-KEY:METHOD=AES-128,URI="https://example.com/key.bin",IV=0x00000000000000000000000000000000
#EXTINF:10.0,
segment-0.ts
#EXTINF:10.0,
segment-1.ts
#EXT-X-KEY:METHOD=AES-128,URI="https://example.com/key2.bin",IV=0x00000000000000000000000000000001
#EXTINF:10.0,
segment-2.ts

关键点： - 每个分片独立加密，可以有不同的密钥和 IV - IV 缺省时使用分片序号（EXT-X-MEDIA-SEQUENCE + 序号） - 密钥 URL 通常需要 Cookie 鉴权

3.2 Python 解密实现

import requests
from Crypto.Cipher import AES

def download_encrypted_hls(m3u8_url, output_path):
    """下载并解密 HLS 视频"""
    session = requests.Session()
    # 设置鉴权 Cookie
    session.headers.update({'Referer': 'https://www.example.com'})

    # 解析 M3U8
    playlist = session.get(m3u8_url).text
    segments = parse_m3u8(playlist)  # 假设已实现解析

    current_key = None
    current_iv = None

    with open(output_path, 'wb') as out:
        for seg in segments:
            # 处理密钥更新
            if seg.get('key'):
                key_url = seg['key']['uri']
                current_key = session.get(key_url).content
                iv_str = seg['key'].get('iv', None)
                if iv_str:
                    current_iv = bytes.fromhex(iv_str[2:])  # 去掉 0x 前缀
                else:
                    # 使用分片序号作为 IV
                    current_iv = seg['seq'].to_bytes(16, 'big')

            # 下载加密分片
            ts_data = session.get(seg['url']).content

            # 解密
            if current_key:
                cipher = AES.new(current_key, AES.MODE_CBC, current_iv)
                ts_data = cipher.decrypt(ts_data)
                # 去除 PKCS7 填充
                pad_len = ts_data[-1]
                ts_data = ts_data[:-pad_len]

            out.write(ts_data)

3.3 其他加密方式

加密方式	标签	破解难度
AES-128	`METHOD=AES-128`	低（获取密钥即可）
SAMPLE-AES	`METHOD=SAMPLE-AES`	中（部分加密，需特定工具）
FairPlay	`METHOD=FAIRPLAY`	高（Apple DRM，需要设备密钥）
Widevine	`METHOD=WIDEVINE`（非标）	极高（Google DRM）

四、广告插入： discontinuity 与 DATERANGE

4.1 广告分片如何嵌入

平台通过 #EXT-X-DISCONTINUITY 标签插入广告：

#EXTINF:10.0,
content-segment-0.ts     # 正片分片

#EXT-X-DISCONTINUITY
#EXTINF:30.0,
ad-segment-1.ts           # 广告分片（编码参数可能不同）

#EXT-X-DISCONTINUITY
#EXTINF:10.0,
content-segment-1.ts     # 继续正片

#EXT-X-DISCONTINUITY 告诉播放器：接下来的分片编码参数可能变了——通常是帧率、分辨率、编码格式。播放器需要重置解码器。

4.2 下载时如何跳过广告

def filter_ad_segments(segments):
    """过滤广告分片"""
    clean_segments = []
    in_ad = False

    for seg in segments:
        if seg.get('discontinuity'):
            # 检测到断点，根据分片时长判断是否为广告
            # 广告通常 15-30 秒一段，正片 5-10 秒
            next_duration = peek_next_duration(segments, seg['index'])
            if next_duration and next_duration >= 15:
                in_ad = True
                continue

        if seg.get('discontinuity') and in_ad:
            # 又一个断点，广告结束
            in_ad = False
            continue

        if not in_ad:
            clean_segments.append(seg)

    return clean_segments

4.3 DATERANGE 标签（HLS 7+）

新版本 HLS 引入 #EXT-X-DATERANGE 用于标记广告时段：

#EXT-X-DATERANGE:ID="ad-1",CLASS="com.apple.hls.interstitial",START-DATE="2026-01-01T00:00:00Z",DURATION=30,X-AD-URL="https://ads.example.com/ad.m3u8"

X-AD-URL 直接指向广告的 M3U8 文件，下载时可以解析这个标签并排除对应分片。

五、字幕与多音轨：不止是视频

5.1 WebVTT 字幕

HLS 字幕通常使用 WebVTT 格式，由 #EXT-X-MEDIA 定义：

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="sub1",NAME="中文",LANGUAGE="zh",AUTOSELECT=YES,DEFAULT=YES,URI="subtitles/zh.m3u8"

字幕 M3U8 的结构：

#EXTM3U
#EXT-X-TARGETDURATION:60
#EXTINF:60.0,
subtitles-0.vtt
#EXTINF:60.0,
subtitles-1.vtt

WebVTT 内容：

WEBVTT

00:00:05.000 --> 00:00:10.000
大家好，欢迎收看本期视频

00:00:12.000 --> 00:00:18.000
今天我们来聊聊流媒体技术

5.2 多音轨

#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio_group",NAME="中文原声",LANGUAGE="zh",DEFAULT=YES,AUTOSELECT=YES,URI="audio/zh.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio_group",NAME="英语配音",LANGUAGE="en",URI="audio/en.m3u8"

#EXT-X-STREAM-INF:BANDWIDTH=6000000,AUDIO="audio_group",...
1080p/index.m3u8

下载时如果只需要中文，可以忽略英文音轨的 M3U8。

六、实战：解析 Master M3U8 选择最佳码率下载

import re
import requests
from urllib.parse import urljoin

class M3U8Downloader:
    """完整的 M3U8 下载器，支持 Master→Media 选择、加密解密、广告过滤"""

    def __init__(self):
        self.session = requests.Session()
        self.session.headers.update({
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) '
                          'AppleWebKit/537.36',
            'Accept': '*/*',
        })

    def parse_master_playlist(self, master_url):
        """解析 Master Playlist，返回所有码率选项"""
        content = self.session.get(master_url).text
        variants = []

        lines = content.strip().split('\n')
        for i, line in enumerate(lines):
            if line.startswith('#EXT-X-STREAM-INF:'):
                attrs = self._parse_attributes(line)
                # 下一行是子 M3U8 的 URL
                if i + 1 < len(lines) and not lines[i + 1].startswith('#'):
                    sub_url = urljoin(master_url, lines[i + 1].strip())
                    attrs['url'] = sub_url
                    variants.append(attrs)

        return variants

    def select_best_quality(self, variants, prefer='highest'):
        """选择最佳码率"""
        if prefer == 'highest':
            return max(variants, key=lambda v: v.get('BANDWIDTH', 0))
        elif prefer == 'lowest':
            return min(variants, key=lambda v: v.get('BANDWIDTH', 0))
        elif prefer == '1080p':
            for v in variants:
                if v.get('RESOLUTION') == '1920x1080':
                    return v
        return variants[0]

    def parse_media_playlist(self, media_url):
        """解析 Media Playlist，返回分片列表"""
        content = self.session.get(media_url).text
        segments = []
        current_key = None
        media_seq = 0

        lines = content.strip().split('\n')
        for i, line in enumerate(lines):
            if line.startswith('#EXT-X-KEY:'):
                current_key = self._parse_attributes(line)
            elif line.startswith('#EXT-X-MEDIA-SEQUENCE:'):
                media_seq = int(line.split(':')[1])
            elif line.startswith('#EXTINF:'):
                duration = float(line.split(':')[1].rstrip(','))
                if i + 1 < len(lines) and not lines[i + 1].startswith('#'):
                    seg_url = urljoin(media_url, lines[i + 1].strip())
                    segments.append({
                        'url': seg_url,
                        'duration': duration,
                        'key': current_key,
                        'seq': media_seq + len(segments)
                    })

        return segments

    def _parse_attributes(self, line):
        """解析 M3U8 属性列表"""
        # 提取冒号后的内容
        content = line.split(':', 1)[1] if ':' in line else line
        attrs = {}

        # 匹配 KEY=VALUE 对
        for match in re.finditer(r'([A-Z-]+)=("[^"]*"|[^,]+)', content):
            key = match.group(1)
            value = match.group(2).strip('"')
            if value.isdigit():
                value = int(value)
            attrs[key] = value

        return attrs

    def estimate_size(self, variant):
        """根据 AVERAGE-BANDWIDTH 估算视频体积"""
        avg_bitrate = variant.get('AVERAGE-BANDWIDTH', variant.get('BANDWIDTH', 0))
        duration = variant.get('_total_duration', 600)  # 默认 10 分钟
        size_mb = (avg_bitrate * duration) / 8 / 1024 / 1024
        return round(size_mb, 1)


# 使用示例
if __name__ == '__main__':
    downloader = M3U8Downloader()

    # 解析 Master Playlist
    variants = downloader.parse_master_playlist(
        'https://example.com/video/master.m3u8'
    )

    # 展示所有可选码率
    print("可用码率档位：")
    for v in variants:
        resolution = v.get('RESOLUTION', '未知')
        bitrate = v.get('BANDWIDTH', 0) / 1_000_000
        est_size = downloader.estimate_size(v)
        print(f"  {resolution} - {bitrate:.1f} Mbps - 预估体积 ~{est_size} MB")

    # 选择最高画质
    best = downloader.select_best_quality(variants, prefer='highest')
    print(f"\n选择: {best.get('RESOLUTION')} @ {best.get('BANDWIDTH')/1_000_000:.1f} Mbps")

    # 获取分片列表
    segments = downloader.parse_media_playlist(best['url'])
    print(f"共 {len(segments)} 个分片")

七、HLS 与 DASH 的对比

特性	HLS	DASH
分片格式	TS / fMP4	fMP4 / WebM
播放列表格式	M3U8（文本）	MPD（XML）
加密	AES-128 / FairPlay	Widevine / PlayReady
自适应	Master Playlist 多码率	AdaptationSet 多 Representation
延迟	HLS 传统 6-30s，LL-HLS 2-8s	类似，LL-DASH 2-5s
生态	Apple 主导，iOS/macOS 原生	开放标准，Android/Web 广泛支持

下载工具的选择：如果同时有 HLS 和 DASH 源，通常选 HLS——M3U8 文本格式更易解析，TS 分片合并也比 DASH 的 fMP4 简单。

八、合规与温馨提示

M3U8 中可能包含平台分发的加密密钥，破解加密内容可能违反 DMCA 或当地法律
广告收入是内容创作者的重要来源，下载时跳过广告仅限个人存档用途
本文技术内容仅供学习研究 HLS 协议实现，不鼓励用于破解付费内容或大规模抓取
更多讨论见下载视频算侵权吗？聊聊个人备份与版权的那条线

Master Playlist 里到底藏了什么？聊聊 M3U8 多码率自适应与广告插入技术

Master Playlist 里到底藏了什么？聊聊 M3U8 多码率自适应与广告插入技术

目录

一、Master Playlist 结构全解析

1.1 两层结构：Master vs Media

1.2 一个真实的 Master Playlist 示例

1.3 关键标签详解

1.4 CODECS 字段的解析

二、自适应码率（ABR）的算法原理

2.1 播放器如何选择码率

2.2 主流的 ABR 算法流派

2.3 对下载的影响

三、HLS 加密体系：AES-128 与 FairPlay

3.1 AES-128 加密

3.2 Python 解密实现

3.3 其他加密方式

四、广告插入： discontinuity 与 DATERANGE

4.1 广告分片如何嵌入

4.2 下载时如何跳过广告

4.3 DATERANGE 标签（HLS 7+）

五、字幕与多音轨：不止是视频

5.1 WebVTT 字幕

5.2 多音轨

六、实战：解析 Master M3U8 选择最佳码率下载

七、HLS 与 DASH 的对比

八、合规与温馨提示

相关推荐

想亲手试试？用 VidDown 一键解析下载

📝 关于技术博客