添加贴纸
功能简介
添加贴纸到草稿，为视频添加装饰性的图片元素。贴纸可以增加视频的趣味性和视觉效果。
使用场景
- 需要为视频添加装饰性贴纸
- 需要添加表情包或图标
- 需要为特定时间段显示贴纸
参数说明
输入参数
基础参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 贴纸资源ID | 字符串 | 是 | 贴纸的唯一标识，通过【搜索贴纸】指令来获取 |
| 开始显示时间 | 小数 | 否 | 贴纸开始显示的时间，单位：秒，默认 0 |
| 结束显示时间 | 小数 | 否 | 贴纸结束显示的时间，单位：秒，默认 5.0 |
| 草稿ID | 字符串 | 否 | 目标草稿的 ID，不填则创建新草稿 |
位置和变换参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 垂直偏移 | 小数 | 否 | 垂直方向的偏移（相对值），单位为半个画布高，范围 -1.0 到 1.0 |
| 垂直偏移_像素 | 整数 | 否 | 垂直方向的偏移（像素值），单位：像素 |
| 水平偏移 | 小数 | 否 | 水平方向的偏移（相对值），单位为半个画布宽，范围 -1.0 到 1.0 |
| 水平偏移_像素 | 整数 | 否 | 水平方向的偏移（像素值），单位：像素 |
| 水平缩放 | 小数 | 否 | 水平方向的缩放比例，1.0 为原始大小，默认 1.0 |
| 垂直缩放 | 小数 | 否 | 垂直方向的缩放比例，1.0 为原始大小，默认 1.0 |
| 旋转角度 | 小数 | 否 | 贴纸的旋转角度，单位：度，默认 0.0 |
其他参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 贴纸透明度 | 小数 | 否 | 贴纸的透明度，范围 0.0-1.0，1.0 为完全不透明（默认值），0.0 为完全透明 |
| 是否水平翻转 | 布尔值 | 否 | 是否水平翻转贴纸，默认 false |
| 是否垂直翻转 | 布尔值 | 否 | 是否垂直翻转贴纸，默认 false |
| 轨道名称 | 字符串 | 否 | 贴纸所在的轨道名称，默认 sticker_main |
| 相对索引 | 整数 | 否 | 轨道相对位置，数值越大越靠上，默认 0 |
| 画布宽度 | 整数 | 否 | 画布的宽度，单位：像素。仅在创建新草稿时需要指定 |
| 画布高度 | 整数 | 否 | 画布的高度，单位：像素。仅在创建新草稿时需要指定 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 返回草稿ID | 字符串 | 是 | 操作后的草稿 ID |
| 草稿URL | 字符串 | 是 | 草稿的访问链接 |
注意事项
贴纸ID获取
贴纸资源ID必须通过【搜索贴纸】指令来获取，不能随意填写。
时间范围
开始显示时间必须小于结束显示时间，贴纸会在指定的时间范围内显示。
偏移参数
相对值和像素值只需设置其中一个，如果都设置，像素值优先级更高。
草稿ID
如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID。