用途
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 技能)。