游戏引擎 / 系统课时
用 Animation Event 触发逻辑
用 Animation Event 触发逻辑
攻击动画能播放,却在挥刀前就扣血,或脚步声比落脚动作早半拍,都会破坏角色表现。本课把动画关键帧变成可调用的事件,让挥刀音效、范围命中、命中特效和脚步声按时触发,并用一次性门控处理重复命中与动作打断。
学习目标
- 理解 Animation Event 与脚本方法的绑定及其时间含义。
- 在攻击和移动剪辑中安排音效、伤害查询与特效事件。
- 避免重复结算,处理打断和事件没有执行到的边界。
把事件放在动作实际发生的时刻
Animation Event 是写在 Animation Clip 时间轴上的回调标记。Animator 播放到标记处时,会在挂有 Animator 的游戏对象上查找同名脚本方法;方法可以没有参数,也可以接收一个支持类型的参数。它适合对齐动作瞬间,而不是决定角色能否发动攻击。具体函数签名可查阅 Unity Animation Event 手册。
以一次非循环的挥刀为例:开始帧打开本次攻击的命中许可;挥刀经过身体前方时播放破风声;刀刃真正到达目标区域时才执行命中查询并生成特效;结束帧关闭许可。走路循环则在左右脚接触地面的关键帧分别放置脚步声事件,不能按固定秒数盲播。

实现可重复使用的事件接收器
把下面两个脚本分别保存为 AttackAnimationEvents.cs 和 EnemyHealth.cs。攻击脚本挂在 Animator 所在的游戏对象上;敌人的生命值脚本挂在带有碰撞体的敌人根对象上。这里用物理范围查询模拟近战命中,并通过一次性许可和目标去重避免同一挥刀重复扣血。
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();
}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 的一名敌人处于命中范围内,一次攻击将打印:
Enemy HP: 30
Hit targets: 1若敌人移出范围,下一次攻击命中回调的预期输出为:
Hit targets: 0EnemyHealth 负责修改生命值,而动画回调只负责在合适的时刻发起查询。多个碰撞体属于同一个敌人时,HashSet 保证本次事件只调用一次 TakeDamage;即使过渡期间意外重复进入 OnAttackHit,命中许可也已被消耗。
绑定剪辑并验证触发时机
- 在角色上添加
Animator、AudioSource和AttackAnimationEvents,将手部前方空对象拖到Hit Origin,配置声音与Enemy Layer。创建敌人专用 Layer,并让敌人的非 Trigger 碰撞体使用它;敌人根节点挂EnemyHealth。 - 创建非循环的
Attack动画剪辑,在Window > Animation > Animation的事件轨道上分别添加OnAttackBegin、OnSwing、OnAttackHit、OnAttackEnd。事件名必须与公开方法名完全一致,不要给本例的无参方法配置参数。导入的 FBX 剪辑也可以在模型导入设置的 Animation/Events 区域添加事件。 - 在循环移动剪辑的左右脚着地帧添加
OnFootstep。将粒子预制体设为非循环,并在粒子系统中配置播放结束时销毁,避免每次命中留下实例。 - 进入 Play 模式,让初始生命值为 50 的敌人站在
Hit Origin半径 0.8 的范围内,播放一次攻击;随后让敌人移出范围再攻击一次。还应核对脚落地时才发声。

音效和粒子应在 Game 视图及音频输出中检查。若控制台没有任何命中日志,先确认动画实际经过了 OnAttackHit 标记;若打印零命中,则逐项检查攻击中心、敌人 Layer 和非 Trigger 碰撞体。
处理打断和权威性边界
Animation Event 只有在播放经过标记时才有机会调用;提前切换或打断动画,不能假设结束事件一定执行。受击、死亡或闪避逻辑应主动调用 CancelAttack,而不只依赖 OnAttackEnd。过渡混合也可能带来意外回调,需要检查事件是否放在了多个同时参与混合的剪辑中。
本例适合单机近战原型。多人游戏中的最终扣血应由权威战斗逻辑判定,动画事件可负责播放表现或提交受约束的命中请求,不能把客户端动画帧当作可信伤害凭证。脚步、破风声和短暂特效最适合交给 Animation Event;冷却、技能是否合法和角色是否死亡,仍属于玩法状态。