Skip to content

[v8.1.0] 支持蒙版位置、羽化、旋转关键帧、支持美颜

Choose a tag to compare

@Hommy-master Hommy-master released this 19 Sep 07:17
· 6 commits to main since this release

✨ 新功能

  • 新增 add_mask_keyframes 接口,可为已有蒙版的视频片段添加关键帧动画
  • 支持蒙版位置、羽化、旋转三类关键帧,同一时间点可一次写入多项属性
  • 参数单位与 add_masks 对齐:位置用像素,羽化 0–100,旋转用角度,时间用微秒
  • 同一属性在同一时间点重复写入会覆盖旧值,不会叠出重复关键帧

🧠 设计说明

  • 对照剪映真实草稿实现:关键帧写在片段上,不改蒙版静态配置
  • 独立于 add_keyframes,避免把剪映内部字段名和素材坐标系暴露给调用方
  • 片段必须先调用 add_masks;未挂蒙版时会明确报错,不会自动创建蒙版

📚 文档与测试

  • 补充中英双语接口文档,并在 README、add_masks 文档中加入关联入口
  • 覆盖位置换算、羽化换算、缺蒙版报错、同时刻覆盖、草稿字段导出等用例

⚠️ 注意

  • 暂不支持宽高、圆角关键帧
  • 位置按素材尺寸换算,不是画布尺寸;超出片段时长的时间点会截断到末尾