最小 JSON 样例
本示例提供可用于服务端合成渲染的最小 JSON,包含一个视频片段和一条组合字幕。首次接入时,可以直接复制完整 JSON 发起合成任务;确认流程跑通后,再按需替换视频地址、字幕文字或组合字幕样式。
完整 JSON
示例内容
- 输出分辨率为 960 × 540;
- 时间线总时长为 10 秒;
- 视频从素材的 0 秒处开始截取,在 10 秒处结束;
- 组合字幕从时间线的 0 秒处开始显示,显示时长为 5 秒;
- 组合字幕包含
VLOG #01和DAILY LIFE两个文字子项。
字段说明
所有时间字段均使用微秒。1 秒等于 1,000,000 微秒。
| 字段路径 | 类型 | 说明 | 示例值或约束 |
|---|---|---|---|
timeline.resWidth | integer | 输出视频的分辨率宽度,单位为像素。 | 960 |
timeline.resHeight | integer | 输出视频的分辨率高度,单位为像素。 | 540 |
timeline.duration | integer | 整条时间线的时长,单位为微秒。 | 10000000(10 秒) |
timeline.videoTracks | array | 视频轨道列表。 | 本示例包含 1 条视频轨道 |
timeline.videoTracks[].videos | array | 当前视频轨道中的视频片段列表。 | 本示例包含 1 个视频片段 |
timeline.videoTracks[].videos[].path | string | 视频素材地址。可以替换为任意正确且合成服务能够访问的视频地址。 | https://alieasset.meishesdk.com/demo/video.mp4 |
timeline.videoTracks[].videos[].trimIn | integer | 视频素材的截取入点时间,单位为微秒。 | 0 |
timeline.videoTracks[].videos[].trimOut | integer | 视频素材的截取出点时间,单位为微秒。 | 10000000(10 秒) |
timeline.captionTracks | array | 字幕轨道列表。 | 本示例包含 1 条字幕轨道 |
timeline.captionTracks[].compoundCaptions | array | 当前字幕轨道中的组合字幕列表。 | 本示例包含 1 条组合字幕 |
timeline.captionTracks[].compoundCaptions[].inPoint | integer | 组合字幕在时间线上的入点时间,单位为微秒。 | 0 |
timeline.captionTracks[].compoundCaptions[].duration | integer | 组合字幕的显示时长,单位为微秒。 | 5000000(5 秒) |
timeline.captionTracks[].compoundCaptions[].styleId | string | 组合字幕素材包 ID。当前只能使用下方列出的两个 ID。 | 二选一 |
timeline.captionTracks[].compoundCaptions[].captionItems | array | 组合字幕中的文字子项列表。 | 本示例包含 2 个文字子项 |
timeline.captionTracks[].compoundCaptions[].captionItems[].index | integer | 文字子项的索引,同一条组合字幕内保持唯一且有序。 | 0、1 |
timeline.captionTracks[].compoundCaptions[].captionItems[].text | string | 字幕文字,可以自由替换;需注意文字长度,过长可能影响字幕素材的排版效果。 | VLOG #01、DAILY LIFE |
组合字幕样式
当前提供以下两个组合字幕素材包,styleId 只能在这两个值之间切换:
8FC6C80D-0F68-4EE2-B773-982975DBB4C4D037A06A-FFD8-4863-A291-A2BC105F0BBC
切换样式时,只需将 JSON 中的 styleId 替换为另一个可选值。修改 captionItems[].text 时,建议保留现有的 index 和子项结构,并根据字幕样式的版面控制文字长度。
修改建议
首次试用时,建议只修改以下字段:
- 将
videos[].path替换为合成服务能够访问的视频地址; - 根据需要替换
captionItems[].text; - 如需查看另一种字幕效果,在两个可选值之间切换
styleId; - 调整时间后,确认视频截取区间、字幕显示区间均未超出时间线时长。