一、学习目标

了解什么是剪映草稿的时间线对象？
熟悉如何创建剪映草稿的时间线？
掌握两个创建时间线的工具节点：generate_timelines 和 generate_timelines_by_audio

（一）什么是剪映草稿的时间线对象？

1. 官方解释：

剪映草稿中的时间线对象是视频编辑工程的核心组成部分，它本质上是一个结构化数据文件，记录了以下关键信息：

- 轨道配置（包括视频、音频、文字等轨道）
- 媒体素材的引用路径
- 特效、转场等编辑操作
- 关键帧动画参数
- 时间线标记点

这些数据以特定格式存储在草稿文件中，使编辑工程可以被完整保存和重现。

2. 通俗解释：

你可以把时间线想象成一条电影胶片，从左到右代表视频从开始到结束的时间。
而时间线对象，就是这条胶片上放的各种“小积木”——每一个积木代表视频、音频、文字、贴纸、转场、特效等元素。

二、步骤详解

包含详细的图文教程，具体操作步骤参考截图的编号

（一）注册/登录扣子网站

• https://www.coze.cn/home(扣子官网)

（二）自定义创建时间线

使用generate_timelines工具节点创建剪映草稿的时间线

1. 创建工作流

（1）点击“资源库”菜单
（2）点击“资源”按钮
（3）点击“工作流”下拉菜单
（4）填写工作流名称：course_002
（5）填写工作流描述：教程2：创建自定义时间线对象
（6）点击“确认”按钮

2. 添加generate_timelines工具节点

（1）点击“添加节点”按钮
（2）点击已收藏插件里的“剪映草稿助手_组装草稿数据“插件
（3）点击“generate_timelines”工具节点（即生成剪映草稿时间线的工具节点）

3. 配置generate_timelines工具节点参数

（1）连接节点
（2）点击“generate_timelines”节点
（3）输入参数：给“timeline_segment”字段赋值：[5000000,3000000]，表示创建一组剪映草稿的时间线，包含两个时间线片段，分别是5秒（5000000微秒）和3秒（3000000微秒）

4. 配置结束节点

（1）连接节点
（2）点击“结束”节点
（3）绑定generate_timelines节点的target属性

5. 运行结果

（1）点击“试运行”
（2）查看创建的剪映草稿的时间线，返回结果如下：

{
    "all_timelines": [
        {
            "duration": 8000000,
            "start": 0
        }
    ],
    "timelines": [
        {
            "duration": 5000000,
            "start": 0
        },
        {
            "duration": 3000000,
            "start": 5000000
        }
    ]
}

（三）使用音频创建时间线

使用generate_timelines_by_audio工具节点创建剪映草稿的时间线

1. 创建工作流

（1）点击“资源库”菜单
（2）点击“资源”按钮
（3）点击“工作流”下拉菜单
（4）填写工作流名称：course_003
（5）填写工作流描述：教程3：根据音频文件创建时间线对象
（6）点击“确认”按钮

2. 添加generate_timelines_by_audio工具节点

（1）点击“添加节点”按钮
（2）点击已收藏插件里的“剪映草稿助手_组装草稿数据“插件
（3）点击“generate_timelines_by_audio”工具节点（即生成剪映草稿时间线的工具节点）

3. 配置开始节点

（1）点击“开始”节点
（2）配置“input”输入参数，通过移动鼠标依次选中Array->File->Audio，鼠标移动到Audio选项并点击它

4. 配置generate_timelines_by_audio工具节点参数

（1）点击“generate_timelines_by_audio”节点
（2）配置输入参数，绑定“开始”节点的“input”属性

5. 配置结束节点

（1）点击“结束”节点
（2）绑定generate_timelines_by_audio节点的target属性

6. 运行结果

（1）点击“试运行”
（2）上传一段或多段音频素材（本案例上传了两段音频素材）
（3）查看创建的剪映草稿的时间线，返回结果如下：

{
    "all_timelines": [
        {
            "duration": 7926000,
            "start": 0
        }
    ],
    "timelines": [
        {
            "duration": 3056000,
            "start": 0
        },
        {
            "duration": 4870000,
            "start": 3056000
        }
    ]
}

（四）工作流源码

飞书文档地址：https://yiaicoze.feishu.cn/wiki/Cio0wKjkJiZLHRkc0efcJzvjnnf?from=from_copylink