编码与格式 / 系统课时

将直播媒体切成 HLS 分片清单

将直播媒体切成 HLS 分片清单

本课使用 FFmpeg 将视频转换为可通过 HTTP 播放的 HLS 直播流,生成 M3U8 播放列表和 TS 媒体分片。通过实际命令和播放器验证,掌握分片时长、播放列表窗口及关键帧间隔如何影响直播延迟,并识别常见的分片失败问题。

学习目标

  • 使用 FFmpeg 生成 HLS 媒体分片和动态 M3U8 播放列表。
  • 理解 hls_time、hls_list_size、GOP 与直播延迟之间的关系。
  • 验证分片清单的正确性,并定位分片过长、播放器卡顿等问题。

HLS 分片与播放列表如何配合

HLS(HTTP Live Streaming)将连续媒体拆成多个可通过 HTTP 获取的片段。播放器先请求 M3U8 清单,再按照清单中的顺序下载媒体分片、解码并播放。

传统 HLS 常使用 MPEG-TS 分片,扩展名为 .ts;也支持 fragmented MP4(fMP4)。本课采用 TS,方便直接观察分片文件。

一个典型的 HLS 直播目录包含:

  • index.m3u8:媒体播放列表,记录当前可播放的分片。
  • seg_000.ts、seg_001.ts:实际的音视频媒体数据。
  • 后续分片:FFmpeg 持续生成,播放列表也不断更新。

HLS直播分片生成与播放器请求流程

直播媒体播放列表与点播列表有一个重要区别:直播时通常没有 #EXT-X-ENDLIST,播放器因此知道后续还可能出现新分片。直播播放列表还使用 #EXT-X-MEDIA-SEQUENCE 标识当前列表首个分片的媒体序列号。

使用 FFmpeg 生成 HLS 直播流

准备一个包含视频和音频的 input.mp4,安装支持 libx264 和 aac 编码器的 FFmpeg。可以先执行 ffmpeg -encoders,确认列表中存在 libx264 和 aac。

下面的命令将本地视频循环作为模拟直播输入,持续输出约 2 秒一片的 HLS 流。适用于 FFmpeg 6.x、7.x、8.x 中的常规 HLS MPEG-TS 输出。

bash
mkdir -p hls
ffmpeg -hide_banner -loglevel warning -re -stream_loop -1 -i input.mp4 -map 0:v:0 -map 0:a:0 -c:v libx264 -preset veryfast -b:v 2000k -pix_fmt yuv420p -r 25 -g 50 -keyint_min 50 -sc_threshold 0 -force_key_frames "expr:gte(t,n_forced*2)" -c:a aac -b:a 128k -ar 48000 -f hls -hls_time 2 -hls_list_size 6 -hls_flags delete_segments+independent_segments -hls_delete_threshold 1 -hls_segment_filename "hls/seg_%03d.ts" hls/index.m3u8

预期结果:命令持续运行后,hls 目录中出现 index.m3u8 和不断增长编号的 .ts 文件。终端可能没有持续日志,因为使用了 -loglevel warning;按 Ctrl+C 可停止模拟直播。

这组配置中:

参数 本例取值 作用
-re 启用 按输入媒体时间戳速率读取文件,模拟实时输入
-stream_loop -1 无限循环读取输入文件
-hls_time 2 设置目标分片时长为 2 秒
-hls_list_size 6 播放列表最多保留 6 个媒体分片条目
-g 50 在 25 fps 输出下设置 50 帧 GOP
-sc_threshold 0 关闭基于场景变化的额外关键帧插入
-force_key_frames 每 2 秒 在目标时间位置强制插入关键帧
delete_segments 启用 删除不再被清单引用且超过保留条件的旧分片
independent_segments 启用 声明分片可独立解码,要求编码设置与之匹配

-map 0:a:0 要求输入文件至少存在一条音轨。只有视频轨的素材应移除此映射并添加 -an;如果音轨可有可无,可以将音频映射改为 -map 0:a:0?。

检查 M3U8 内容和媒体分片

保持 FFmpeg 运行,在另一个终端读取播放列表。

bash
cat hls/index.m3u8

预期输出示例:

text
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:2
#EXT-X-MEDIA-SEQUENCE:12
#EXT-X-INDEPENDENT-SEGMENTS
#EXTINF:2.000000,
seg_012.ts
#EXTINF:2.000000,
seg_013.ts
#EXTINF:2.000000,
seg_014.ts
#EXTINF:2.000000,
seg_015.ts
#EXTINF:2.000000,
seg_016.ts
#EXTINF:2.000000,
seg_017.ts

这是符合本例参数的示意输出,并非每次运行都逐字相同。实际媒体序列号、分片名称和时长取决于采集时间、时间戳以及编码边界。

重点检查以下字段:

  • #EXTM3U:表明文件是扩展 M3U 播放列表。
  • #EXT-X-TARGETDURATION:分片目标时长的整数秒值,必须满足 HLS 对实际分片时长的约束。
  • #EXT-X-MEDIA-SEQUENCE:列表中第一个媒体分片的序列号,并非整个直播已经生成的分片数量。
  • #EXTINF:紧随其后的分片实际媒体持续时间。
  • #EXT-X-INDEPENDENT-SEGMENTS:声明媒体分片具有独立解码能力,应保证每个分片从适当的随机访问点开始。

使用 FFprobe 检查其中一个分片的实际持续时间:

bash
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1 hls/seg_012.ts

预期输出示例:

text
duration=2.000000

其中 seg_012.ts 只是示例文件名,实际检查时应替换为当前目录中存在的分片。分片持续时间允许存在小幅偏差,并不要求严格等于 2.000000 秒。

如果需要通过 HTTP 测试,可以在项目工作目录启动静态服务器:

bash
python3 -m http.server 8000

预期输出示例:

text
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...

使用 VLC 的“媒体 → 打开网络串流”功能,输入 http://127.0.0.1:8000/hls/index.m3u8,应能播放持续更新的模拟直播。端口 8000 是本例固定值;若端口被占用,应更换空闲端口并同步修改播放地址。

Python 简易 HTTP 服务器仅用于本机验证;正式上线还需要检查 M3U8 和 TS 的 MIME 类型、跨域响应头、缓存策略及 HTTPS 配置。

分片时长和列表窗口如何影响延迟

-hls_time 2 只是分片的目标持续时间,不代表播放器的直播延迟就是 2 秒。HLS 通常需要等待分片封装完成,播放器还会主动保留一定的播放缓冲。

假设每个分片实际持续 2 秒,列表保留 6 个分片,那么播放列表覆盖的媒体时间约为:

2×6=12 秒2\times6=12\text{ 秒}

这 12 秒是当前播放列表覆盖的媒体时长,不是承诺的端到端延迟。若播放器选择落后直播边缘约 3 个分片的位置开始播放,则仅这一部分距离就约为 6 秒,此外还要考虑编码、上传、网络传输、清单轮询及解码时间。

配置方案 分片目标时长 列表条目数 列表覆盖时长约值
方案 A 6 秒 5 30 秒
方案 B 2 秒 6 12 秒
方案 C 1 秒 6 6 秒

缩短分片通常有助于缩短分片发布周期,但会增加 HTTP 请求次数、文件管理开销和对网络抖动的敏感性。列表窗口过短还可能导致网络较慢的播放器请求已经被移除的分片。

在普通 HLS 直播中,可以先以 2~6 秒分片进行测试,观察实际直播延迟、首帧时间和卡顿率,再根据业务需求调整。需要更低延迟时,应进一步评估 Low-Latency HLS,而不是单纯把传统 TS 分片缩短到极小值。

关键帧为何决定实际切片位置

HLS 分片器通常需要在关键帧处切分媒体。即使设置 -hls_time 2,如果视频每 5 秒才出现一个可用关键帧,实际分片仍可能接近 5 秒,甚至在时间戳或编码条件异常时更长。

以 25 fps 视频为例,目标每 2 秒产生一个 GOP 边界:

GOP=25×2=50 帧GOP=25\times2=50\text{ 帧}

因此本例同时使用 -r 25、-g 50 和 -force_key_frames。其中 -g 规定最大关键帧间隔,强制关键帧参数则进一步约束期望的时间切点。实际切点还受时间基、帧时间戳和编码器行为影响。

GOP关键帧间隔与HLS分片边界的关系

当输入编码已经是 H.264,直接使用 -c:v copy 可以降低转码开销,但不能重新安排原视频关键帧。若原始关键帧分布无法满足切片要求,就应重新编码或在上游编码器调整 GOP。

另外,-hls_flags independent_segments 不能让原本不可独立解码的分片自动变得独立。使用该标志前,应确保编码器输出的关键帧和分片起点满足要求。

常见失败现象与修正方法

分片实际长度明显超过设置值:先检查 FFprobe 报告的分片时长,再检查源视频帧率和关键帧间隔。如果采用视频流复制且关键帧过稀,应改为重新编码并设置适当 GOP。

播放器播放一段时间后出现 404:直播列表已经滑动,旧分片可能被删除。检查播放器是否长期停留在过期播放位置,并增加 hls_list_size 或合理延长旧分片保留时间。delete_segments 的实际删除时间还受到分片时长和 hls_delete_threshold 等条件影响,并非分片一退出列表就立即删除。

直播卡顿但文件正常生成:分别检查 HTTP 请求耗时、分片下载速度、编码器处理速度以及播放器缓冲。如果编码速度低于实时要求,优先尝试降低分辨率、码率或使用更快的编码预设,而不是直接缩短分片。

M3U8 能访问但视频无法播放:确认其中的相对 TS 地址能够通过 HTTP 访问,服务器正确提供媒体内容,并检查目标播放器是否支持当前视频和音频编码格式。浏览器原生 HLS 支持存在差异,不能因为 M3U8 地址可访问就认定所有浏览器均可直接播放。

实际验收时,持续观察至少 30 秒:清单应不断更新、媒体序列号逐步递增、分片可被访问、播放器能够连续播放。对于本例,分片时长接近 2 秒、列表保持约 6 个条目且没有持续 404 或缓冲中断,即可认为基本分片链路正常。最终直播延迟仍应通过采集端与播放端的实际时间差单独测量。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将直播媒体切成 HLS 分片清单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通