iPhone Safari 上的 HLS 为何会暂停：行内播放、自动播放与可见状态
从行内／全屏行为、自动播放条件、画面外播放和串流错误等方面，诊断 iPhone Safari 上的 HLS 暂停。
iPhone Safari 上的 HLS 视频如果暂停或自动进入全屏，不一定是播放列表或网络故障。Safari 文档描述的媒体行为包括行内／全屏规则、自动播放条件，以及与可见状态相关的播放行为。如果没有记录视频元素和请求的变化，这些情况很容易被误认为串流重新加载。
先区分四种现象：视频是进入全屏、暂停、失去来源，还是停止收到媒体数据？使用同一条获授权的串流，一次只复现一个动作：点击播放、把视频滚出可视范围、静音／取消静音；等播放稳定后，再单独测试旋转。不要假设每次 iPhone Safari 暂停都有相同原因。
验证方法 — 2026 年 9 月 29 日： 我们核对了 Apple 当前的“Delivering Video Content for Safari”文档，以及 MDN 关于媒体 pause 事件和 play() 的资料。本文介绍文档记录的行为与诊断步骤；没有实测实体 iPhone、Safari 版本或实时 HLS 流。如需声称在特定设备复现，应使用受影响的 iOS 与 Safari 版本确认。
先区分行内播放与暂停
iPhone 上的 Safari 默认使用全屏播放，除非明确指定行内播放。如果嵌入式播放器应该留在页面中，请检查视频元素是否带有 playsinline，以及应用代码是否调用了全屏方法：
<video controls playsinline></video>
playsinline 会改变呈现方式；它不能修复损坏的播放列表、赋予自动播放权限，也不保证后台播放不中断。如果用户选择 Safari 原生全屏控制项，应把它视为呈现模式转换，并观察同一个视频元素和来源是否仍在使用。
调试 HLS 之前先核对自动播放条件
Apple 文档指出，Safari 自动播放需要 playsinline；默认情况下，只有视频没有音轨或处于静音状态时才允许自动播放。如果新增音轨、未经过用户操作就取消静音，或正在自动播放的视频不再位于屏幕内（例如滚出可视范围），播放可能会暂停。这些条件与分片返回 404 或 manifest 请求失败不同。
对于需要用户控制的串流，建议提供清晰可见的播放按钮，并在用户点击时开始播放。如果应用代码调用 video.play()，要处理返回的 promise：如果 promise 被拒绝，表示播放没有开始，不能报告为成功。不要不断自动重试；应保留用户可以点击的控件。
记录一次暂停前后的证据
在事件发生前后记录一小段时间线：
| 信号 | 有助于区分的情况 |
|---|---|
pause、playing、waiting、ended、error 事件 | 播放是暂停、停滞、结束，还是发生媒体错误 |
video.paused、currentTime、readyState、networkState | 媒体元素状态是否变化，还是播放时间只是停止前进 |
currentSrc 和视频元素身份 | 来源或实际媒体元素是否被替换 |
支持时的 fullscreenchange 和可见控件 | 呈现模式变化还是播放中断 |
| manifest 和下一个分片的请求活动 | 内容传送是否停止，或串流仍在继续请求 |
| 静音状态、音轨数量以及视频是否在屏幕内 | 能否用自动播放／可见条件解释暂停 |
不要记录完整串流 URL、签名查询字符串、Cookie、密钥或授权头。要区分整个文档变为隐藏状态，和视频只是滚出了屏幕；两者不是同一情况。如果播放期间页面可滚动，可以用 IntersectionObserver 或人工记录视频元素是否在屏幕内。
使用受控测试矩阵
使用同一条获准测试的串流，每次只改变一个条件：
| 测试 | 保持不变 | 记录内容 |
|---|---|---|
| 视频保持行内显示并点击播放 | 串流、网络、来源 | 是否开始播放，以及触发了哪些事件 |
| 播放时把视频滚出屏幕 | 来源和静音状态 | 暂停时间、元素可见状态、是否有新的分片请求 |
| 开始播放后静音或取消静音 | 播放位置和视口 | 音频状态变化后是否发生暂停 |
| 进入和退出原生全屏 | 来源和播放位置 | 全屏转换以及来源是否仍然连接 |
| 重新加载页面后再测一次 | 设备、Safari／iOS 版本 | 操作顺序是否可以复现 |
不要把桌面版 Safari、模拟器或 Chromium 的移动设备仿真当作 iPhone Safari 实测。如果无法使用出问题的设备，请报告确切的操作系统／浏览器版本，并标注为“文档核对”或“尚未测试”。
何时检查 HLS 请求链
当证据指向这些问题时，再调查播放列表、CORS、授权、CDN 或编解码器：manifest 或分片请求失败、响应内容是 HTML 而非媒体、来源意外改变，或者 Safari 报告解码／网络错误。如果自动播放中的视频滚出屏幕后暂停，但来源仍在连接、请求也有效，应先检查呈现或播放策略，不要直接判定 HLS 封装有问题。
延伸阅读：移动设备 HLS 播放指南、自动播放故障排查，以及手机旋转／播放器重建诊断。
一手参考资料
- Apple：Delivering Video Content for Safari
- Apple：WKWebView 的
allowsInlineMediaPlayback - MDN：
<video>元素与playsinline - MDN：
HTMLMediaElement的 pause 事件 - MDN：
HTMLMediaElement.play()
关键是判断 Safari 改变了呈现方式、应用了自动播放条件，还是确实失去了媒体传送。先在受影响的 iPhone 上记录事件顺序，再决定是否修改 HLS 封装或增加自动重试。