游戏引擎 / 系统课时
用 Animation 播放角色动作
用 Animation 播放角色动作
角色行走通常由一组离散图片或关键帧构成,播放动作前必须先有可用的动画剪辑和属性轨道。本节创建最小 SpriteFrame 序列,用脚本启动它,并区分动画状态与真正的游戏规则。
学习目标
- 为 SpriteFrame 属性创建关键帧剪辑
- 通过剪辑名播放并检查动画状态
- 避免动画轨道与移动逻辑争抢属性
让剪辑拥有可观察的变化
准备两张不同姿态、相同尺寸的角色 PNG,导入后确认各自有 SpriteFrame。创建 Player 精灵节点并添加 Animation,创建名为 walk 的剪辑,加入该 Animation 的 clips 列表。在动画编辑窗口选中该节点,给 Sprite 的 spriteFrame 属性建立轨道。

在 0、0.1、0.2 秒分别记录 A、B、A 三个 SpriteFrame,剪辑时长设为 0.3 秒,循环模式设为 Loop。图片属性是离散切换,不能像数值位置一样在两张图片间线性插值。保存剪辑与场景,退出动画编辑状态再预览。
通过明确名称启动
将 WalkPlayer.ts 挂到同一节点。关闭 Animation 的自动播放,避免自动入口与脚本同时启动;剪辑名称必须是 walk,不是资源目录路径。
import { _decorator, Component, Animation } from 'cc';
const { ccclass } = _decorator;
@ccclass('WalkPlayer')
export class WalkPlayer extends Component {
private animation: Animation | null = null;
start(): void {
this.animation = this.getComponent(Animation);
const state = this.animation?.getState('walk');
if (!state) {
console.error('Missing walk clip');
return; // 剪辑不存在时不要假装已经播放
}
this.animation!.play('walk');
console.log('animation:walk');
}
onDisable(): void {
this.animation?.stop(); // 离开当前行为时停止显示动画
}
}预期结果:控制台出现 animation:walk,角色每 0.1 秒左右切换姿态并循环。节点不应自行移动,因为剪辑只记录 SpriteFrame;若它的位置也变化,检查是否意外记录了 position 轨道。
管理播放和规则的边界
移动控制器应只在速度从零变为非零、或状态切换时播放动作,不能每帧重复 play 让剪辑总回到开头。走路、待机和受伤应由明确的角色状态选择;停止动画不代表恢复生命值或撤销一次攻击。
攻击帧事件可以通知逻辑进入命中窗口,但逻辑仍需校验攻击身份、目标有效性和重复命中。循环动画不会自然完成,不能依赖其完成事件结束战斗流程。组件重新启用后是否重播应由状态恢复策略决定,本例仅演示首次启动与停用清理。
若日志成功却图片不变,按顺序检查轨道是否指向当前 Sprite、关键帧是否真的不同、剪辑时间是否足够以及图片引用是否丢失。不要用不断重播掩盖错误轨道。