游戏引擎 / 系统课时

用状态驱动角色动画

用状态驱动角色动画

角色停止、移动或攻击时,如果输入脚本各自直接播放动画剪辑,很容易互相覆盖。本节在 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 不会重启正在进行的攻击。

ts
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,控制台依次出现:

text
动画状态: idle
动画状态: run
动画状态: attack
动画状态: run
动画状态: idle

如果攻击期间先松开 D,攻击结束应直接回到 idle。如果看到“找不到动画状态”,检查 Animation 的 Clips 列表及状态名;如果攻击始终不结束,检查 attack 是否误设成循环播放。

接入移动与攻击系统

接入键盘、摇杆或 AI 后,移动系统在移动意图变化时调用 setMoving(),攻击系统在攻击获准时调用 requestAttack();把示例中的键盘事件监听移除,避免两个系统重复发命令。真实项目还应在攻击判定层管理冷却和伤害,动画状态机只决定视觉表现。

FINISHED 只适合等待正常结束的非循环剪辑。若有受击、死亡等更高优先级打断,需先扩展状态与抢占规则,再决定是否忽略旧剪辑完成事件,不能把动画播放结束当成攻击命中判定。

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

目录与阅读设置

阅读设置

17

记录一个想法

用状态驱动角色动画

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

登录哪都通