HTML5媒体播放器实现“记忆播放”需监听pause、ended和visibilitychange事件实时保存currentTime至localStorage,键名用videoId或标准化URL,加载时读取并跳转,点击重播时清除对应key。

HTML5 媒体播放器实现“记忆播放”(即下次打开时从上次停止的位置继续播放),核心是 监听播放进度 + 本地存储时间点 + 页面加载时自动跳转。不需要后端,纯前端即可完成,关键是时机和精度的把控。
监听页面播放与暂停事件,实时保存播放时间
用户暂停或离开页面前,需及时记录当前 currentTime。推荐监听 pause、ended 和 visibilitychange(页面切到后台时)事件:
- 在
pause时存一次,覆盖之前可能未更新的值 - 监听
document.visibilityState,当页面隐藏(visibilitychange触发且state === 'hidden')时立即保存,防止用户直接关页签丢进度 - 可配合
timeupdate节流保存(如每 10 秒记一次),避免频繁写入 localStorage 影响性能
用 localStorage 按视频 URL 或 ID 存储进度
不能只存一个时间戳,否则多个视频会互相覆盖。建议用唯一键名,例如:
localStorage.setItem('video_progress_' + videoId, currentTime.toFixed(2))- 若用 src 地址做标识,注意 URL 可能带参数或编码差异,建议先
new URL(src).origin + new URL(src).pathname标准化 - 存之前校验
currentTime > 0 && currentTime ,避免存无效值(如 0 或 NaN)
页面加载后自动恢复播放位置
在 元素加载完成(loadedmetadata)后再设置 currentTime,否则会报错或无效:
- 监听
video.addEventListener('loadedmetadata', () => { ... }) - 从中取出对应视频的记录值,用
parseFloat()转为数字,并限制在合法范围内(Math.min(savedTime, video.duration - 0.5)) - 设置完
currentTime后,可选调用video.play().catch(e => console.warn('自动播放被阻止'))尝试续播(注意浏览器自动播放策略限制)
补充体验细节:清除逻辑与多设备同步
记忆功能要“可预期”,不能让用户困惑:
- 用户点击“重新开始”或“重播”时,主动清除对应 key:
localStorage.removeItem('video_progress_' + videoId) - 如需跨设备同步进度,必须上服务端(如登录后存到用户 profile),localStorage 是浏览器隔离的,无法共享
- 可加 UI 提示,例如在播放器右下角显示“已记住 12:35,点击继续”(需判断是否已存且未过期)
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











