游戏引擎 / 系统课时

把多个动作连成动画状态

把多个动作连成动画状态

本课将待机、移动和跳跃三个独立骨骼动画连接成可控制的动画状态机。你会使用 Cocos Creator 3.8 的 Animation Graph 配置状态、切换条件和过渡时间,再通过 TypeScript 驱动动画参数,让角色根据输入自动切换动作,而不是反复手动播放动画片段。

学习目标

  • 理解动画状态、转换条件与过渡混合的职责。
  • 创建 Idle、Move、Jump 状态并配置双向转换。
  • 使用 AnimationController 修改变量,验证动画切换效果。

让动作成为有条件的状态

假设角色已经拥有从 FBX 或 glTF 导入的 Idle、Move、Jump 三段骨骼动画。单独播放这些动画并不难,困难在于决定何时切换,以及切换时如何避免姿势突然跳变。

动画状态机将这个问题拆成三个部分:状态负责播放动作,变量负责描述角色当前的运动意图,转换负责判断能否进入另一个状态。这样移动脚本只需更新速度或发出跳跃请求,不必关心动画片段如何停止和混合。

本例使用两个变量:

变量 类型 含义
speed Float 移动输入强度,示例取 0 或 1
jump Trigger 一次性的跳跃动画请求

三个动画状态分别承担不同职责。Idle 在未移动时循环播放,Move 在存在移动输入时循环播放,Jump 播放一次完整的起跳与落地动作。

这里的 Jump 是动画表现状态,不等于物理系统已经执行跳跃。正式项目应由角色运动系统负责起跳、重力和落地检测,再向动画系统同步真实运动状态。

待机、移动和跳跃动画状态的转换条件与过渡关系

在编辑器中配置动画图

先确认三段动画使用相同的骨骼层级,并且能够在目标模型上独立播放。移动动画最好采用原地动作,避免动画根位移与角色控制脚本同时改变世界位置。

  1. 在资源管理器 Assets 中点击创建按钮,选择 Animation Graph,新建角色动画图。
  2. 选中动画图资源,在属性检查器 Inspector 中点击 Edit,打开动画图编辑面板。
  3. 在 Variables 中创建 Float 类型的 speed 和 Trigger 类型的 jump,初始 speed 设为 0。
  4. 在图的空白区域右键,选择 Add State - Animation Clip,创建三个动作状态,并分别命名为 Idle、Move、Jump。
  5. 逐个选中状态,将对应骨骼动画片段绑定到 Clip 属性。将 Idle、Move 设置为循环播放,Jump 设置为非循环播放。
  6. 从 Entry 创建指向 Idle 的转换,让角色启动时先播放待机动画。
  7. 在场景角色的模型根节点上添加 Animation Controller 组件,将动画图资源拖入 Graph 属性,保存动画图。

设置切换条件与过渡时间

在动画图中右键源状态,选择 Add Transition,再点击目标状态建立转换。选中转换箭头,在 Inspector 中设置 Conditions、Duration 和退出时间。

建议从以下规则开始:

转换 条件 过渡时间
Idle → Move speed > 0.1 0.12 秒
Move → Idle speed <= 0.1 0.12 秒
Idle → Jump jump 触发 0.08 秒
Move → Jump jump 触发 0.08 秒
Jump → Idle speed <= 0.1 且满足退出时间 0.10 秒
Jump → Move speed > 0.1 且满足退出时间 0.10 秒

对于待机和移动之间的转换,关闭 Enable Exit Times,使条件满足时立即开始混合。否则可能要等动画循环达到指定播放进度后才能转换,导致松开按键仍继续跑动。

对于 Jump 的返回转换,开启 Enable Exit Times,例如设为 0.85,让跳跃动作至少播放到约 85% 的进度,再根据 speed 选择返回状态。Duration 使用秒作为单位,以上数值只是适合短动作的起点,应结合实际片段长度微调。

Trigger 变量适合跳跃这类瞬时请求。它在符合条件的状态转换完成后由状态机复位,不需要每帧持续写入 true。不要给两个返回状态配置互相重叠的条件,否则可能出现不可预期的转换选择。

用脚本驱动动画变量

创建 CharacterAnimationInput.ts,并挂在带有 Animation Controller 的同一个节点上。以下示例直接监听 W 和空格键,仅用于验证动画状态机,不负责角色实际位移或物理跳跃。

ts
import {
    _decorator, Component, animation,
    input, Input, EventKeyboard, KeyCode
} from 'cc';

const { ccclass } = _decorator;

@ccclass('CharacterAnimationInput')
export class CharacterAnimationInput extends Component {
    private controller: animation.AnimationController | null = null;
    private moving = false;

    onLoad() {
        this.controller = this.getComponent(animation.AnimationController);
        if (!this.controller) {
            console.error('缺少 AnimationController');
        }
    }

    onEnable() {
        input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
        input.on(Input.EventType.KEY_UP, this.onKeyUp, this);
    }

    onDisable() {
        // 组件停用后解除监听,避免重复接收输入。
        input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
        input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
    }

    private onKeyDown(event: EventKeyboard) {
        if (!this.controller) return;

        if (event.keyCode === KeyCode.KEY_W && !this.moving) {
            this.moving = true;
            this.controller.setValue('speed', 1);
            console.log('speed=1');
        }

        if (event.keyCode === KeyCode.SPACE) {
            // Trigger 在状态转换完成后由动画图复位。
            this.controller.setValue('jump', true);
            console.log('jump trigger');
        }
    }

    private onKeyUp(event: EventKeyboard) {
        if (!this.controller) return;

        if (event.keyCode === KeyCode.KEY_W) {
            this.moving = false;
            this.controller.setValue('speed', 0);
            console.log('speed=0');
        }
    }
}

预期输出:启动预览后,按住 W、按一次空格、再松开 W,控制台依次出现以下业务日志。实际日志可能带有引擎时间前缀。

text
speed=1
jump trigger
speed=0

对应的可见效果为:角色从 Idle 进入 Move,按空格后切换到 Jump;跳跃片段达到退出条件后,因为 speed 已经变成 0,最终返回 Idle。若一直按住 W,则应返回 Move。

验证状态机是否可靠

先执行完整操作序列:启动时待机、按 W 移动、松开 W 待机、按空格跳跃、等待动作结束,再尝试移动过程中跳跃。每次操作都应能找到唯一合理的目标状态。

如果控制台日志正确但动作不切换,应按以下顺序定位:

  1. 检查 Animation Controller 的 Graph 是否绑定正确,模型骨骼与动画片段是否兼容。
  2. 检查 Variables 中的名称、大小写和类型是否与代码中的 speed、jump 完全一致。
  3. 检查 Entry 是否能够进入 Idle,以及转换箭头方向是否正确。
  4. 检查数值条件、Enable Exit Times 和 Duration,排除条件永远不满足或过渡时间过长的问题。
  5. 检查 Jump 是否意外循环,以及两个返回转换是否覆盖了 speed 的不同取值。

本例的核心边界是:角色运动逻辑负责产生可信的速度与跳跃状态,Animation Controller 负责根据变量选择片段和完成平滑过渡。保持这两个职责独立,后续增加奔跑、受击或落地动画时才不会让控制代码变得难以维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

把多个动作连成动画状态

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

登录哪都通