游戏引擎 / 系统课时

用 Animation Event 触发逻辑

用 Animation Event 触发逻辑

攻击动画能播放,却在挥刀前就扣血,或脚步声比落脚动作早半拍,都会破坏角色表现。本课把动画关键帧变成可调用的事件,让挥刀音效、范围命中、命中特效和脚步声按时触发,并用一次性门控处理重复命中与动作打断。

学习目标

  • 理解 Animation Event 与脚本方法的绑定及其时间含义。
  • 在攻击和移动剪辑中安排音效、伤害查询与特效事件。
  • 避免重复结算,处理打断和事件没有执行到的边界。

把事件放在动作实际发生的时刻

Animation Event 是写在 Animation Clip 时间轴上的回调标记。Animator 播放到标记处时,会在挂有 Animator 的游戏对象上查找同名脚本方法;方法可以没有参数,也可以接收一个支持类型的参数。它适合对齐动作瞬间,而不是决定角色能否发动攻击。具体函数签名可查阅 Unity Animation Event 手册。

以一次非循环的挥刀为例:开始帧打开本次攻击的命中许可;挥刀经过身体前方时播放破风声;刀刃真正到达目标区域时才执行命中查询并生成特效;结束帧关闭许可。走路循环则在左右脚接触地面的关键帧分别放置脚步声事件,不能按固定秒数盲播。

动画关键帧与攻击逻辑的触发时序

实现可重复使用的事件接收器

把下面两个脚本分别保存为 AttackAnimationEvents.cs 和 EnemyHealth.cs。攻击脚本挂在 Animator 所在的游戏对象上;敌人的生命值脚本挂在带有碰撞体的敌人根对象上。这里用物理范围查询模拟近战命中,并通过一次性许可和目标去重避免同一挥刀重复扣血。

csharp
using System.Collections.Generic;
using UnityEngine;

public class AttackAnimationEvents : MonoBehaviour
{
    [SerializeField] private Transform hitOrigin;
    [SerializeField, Min(0.01f)] private float hitRadius = 0.8f;
    [SerializeField] private LayerMask enemyLayer;
    [SerializeField, Min(0)] private int damage = 20;
    [SerializeField] private AudioSource soundSource;
    [SerializeField] private AudioClip swingSound;
    [SerializeField] private AudioClip footstepSound;
    [SerializeField] private ParticleSystem hitEffectPrefab;

    private bool canApplyHit;

    public void OnAttackBegin() => canApplyHit = true;

    public void OnSwing()
    {
        if (soundSource != null && swingSound != null)
            soundSource.PlayOneShot(swingSound);
    }

    public void OnAttackHit()
    {
        if (!canApplyHit || hitOrigin == null) return;
        canApplyHit = false; // 一次挥刀只允许执行一次范围查询

        Collider[] colliders = Physics.OverlapSphere(
            hitOrigin.position, hitRadius, enemyLayer,
            QueryTriggerInteraction.Ignore);
        var hitEnemies = new HashSet<EnemyHealth>();

        foreach (Collider col in colliders)
        {
            EnemyHealth health = col.GetComponentInParent<EnemyHealth>();
            if (health == null || !hitEnemies.Add(health)) continue;

            health.TakeDamage(damage);
            if (hitEffectPrefab != null)
            {
                ParticleSystem effect = Instantiate(
                    hitEffectPrefab, col.ClosestPoint(hitOrigin.position),
                    Quaternion.identity);
                effect.Play();
            }
        }

        Debug.Log($"Hit targets: {hitEnemies.Count}");
    }

    public void OnFootstep()
    {
        if (soundSource != null && footstepSound != null)
            soundSource.PlayOneShot(footstepSound);
    }

    public void OnAttackEnd() => canApplyHit = false;

    // 受击或闪避中断攻击时,战斗控制逻辑也应调用此方法。
    public void CancelAttack() => canApplyHit = false;

    private void OnDisable() => CancelAttack();
}
csharp
using UnityEngine;

public class EnemyHealth : MonoBehaviour
{
    [SerializeField, Min(1)] private int maxHp = 50;
    private int hp;

    private void Awake() => hp = maxHp;

    public void TakeDamage(int amount)
    {
        if (hp == 0 || amount <= 0) return;
        hp = Mathf.Max(0, hp - amount); // 避免生命值成为负数
        Debug.Log($"Enemy HP: {hp}");
    }
}

预期结果:按下文绑定剪辑并让生命值为 50 的一名敌人处于命中范围内,一次攻击将打印:

text
Enemy HP: 30
Hit targets: 1

若敌人移出范围,下一次攻击命中回调的预期输出为:

text
Hit targets: 0

EnemyHealth 负责修改生命值,而动画回调只负责在合适的时刻发起查询。多个碰撞体属于同一个敌人时,HashSet 保证本次事件只调用一次 TakeDamage;即使过渡期间意外重复进入 OnAttackHit,命中许可也已被消耗。

绑定剪辑并验证触发时机

  1. 在角色上添加 Animator、AudioSource 和 AttackAnimationEvents,将手部前方空对象拖到 Hit Origin,配置声音与 Enemy Layer。创建敌人专用 Layer,并让敌人的非 Trigger 碰撞体使用它;敌人根节点挂 EnemyHealth。
  2. 创建非循环的 Attack 动画剪辑,在 Window > Animation > Animation 的事件轨道上分别添加 OnAttackBegin、OnSwing、OnAttackHit、OnAttackEnd。事件名必须与公开方法名完全一致,不要给本例的无参方法配置参数。导入的 FBX 剪辑也可以在模型导入设置的 Animation/Events 区域添加事件。
  3. 在循环移动剪辑的左右脚着地帧添加 OnFootstep。将粒子预制体设为非循环,并在粒子系统中配置播放结束时销毁,避免每次命中留下实例。
  4. 进入 Play 模式,让初始生命值为 50 的敌人站在 Hit Origin 半径 0.8 的范围内,播放一次攻击;随后让敌人移出范围再攻击一次。还应核对脚落地时才发声。

Unity Animation 窗口的事件轨道与 Function 字段

音效和粒子应在 Game 视图及音频输出中检查。若控制台没有任何命中日志,先确认动画实际经过了 OnAttackHit 标记;若打印零命中,则逐项检查攻击中心、敌人 Layer 和非 Trigger 碰撞体。

处理打断和权威性边界

Animation Event 只有在播放经过标记时才有机会调用;提前切换或打断动画,不能假设结束事件一定执行。受击、死亡或闪避逻辑应主动调用 CancelAttack,而不只依赖 OnAttackEnd。过渡混合也可能带来意外回调,需要检查事件是否放在了多个同时参与混合的剪辑中。

本例适合单机近战原型。多人游戏中的最终扣血应由权威战斗逻辑判定,动画事件可负责播放表现或提交受约束的命中请求,不能把客户端动画帧当作可信伤害凭证。脚步、破风声和短暂特效最适合交给 Animation Event;冷却、技能是否合法和角色是否死亡,仍属于玩法状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Animation Event 触发逻辑

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

登录哪都通