核心是用响应式时间源统一驱动所有组件:父组件或Pinia中用ref(0)定义videoTime,播放器负责读写校验,其他组件只读;播放器节流更新、拖拽防抖、值校验;非控制组件纯响应消费;暂停恢复、跨端同步需兜底校准。

核心是用一个响应式时间源统一驱动所有组件,播放器负责读写和校验,其他组件只读不干预。
定义共享的响应式时间变量
在父组件或 Pinia store 中创建单一可信源:
- 推荐用 ref(0) 而非 reactive 包裹整个 media 对象,避免不必要的响应式开销
- 通过 provide/inject 或 store 暴露给子组件,确保所有进度条、字幕、章节列表都读取同一份
videoTime - 不要让多个组件各自访问
audio.currentTime,那是竞态源头
播放器组件:读取 + 写入 + 防抖校验
它唯一有权修改时间源的组件,需兼顾同步与容错:
- 监听 timeupdate,用节流(如 30ms)更新
videoTime.value = audio.currentTime - 监听 loadedmetadata 后才启用同步,避免 duration 为 NaN 导致计算异常
- 拖拽时先 暂停,赋值
audio.currentTime后等待 seeked 事件再恢复,防止跳变 - 对写入值做校验:过滤 NaN、Infinity、负数及超出 duration 的值
非控制类组件:纯响应、零副作用
进度条、歌词、时间轴等只消费时间,不触发任何 DOM 操作或媒体方法:
- 进度条显示直接绑定
:value="videoTime",拖动时只 emit('seek', time) - 歌词高亮用 computed 查找当前时间对应索引,避免每次渲染遍历数组
- 章节跳转点击后发事件,由播放器统一处理 seek 和状态同步
应对真实场景的兜底逻辑
暂停、切后台、多端同步等不能只靠原生事件:
- 暂停时记录
lastPausedTime;恢复前比对audio.currentTime,不一致就手动修正 - 需要跨设备同步时,
videoTime上报服务端,客户端通过 WebSocket 接收校准指令 - 组件挂载时 watchEffect 自动执行一次,结合
loadedmetadata判断是否就绪
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











