游戏引擎 / 系统课时
把动画事件接到游戏逻辑
把动画事件接到游戏逻辑
角色挥刀时,伤害不该在按下攻击键的瞬间生效,也不该靠一个固定延时猜测命中帧。本课使用 Cocos Creator 3.8 的动画事件帧,在挥刀经过目标的时刻触发一次演示伤害、音效和特效,并处理动画结束及中断。
学习目标
- 理解动画事件帧与动画播放结束事件的不同职责。
- 在
attack动画指定帧调用 TypeScript 组件方法。 - 验证一次攻击只结算一次,且中断后能重新攻击。
事件帧为什么比定时器准确
AnimationClip 记录角色动作;事件帧记录动画播放到某个位置时要调用的方法。攻击动作加速或减速后,事件仍跟随动画时间线移动,而独立 scheduleOnce 延时容易与画面错位。
以 0.6 秒的非循环攻击动作为例:开始时锁定攻击输入,约 0.25 秒刀刃碰到目标时触发 onAttackHit,播放完毕再解除攻击锁。这里的 0.25 秒仅为演示,实际应对齐精灵帧中武器接触目标的画面。

配置动画与事件
- 在角色节点
Player上添加Animation,将非循环动画片段attack加入该组件的 Clips;把PlayerAttack脚本也挂在这个节点,避免事件找不到接收方法。 - 打开动画编辑器,选中
attack,在动作真正击中目标的帧右键事件轨道选择新建事件帧,双击事件帧编辑函数名onAttackHit,无需参数,然后保存片段。 - 给脚本的
attackAnimation属性拖入同节点的Animation;命中音效可选填已配置音频片段的AudioSource,命中特效可选填Prefab和用于承载特效的fxRoot。 - 为测试创建一个攻击按钮,在 Button 的 Click Events 中将目标指向
Player,选择PlayerAttack.beginAttack。实际项目可由输入控制器调用该方法。
用组件接住事件
把下面内容保存为 PlayerAttack.ts。示例用脚本内部的 enemyHp 模拟固定目标,便于单独验证事件时序;真实项目应在命中帧进行有效目标检测,再交给战斗逻辑结算伤害。
ts
import {
_decorator, Animation, AnimationState, AudioSource,
Component, Node, Prefab, instantiate
} from 'cc';
const { ccclass, property } = _decorator;
@ccclass('PlayerAttack')
export class PlayerAttack extends Component {
@property(Animation) attackAnimation: Animation | null = null;
@property(AudioSource) hitAudio: AudioSource | null = null;
@property(Prefab) hitEffect: Prefab | null = null;
@property(Node) fxRoot: Node | null = null;
private enemyHp = 30;
private attacking = false;
private hitDone = false;
onEnable(): void {
this.attackAnimation?.on(Animation.EventType.FINISHED, this.onFinished, this);
}
onDisable(): void {
this.attackAnimation?.off(Animation.EventType.FINISHED, this.onFinished, this);
this.attacking = false;
}
public beginAttack(): void {
if (this.attacking || !this.attackAnimation?.getState('attack')) return;
this.attacking = true;
this.hitDone = false;
this.attackAnimation.play('attack');
}
// 由 attack 片段上的事件帧按名称调用
public onAttackHit(): void {
if (!this.attacking || this.hitDone) return;
this.hitDone = true; // 同一轮攻击只结算一次
this.enemyHp = Math.max(0, this.enemyHp - 10);
this.hitAudio?.play();
if (this.hitEffect && this.fxRoot) {
const effect = instantiate(this.hitEffect);
this.fxRoot.addChild(effect);
// 临时特效需要回收,避免反复攻击堆积节点
this.scheduleOnce(() => {
if (effect.isValid) effect.destroy();
}, 0.4);
}
console.log(`attack hit: enemyHp=${this.enemyHp}`);
}
private onFinished(_type: Animation.EventType, state: AnimationState): void {
if (state.name === 'attack') this.attacking = false;
}
// 被击退、死亡或强制切状态时主动调用
public cancelAttack(): void {
this.attacking = false;
this.attackAnimation?.stop();
}
}预期输出:在每次非循环攻击完整结束后再点击一次按钮,控制台依次出现:
text
attack hit: enemyHp=20
attack hit: enemyHp=10
attack hit: enemyHp=0同时,有效配置了音效和特效资源时,会在事件帧播放命中声音并生成特效;没有配置这两项时仍可验证扣血日志。
防止重复伤害与中断残留
hitDone 防止同一轮攻击的命中函数被重复调用;attacking 阻止尚未收招时再次启动动画。动画须设置为非循环,否则结束时机与攻击锁可能不符。
测试时把事件帧移至挥刀前后对比声音与画面的同步性;再在命中前调用 cancelAttack(),确认没有扣血并能重新发起攻击。不要仅因播放到命中帧就认定攻击必然打中:事件帧决定何时检查命中,目标距离、碰撞、无敌状态和最终伤害仍属于游戏规则层。
按自己的节奏,确认真正理解。