元素本身不对接字幕库，仅声明外部WebVTT文件路径；多语言字幕需手动导出为合规.vtt文件（首行WEBVTT、UTF-8无BOM、时间格式精确），再通过多个标签引用，由浏览器原生解析并支持用户切换。

直接说结论：`` 元素本身不对接字幕库，它只负责声明一个外部 WebVTT 文件路径；所谓“整合字幕库”，本质是把字幕库导出的多语言字幕文件（如 `zh.vtt`、`en.vtt`）按规范部署，并在 HTML 中用多个 `` 正确引用——中间没有 API、SDK 或自动加载机制。

为什么 track 不能直接连字幕库？

浏览器原生 `` 的 `src` 属性只接受 HTTP(S) 可访问的 URL 字符串，不支持：
– 字幕库返回的 JSON/数组结构
– Blob URL 或 `data:` 协议（静默忽略）
– 动态生成的字符串内容（除非你手动创建 `` 并注入 DOM，再调用 `textTracks` API 控制）
换句话说：track 是声明式挂载，不是运行时集成。它和“字幕库”之间必须由你完成一次「导出 → 保存为 .vtt → 部署 → 引用」的手动桥接。

怎么把字幕库导出的字幕变成可用的 track？

多数字幕库（如 Aegisub、YouTube Studio、或自研管理后台）支持导出为 SRT 或 WebVTT。但 `` 要求严格，导出后必须检查并修正：

• 首行必须是顶格、全大写、无空格、无 BOM 的 WEBVTT（不是 webvtt 或 WebVTT）
• 时间戳格式必须为 00:00:01.234 --> 00:00:04.567（毫秒三位，箭头前后各两个空格）
• 文件编码必须是 UTF-8 无 BOM（Windows 记事本默认带 BOM，务必用 VS Code / Notepad++ 重存）
• 中文、日文等非 ASCII 字符需能正常显示，否则在 Firefox 中可能空白
• 如果字幕库导出的是 SRT，强烈建议转成 WebVTT：SRT 容错差，且部分浏览器（如 Safari）对 SRT 的 `srclang` 识别不稳定

track 挂载时常见的路径与跨域问题

即使字幕文件内容完全合规，`src` 写错也会导致静默失败——控制台通常只报 Failed to load resource，不提示具体原因：

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• src 必须是相对路径（如 ./sub/zh.vtt）或绝对路径（如 /vtt/en.vtt），不能是 blob: 或 data:
• 开发时若用 file:// 协议打开 HTML，所有 .vtt 加载必失败（浏览器禁用 file 协议下的跨域请求）→ 必须起本地服务，例如：python3 -m http.server
• 视频和字幕若不同源（如视频在 https://example.com，字幕在 https://cdn.example.com/sub/zh.vtt），服务器必须返回 Access-Control-Allow-Origin: * 响应头
• Nginx/Apache 需显式配置 MIME 类型：add_type text/vtt .vtt;，否则 Safari 可能拒绝解析

如何让多个字幕库语言在页面上可切换？

HTML 中写多个 `` 只是声明轨道，**用户能否看到、是否可切换，取决于 JavaScript 控制 `mode` 属性**：

立即学习“前端免费学习笔记（深入）”；

• 每个 `` 必须有唯一 srclang（如 zh、en-US、ja），且不能写成 chinese 或 jp（BCP 47 不认）
• 不要依赖 `default` 实现多语言切换——它只影响首次加载，且同一 kind 下只能有一个生效
• 正确做法：用 JS 遍历 video.textTracks，把目标轨道设为 track.mode = 'showing'，其余设为 'disabled'
• 注意：Safari 默认隐藏字幕菜单，除非至少一个 `` 带 default 属性，否则右键根本看不到选项

真正容易被忽略的一点：双语对照（比如中英/中拼）不是靠两个 `` 同时启用实现的——浏览器只允许一个 `subtitles` 轨道处于 `showing` 状态。要显示两行，必须把翻译和拼音合并进同一个 `.vtt` 文件，用 `` 和 `` 包裹，再通过 CSS 的 video::cue(.translation) 和 video::cue(.pinyin) 分别控制样式。这是原生能力边界，绕不开。