如何基于localStorage存储的暂停时间实现视频从对应位置恢复播放?
视频断点续播修复方案
核心问题定位
- 你已经实现了暂停时把播放进度存入localStorage、也能读取存储值,但全程没有把读取到的时间值赋值给视频的
currentTime属性,这是没法跳转到对应播放位置的核心原因。 - 存在浏览器原生的行为限制:如果在视频元数据(包含视频总时长、可跳转播放范围的基础信息)还未加载完成时强行设置
currentTime,设置操作会被浏览器静默忽略,这是这类断点续播功能最常见的踩坑点。 - localStorage存储的内容默认是字符串格式,直接赋值虽然在多数场景下能被浏览器隐式转换,但最好显式转成数值类型,避免极端场景下的赋值异常。
修复后的可运行代码
<video id="myVideo" width="300" height="300" controls> <source src="Bunny.mp4" type="video/mp4"> Your browser does not support HTML5 video. </video><br /> <button onclick="PlayVideo()" type="button" id="PlayVideo">Play</button> <script> var vid = document.getElementById("myVideo") var isPlaying = false var STORAGE_KEY = 'CaptureTime' // 等视频元数据加载完成后再执行跳转设置,避免静默失效 vid.addEventListener('loadedmetadata', function() { // 读取本地存储的进度,不存在则默认从0开始 const savedProgress = parseFloat(localStorage.getItem(STORAGE_KEY)) || 0 // 校验进度有效性,避免存储值超出视频总时长导致跳转失败 if (savedProgress > 0 && savedProgress < vid.duration) { vid.currentTime = savedProgress } }) function getCurTime() { return vid.currentTime } function PlayVideo() { var changeBtn = document.getElementById("PlayVideo") // 播放前重新读取一次本地存储的进度 const savedProgress = parseFloat(localStorage.getItem(STORAGE_KEY)) || 0 if (isPlaying) { vid.pause() // 暂停时实时更新存储的播放进度 localStorage.setItem(STORAGE_KEY, getCurTime()) changeBtn.innerHTML = "Play" } else { // 可选:播放前强制对齐存储的进度,覆盖用户手动拖动进度条的操作,不需要可以删掉这段 if (savedProgress > 0 && savedProgress < vid.duration) { vid.currentTime = savedProgress } vid.play() changeBtn.innerHTML = "Pause" } isPlaying = !isPlaying } </script>
关键改动说明
- 新增
loadedmetadata事件监听:确保浏览器已经加载完视频的基础信息、支持进度跳转后,再执行进度赋值操作,解决原生的静默跳转失效问题。 - 所有从localStorage读取的进度值都通过
parseFloat转成数值类型,消除类型不匹配带来的潜在异常。 - 增加了进度有效性校验:只有当存储的进度在0到视频总时长的合法区间内,才会执行跳转,避免脏数据导致的功能异常。
- 支持灵活调整逻辑:如果不需要强制对齐用户上次的暂停位置、允许用户手动拖动进度条选择播放位置,只要删除
else分支里设置vid.currentTime的代码即可,仅保留页面初次加载时的断点跳转逻辑。
内容的提问来源于stack exchange,提问作者Vivek
相关产品推荐
相关产品推荐

