# 云映 VTT 条目标识核对：编号不是播放时间或字幕正文

语言：zh-CN
原文：[云映 VTT 条目标识核对：编号不是播放时间或字幕正文](<https://allluckly.cn/guides/icouldplay-webvtt-cue-identifier-order/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-webvtt-cue-identifier-order/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-webvtt-cue-identifier-order/>)
发布于: 2026-11-07T00:00:00+08:00
内容更新于: 2026-11-07T00:00:00+08:00
署名：Bison

给三条自制VTT添加易辨认标识，保留时间顺序，核对文件身份与实际显示，不依赖原生编号导航。

字幕文件里时间行上方的文字可能是条目标识，而不是要显示的台词。这个练习用一份极小的自制文件，让标识与时间各做各的事。先确认当前安装版本能够载入该VTT样本；若不支持，就保留文件检查结果，不把规范写成播放器已经实现的每一项功能。

## 选用原片并保留原字幕

选择至少十二秒的自制短片，在外部纯文本编辑器新建单独文件，不覆盖原字幕。给文件取明显的练习名称，使用UTF-8和VTT扩展名，记录它对应的原片时长。云映是回看载入结果的地方，不要求在播放器内编辑文件。先用已有入门样本确认视频可播、字幕入口可用，再做本篇的标识对照；若连普通提示都不能载入，先解决文件路径与格式问题。

## 建立三个有名字的条目

采用以下原创样本，每个条目用不同英文标识。`cue-B`故意位于`cue-A`之前，但开始时间仍递增；不要为追求字母顺序交换时间行。空行隔开条目，标识和时间各占一行，箭头保持原样。台词使用简单英文，以便中英文教程共享同一份可核对文件。

```vtt
WEBVTT

cue-B
00:01.000 --> 00:03.000
First card

cue-A
00:04.000 --> 00:06.000
Second card

cue-C
00:08.000 --> 00:10.000
Third card
```

## 把标识与可见文字分栏记录

在外部笔记中列出标识、开始、结束与应见文字四项。第一条预期是第一秒到第三秒的First card，不是cue-B，也不是按字母排第二条。W3C WebVTT说明标识是可选的条目标签；它不能代替时间，规范也没有要求播放器提供按这些标签搜索的界面。记录这种角色差别后再打开云映，不把一个文件中的命名习惯推及其他字幕格式。

## 从开头顺播核对显示顺序

载入练习文件并确认当前选中的就是这一份，从第一秒之前顺播，看三条文字是否按时间出现。记录实际看到的词与大致区间，不只拍一个恰好暂停的截图。若出现cue-B之类标签，先回外部编辑器查它是否被误放到时间行下面，或者漏了条目间空行。不同引擎的解析表现可以记录，但不能仅凭一次不显示就宣称规范禁止使用字母标识。

## 只改一个标识做第二份对照

另存一份文件，只把cue-B改为opening-card，其他字符尤其时间和台词不变。重新选择第二份，从相同位置顺播，对照显示是否保持一致。把两份名称与观察分别记下，不能同时更换片源和字号后再把差异归因标识。若播放器仍用了旧文件，先核所选条目，不急着删除媒体或清空字幕目录。预期显示不变是本练习的比较目标，实际是否达到仍以当前版本观察为准。

## 排查重复标签与错贴行

当前所引W3C规范要求同一VTT文件的条目标识唯一；播放器宽容地读出重复标签，也不能证明文件符合规范。本练习保留唯一标签，同时让人工回查不含糊。发现重复时只修改相关标识，不重排原时间或正文。检查是否把时间戳写进标签行、把箭头打成其他符号，或把多行正文误拆成新条目。一次只修一处并另存，回放同一区间；不把重新编号写成万能修复，也不借机重排整份字幕导致时间关系改变。

## 保留可回到源文件的结果

完成后应能凭标签在外部编辑器找到条目，凭时间在视频附近回看，凭正文确认实际提示。退出播放器再打开原练习文件，核对选中状态与三条内容，避免留下另一份实验字幕作为正式观看默认。没有编号搜索入口并不妨碍这个任务，但也不能宣称云映拥有该入口。资料来自[W3C WebVTT](<https://www.w3.org/TR/webvtt1/>)，只用到标识、时间与正文的职责区别；不代表本次已逐项测试所有解析行为。

## 标识本身也要保持为一行

给标识命名时采用简短英文字母与连字符，不使用换行，也不把时间箭头放进去。为方便人工检查，先不要添加复杂符号或从表格复制隐藏分隔字符。文件可以没有标识，但添加以后也不能省去下一行的开始与结束时间。若要比较无标识版本，另存第三份，只移除三个标签行；保留它与改名版本是两个独立实验，不在同一次回放中同时删标签又改时间。

## 把交接说明指向标签和台词两处

如果请另一人复核，不只写“改第二条”。写明文件版本、cue-A标识、四至六秒区间与Second card正文，对方才知道第二条指文件顺序而不是字母排序。以后插入新条目，标签可以保持稳定，但对应时间或正文仍可能修订，旧备注须带版本。若找不到标识，先核对文件是否为无标签对照，不要求播放器替外部编辑器做全文检索。这样保留的是人工审校索引，不是可点击视频章节。

## 相关教程与资料

[参照短片](<https://allluckly.cn/guides/icouldplay-playback-reference-clip/>)、[字幕时间诊断](<https://allluckly.cn/guides/icouldplay-subtitle-offset-drift/>)。

资料核对：2026 年 11 月 7 日，依据 [云映官方 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 兼容存储，并改进来源切换及跳转后的字幕显示；本文按这些公开范围与现有播放能力组织任务，具体入口以安装版本为准。自制样本、手工记录与外部文件整理不是应用新增自动功能；未声称已完成真机或私人服务器实测。