游戏客户端架构 / 系统课时

一个组件只负责什么

一个组件只负责什么

角色受伤后需要扣血、播放受击音效、更新血条,甚至触发死亡动画。如果把这些行为都放进一个生命值组件,它会随着界面和表现需求不断膨胀。本课用可运行的生命值示例,明确组件应该接收什么、保存什么、输出什么,以及哪些职责必须留给外部系统。

学习目标

  • 用状态所有权和变化原因判断组件是否职责单一。
  • 为组件写出明确的输入、内部状态与输出契约。
  • 通过独立运行和变更测试验证组件不依赖界面、声音等外部功能。

从状态所有权界定职责

以 HealthComponent 为例,它负责维护当前生命值,保证数值处于 0 到最大生命值之间,并在数值变化时发出通知。扣血前的命中判定、护甲计算属于战斗规则;血条怎么画、死亡音效怎么播属于表现系统。

判断职责是否过大,不是数方法个数,而是问:这些方法是否因为同一种业务规则变化而改变? 调整生命值上下限可能修改 HealthComponent;更换 HUD 布局或音效资源则不应改它。

写清输入、状态和输出契约

先给组件写一份可以验证的契约,再决定具体引擎实现:

边界 内容 规则
输入 applyDamage(amount) 接收已结算的非负伤害
状态 maxHp、currentHp 不低于 0,且不高于 maxHp
输出 HealthChanged 仅在数值实际变化时发出变化前后值
外部消费者 HUD、音频、动画 订阅或接收事件,不由组件直接调用

生命值组件的输入输出和职责隔离

这张图的关键不是事件机制本身,而是依赖方向:组件可以通知“生命值已经变化”,却不应知道通知最终驱动血条、震屏还是声音。即使不用事件总线,也可通过注入的回调保持这一边界。

用最小代码验证组件行为

下面示例可保存为 health.js,在 Node.js 中运行。为了独立测试,组件不引用任何游戏引擎 API;实际项目可把同样的状态规则放入引擎组件,再用适配层连接事件系统。

js
class HealthComponent {
  constructor(maxHp, onChanged) {
    if (!Number.isFinite(maxHp) || maxHp <= 0) {
      throw new Error("maxHp 必须为正数");
    }
    this.maxHp = maxHp;
    this.currentHp = maxHp;
    // 外部注入通知出口,生命值组件不认识 HUD 或音频对象。
    this.onChanged = onChanged;
  }

  applyDamage(amount) {
    // 命中和护甲已在组件之外结算。
    if (!Number.isFinite(amount) || amount < 0) {
      throw new Error("伤害必须是非负有限数");
    }
    const previousHp = this.currentHp;
    this.currentHp = Math.max(0, previousHp - amount);
    // 状态没变就不重复通知消费者。
    if (previousHp !== this.currentHp) {
      this.onChanged({ previousHp, currentHp: this.currentHp });
    }
  }
}

const health = new HealthComponent(100, ({ previousHp, currentHp }) => {
  console.log(`生命值:${previousHp} -> ${currentHp}`);
});

health.applyDamage(30);
health.applyDamage(500);
health.applyDamage(10);

预期输出:

text
生命值:100 -> 70
生命值:70 -> 0

第一次扣血正常下降;第二次超过剩余生命值也只会归零;第三次在零生命值时没有变化,因此不会产生第三条通知。这分别验证了范围约束、边界处理和通知条件。回调这里只负责打印,换成事件发布器也不需要修改扣血规则。

处理新需求时决定放在哪里

若加入护甲减伤,应先由战斗系统计算最终伤害,再传给 applyDamage,避免生命值组件依赖武器、护甲和攻击者。如果加入中毒持续掉血,可由状态效果组件定时提交伤害;生命值组件仍只处理数值变化。死亡是否触发一次,则需定义清楚:生命值组件可以输出首次降到零的事实,但播放死亡动画、发放奖励和销毁对象应由各自负责的模块处理。

验收时尝试替换 HUD、关闭所有音效、增加一个新的受击特效。如果这三件事均无需修改 HealthComponent,而扣血、封顶和事件测试仍通过,说明组件边界具备实际可维护性;若一改界面就要改扣血代码,应将表现逻辑移出组件。

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

目录与阅读设置

阅读设置

17

记录一个想法

一个组件只负责什么

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

登录哪都通