西瓜视频m3u8.com网页：一份关于索引清单、分片加载与网页播放器协同的极简手册

m3u8 清单是一种惰性的描述文件，本身不含画面数据，只说明“有哪些片段、各自多长、按什么顺序取”。它的第一行固定为 #EXTM3U，随后由标签行与片段地址行交替排列，播放器自上而下读完即可建立播放计划。

#EXT-X-VERSION

清单遵循的协议版本，决定后续可用的标签范围

#EXT-X-TARGETDURATION

单个片段的时长上限，播放器据此安排缓冲节奏

#EXT-X-MEDIA-SEQUENCE

首个片段的序号；直播清单会随播放推进整体前移

#EXTINF

紧随其后的那一小段媒体的时长，单位是秒

#EXT-X-KEY

分片的加密方式与密钥获取地址，缺失时不应默认它是明文

#EXT-X-ENDLIST

该标签一出现即代表清单已完结，属于点播而不是直播

多变体清单与清晰度

当同一内容提供多个清晰度时，顶层清单往往只列出若干条子清单地址，每条各带一个带宽或分辨率标注。播放器根据当前带宽与设备能力挑一条子清单跟随，这就是清晰度自动切换的由来；观众手动选择时，相当于强制换到指定子清单。

1. 取得播放地址。页面在加载阶段拿到清单地址，它可能是相对路径，也可能带有时效签名；签名过期后再次请求会被直接拒绝，需要重新从页面获取而不是复用旧地址。
2. 解析索引清单。播放器逐行读取标签，建立分片队列，并优先拉取首个片段以便尽快出画。清单越长，建立队列的开销越明显。
3. 请求媒体分片。相邻分片可以并发请求，但必须按序拼装，否则时间轴会错位；出现丢片段时，画面通常表现为短暂定格或跳帧。
4. 解码与渲染。浏览器能直接处理时交给媒体管道，否则经 MSE 把分片追加进缓冲区再解码上屏，此时缓冲水位直接决定拖动是否顺畅。
5. 跟随清单更新。点播在读到结束标签后停止重取；直播则周期性重新拉取清单，丢弃已经滑出窗口的旧片段，保持播放点始终贴近最新内容。

音轨与字幕的位置

多语言音轨和字幕通常也以独立清单或独立分段的形式给出，并在顶层清单中以关联关系绑定。切换语言并不改变画面分片，只是换用另一路音频或字幕来源，因此切换时的画面位置一般无需重新加载。