You need to enable JavaScript to run this app. 如何基于localStorage存储的暂停时间实现视频从对应位置恢复播放?
优惠活动
大模型
产品
解决方案
定价
更多

如何基于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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 19:27:03