时间坐标与字幕语法
云映 VTT 条目标识核对:编号不是播放时间或字幕正文
给三条自制VTT添加易辨认标识,保留时间顺序,核对文件身份与实际显示,不依赖原生编号导航。
本文目录
字幕文件里时间行上方的文字可能是条目标识,而不是要显示的台词。这个练习用一份极小的自制文件,让标识与时间各做各的事。先确认当前安装版本能够载入该VTT样本;若不支持,就保留文件检查结果,不把规范写成播放器已经实现的每一项功能。
选用原片并保留原字幕
选择至少十二秒的自制短片,在外部纯文本编辑器新建单独文件,不覆盖原字幕。给文件取明显的练习名称,使用UTF-8和VTT扩展名,记录它对应的原片时长。云映是回看载入结果的地方,不要求在播放器内编辑文件。先用已有入门样本确认视频可播、字幕入口可用,再做本篇的标识对照;若连普通提示都不能载入,先解决文件路径与格式问题。
建立三个有名字的条目
采用以下原创样本,每个条目用不同英文标识。cue-B故意位于cue-A之前,但开始时间仍递增;不要为追求字母顺序交换时间行。空行隔开条目,标识和时间各占一行,箭头保持原样。台词使用简单英文,以便中英文教程共享同一份可核对文件。
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,只用到标识、时间与正文的职责区别;不代表本次已逐项测试所有解析行为。
标识本身也要保持为一行
给标识命名时采用简短英文字母与连字符,不使用换行,也不把时间箭头放进去。为方便人工检查,先不要添加复杂符号或从表格复制隐藏分隔字符。文件可以没有标识,但添加以后也不能省去下一行的开始与结束时间。若要比较无标识版本,另存第三份,只移除三个标签行;保留它与改名版本是两个独立实验,不在同一次回放中同时删标签又改时间。
把交接说明指向标签和台词两处
如果请另一人复核,不只写“改第二条”。写明文件版本、cue-A标识、四至六秒区间与Second card正文,对方才知道第二条指文件顺序而不是字母排序。以后插入新条目,标签可以保持稳定,但对应时间或正文仍可能修订,旧备注须带版本。若找不到标识,先核对文件是否为无标签对照,不要求播放器替外部编辑器做全文检索。这样保留的是人工审校索引,不是可点击视频章节。
相关教程与资料
资料核对:2026 年 11 月 7 日,依据 云映官方 App Store 说明与 Apple 公开版本查询,当前版本 1.1.1,最低要求 iOS / iPadOS 15.0。1.1.1 的公开更新列出 Kodi、OpenList / AList 与 S3 兼容存储,并改进来源切换及跳转后的字幕显示;本文按这些公开范围与现有播放能力组织任务,具体入口以安装版本为准。自制样本、手工记录与外部文件整理不是应用新增自动功能;未声称已完成真机或私人服务器实测。