游戏引擎 / 系统课时
用 class 封装游戏行为
用 class 封装游戏行为
血量被多个函数直接修改后,负数、重复死亡与共享状态会变得难以追踪。本节用一个纯 TypeScript 类把初始化、受伤和查询收拢到同一个对象,保证每个角色拥有独立状态,并把业务行为与 Cocos 组件生命周期分开。
学习目标
- 用 constructor 建立对象初始状态。
- 用方法集中维护血量变化规则。
- 区分普通类对象与引擎组件的创建方式。
让对象维护自己的规则
类把状态与操作状态的方法放在一起,调用方表达“受到伤害”,而不是分别改 hp、alive 和显示内容。constructor 用于建立普通对象的初始不变量,例如最大血量必须为正数。方法完成规则检查,查询入口则只返回调用者需要的数据。
类不必继承 Component 才能服务于游戏。血量计算不需要节点、场景或引擎回调,保持为普通类可以让它被角色组件调用,也可以独立编译运行。输入事件与界面显示仍由引擎组件适配,避免为了测试血量必须打开场景。
写出一个独立血量对象
文件:main.ts,完整纯 TypeScript 主例程,strict 编译后运行 dist/main.js。
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()}`);预期输出:
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。