游戏引擎 / 系统课时
建立角色动画蓝图
建立角色动画蓝图
角色已经能移动,并不意味着骨骼会自动播放正确动画。本课建立角色的 Animation Blueprint,把角色速度、是否离地和移动方向读成动画变量,再把动画蓝图绑定到 Skeletal Mesh,形成从 Gameplay 状态到最终姿势的完整链路。
学习目标
- 创建 Animation Blueprint,并正确绑定目标 Skeleton 与角色 Skeletal Mesh
- 从角色读取
Speed、IsInAir和Direction等移动状态 - 验证 Animation Blueprint 是否持续更新并驱动角色姿势
建立并绑定 Animation Blueprint
在 Content Browser 中选择角色使用的 Skeleton,创建 Animation Blueprint。父类保持 AnimInstance,目标 Skeleton 必须与角色 Skeletal Mesh 使用的骨骼兼容,否则动画资源和最终姿势可能无法正常连接。
将蓝图命名为例如 ABP_Player,然后选中角色蓝图中的 Skeletal Mesh Component,在动画设置中完成两项配置:
- 将 Animation Mode 设置为 Use Animation Blueprint。
- 将 Anim Class 设置为
ABP_Player。
先不要急着搭复杂状态机。可以在 AnimGraph 中放入一段与角色骨架兼容的 Idle 动画,并连接到最终 Output Pose。进入 PIE 后,如果角色能保持正确待机姿势,就说明 Skeletal Mesh、Skeleton、动画资源和 Anim Class 之间的基础绑定已经打通。
从角色读取移动状态
Animation Blueprint 的职责不是决定角色能否移动,而是读取 Gameplay 已经产生的状态,再把这些状态转换成动画。常用的读取链路是 Event Blueprint Update Animation → Try Get Pawn Owner → Character → CharacterMovement。
每次动画更新时,可以计算三个基础变量:
Speed:读取角色Velocity,使用水平速度长度,避免跳跃的垂直速度干扰地面移动动画。IsInAir:从 CharacterMovement 调用Is Falling,表示角色当前是否脱离可行走地面。Direction:根据 Velocity 与角色朝向计算移动方向,后续用于前进、后退和侧移动画混合。
片段示例:下面表示 Event Graph 中需要建立的核心数据关系,依赖 Try Get Pawn Owner 已成功取得当前 Character,并不是可独立执行的脚本。
Velocity = Character.GetVelocity()
Speed = VectorLengthXY(Velocity)
IsInAir = CharacterMovement.IsFalling()
Direction = CalculateDirection(Velocity, Character.GetActorRotation())预期结果:角色静止时 Speed 接近 0;开始水平移动后 Speed 增大;离开地面时 IsInAir 为 true;向角色左右方向移动时 Direction 会出现相应的正负角度。具体速度值取决于 CharacterMovement 配置。

把数据更新和姿势生成分开
Event Graph 负责收集或计算动画需要的数据,AnimGraph 负责利用这些数据生成姿势。把两者分开后,排查问题会简单很多:角色移动正常但动画不切换时,可以先观察变量是否变化;变量正确而姿势错误,再检查 AnimGraph、Blend Space 或状态机。
初学阶段使用 Event Blueprint Update Animation 读取状态最直观。项目变复杂后,如果动画更新出现较多跨对象访问,再考虑使用 Property Access、线程安全动画更新等方式降低动画线程与 Gameplay 对象之间的耦合,不必在最初就增加结构复杂度。
验证动画实例是否真的在工作
进入 PIE 后,可以打开控制台执行动画调试命令。先让角色处于可见状态,再输入:
ShowDebug Animation预期结果:游戏视口出现当前角色的动画调试信息,可用于确认正在使用的 Animation Instance、状态机或相关动画数据;显示内容会随 UE5 小版本和当前动画配置略有差异。调试结束后可执行 ShowDebug None 关闭调试显示。
如果 Speed 始终为 0,优先检查 Try Get Pawn Owner 是否取得当前角色,以及速度读取对象是否正确;如果变量持续变化但网格仍保持参考姿势,则回到 Skeletal Mesh 的 Anim Class、Skeleton 兼容性和 AnimGraph 输出链路检查。基础数据链稳定后,再引入状态机控制待机、移动与跳跃动画。