游戏客户端架构 / 系统课时
处理组件之间的直接调用
处理组件之间的直接调用
当攻击组件需要扣除目标生命值时,直接调用生命组件通常是最简单的方案。但随着功能增加,攻击逻辑可能逐渐依赖动画、音效和界面,最终形成难以维护的调用链。本课通过具体示例建立组件调用边界,明确哪些依赖可以保留,哪些应该转移或解耦。
学习目标
- 判断组件直接调用是否合理,识别双向依赖和跨职责调用。
- 使用单向依赖与最小能力接口组织组件协作。
- 区分同步调用、事件通知和系统协调的适用场景。
直接调用的边界在哪里
组件化并不意味着所有组件之间都不能直接调用。组件是封装某项能力及相关状态的对象,当一个组件必须立即使用另一项能力,而且调用关系稳定、职责明确时,直接调用通常更清晰。
例如,AttackComponent 负责产生攻击行为,目标的 HealthComponent 负责扣除生命值。攻击组件请求目标接收伤害,是一种合理的单向调用。
真正的问题不是出现了方法调用,而是调用方知道了多少不属于自己的细节。
假设攻击组件持有整个敌人对象,并执行以下操作:
- 查找敌人内部的生命组件并修改生命值。
- 直接修改敌人的动画播放状态。
- 直接调用敌人的音效组件。
- 直接更新敌人血条。
此时攻击组件已经了解目标的内部结构。敌人调整组件布局、替换动画系统或取消血条,都可能迫使攻击代码修改。
判断调用是否越界,可以检查三个问题:调用方是否确实需要这个结果;是否必须知道目标的具体实现;被调用方是否反过来依赖调用方。
建立单向依赖与最小能力接口
更稳妥的方式是让调用方依赖一项明确的能力,而不是依赖完整对象结构。
攻击组件只需要表达“让目标接收伤害”,并不需要知道目标如何储存生命值、播放受击动画或刷新界面。因此,可以把 takeDamage 视为最小的伤害接收接口。

这张图的关键区别在于依赖方向。左侧调用方直接接触目标内部多个组件;右侧调用方只认识伤害接收能力,具体由哪种组件实现并不重要。
跨引擎实现时,可以使用语言接口、抽象类、协议或结构化的方法约定。无论选择哪种形式,都应尽量保持能力接口稳定、参数明确、返回语义清晰。
对于同一对象内长期存在的依赖,可以在对象装配阶段注入引用;对于攻击目标这样会不断变化的对象,则更适合在每次攻击时传入当前目标的能力引用,避免缓存过期对象。
实现一次可验证的单向调用
下面使用原生 JavaScript 模拟攻击组件与生命组件的协作。示例可保存为 app.js,使用 Node.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)}`);预期输出:
命中=true
目标生命=28
空目标=false这个示例保留了直接调用,但限定了调用方的知识范围:AttackComponent 只知道接收者具有 takeDamage 方法,不知道生命值储存在哪个字段,也不依赖任何特定的敌人类。
这里的 true 表示请求被提交给有效接收者,不代表一定造成了正数伤害。如果项目需要表示护盾抵消、无敌或免疫,应该进一步约定伤害结算结果,而不是依赖当前布尔值推断。
示例中的动态方法检查是一种轻量方案。正式项目可以使用静态接口检查或组件能力注册表,让依赖契约更加明确。
把依赖装配与生命周期留在外层
组件不应该在每次业务调用时自行遍历整个场景来寻找依赖。寻找目标、获取组件以及判断当前对象是否仍然有效,最好由明确的装配层或协调者负责。
可以采用以下边界:
- 对象装配阶段创建组件,并为需要稳定协作的组件提供必要引用。
- 业务执行阶段通过明确接口发起调用,不重新扫描无关组件。
- 目标缺失或能力不存在时,根据业务规则拒绝操作或返回失败结果。
- 对象禁用、销毁或从对象池回收时,清理订阅与长期引用,防止后续访问失效实例。
对于必需依赖,例如某种角色必须同时拥有移动组件和碰撞组件,通常应该在装配阶段验证完整性。对于可选依赖,例如某些对象没有生命组件,可以允许能力检查失败并由调用方决定是否继续。
何时改用事件或协调器
直接调用适合立即执行的明确命令,但并不适合所有协作关系。尤其当一个状态变化会影响多个独立系统时,继续添加直接调用会使核心组件不断扩大依赖范围。
| 协作需求 | 更合适的方式 | 原因 |
|---|---|---|
| 攻击请求目标扣血 | 直接调用能力接口 | 需要明确发起命令并取得结果 |
| 生命值变化后刷新 HUD、播放提示音 | 事件通知 | 多个订阅者可以独立响应 |
| 同一次拾取同时修改背包和地面物品 | 协调器或游戏系统 | 需要统一检查和处理跨对象规则 |
| 查询目标是否存活 | 只读查询接口 | 不需要广播或修改状态 |
以生命值变化为例,HealthComponent 完成扣血后可以发布 HealthChanged。HUD 负责更新显示,音频组件负责判断是否播放提示音,生命组件不需要反向持有这些订阅者。
但是事件不能替代所有直接调用。攻击是否能命中、伤害是否被接受等需要立即得知的结果,通常应保持明确的同步请求链;事后的显示、声音和统计才适合通知机制。
判断是否需要解耦时,重点看依赖是否跨越职责边界,以及一个组件的变化是否迫使无关组件修改。只要调用方向稳定、契约足够窄,直接调用就是合理的组件协作方式。