用途:当 2D 角色需要在精灵实体上播放动画剪辑时使用本技能;播放器与剪辑类型配合 bevy-animation,需要混合剪辑时配合 bevy-animation-graph。
主要能力:帧序列可用 Sprite 的 texture_atlas(TextureAtlas)或 AnimationClip 曲线实现;命名切割肢体用 AnimationTargetId::from_name / from_names 指定曲线写入的实体;循环播放用 ActiveAnimation::repeat 设置 RepeatAnimation::Forever。剪辑资源是 AnimationClip 句柄,不是全局播放器。
使用方式:可见实体挂 Sprite(bevy::sprite),用 AnimationPlayer 与 AnimationTargetId / AnimatedBy(bevy::animation)把剪辑关联到该实体。引擎系统 advance_animations 与 animate_targets 由引擎拥有,游戏代码不应重新实现;对剪辑结束做出反应的逻辑应链在它们之后。帧表用 Sprite::from_atlas_image 与 TextureAtlas,剪辑曲线用 animated_field! 加 AnimatableCurve。切割肢体是带 AnimationTargetId 和 AnimatedBy 的实体,指向拥有 AnimationPlayer 的实体。
限制:目标为 Bevy 0.20+;不要在文档 URL 中固定 /0.20.0/,链接保持 latest。不要从两个无序系统可变查询同一组件,除非用 .chain() 排序。不要在本技能中虚构物理、导航、网络或 XR crate,也不要使用未命名的第三方 crate 或自造 API;仅使用有文档的 Bevy API。帧类型仅限 Sprite、TextureAtlas 和 AnimationClip。消息与观察者 API 见 bevy-events-messaging。具体收费、平台等信息暂未提供。