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 與下一個片段的請求活動 | 傳送是否停止，或串流仍持續擷取資料 |
| 靜音狀態、音軌數，以及影片是否在畫面內 | 可解釋暫停的自動播放／可視狀態條件 |
不要記錄完整串流網址、簽署查詢字串、Cookie、金鑰或授權標頭。請區分整份文件變成隱藏狀態，與影片只是被捲出畫面；兩者不是同一現象。若頁面可在播放時捲動，可用 IntersectionObserver 或人工記錄影片元素是否在畫面內。
使用受控測試矩陣
使用同一條獲准測試的串流，每次只改變一項條件：
| 測試 | 保持不變 | 記錄內容 |
|---|---|---|
| 影片維持行內顯示並點選播放 | 串流、網路、來源 | 是否開始播放，以及觸發哪些事件 |
| 播放時將影片捲出畫面 | 來源與靜音狀態 | 暫停時間、元素可視狀態、是否有新片段請求 |
| 開始播放後靜音或取消靜音 | 播放位置與視窗 | 音訊狀態改變後是否暫停 |
| 進入及離開原生全螢幕 | 來源與播放位置 | 全螢幕切換及來源是否仍連結 |
| 重新載入頁面後再測一次 | 裝置、Safari／iOS 版本 | 操作順序是否可重現 |
不要把桌面版 Safari、模擬器或 Chromium 行動裝置模擬視為 iPhone Safari 實測。若無法使用受影響裝置，請回報確切 OS／瀏覽器版本，並標示為「文件核對」或「尚未測試」。
何時該檢查 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 封裝或加入自動重試。