您的位置首页 >人工智能 >

【直播切片工作台】第39章Recipe 三大步骤创建铺轨与字幕

直播切片工作台里的 Recipe 流水线,核心就是依靠 CreateStep、VideosStep、CaptionsStep 这固定三步,自动完成剪映草稿创建、切片视频铺轨、ASR 字幕对齐,整套流程依靠 Session 会话共享数据、ClipPlacement 做时间轴映射,解决切片拼接之后字幕错位的痛点,不用人工逐个校对字幕时间。整个 Recipe 的执行顺序不能调换,必须先建草稿会话,再把切片依次铺入主视频轨道、记录时间映射关系,最后再读取映射表换算字幕在草稿里的时间位置,顺序颠倒会直接出现轨道缺失、字幕时间偏移、任务报错的问题。下面把三大步骤拆开讲清楚每个环节的作用、内部逻辑和产出数据。

第一步:CreateStep 创建草稿会话

  • 核心作用:初始化剪映草稿、生成 Session 上下文黑板,初始化时间线游标,为后面铺轨、字幕步骤提供统一的状态存储。
  • 执行动作:调用剪映草稿 API,新建空白草稿对象;初始化 Session 结构体,存入基础参数、素材路径、日志实例、API 客户端;初始化 Timeline 游标,游标单位是微秒,用来记录轨道推进位置。
  • 输出结果:可用的草稿会话 Session,里面预留 ClipPlacements 数组,用来存后续切片的时间映射记录。

第二步:VideosStep 切片铺轨,记录时间映射

  • 核心作用:上传选中的直播切片素材,按顺序追加到草稿主视频轨道,生成 ClipPlacement 时间映射条目,这一步是字幕能对齐的关键。
  • 执行动作:按切片顺序循环,调用 Timeline.Advance 拿到当前轨道起始位置;上传媒资,把切片添加进主视频轨;写入 ClipPlacement,包含源视频毫秒时间(SourceStartMS、SourceEndMS)、草稿微秒时间(DraftStartUS、DraftEndUS)。
  • 输出结果:主视频轨道拼接完成,Session 的 ClipPlacements 数组填充完整,保存源时间轴和草稿时间轴的对应关系。

第三步:CaptionsStep 基于映射自动生成对齐字幕

  • 核心作用:读取 ASR 识别出来的字幕分句时间,依靠第二步生成的 ClipPlacement 换算草稿内字幕时间,批量写入草稿字幕轨道。
  • 执行动作:遍历 ASR 字幕条目,匹配字幕源时间落在哪一条 ClipPlacement;套用换算公式:(asrMS - SourceStartMS) * 1000 + DraftStartUS,换算成草稿时间;批量调用接口添加字幕到草稿轨道。
  • 输出结果:字幕全部同步挂载到对应切片位置,整个 Recipe 流水线结束,得到带视频轨 + 字幕轨的完整剪映草稿。

Recipe 整体调用说明

默认 DefaultRecipe 就是固定这三步的顺序组装,Steps 数组顺序为 CreateStep→VideosStep→CaptionsStep;你自定义 Recipe 时如果修改步骤顺序,字幕同步逻辑会失效;每一步都独立持有 API、上传器、日志实例,互相解耦,单独调试单一步骤很方便。

【相关 FAQ】

问题 1:直播切片工作台 Recipe 铺轨字幕流程里,能不能调换 VideosStep 和 CaptionsStep 的顺序?

回答 1:不能调换,Recipe 铺轨字幕流程必须先执行 VideosStep 完成铺轨、生成 ClipPlacement 映射,CaptionsStep 依赖这份时间映射数据做字幕换算,先跑字幕步骤会找不到时间对应关系,字幕全部错位。

问题 2:直播切片工作台 Recipe 的 ClipPlacement 在铺轨字幕环节起到什么作用?

回答 2:ClipPlacement 是 Recipe 铺轨字幕的时间翻译协议,记录源视频毫秒时间和草稿微秒时间的对应关系,CaptionsStep 依靠它把 ASR 字幕的原始时间,转换成草稿轨道上的字幕起止时间。

问题 3:直播切片工作台 Recipe 三大步骤执行失败,字幕全部不生成一般是什么原因?

回答 3:大多是 CreateStep 草稿创建失败、VideosStep 切片上传铺轨失败,导致 ClipPlacement 为空,Recipe 的 CaptionsStep 没有映射数据,无法计算字幕位置,最终字幕写入失败。

【参考资料】

[2026-11-19](

【直播切片工作台】第 38 章:草稿会话与时间线)阿里云开发者社区

[2026-11-14](

【直播切片工作台】第 36 章:剪映草稿流水线总览)阿里云开发者社区

【免责声明】

本文内容仅针对直播切片工作台 Recipe 流水线技术逻辑做讲解,仅用于技术学习参考,不保证适配所有二次修改后的自定义 Recipe 代码;不同版本工作台 API 存在差异,实际开发时请结合对应版本接口文档调试,使用过程中产生的任务异常、素材丢失等问题由使用者自行承担。

今日大家都在搜的词: