SuperAPI AI 工具集

bevy-tweening

编程与开发

查看项目

更新于 10-16 17:46

技能介绍

用途

bevy-tweening 是一个 Bevy ECS 技能,用于处理“某个值需要随时间缓动”的场景,也就是补间(tween)与游戏手感(juice)效果。它的核心思路是:补间播放器由开发者自己在 ECS 中基于已用时间构建,而不是依赖某个现成的补间节点或第三方库。

主要能力

  • 缓动采样:EasingCurve 可在两个值之间采样缓动,它本身不是存储实体状态的播放器。示例使用 EasingCurve::sample_clamped 获取缓动后的 t,内置曲线包括 EaseFunction::QuadraticOut 与 EaseFunction::CubicOut。
  • 属性补间:通过自定义组件保存 start、end、elapsed、duration,在 Update 中用 Time::delta_secs 推进已用时间,然后写入 Transform。
  • 手感效果:例如 punch scale(缩放冲击)使用同一套时钟和不同的缓动函数。
  • 序列:延迟后移动由两个组件组合实现——Wait 组件计时结束后插入 Slide 组件,顺序由数据表达,而非序列资产。
  • 完成处理:当 elapsed 达到 duration 时,通过移除标记组件结束补间,而不是依赖回调类型。

使用方式

依赖声明为:

[dependencies]
bevy = "0.20"

一个系统负责推进已用时间,缓动后的 t 由 EasingCurve::sample_clamped 得到,完成的补间由标记组件移除。示例代码定义了 Slide 组件(start、end、elapsed、duration),在 Startup 中生成实体,在 Update 中推进时间并写入 Transform,完成后 remove::<Slide>()。Punch 组件用相同时钟配合 CubicOut 实现缩放冲击。Wait 组件在剩余时间归零后插入 Slide 并移除自身,实现“延迟再移动”。

适用场景

  • 需要让某个值随时间缓动的属性动画。
  • 需要序列化效果(先等待、后移动)。
  • 需要为游戏添加手感反馈(如缩放冲击)。

限制与边界

  • 目标版本为 Bevy 0.20+。
  • 只使用官方文档中的 Bevy crate 与模块,不引入 Godot Tween 节点、Godot 类型,也不把命名第三方补间 crate 作为选定方案。
  • 不在此技能中虚构物理、导航、网络或 XR crate。
  • 不要从两个无序系统可变查询同一组件;除非用 .chain() 排序,否则调度会并行运行系统。
  • 文档 URL 不要固定 /0.20.0/,链接保持 latest。
  • 基于剪辑的属性动画属于 bevy-animation 的 AnimationClip,那是剪辑,不是一次性 UI 补间。

相关技能

前置技能包括 bevy-master(枢纽与调度)、bevy-ecs-composition(组件与系统)、bevy-animation(基于剪辑的属性动画)。互补技能为 godot-tweening(等价的 Godot 技能)。