剪映剪辑助手-轨道

显示全部

轨道

剪映剪辑助手 / 轨道类动作。

添加轨道

add_jianying_track

剪映剪辑助手轨道

用途：在指定轨道类型末尾添加一条空轨道，并把轨道ID存到上下文变量“当前轨道”中。

写法：添加轨道轨道类型=<轨道类型> [轨道名=<轨道名>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

添加轨道 轨道类型="文本" 轨道名="主轨道"

错误示例

添加轨道 轨道名="主轨道"

为什么错：漏写了必填参数：轨道类型。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道类型	`track_type`	新轨道类型，只支持：文本/视频/音频/贴纸/滤镜/特效。	是	无
轨道名	`track_name`	可选的新轨道名；禁止包含冒号。	否	无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`当前轨道`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`片段数量`	integer	是	未提供说明
`新建轨道类型`	string	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

插入轨道

insert_jianying_track

剪映剪辑助手轨道

用途：在指定轨道之前插入一条同类型空轨道，并把轨道ID存到上下文变量“当前轨道”中。

写法：插入轨道目标轨道=<目标轨道> [轨道名=<轨道名>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

插入轨道 目标轨道="示例值" 轨道名="主轨道"

错误示例

插入轨道 轨道名="主轨道"

为什么错：漏写了必填参数：目标轨道。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
目标轨道	`target_track`	要插入到它前面的目标轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。	是	无
轨道名	`track_name`	可选的新轨道名；禁止包含冒号。	否	无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`当前轨道`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`片段数量`	integer	是	未提供说明
`插入到轨道前`	string	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

命名轨道

rename_jianying_track

剪映剪辑助手轨道

用途：把指定轨道改成新的轨道名。

写法：命名轨道 [轨道=<轨道>] 新轨道名=<新轨道名> [覆盖已有=<覆盖已有>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

命名轨道 新轨道名="主轨道" 轨道="示例值"

错误示例

命名轨道 轨道="示例值"

为什么错：漏写了必填参数：新轨道名。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track`	要改名的轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。不填时默认使用当前轨道。	否	无
新轨道名	`new_track_name`	要设置的新轨道名；禁止包含冒号。	是	无
覆盖已有	`overwrite`	轨道名已存在时是否覆盖。默认不覆盖。	否	False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`原轨道名`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`覆盖已有`	boolean	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

选中轨道

select_jianying_track

剪映剪辑助手轨道

用途：定位一条轨道，并把轨道ID存到上下文变量“当前轨道”中。

写法：选中轨道轨道=<轨道>

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

选中轨道 轨道="示例值"

错误示例

选中轨道

为什么错：漏写了必填参数：轨道。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track`	要选中的轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。	是	无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`当前轨道`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`片段数量`	integer	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

移动轨道

move_jianying_track

剪映剪辑助手轨道

用途：把来源轨道移动到目标轨道位置；可选覆盖目标轨道，并把保留下来的轨道ID存到上下文变量“当前轨道”中。

写法：移动轨道 [源轨道=<源轨道>] 目标轨道=<目标轨道> [覆盖目标轨道=<覆盖目标轨道>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

移动轨道 目标轨道="示例值" 源轨道="示例值"

错误示例

移动轨道 源轨道="示例值"

为什么错：漏写了必填参数：目标轨道。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
源轨道	`source_track`	要移动的来源轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。不填时默认使用当前轨道。	否	无
目标轨道	`target_track`	要移动到它位置上的目标轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。	是	无
覆盖目标轨道	`overwrite_target_track`	是否覆盖目标轨道。为 True 时保留源轨道ID，用源轨内容替换目标轨，并删除原目标轨。	否	False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`当前轨道`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`片段数量`	integer	是	未提供说明
`覆盖目标轨道`	boolean	是	未提供说明
`目标轨道`	string	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

清空轨道

clear_jianying_track

剪映剪辑助手轨道

用途：清空指定轨道内的全部片段，保留轨道本身。

写法：清空轨道 [轨道=<轨道>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

清空轨道 轨道="示例值"

错误示例

清空轨道 轨道="示例值" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track`	要清空的轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。不填时默认使用当前轨道。	否	无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`删除片段数量`	integer	是	未提供说明
`清理素材数量`	integer	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

删除轨道

delete_jianying_track

剪映剪辑助手轨道

用途：删除指定轨道及其全部片段。

写法：删除轨道 [轨道=<轨道>]

保存为

默认保存主结果，通常就是 删除轨道ID 这个字段。

正确示例

删除轨道 轨道="示例值"

错误示例

删除轨道 轨道="示例值" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track`	要删除的轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。不填时默认使用当前轨道。	否	无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`删除片段数量`	integer	是	未提供说明
`清理素材数量`	integer	是	未提供说明
`删除轨道ID`	string	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段删除轨道ID。

设置轨道属性

set_jianying_track_attribute

剪映剪辑助手轨道

用途：设置指定轨道的状态位。

写法：设置轨道属性 [轨道=<轨道>] 轨道状态=<轨道状态>

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

设置轨道属性 轨道='主视频轨' 轨道状态='静音,隐藏'

# 说明：把指定视频轨设为静音并隐藏

错误示例

设置轨道属性 轨道="示例值"

为什么错：漏写了必填参数：轨道状态。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track`	要设置的轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。不填时默认使用当前轨道。	否	无
轨道状态	`track_state`	要改成什么状态，可写正常、静音、隐藏、锁定，也可以用逗号组合。	是	无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`原轨道属性`	integer	是	未提供说明
`轨道属性`	integer	是	未提供说明
`轨道状态`	string	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

复制当前草稿轨道

copy_jianying_track_in_current_draft

剪映剪辑助手轨道

用途：复制当前草稿里的指定轨道到当前草稿的新轨道，并把目标轨道ID存到上下文变量“当前轨道”中。

写法：复制当前草稿轨道源轨道=<源轨道> 新轨道名=<新轨道名> [整体偏移=<整体偏移>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

复制当前草稿轨道 源轨道='主视频轨' 新轨道名='主视频副本'

# 说明：从当前草稿复制一条轨道到新轨道。

错误示例

复制当前草稿轨道 源轨道="示例值"

为什么错：漏写了必填参数：新轨道名。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
源轨道	`source_track`	当前草稿里的源轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。	是	无
新轨道名	`new_track_name`	复制后的新轨道名；禁止包含冒号。	是	无
整体偏移	`offset`	复制后整轨片段整体偏移时间。	否	0

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`当前轨道`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`片段数量`	integer	是	未提供说明
`来源草稿路径`	string	是	未提供说明
`复制片段数量`	integer	是	未提供说明
`整体偏移`	integer	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

从草稿导入轨道

import_jianying_track_from_draft

剪映剪辑助手轨道

用途：从其他草稿导入指定轨道到当前草稿；不写目标轨道时新增轨道，写了目标轨道时覆盖该目标轨道。

写法：从草稿导入轨道源草稿名=<源草稿名> 源轨道=<源轨道> [目标轨道=<目标轨道>] [新轨道名=<新轨道名>] [整体偏移=<整体偏移>]

保存为

默认保存主结果，通常就是 轨道ID 这个字段。

正确示例

从草稿导入轨道 源草稿名="示例名称" 源轨道="示例值"

错误示例

从草稿导入轨道 源草稿名="示例名称"

为什么错：漏写了必填参数：源轨道。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
源草稿名	`source_draft_name`	源草稿名称。	是	无
源轨道	`source_track`	源轨道；支持轨道ID、真实轨道名、视频:1 这类轨道写法、{当前轨道}。	是	无
目标轨道	`target_track`	目标轨道；提供后覆盖当前草稿里这条轨道。	否	无
新轨道名	`new_track_name`	导入后的新轨道名；不写目标轨道时可用它指定新增轨道名。	否	无
整体偏移	`offset`	导入后整轨片段整体偏移时间。	否	0

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道ID`	string	是	未提供说明
`当前轨道`	string	是	未提供说明
`轨道名`	string	是	未提供说明
`片段数量`	integer	是	未提供说明
`来源草稿路径`	string	是	未提供说明
`复制片段数量`	integer	是	未提供说明
`整体偏移`	integer	是	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道ID。

查看轨道列表

list_jianying_tracks

剪映剪辑助手轨道

用途：查看当前草稿的轨道列表与轨道ID。

写法：查看轨道列表

保存为

默认保存主结果，通常就是 轨道列表 这个字段。

正确示例

查看轨道列表

错误示例

查看轨道列表 错误参数=1

为什么错：使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径	类型	必有	说明
`状态`	string	是	未提供说明
`草稿路径`	string	是	未提供说明
`草稿名`	string	是	未提供说明
`轨道数量`	integer	是	未提供说明
`轨道列表`	array	是	未提供说明
`轨道列表[*]`	object	否	数组元素
`轨道列表[*].轨道名`	string	否	未提供说明
`轨道列表[*].轨道ID`	string	否	未提供说明
`轨道列表[*].片段数量`	integer	否	未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加保存为=变量名，默认保存主结果字段轨道列表。