游戏 AI / 系统课时
动画事件如何通知状态机
动画事件如何通知状态机
攻击动画里常有两个必须精确对齐的时刻:真正造成伤害的命中帧,以及动作播放完成的结束点。动画事件适合报告这些“时间事实”,但事件到达时 AI 可能已经切到受击、死亡或追击状态,因此状态机必须先验证事件是否仍然有效。
学习目标
- 用动画事件通知命中与动作完成,而不是让动画事件直接改 AI 状态。
- 在事件回调处验证当前状态,丢弃过期事件。
- 明确命中事件和结束事件分别应该驱动什么逻辑。
让动画事件只报告发生了什么
动画事件最适合表达“这一帧到了”,例如 AttackHitFrame 和 AttackAnimationFinished。它不应该直接扣血、切换到追击状态或重置整套 AI,因为这些动作还依赖当前目标、攻击是否已取消以及 NPC 是否已经死亡。

这种设计的关键是把“事件发生”和“事件是否有效”拆开。动画系统负责前者,状态机负责后者。
通过接收器转交给当前状态
下面是 Unity 中的片段示例。动画剪辑上的 Animation Event 分别调用 OnAttackHitFrame 和 OnAttackAnimationFinished。接收器不直接处理战斗,而是把事件交给状态机;状态机只有在当前仍处于 AttackState 时才转发。
using UnityEngine;
public interface IState
{
}
public sealed class AttackState : IState
{
private bool hitApplied;
public void Enter()
{
// 每次开始新的攻击生命周期时重新允许一次命中。
hitApplied = false;
}
public void OnHitFrame()
{
if (hitApplied)
{
return;
}
hitApplied = true;
Debug.Log("Attack hit accepted");
}
public void OnAnimationFinished()
{
Debug.Log("Attack finish accepted");
}
}
public sealed class EnemyStateMachine : MonoBehaviour
{
public IState CurrentState { get; private set; }
public void SetState(IState nextState)
{
CurrentState = nextState;
if (nextState is AttackState attack)
{
attack.Enter();
}
}
public void HandleAttackHitFrame()
{
if (CurrentState is AttackState attack)
{
attack.OnHitFrame();
}
}
public void HandleAttackAnimationFinished()
{
if (CurrentState is AttackState attack)
{
attack.OnAnimationFinished();
}
}
}
public sealed class AnimationEventReceiver : MonoBehaviour
{
[SerializeField] private EnemyStateMachine stateMachine;
public void OnAttackHitFrame()
{
stateMachine.HandleAttackHitFrame();
}
public void OnAttackAnimationFinished()
{
stateMachine.HandleAttackAnimationFinished();
}
}预期输出:当事件到达且 CurrentState 仍是 AttackState 时,控制台分别出现对应日志;如果攻击期间已经切换到其他状态,则两个回调都会被忽略,不产生攻击日志。
Attack hit accepted
Attack finish accepted命中事件与结束事件不要混用
命中事件通常只负责“这一次攻击现在可以结算”,例如生成判定盒、发射投射物或调用伤害结算。结束事件则表示动画表现已经走到允许离开攻击状态的节点,两者语义不同。
如果同一攻击动画可能因为受击或死亡被提前打断,状态切换应先发生,随后即使旧动画在混合期间又抛出事件,CurrentState 校验也会把它丢弃。这样不会出现“角色已经死亡,旧攻击动画却又打出一次伤害”的问题。
处理重复命中与快速切换
除了校验当前状态,还要防止同一个命中事件被重复消费。示例中的 hitApplied 保证一次 AttackState 生命周期内只结算一次命中,并在 Enter() 时重置,因此复用同一个状态实例也不会把上一次攻击的命中标记带进来。
如果项目存在多层 Animator、复杂 Cross Fade,或同一帧快速退出再进入攻击的情况,仅校验“当前是否是 AttackState”仍可能不够。此时应增加本次攻击的序号或播放上下文,让回调同时验证状态与本次攻击身份,而不是仅凭函数名判断事件归属。
最终的稳定关系是:状态机先决定进入攻击,Animator 负责把动作播放到正确时间点,Animation Event 把关键时间点送回状态机,而状态机再次确认事件仍属于当前有效攻击。这样即使动画被打断,战斗逻辑也不会被过期事件反向拖走。