在專案裡用 HTML5 的 video 與 audio 標籤播放媒體,卻發現進度條完全無法拖動——這是一個很典型、但原因不在前端的問題。
一開始對照 W3C 範例逐行檢查,HTML 結構看起來沒有任何差異。接著做了一個對照實驗:把同一個 video 標籤改成播放本地檔案,結果進度條正常可用。
由此可確定問題不在標籤寫法,而在「載入來源」。於是打開 F12 比對兩者的網路回應,發現動態載入的版本回應標頭少了幾項關鍵資訊。把它們逐一補進後端程式碼,最後成功恢復。
response.setHeader("Cache-Control", "max-age=31536000, must-revalidate");
response.setHeader("Content-Length", file.length() + "");
if (fileName.contains(".mp4")) {
response.setContentType("video/mpeg4");
}
if (fileName.contains(".mp3")) {
response.setContentType("audio/mpeg");
response.setHeader("Accept-Ranges:", "bytes");
}
Content-Length:瀏覽器需要知道檔案總長度才能算出總時長、繪製完整的進度條。若回應使用 chunked 編碼而沒有這個標頭,duration 可能回傳 Infinity,進度條自然無法運作。
Accept-Ranges: bytes:這是拖動進度條的核心。瀏覽器在使用者拖曳時,會送出帶有 Range: bytes=起始-結束 的請求,只取檔中某一段;伺服器必須回應 206 Partial Content 並附帶 Content-Range,否則拖放的位置就無法對應到正確的播放時間。少了這個標頭,進度條只能顯示、不能操作。
Content-Type:正確的 MIME 型別能讓瀏覽器直接判定可否播放,不必先下載再試探。
範例中把 mp4 的 MIME 寫成 video/mpeg4,更標準的值其實是 video/mp4;setHeader("Accept-Ranges:", ...) 的標頭名稱末尾多了冒號,部分容器會因此無法正確解析,建議寫成 setHeader("Accept-Ranges", "bytes")。
若使用 Spring Boot 等框架,也可以直接把 ResourceRegionHttpMessageConverter 或 ResponseEntity<Resource> 交給框架處理 Range 請求,不必自己解析標頭。而在 Nginx 上靜態檔案預設就支援 Range,這個問題通常只出現在自行串流的動態輸出情境。
HTML5 影音的進度條依賴伺服器正確回應 Content-Length 與 Accept-Ranges。前端標籤寫得再對,後端不配合也一樣拖不動。遇到這類問題,與其繼續改前端,不如先打開 DevTools 看回應標頭。原文作者:youcanyouup。