普通字幕
公共工程字段和通用参数规则见 JSON 样例概述。
普通字幕
创建包含文本、字体、字号、颜色和时间区间的普通字幕。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].align | 文本对齐方式 | string；如 left-vCenter、center-vCenter、right-vCenter | center-vCenter |
timelines[].captionTracks[].captions[].color | 颜色 | string；#AARRGGBB | #ffffffff |
timelines[].captionTracks[].captions[].duration | 时间位置或时长 | integer，微秒；通常 >= 0 | 48680000 |
timelines[].captionTracks[].captions[].font | 字体名称 | string；应与字体资源映射一致 | 非空 |
timelines[].captionTracks[].captions[].fontSizeRatio | 字号比例 | number；有限正数 | 0.1 |
timelines[].captionTracks[].captions[].inPoint | 时间位置或时长 | integer，微秒；通常 >= 0 | 520000 |
timelines[].captionTracks[].captions[].text | 字幕文字 | string；允许换行 | 非空 |
timelines[].captionTracks[].captions[].type | 对象或参数类型 | string；取值由对象决定 | general |
字幕描边
为字幕开启描边，并配置描边颜色、宽度和透明度。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].outline | 功能开关 | boolean；true 或 false | true |
timelines[].captionTracks[].captions[].outlineColor | 颜色 | string；#AARRGGBB | #ffdf1010 |
timelines[].captionTracks[].captions[].outlineWidth | 样式参数 | number；范围由字幕渲染器确定 | 80 |
字幕阴影
为字幕开启阴影，并配置颜色、羽化和横纵偏移。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].shadow | 功能开关 | boolean；true 或 false | true |
timelines[].captionTracks[].captions[].shadowColor | 颜色 | string；#AARRGGBB | #c1ca1a1a |
timelines[].captionTracks[].captions[].shadowFeather | 样式参数 | number；范围由字幕渲染器确定 | 40 |
timelines[].captionTracks[].captions[].shadowOffsetX | 样式参数 | number；范围由字幕渲染器确定 | 3 |
timelines[].captionTracks[].captions[].shadowOffsetY | 样式参数 | number；范围由字幕渲染器确定 | -1 |
字幕动画时长自适应
让字幕动画随字幕持续时间自动伸缩。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].enableSpeed | 功能开关 | boolean；true 或 false | true |
timelines[].captionTracks[].captions[].fxParams[].key | 特效参数名 | string；由 SDK 或资源包定义 | Stretch Time |
timelines[].captionTracks[].captions[].fxParams[].type | 对象或参数类型 | string；取值由对象决定 | bool |
timelines[].captionTracks[].captions[].fxParams[].value | 参数值 | string；逻辑数字或布尔值也保持 string | true |
timelines[].captionTracks[].captions[].type | 对象或参数类型 | string；取值由对象决定 | general |
字幕位置
通过平移参数调整字幕在画面中的位置。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].anchorPointX | 位置或锚点 | number；有限数值 | 0 |
timelines[].captionTracks[].captions[].anchorPointY | 位置或锚点 | number；有限数值 | 0 |
timelines[].captionTracks[].captions[].translationX | 位置或锚点 | number；有限数值 | -195.92034912109375 |
timelines[].captionTracks[].captions[].translationY | 位置或锚点 | number；有限数值 | 202.73561096191406 |
多行字幕与行间距
创建多行字幕并调整行间距。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].align | 文本对齐方式 | string；如 left-vCenter、center-vCenter、right-vCenter | left-vCenter |
timelines[].captionTracks[].captions[].lineSpacing | 样式参数 | number；范围由字幕渲染器确定 | -10 |
timelines[].captionTracks[].captions[].text | 字幕文字 | string；允许换行 | 非空 |
竖排字幕
将字幕文字方向设置为竖排。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].align | 文本对齐方式 | string；如 left-vCenter、center-vCenter、right-vCenter | left-vCenter |
timelines[].captionTracks[].captions[].direction | 文字方向 | string；horizontal 或 vertical | vertical |
timelines[].captionTracks[].captions[].text | 字幕文字 | string；允许换行 | 非空 |
字幕旋转
设置字幕旋转角度。
完整 JSON
关键参数
| 字段路径 | 作用 | 类型与范围 | 示例值 |
|---|---|---|---|
timelines[].captionTracks[].captions[].rotation | 旋转角度 | number；方向按引擎坐标系 | -90 |
timelines[].captionTracks[].captions[].translationX | 位置或锚点 | number；有限数值 | 0 |
timelines[].captionTracks[].captions[].translationY | 位置或锚点 | number；有限数值 | 0.026611328125 |