Skip to content

[v8.1.11] ✨ 文字模板入场动画支持与缓存数据补全

Choose a tag to compare

@Hommy-master Hommy-master released this 20 Oct 06:30
· 8 commits to main since this release

🎯 本次更新

  • 解决了套用剪映文字模板后“只有文字、没有入场动画”的问题,并基于本机剪映缓存批量补全了模板的资源与动画数据。

✨ 主要改动

  • 文字模板现在可以携带模板自带的入场动画,生成草稿时写入片段的动画素材
  • 模板配置新增可选的 resources 资源清单与 animation 动画参数
  • 资源与动画的缓存路径均可留空,由剪映按 resource_id 自动拉取,不依赖本机缓存
  • 用户显式指定入场动画时优先于模板自带动画,不会产生动画冲突
  • 新增缓存提取工具,可扫描本机 artistEffect 缓存补录模板数据

🗂️ 数据补全

  • 从剪映缓存中匹配到 2482 个文字模板并补录资源清单
  • 其中 1961 个模板补录了入场动画,本轮新增 1595 个
  • 同时兼容 ScriptTemplate 与 TextTemplate 两种缓存格式
  • 资源清单覆盖 default、sticker、fonts、text、flower 等面板类型

🛠️ 兼容性

  • 未补录 resources 与 animation 的模板保持原有行为,仍可正常显示文字
  • 接口参数与调用方式没有变化
  • openapi.yaml 未改动
  • 配置文件体积由约 687K 增至约 2.5M,解析与原逻辑一致

✅ 测试

  • 文字模板、气泡、花字、发光、文字动画、对齐等关联测试全部通过
  • 通过真实生成流程验证了新格式、旧格式、多资源模板和循环动画模板
  • 提供两份验证草稿,已在剪映中确认入场动画生效

📌 注意事项

  • 缓存中仍有 2083 个文字模板不在现有配置中,缺少名称和分类,暂未加入
  • 字幕模板是独立类别,本机缓存中没有对应数据,项目也尚未提供该功能
  • 模板动画数据需要按模板补录,可用 tools/extract_text_template_cache.py 在下载新模板后重新运行