# 云映 VTT 水平字幕框：分开位置百分比、框宽与文字长度

语言：zh-CN
原文：[云映 VTT 水平字幕框：分开位置百分比、框宽与文字长度](<https://allluckly.cn/guides/icouldplay-webvtt-position-size-cue-box-check/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-webvtt-position-size-cue-box-check/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-webvtt-position-size-cue-box-check/>)
发布于: 2026-11-11T00:00:00+08:00
内容更新于: 2026-11-11T00:00:00+08:00
署名：Bison

用三个单变量字幕样本核对水平位置与框宽，不把百分比当作字数或像素。

水平字幕时间行中的 position 与 size 看起来都是百分数，回答的问题却不同。把 size 写成50%，不表示这句话只显示一半，也不表示字体自动变成一半。本课用三个相同文字、位置或框宽不同的自制条目，建立源码条件与实际显示分开的记录；在云映里完成的是选择字幕和观看核对，不是寻找一个未经证实的百分比输入面板。

## 一、固定水平观看条件与短片身份

准备至少十四秒、背景清楚的自有练习短片，先在云映正常播放一次，记下文件与来源位置。保持同一设备方向与视频显示方式，先不切换全屏比例、字号和播放器来源。用纯文本编辑器创建 UTF-8 字幕，并保留没有任何位置参数的普通对照。观察记录先分成源码条件、实际文字、可见位置、换行和未确认事项五栏；位置只用靠左、中间、靠右等可见描述，暂不凭屏幕截图估算精确像素。这样后面即使发现某个参数没有可辨认效果，也能如实留下条件与结果，而不必用另一个设置变化来补出预期画面。

## 二、构造三个相同文字的对照条目

复制下方原创字幕。前两条只有 position 从25%变成75%，size 仍为40%；第二与第三条位置相同，只有 size 从40%变为20%。center 用来明确本例位置锚点的对齐条件，不是正文中的一个词。保存后逐条朗读源码里的句子，确认三条文字、标点与字母大小写一致。若你提前把第三条缩短，看到行数变少时就无法区分是框宽条件变化还是文字变短造成。条目之间时间互不重叠，便于顺播记录；示例是水平布局，没有添加纵排参数，因此不能把本文百分比直接套成纵排字列移动的结论。

```
WEBVTT

00:00:01.000 --> 00:00:04.000 position:25%,center size:40% align:center
Keep the small blue cup beside the notebook.

00:00:05.000 --> 00:00:08.000 position:75%,center size:40% align:center
Keep the small blue cup beside the notebook.

00:00:09.000 --> 00:00:12.000 position:75%,center size:20% align:center
Keep the small blue cup beside the notebook.
```

## 三、先画框的示意，不画固定字数格

在笔记中画一个横向长方形代表视频区域，再用三幅小图分别标注 position 与 size 条件。根据[W3C WebVTT 布局说明](<https://www.w3.org/TR/webvtt1/>)，本例的水平位置与字幕框尺寸需要连同对齐条件理解，框的尺寸不等于文字实际墨迹宽度。纸面图只帮助表达相对范围，不是设备截图，也不预告云映必然逐像素实现该草图。不要把40%写成四十个字符，不把75%写成离左边七十五像素。预期栏可以写“比较相同文字的相对位置与可用宽度”，至于能否看出移动或换行，留到实际观察栏填写，避免先把布局示意当成已测试结果。

## 四、顺播核对第一与第二条的位置

加载练习字幕，从零秒顺播到八秒以后。第一条出现时先读完整句子，再记其相对视频区域的位置；第二条重复同样顺序。不要把播放器控制栏弹出后临时挤压画面的状态与控制栏隐藏状态混在一起比较，尽量在相同显示条件下看两条。若相对位置有差异，记录差异方向；若没有，记录当前未观察到位置变化，不直接宣布所有 VTT 参数都不受支持。可再顺播一次确认文件确实选对，但先不修改源码。比较的是这两个给定条目的结果，不是靠拖动手机或改变窗口尺寸得到的一次新位置。

## 五、比较第二与第三条的框宽效果

继续顺播到十二秒以后，核对第二与第三条的文字仍完整，记录行数、是否截断与是否越出可见视频区域。即使第三条行数更多，也不能说字体必然变小；先比较字形大小是否真的改变，再分别记录行数。若两条都是一行，可能是当前文字、显示环境或渲染处理没有形成可见差异，本课不要求为了凑结果改成极长句子。若你确实想测试更长文字，另存一份两条同时改成长句的副本，重新开始同样的单变量比较，不能只改其中一条。这样结果能够说明比较条件，而不是只留下“窄框看起来不一样”的模糊印象。

## 六、区分视频区域、黑边与整块屏幕

观察位置时先指出你以哪个区域作参照：屏幕整体、可见视频画面，还是含黑边的播放区域。三者可能不重合，截图里靠近屏幕右边不代表源码按整块设备屏幕计算。保留同一画面时点的笔记，记录是否存在上下或左右黑边，以及是否进行裁切。若切换显示方式后想复查，就另开一轮，注明这是新的显示条件，不与第一轮直接合并成同一测量。本文不声称云映提供视频区域边界量尺，也不要求自行估算精确百分比；可见文字完整、相对位置描述一致，已经足够形成可复查的阅读记录。

## 七、问题排查：语法、轨道与外观覆盖

若参数文字直接出现在屏幕上，检查它们是否误放到了正文行；正确位置在时间行结束时间之后。若某条完全不出现，先检查空行、箭头与时间区间，再确认没有选择旧字幕。若设置了应用已有的字幕外观选项，记录实际值，必要时用同一选项的另一值做独立对照，不凭猜测寻找“忽略文件布局”开关。出现遮挡、截断或阅读困难时可立即切回普通字幕副本，保留问题样本供复查；不需要删除影片或清空媒体库。每次只处理一个已经发现的问题，并在记录中注明是否解决，避免同时修改三个位置参数后失去原因线索。

## 八、完成检查与条件化结论

最终保存三条源码条件、每条实际文字与相对位置、第二第三条的行数，以及显示区域和设备方向。确认你没有把框宽写成字数、把位置百分比写成像素，也没有把没有观察到差异写成规范没有这些概念。若只做了文件练习，播放栏明确留为未执行；若完成观看，也只报告当前样本与条件下的结果。把练习文件、普通备用版与笔记放在同一个任务目录，保留日期，未来改变显示环境时可以重新核对。可读文字与可追溯条件比一张缺少来源的布局截图更能帮助自己解释问题，也不会把外部字幕编辑误称为应用的新功能。

## 相关教程与资料

[VTT纵排方向](<https://allluckly.cn/guides/icouldplay-webvtt-vertical-writing-column-direction/>)、[VTT基础练习](<https://allluckly.cn/guides/icouldplay-make-webvtt-practice/>)。

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