游戏引擎 / 系统课时

用 class 封装游戏行为

用 class 封装游戏行为

血量被多个函数直接修改后,负数、重复死亡与共享状态会变得难以追踪。本节用一个纯 TypeScript 类把初始化、受伤和查询收拢到同一个对象,保证每个角色拥有独立状态,并把业务行为与 Cocos 组件生命周期分开。

学习目标

  • 用 constructor 建立对象初始状态。
  • 用方法集中维护血量变化规则。
  • 区分普通类对象与引擎组件的创建方式。

让对象维护自己的规则

类把状态与操作状态的方法放在一起,调用方表达“受到伤害”,而不是分别改 hp、alive 和显示内容。constructor 用于建立普通对象的初始不变量,例如最大血量必须为正数。方法完成规则检查,查询入口则只返回调用者需要的数据。

类不必继承 Component 才能服务于游戏。血量计算不需要节点、场景或引擎回调,保持为普通类可以让它被角色组件调用,也可以独立编译运行。输入事件与界面显示仍由引擎组件适配,避免为了测试血量必须打开场景。

写出一个独立血量对象

文件:main.ts,完整纯 TypeScript 主例程,strict 编译后运行 dist/main.js。

ts
export {};
class Health {
    private hp: number;
    constructor(private readonly maxHp: number) {
        if (!Number.isFinite(maxHp) || maxHp <= 0) {
            throw new Error('invalid maxHp');
        }
        this.hp = maxHp;
    }
    damage(amount: number): boolean {
        // 返回值仅表示这次调用是否造成首次死亡。
        if (!Number.isFinite(amount) || amount < 0) throw new Error('invalid damage');
        const wasAlive = this.hp > 0;
        this.hp = Math.max(0, this.hp - amount);
        return wasAlive && this.hp === 0;
    }
    snapshot(): string { return `${this.hp}/${this.maxHp}`; }
}
const first = new Health(30);
const second = new Health(30);
console.log(first.damage(40));
console.log(first.damage(1));
// 两个实例的 hp 不共享。
console.log(`${first.snapshot()}|${second.snapshot()}`);

预期输出:

text
true
false
0/30|30/30

第一次伤害跨过存活边界,所以返回 true;第二次已死亡,不应再次触发首次死亡逻辑。第二个对象仍有满血,说明实例状态独立。参数属性写法把 constructor 参数同时声明为字段,适用于这种明确的初始化依赖,不必额外重复赋值代码。

把创建时机留给调用方

普通 Health 可以通过 new 创建;组件实例的创建与销毁由节点和引擎管理,不能照搬 new MyComponent()。组件通常在自己的初始化阶段创建 Health,再把输入动作交给它。Health 不应在 constructor 中读取 this.node,因为它没有引擎节点上下文。

方法被当作回调传出时,this 可能变化;本例直接通过实例调用,因此 this 明确。以后把方法交给事件系统,要保留绑定关系或使用稳定的箭头函数入口。类只组织代码,不会改变 JavaScript 对 this 的调用规则。

验证行为而非字段细节

练习把两次伤害改为 10 和 20,确认仅第二次返回 true;再输入负值,确认规则主动拒绝。调用方应围绕 damage 与 snapshot 使用对象,避免依赖 hp 的内部存储形式。将来把血量改为护盾加生命值时,外部调用协议仍可保持清晰。类规则见 TypeScript Classes。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 class 封装游戏行为

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

登录哪都通