# 云映 VTT 语种标注：分开 lang 标签、实际词句与字幕轨名称

语言：zh-CN
原文：[云映 VTT 语种标注：分开 lang 标签、实际词句与字幕轨名称](<https://allluckly.cn/guides/icouldplay-webvtt-language-span-label-wording-check/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-webvtt-language-span-label-wording-check/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-webvtt-language-span-label-wording-check/>)
发布于: 2026-11-11T00:00:00+08:00
内容更新于: 2026-11-11T00:00:00+08:00
署名：Bison

比较正确、错误与缺省语种标注，避免把元数据当成自动翻译或语言识别。

字幕文件中的 lang 标注、字幕选择列表上的语种名称，以及句子真正用了哪种语言，是三个可以互相对照但不能互相替代的信息。本课用同一句原创短句制作三条条目，在云映检查文字是否完整，再人工审核标注是否与词句相符。结果是一份文字与元数据分开的核对单，不声称应用会自动识别错误标注或替你翻译。

## 一、准备短片与三层记录栏

选一段至少十二秒的自有短片，先不带练习字幕顺播，确认画面自身没有相同文字。电脑上创建纯文本 UTF-8 文件，保留一个普通文字备用版本。记录分成三层：文件内部的标注、应用可见的字幕名称、实际读到的词句；每一层都要有“未提供”或“未观察”可选状态，不能为了填满表格而猜一个语种。使用自己安装版本已有的字幕入口配对短片；如果没有加载入口，就先完成文件审核，不把纸面检查当成已经完成设备显示。素材身份、文件名与练习日期同时保留，方便下一次换轨道时确认自己看的确实是这一份。

## 二、制作正确、故意错标与无标注对照

复制下方原创文件，三条可读文字完全相同。第一条给 Bonjour 标 fr，第二条故意标 en，第三条不给它语种标注；后半句都保留英文。Bonjour 在本例中是法语问候，第二条是专供找错的教学条件，不是推荐写法。保存后逐个核对开闭标记，尤其不要把第二条在整理时自动改回 fr，否则失去错误元数据对照。三条时间互不重叠，便于从头顺播；练习要检查的是标注与文字的关系，不要求音轨也包含法语，也不要求应用显示一枚对应语言徽章。

```
WEBVTT

00:00:01.000 --> 00:00:03.000
<lang fr>Bonjour.</lang> We are ready.

00:00:04.000 --> 00:00:06.000
<lang en>Bonjour.</lang> We are ready.

00:00:07.000 --> 00:00:09.000
Bonjour. We are ready.
```

## 三、理解标注范围，不把标签当翻译命令

依据[W3C WebVTT 语种跨度说明](<https://www.w3.org/TR/webvtt1/>)，lang 可为条目中的一段文字附加语种信息；标注本身不会把词句翻译为另一种语言。用笔圈出第一条标记包围的范围，确认它只包住 Bonjour.，没有包住后面的英文句子。第二条虽然写 en，字母仍然是 Bonjour，并不会因此自动变成 Hello。第三条没有该标注，也不等于句子没有语言。把这三个判断写在源码审核栏，不替云映承诺读屏发音、自动选轨或错误提示等尚未核实的行为；本课只需要正确理解文件内的声明与实际文字。

## 四、先核可见文字，再看是否有字面标签

把练习文件配对后从零秒顺播，分别抄三条实际看到的句子。先看 Bonjour、We、are、ready 是否完整，再记录是否出现字面 lang、fr 或 en。不要因为第二条错标就期待播放器必须报错，也不要把没有报错写成“应用认为这是英语”。如果三条都显示同样文字，记录当前文字结果一致即可，元数据的对错仍在人工审核栏中保留。若某条少字，先记缺的是哪个词与出现时间，再回查标记与文件格式。可见文字核对完成前，不需要调整音轨、网络来源或整个应用语言，以免把其他变化混进本课对照。

## 五、单独记录字幕选择列表的名称

在安装版本可见的字幕选择界面查看当前条目的名称或语言标签，原样抄录，并注明它是否只是文件名。若界面没有语种名称，就写“未显示”，不从 lang fr 推测界面一定会列出法语。一个文件可以在单条字幕内部混合不同语言，选择列表的轨道级名称与条目内部某个词的标注范围不同；本课的两句混合正好可以用来保持这种区别。查看完返回播放页，确认仍选中同一个文件，再顺播第三条。此步骤只是收集当前可见信息，不修改系统语言，也不要求应用存在按每个词切换字幕轨道的功能。

## 六、修正副本后保留修改依据

完成错误对照后，另存一份审核通过的版本，只把第二条的 en 改为 fr，正文与时间保持原样。笔记写清修改理由是人工确认本例词句与标签不符，不是应用自动检测。重新打开修正版时，先核文件身份，再检查三条文字仍完整；文字没有变化是合理结果，因为你改的是元数据，不是句子翻译。保留原始错标版供学习，但在文件名或说明中明确标为教学错例，避免日后误当成正式字幕。不要把修正后的两个版本合并覆盖唯一原稿，所有修改应能够从记录中恢复到修改前条件。

## 七、问题排查：错标、缺字与翻译期待

如果希望看到中文却仍看到 Bonjour，不要反复切换 lang 值；需要的是另一份经过翻译的正文，而不是给原词换语种标记。若标签被显示为普通文字，先检查是否使用了错误括号、是否被转义，或文件是否走了普通文本处理路径。若切换字幕后画面不变，先确认文件选择和条目时间，不认为相同外观就证明文件没换。若语种标签与内容不符，保存有问题的原稿和人工判定依据，再改副本；不要把未知语言一律改成自己熟悉的语言代码。无法确认的词可查可靠词典或向素材作者核实，保持未知比制造准确的假象更便于后续复查。

## 八、完成检查与元数据边界

最终记录应包含三条源码条件、各条可见文字、选择列表实际名称、人工审核结论及修正版差异。核对没有把法语问候的例子说成全部语种识别测试，没有把语种标记当字体命令或翻译按钮，也没有声称自己未执行的真机验证。完成文件审核但未播放时明确写这一状态；完成播放时则保留视频、文件和当前显示条件。下次遇到混合语言字幕，可以继续逐层核对轨道名称、内部标注与实际正文，而不是让一个看似正确的语种标签替代全部检查。最后确认普通文字备用版仍可用，原视频与原字幕没有被覆盖。

## 相关教程与资料

[VTT说话者标注](<https://allluckly.cn/guides/icouldplay-webvtt-voice-annotation-visible-name/>)、[VTT类名与正文](<https://allluckly.cn/guides/icouldplay-vtt-class-label-visible-text-check/>)。

资料核对：2026 年 11 月 11 日，依据 [云映官方 App Store 说明](<https://apps.apple.com/cn/app/id6755653178>)与 [Apple 公开版本查询](<https://itunes.apple.com/lookup?id=6755653178&country=cn>)，当前版本 1.1.1，最低要求 iOS / iPadOS 15.0。1.1.1 的公开更新列出 Kodi、OpenList / AList 与 S3 兼容存储，并改进来源切换及跳转后的字幕显示；本文按这些公开范围与现有播放能力组织任务，具体入口以安装版本为准。自制样本、手工记录与外部文件整理不是应用新增自动功能；未声称已完成真机或私人服务器实测。