Skip to content

最小 JSON 样例

本示例提供可用于服务端合成渲染的最小 JSON,包含一个视频片段和一条组合字幕。首次接入时,可以直接复制完整 JSON 发起合成任务;确认流程跑通后,再按需替换视频地址、字幕文字或组合字幕样式。

完整 JSON

示例内容

  • 输出分辨率为 960 × 540;
  • 时间线总时长为 10 秒;
  • 视频从素材的 0 秒处开始截取,在 10 秒处结束;
  • 组合字幕从时间线的 0 秒处开始显示,显示时长为 5 秒;
  • 组合字幕包含 VLOG #01DAILY LIFE 两个文字子项。

字段说明

所有时间字段均使用微秒。1 秒等于 1,000,000 微秒。

字段路径类型说明示例值或约束
timeline.resWidthinteger输出视频的分辨率宽度,单位为像素。960
timeline.resHeightinteger输出视频的分辨率高度,单位为像素。540
timeline.durationinteger整条时间线的时长,单位为微秒。10000000(10 秒)
timeline.videoTracksarray视频轨道列表。本示例包含 1 条视频轨道
timeline.videoTracks[].videosarray当前视频轨道中的视频片段列表。本示例包含 1 个视频片段
timeline.videoTracks[].videos[].pathstring视频素材地址。可以替换为任意正确且合成服务能够访问的视频地址。https://alieasset.meishesdk.com/demo/video.mp4
timeline.videoTracks[].videos[].trimIninteger视频素材的截取入点时间,单位为微秒。0
timeline.videoTracks[].videos[].trimOutinteger视频素材的截取出点时间,单位为微秒。10000000(10 秒)
timeline.captionTracksarray字幕轨道列表。本示例包含 1 条字幕轨道
timeline.captionTracks[].compoundCaptionsarray当前字幕轨道中的组合字幕列表。本示例包含 1 条组合字幕
timeline.captionTracks[].compoundCaptions[].inPointinteger组合字幕在时间线上的入点时间,单位为微秒。0
timeline.captionTracks[].compoundCaptions[].durationinteger组合字幕的显示时长,单位为微秒。5000000(5 秒)
timeline.captionTracks[].compoundCaptions[].styleIdstring组合字幕素材包 ID。当前只能使用下方列出的两个 ID。二选一
timeline.captionTracks[].compoundCaptions[].captionItemsarray组合字幕中的文字子项列表。本示例包含 2 个文字子项
timeline.captionTracks[].compoundCaptions[].captionItems[].indexinteger文字子项的索引,同一条组合字幕内保持唯一且有序。01
timeline.captionTracks[].compoundCaptions[].captionItems[].textstring字幕文字,可以自由替换;需注意文字长度,过长可能影响字幕素材的排版效果。VLOG #01DAILY LIFE

组合字幕样式

当前提供以下两个组合字幕素材包,styleId 只能在这两个值之间切换:

  • 8FC6C80D-0F68-4EE2-B773-982975DBB4C4
  • D037A06A-FFD8-4863-A291-A2BC105F0BBC

切换样式时,只需将 JSON 中的 styleId 替换为另一个可选值。修改 captionItems[].text 时,建议保留现有的 index 和子项结构,并根据字幕样式的版面控制文字长度。

修改建议

首次试用时,建议只修改以下字段:

  1. videos[].path 替换为合成服务能够访问的视频地址;
  2. 根据需要替换 captionItems[].text
  3. 如需查看另一种字幕效果,在两个可选值之间切换 styleId
  4. 调整时间后,确认视频截取区间、字幕显示区间均未超出时间线时长。

准备完成后,可参考发起合成任务提交该 JSON,并使用返回的 taskId 查询任务结果