游戏 AI / 系统课时

动画事件如何通知状态机

动画事件如何通知状态机

攻击动画里常有两个必须精确对齐的时刻:真正造成伤害的命中帧,以及动作播放完成的结束点。动画事件适合报告这些“时间事实”,但事件到达时 AI 可能已经切到受击、死亡或追击状态,因此状态机必须先验证事件是否仍然有效。

学习目标

  • 用动画事件通知命中与动作完成,而不是让动画事件直接改 AI 状态。
  • 在事件回调处验证当前状态,丢弃过期事件。
  • 明确命中事件和结束事件分别应该驱动什么逻辑。

让动画事件只报告发生了什么

动画事件最适合表达“这一帧到了”,例如 AttackHitFrame 和 AttackAnimationFinished。它不应该直接扣血、切换到追击状态或重置整套 AI,因为这些动作还依赖当前目标、攻击是否已取消以及 NPC 是否已经死亡。

动画事件回传到状态机的校验流程

这种设计的关键是把“事件发生”和“事件是否有效”拆开。动画系统负责前者,状态机负责后者。

通过接收器转交给当前状态

下面是 Unity 中的片段示例。动画剪辑上的 Animation Event 分别调用 OnAttackHitFrame 和 OnAttackAnimationFinished。接收器不直接处理战斗,而是把事件交给状态机;状态机只有在当前仍处于 AttackState 时才转发。

csharp
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 时,控制台分别出现对应日志;如果攻击期间已经切换到其他状态,则两个回调都会被忽略,不产生攻击日志。

text
Attack hit accepted
Attack finish accepted

命中事件与结束事件不要混用

命中事件通常只负责“这一次攻击现在可以结算”,例如生成判定盒、发射投射物或调用伤害结算。结束事件则表示动画表现已经走到允许离开攻击状态的节点,两者语义不同。

如果同一攻击动画可能因为受击或死亡被提前打断,状态切换应先发生,随后即使旧动画在混合期间又抛出事件,CurrentState 校验也会把它丢弃。这样不会出现“角色已经死亡,旧攻击动画却又打出一次伤害”的问题。

处理重复命中与快速切换

除了校验当前状态,还要防止同一个命中事件被重复消费。示例中的 hitApplied 保证一次 AttackState 生命周期内只结算一次命中,并在 Enter() 时重置,因此复用同一个状态实例也不会把上一次攻击的命中标记带进来。

如果项目存在多层 Animator、复杂 Cross Fade,或同一帧快速退出再进入攻击的情况,仅校验“当前是否是 AttackState”仍可能不够。此时应增加本次攻击的序号或播放上下文,让回调同时验证状态与本次攻击身份,而不是仅凭函数名判断事件归属。

最终的稳定关系是:状态机先决定进入攻击,Animator 负责把动作播放到正确时间点,Animation Event 把关键时间点送回状态机,而状态机再次确认事件仍属于当前有效攻击。这样即使动画被打断,战斗逻辑也不会被过期事件反向拖走。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

动画事件如何通知状态机

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通