不同步主因是格式、加载时机和浏览器策略敏感;须确保其位于内且在后,WebVTT首行为纯WEBVTT,时间戳严格为HH:MM:SS.mmm格式,srclang匹配系统语言,并配置跨域权限。

为什么<track></track>写了却不同步?
不是<track></track>没起作用,而是它对格式、加载时机和浏览器策略极其敏感。常见现象是:字幕全黑、延迟几秒、越播越偏、iPad上完全不显示——这些基本都卡在初始化阶段。
关键检查点:
-
<track></track>必须放在<video></video>内部、所有<source></source>之后,顺序错就失效 - WebVTT 文件首行必须是纯
WEBVTT(无空格、无BOM、无注释) - 时间戳必须严格为
HH:MM:SS.mmm格式,比如00:01:02.300,写成00:01:02.3或00:01:02.30在 iOS Safari 会累积漂移 -
srclang值要和用户系统语言匹配,否则即使加了default也可能被忽略 - 跨域资源必须带
crossorigin="anonymous"且服务端返回Access-Control-Allow-Origin
timeupdate事件里手动同步字幕的坑在哪?
想用 JavaScript 控制<mark></mark>或<div>模拟字幕?别绕开<code><track></track>自己造轮子——除非你真需要逐词高亮或动态文本替换。
如果非得手动同步,注意三点:
立即学习“前端免费学习笔记(深入)”;
- 别用
setInterval轮询video.currentTime,它和渲染帧率脱节,容易漏判或重复触发 - 用
video.addEventListener('timeupdate', handler),但要在 handler 里加容差判断:Math.abs(currentTime - cue.start) ,直接等号比对几乎必失败 -
currentTime是浮点数,受playbackRate影响;变速播放时,所有时间计算都要乘以该系数,否则字幕提前/滞后会指数级放大
iPad字幕不同步,最快修复法是什么?
iOS Safari 不是“不支持”,而是对时间戳做了毫秒整数归一化——它会把00:01:02.3当成00:01:02.000,再把00:01:02.300当成00:01:02.300,两者在解析链上就错位了。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
最稳做法是重导 WebVTT:
- 用
ffmpeg -i input.mp4 -vf "subtitles=subtitle.srt" -c:a copy output.mp4硬编码验证原始时间轴是否准 - 再用
ffmpeg -i subtitle.srt -c:s webvtt subtitle.vtt转出标准 VTT,强制三位毫秒、Unix 换行、无注释 - 确保
<track></track>标签带default,且srclang="zh"(或对应语言)与设备设置一致
高精度场景要不要上 Web Worker?
普通课程视频,原生<track></track> + 正确 VTT 就够了。但如果你做的是多轨道字幕切换、实时语音对齐、或用户可微调偏移(←/→键),主线程算时间校准确实会卡顿。
Worker 不是“更高级”,而是分工明确:
- 主线程只管
postMessage({ currentTime, playbackRate, droppedFrames }) - Worker 内做滑动窗口偏移估算、PTS 缩放、丢帧补偿预测,输出
{ id, start, end, text, render } - 渲染仍由主线程完成,只更新 DOM 中已存在的元素,不创建新节点
真正容易被忽略的,是video.getVideoPlaybackQuality()返回的droppedVideoFrames——它能告诉你当前是否因性能问题丢帧,而这个信号必须传给 Worker 才能反向修正字幕隐藏逻辑。没这个,再准的 VTT 也会在低端 iPad 上闪退。


















