云映 HLS 缺段跟读：GAP 标记不等于黑色视频

这课讨论清单对缺少媒体的声明，不教删除片段。先读明确版本的公开工作草案，再用三个四秒条目的原创摘录检查作用范围，最后记录真实来源。示例地址不提供资源，不能把文字审核写成云映已播放或已自动修复；黑屏现象也不足以倒推出清单一定带有 GAP。

一、先固定所依据的资料版本

本课依据HTTP Live Streaming第二版工作草案22对 EXT-X-GAP 的说明。该文是工作草案，正文标注二〇二六年五月一日、十一月二日到期，不把它称为已正式发布的新 RFC，也不说旧 RFC 8216 已包含本标签。学习时保存这个明确版本与访问日期；以后文档变化重新核条文，不把草案状态、格式能力与具体播放器实现合并成一句“全都支持”。

二、保留真实清单与来源身份

只读取自己有权访问的清单副本，记地址、取得时间、来源名称与是否拿到媒体对象。没有真实资料时用下列摘录完成练读，真实字段写未取得；不从播放器画面或错误文字猜出原清单内容。示例三段名称 a、missing、c 只用于区分位置，字母不表示剧情，文件名中写 missing 也不是缺段标签的替代品。审核过程不覆盖服务器上的文件、不删除旧来源，也不把不存在的示例地址拿去反复重试当网络诊断。

三、把标记只连到下一媒体段

摘录把 GAP 放在第二段前，按该草案的定义，它声明所作用的下一媒体段 URI 不包含媒体数据，并建议客户端不加载。画箭头连到 missing.ts，不把它连到前一段 a.ts，也不让它一直作用到后续所有段。草案语义只说明声明的含义，不能凭文本证明真实服务器返回了什么，更不能将缺段解释为一个编码完整的黑色视频文件。对未知的 URI 返回对象保持待核，保留标记和对象两类证据。

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:4
#EXTINF:4.0,
a.ts
#EXTINF:4.0,
#EXT-X-GAP
missing.ts
#EXTINF:4.0,
c.ts
#EXT-X-ENDLIST

四、保存十二秒声明范围的台账

按摘录的相对时长画零到四、四到八、八到十二三格，第二格注明缺段声明，三条 EXTINF 相加仍为十二秒。这个台账仅解释清单声明，不保证设备界面显示什么总时长，也不保证遇缺段时会等待、跳转或显示某种固定画面。不能直接删第二行四秒就把后面内容重编号为四秒开始，那会变成另一份编辑后的时间模型，而非读懂原清单。每次记录都保留相对时间、段身份和实际可用性三栏。

五、用黑色视频作概念对照

另设对照：一段确有编码媒体数据的四秒黑画面。它可以有可解码画面甚至声音，与“下一 URI 不含媒体数据”的声明不同。这里只做概念辨析，没有提供该媒体文件，不把它写成已经跑过的播放实验。对实际看到的黑屏，先记录画面持续范围、声音是否仍在以及来源身份；仅凭黑色不能断定有 GAP，同样有 GAP 也不能承诺应用必定绘制黑色视频。不能靠改文件名或删除标签生成缺失的媒体字节。

六、在云映记录可复查的现象

对真实来源从缺段前的可用位置顺播，记录可见时间、声音、等待或错误的原文，再检查后续可用内容是否能认出。没有清单就只能描述现象，不能填“已发现 GAP”。当前公开更新没有承诺所有 HLS 草案扩展的支持；本课也不把一次结果扩大为完整兼容认证。保留原片与可用备用来源，若需要提供者补齐缺少媒体，只反馈自己实际掌握的清单条目和观察，不声称应用能凭空恢复不存在的内容。

七、区分缺段声明与请求失败

若没有 GAP 但某地址请求失败，应另记请求结果，不能反过来给原清单补一个标签再说证据一致。若标签位置不清，回到下一媒体段的作用范围核对；若总范围算错，重新逐条加时长，不用应用进度条替代清单算术。一次只修正文档中的一个误读，原资料保留。真实来源后来被更新时，新的取得时间与内容另存，避免将今天的标签和昨天的错误拼成同一次会话，更不能未经来源方授权改远端配置。

八、重开可用来源并交付限制

退出后重开自己的完整可用样本，确认日常来源没有被练习摘录替换。交付明确版本的参考、三段时间尺、标签作用箭头、黑帧对照与实际观察状态。通过标准是能分清“声明缺媒体”“有媒体但画面黑”“请求失败”三件事，并说明哪些未核。换清单后重新检查，不把本例第二段位置写成固定规则；未执行真机测试、资源获取或部署验证的部分都保留待核，不能改写为已通过。