video.textTracks切换字幕仅控制显隐,不影响视频播放状态;需手动设置currentTime=0并调用play()才能重播,且必须在用户手势回调中执行。

video.textTracks 切换时不会自动重播
调用 textTracks[i].mode = 'showing' 只控制字幕显隐,完全不影响视频当前播放状态。哪怕你刚切到新语言字幕,视频照样在原位置继续播——它根本不知道你在动字幕轨道。
常见错误是以为“换了字幕=重播”,结果用户看到画面和字幕时间轴错位,尤其当新字幕文件起始时间不一致时,第一句就对不上。
- 字幕轨道加载完成 ≠ 视频重播,二者生命周期独立
-
textTracks列表里的每个TextTrack对象没有reload()或reset()方法 - 浏览器不会因字幕切换触发
seeked或timeupdate事件
想“重置播放”得手动操作 currentTime
真正让视频回到开头、再配合新字幕显示,必须显式设置 video.currentTime = 0,然后调 play()(或保持暂停态)。但要注意:这个操作受浏览器播放策略约束,不能在非用户手势上下文中执行。
- 必须在 click/tap 等用户事件回调里做,比如字幕选择按钮的
onclick - 设完
currentTime = 0后立即play(),否则可能卡在 0 秒不动 - iOS Safari 和新版 Chrome 会拒绝无交互的
play(),即使currentTime已归零 - 如果视频处于
paused状态,play()会恢复播放;如果已结束,play()也会从头开始
优酷等第三方播放器不走标准 textTracks 流程
像优酷、腾讯视频这类封装播放器,video.textTracks 基本不可用——它们压根没挂载真实 track 元素,或者用自定义 DOM 覆盖了原生控件。你查 video.textTracks.length 很可能为 0,video.addTextTrack() 也无效。
立即学习“前端免费学习笔记(深入)”;
- 不要试图用
video.textTracks[0].mode = 'disabled'关优酷字幕,这行不通 - 嵌入优酷
iframe时,唯一可控入口是 URL 参数,如?lang=zh_CN&subtitle=off(具体参数以优酷文档为准) - PC 网页端手动关字幕,必须先播放(哪怕只播 1 帧),按钮才激活;未登录账号时该按钮直接不渲染
WebVTT 字幕文件变更后需重新加载 track
如果你动态替换字幕内容(比如用户选新语种后用 JS 修改 track.src),浏览器不会自动 fetch 新 VTT 文件并应用——它只会静默忽略这次赋值。
正确做法是移除旧 track 元素,新建一个并 append 到 video 上,再设 mode = 'showing'。否则即使 src 改了,轨道仍显示旧内容或空白。
- 修改
track.src属性本身不触发重新加载 - 必须用
video.removeChild(oldTrack)+video.appendChild(newTrack) - 新
track插入后,需等待load事件或检查readyState === 2再启用,否则可能显示为空 - VTT 文件必须严格 UTF-8 无 BOM,首行必须是顶格
WEBVTT,否则加载失败且无提示



















