游戏引擎 / 系统课时
用状态驱动角色动画
用状态驱动角色动画
角色停止、移动或攻击时,如果输入脚本各自直接播放动画剪辑,很容易互相覆盖。本节在 Cocos Creator 3.8 中建立待机、移动、攻击三种表现状态,让动画只接受一个调度入口,并在攻击结束后恢复正确的移动表现。
学习目标
- 区分角色行为状态与正在播放的动画剪辑。
- 建立待机、移动、攻击的状态优先级及切换条件。
- 使用
Animation播放剪辑,并通过完成事件恢复常规状态。
准备剪辑与映射关系
创建一个可见角色节点,在同一节点上添加 Animation 和稍后编写的脚本组件。将三段动画剪辑加入 Animation 的 Clips 列表,确认其动画状态名称分别为 idle、run、attack;默认状态名取自剪辑名称,名称及大小写必须与代码一致。
| 行为状态 | 动画状态名 | 播放方式 | 触发条件 |
|---|---|---|---|
| 待机 | idle |
循环 | 无移动意图 |
| 移动 | run |
循环 | 有移动意图 |
| 攻击 | attack |
单次 | 收到攻击请求 |
在动画编辑器中把 idle、run 的 WrapMode 设为 Loop,把 attack 设为 Normal,并关闭 Animation 的 Play On Load,由脚本负责首次播放。剪辑应实际包含角色的可见变化;测试用键盘只驱动动画,不负责移动节点。
明确状态转换和抢占规则
待机与移动可以随输入相互切换,但攻击是优先级更高的短暂动作。攻击期间记录最新移动意图,不立即切回 run;只有 attack 播放完成,才根据当时的输入回到待机或移动。

这里的“状态”是业务脚本维护的决策结果,不等于 Animation 组件内部唯一正在播放的动画;后续使用交叉淡化时,组件可能同时管理多个播放状态。业务层仍应只记录一个当前目标表现。
编写统一动画驱动组件
下面是可挂载在角色节点上的完整 TypeScript 脚本 HeroAnimationDriver.ts。D 表示有移动意图,J 请求攻击;反复按 J 不会重启正在进行的攻击。
import {
_decorator, Animation, AnimationState, Component,
EventKeyboard, Input, KeyCode, input
} from 'cc';
const { ccclass } = _decorator;
type HeroState = 'idle' | 'run' | 'attack';
@ccclass('HeroAnimationDriver')
export class HeroAnimationDriver extends Component {
private animation: Animation | null = null;
private state: HeroState | null = null;
private moving = false;
onLoad(): void {
this.animation = this.getComponent(Animation);
if (!this.animation) {
console.error('缺少 Animation 组件');
return;
}
// 单次攻击完成后,再计算恢复到哪种常规状态。
this.animation.on(Animation.EventType.FINISHED, this.onFinished, this);
}
onEnable(): void {
input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
input.on(Input.EventType.KEY_UP, this.onKeyUp, this);
}
start(): void {
this.switchTo('idle');
}
private onKeyDown(event: EventKeyboard): void {
if (event.keyCode === KeyCode.KEY_D) this.setMoving(true);
if (event.keyCode === KeyCode.KEY_J) this.requestAttack();
}
private onKeyUp(event: EventKeyboard): void {
if (event.keyCode === KeyCode.KEY_D) this.setMoving(false);
}
public setMoving(value: boolean): void {
this.moving = value;
if (this.state !== 'attack') {
this.switchTo(value ? 'run' : 'idle');
}
}
public requestAttack(): void {
if (this.state !== 'attack') this.switchTo('attack');
}
private switchTo(next: HeroState): void {
if (!this.animation || this.state === next) return;
if (!this.animation.getState(next)) {
console.error(`找不到动画状态: ${next}`);
return;
}
// 只有目标状态变化时才重新播放。
this.state = next;
this.animation.play(next);
console.log(`动画状态: ${next}`);
}
private onFinished(_type: Animation.EventType, clip: AnimationState): void {
if (clip.name === 'attack' && this.state === 'attack') {
this.switchTo(this.moving ? 'run' : 'idle');
}
}
onDisable(): void {
input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
}
onDestroy(): void {
this.animation?.off(Animation.EventType.FINISHED, this.onFinished, this);
}
}预期输出:运行预览后先按住 D,再按 J,等待攻击播完,最后松开 D,控制台依次出现:
动画状态: idle
动画状态: run
动画状态: attack
动画状态: run
动画状态: idle如果攻击期间先松开 D,攻击结束应直接回到 idle。如果看到“找不到动画状态”,检查 Animation 的 Clips 列表及状态名;如果攻击始终不结束,检查 attack 是否误设成循环播放。
接入移动与攻击系统
接入键盘、摇杆或 AI 后,移动系统在移动意图变化时调用 setMoving(),攻击系统在攻击获准时调用 requestAttack();把示例中的键盘事件监听移除,避免两个系统重复发命令。真实项目还应在攻击判定层管理冷却和伤害,动画状态机只决定视觉表现。
FINISHED 只适合等待正常结束的非循环剪辑。若有受击、死亡等更高优先级打断,需先扩展状态与抢占规则,再决定是否忽略旧剪辑完成事件,不能把动画播放结束当成攻击命中判定。