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

处理组件之间的直接调用

处理组件之间的直接调用

当攻击组件需要扣除目标生命值时,直接调用生命组件通常是最简单的方案。但随着功能增加,攻击逻辑可能逐渐依赖动画、音效和界面,最终形成难以维护的调用链。本课通过具体示例建立组件调用边界,明确哪些依赖可以保留,哪些应该转移或解耦。

学习目标

  • 判断组件直接调用是否合理,识别双向依赖和跨职责调用。
  • 使用单向依赖与最小能力接口组织组件协作。
  • 区分同步调用、事件通知和系统协调的适用场景。

直接调用的边界在哪里

组件化并不意味着所有组件之间都不能直接调用。组件是封装某项能力及相关状态的对象,当一个组件必须立即使用另一项能力,而且调用关系稳定、职责明确时,直接调用通常更清晰。

例如,AttackComponent 负责产生攻击行为,目标的 HealthComponent 负责扣除生命值。攻击组件请求目标接收伤害,是一种合理的单向调用。

真正的问题不是出现了方法调用,而是调用方知道了多少不属于自己的细节。

假设攻击组件持有整个敌人对象,并执行以下操作:

  • 查找敌人内部的生命组件并修改生命值。
  • 直接修改敌人的动画播放状态。
  • 直接调用敌人的音效组件。
  • 直接更新敌人血条。

此时攻击组件已经了解目标的内部结构。敌人调整组件布局、替换动画系统或取消血条,都可能迫使攻击代码修改。

判断调用是否越界,可以检查三个问题:调用方是否确实需要这个结果;是否必须知道目标的具体实现;被调用方是否反过来依赖调用方。

建立单向依赖与最小能力接口

更稳妥的方式是让调用方依赖一项明确的能力,而不是依赖完整对象结构。

攻击组件只需要表达“让目标接收伤害”,并不需要知道目标如何储存生命值、播放受击动画或刷新界面。因此,可以把 takeDamage 视为最小的伤害接收接口。

越界的直接调用与最小能力接口的依赖方向对比

这张图的关键区别在于依赖方向。左侧调用方直接接触目标内部多个组件;右侧调用方只认识伤害接收能力,具体由哪种组件实现并不重要。

跨引擎实现时,可以使用语言接口、抽象类、协议或结构化的方法约定。无论选择哪种形式,都应尽量保持能力接口稳定、参数明确、返回语义清晰。

对于同一对象内长期存在的依赖,可以在对象装配阶段注入引用;对于攻击目标这样会不断变化的对象,则更适合在每次攻击时传入当前目标的能力引用,避免缓存过期对象。

实现一次可验证的单向调用

下面使用原生 JavaScript 模拟攻击组件与生命组件的协作。示例可保存为 app.js,使用 Node.js 执行,不依赖游戏引擎。

js
class HealthComponent {
  constructor(hp) {
    this.hp = hp;
  }

  takeDamage(amount) {
    // 无效伤害不能污染组件状态
    if (!Number.isFinite(amount) || amount <= 0) return this.hp;
    this.hp = Math.max(0, this.hp - amount);
    return this.hp;
  }
}

class AttackComponent {
  constructor(damage) {
    this.damage = damage;
  }

  attack(receiver) {
    // 只检查目标是否提供所需能力,不访问其内部结构
    if (!receiver || typeof receiver.takeDamage !== 'function') {
      return false;
    }
    receiver.takeDamage(this.damage);
    return true;
  }
}

const attack = new AttackComponent(12);
const slimeHealth = new HealthComponent(40);

console.log(`命中=${attack.attack(slimeHealth)}`);
console.log(`目标生命=${slimeHealth.hp}`);
console.log(`空目标=${attack.attack(null)}`);

预期输出:

text
命中=true
目标生命=28
空目标=false

这个示例保留了直接调用,但限定了调用方的知识范围:AttackComponent 只知道接收者具有 takeDamage 方法,不知道生命值储存在哪个字段,也不依赖任何特定的敌人类。

这里的 true 表示请求被提交给有效接收者,不代表一定造成了正数伤害。如果项目需要表示护盾抵消、无敌或免疫,应该进一步约定伤害结算结果,而不是依赖当前布尔值推断。

示例中的动态方法检查是一种轻量方案。正式项目可以使用静态接口检查或组件能力注册表,让依赖契约更加明确。

把依赖装配与生命周期留在外层

组件不应该在每次业务调用时自行遍历整个场景来寻找依赖。寻找目标、获取组件以及判断当前对象是否仍然有效,最好由明确的装配层或协调者负责。

可以采用以下边界:

  1. 对象装配阶段创建组件,并为需要稳定协作的组件提供必要引用。
  2. 业务执行阶段通过明确接口发起调用,不重新扫描无关组件。
  3. 目标缺失或能力不存在时,根据业务规则拒绝操作或返回失败结果。
  4. 对象禁用、销毁或从对象池回收时,清理订阅与长期引用,防止后续访问失效实例。

对于必需依赖,例如某种角色必须同时拥有移动组件和碰撞组件,通常应该在装配阶段验证完整性。对于可选依赖,例如某些对象没有生命组件,可以允许能力检查失败并由调用方决定是否继续。

何时改用事件或协调器

直接调用适合立即执行的明确命令,但并不适合所有协作关系。尤其当一个状态变化会影响多个独立系统时,继续添加直接调用会使核心组件不断扩大依赖范围。

协作需求 更合适的方式 原因
攻击请求目标扣血 直接调用能力接口 需要明确发起命令并取得结果
生命值变化后刷新 HUD、播放提示音 事件通知 多个订阅者可以独立响应
同一次拾取同时修改背包和地面物品 协调器或游戏系统 需要统一检查和处理跨对象规则
查询目标是否存活 只读查询接口 不需要广播或修改状态

以生命值变化为例,HealthComponent 完成扣血后可以发布 HealthChanged。HUD 负责更新显示,音频组件负责判断是否播放提示音,生命组件不需要反向持有这些订阅者。

但是事件不能替代所有直接调用。攻击是否能命中、伤害是否被接受等需要立即得知的结果,通常应保持明确的同步请求链;事后的显示、声音和统计才适合通知机制。

判断是否需要解耦时,重点看依赖是否跨越职责边界,以及一个组件的变化是否迫使无关组件修改。只要调用方向稳定、契约足够窄,直接调用就是合理的组件协作方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理组件之间的直接调用

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

登录哪都通