游戏客户端架构 / 系统课时
哪些模块不该直接互相调用
哪些模块不该直接互相调用
玩家受到伤害时,如果战斗代码同时修改血条、播放音效和累计任务进度,增加一个反馈功能就可能迫使战斗逻辑跟着修改。本篇沿着输入、战斗和表现模块的通信链路,判断哪些直接调用合理,哪些依赖应该改为事件通知。
学习目标
- 区分发起操作的命令调用与响应结果的通知关系。
- 识别战斗、UI、音频和任务模块之间不必要的直接依赖。
- 掌握划分模块通信边界的判断方法。
从玩家受击追踪模块依赖
假设玩家按下攻击键,输入模块将攻击命令交给战斗模块。战斗模块检查攻击条件、计算伤害并更新目标生命值,然后通知 HUD 更新血条、音频模块播放受击音效、任务模块累计伤害进度。
这条链路存在两种不同性质的通信。输入模块调用战斗模块,是为了发起一个明确动作;战斗模块调用伤害计算器,是为了完成自身业务。但更新 HUD、播放音效和累计任务进度,属于其他模块对战斗结果作出的响应。

左侧结构的问题不是调用次数多,而是战斗模块知道了不属于自己职责的模块接口。右侧结构保留输入到战斗的命令关系,同时把已经发生的战斗事实交给感兴趣的模块处理。
判断直接调用是否越界
不能简单认为跨模块调用都应该改成事件。判断时应检查三个问题:
- 是否必须指定执行者? 输入模块要求战斗模块执行攻击,调用目标明确,适合直接调用。
- 是否必须获得结果? 战斗模块需要伤害计算器返回数值,直接调用可以清楚表达控制顺序和失败处理。
- 是否只是响应已发生的事实? UI、音频和任务模块只需要知道伤害已经生效,并不负责决定这次伤害能否成立,通常适合订阅事件。
还要观察模块的修改原因。假如更换 UI 框架会迫使战斗模块修改代码,或者禁用声音会影响伤害结算,就说明职责边界可能不合理。
相反,战斗内部的伤害公式、生命值状态和结算规则往往需要保持明确的协作关系。为了消除所有直接引用而引入事件,反而会让执行顺序难以追踪。
用代码观察依赖成本
下面的 JavaScript 示例模拟一个直接调用三个反馈模块的战斗对象。保存为 coupling.js,使用 Node.js 执行 node coupling.js。
class Combat {
constructor(hud, audio, quests) {
this.hp = 100;
this.hud = hud;
this.audio = audio;
this.quests = quests;
}
takeDamage(amount) {
// 伤害结算本身属于战斗模块
this.hp = Math.max(0, this.hp - amount);
// 反馈调用让战斗模块依赖三个外部接口
this.hud.setHealth(this.hp);
this.audio.play('hurt');
this.quests.addProgress('take-damage', amount);
}
}
// 使用简单对象模拟独立的表现与任务模块
const hud = { setHealth: hp => console.log('HUD:', hp) };
const audio = { play: name => console.log('Audio:', name) };
const quests = {
addProgress: (key, value) => console.log('Quest:', key, value)
};
new Combat(hud, audio, quests).takeDamage(25);预期输出:
HUD: 75
Audio: hurt
Quest: take-damage 25程序能够正确运行,但其构造函数必须接收三个反馈模块。假如新增摄像机震动,还可能需要新增构造参数和调用;若某个反馈模块接口改变,战斗实现也要修改。这就是可以实际观察到的维护成本。
将命令与事实通知分开
更稳定的设计是让战斗模块只负责检查攻击条件、计算伤害和更新状态。结算成功后,再发布表示事实的 DamageApplied 事件,供 HUD、音频和任务模块分别订阅。
事件负载可以包含 targetId、damage、previousHp 和 currentHp。订阅者依据这些数据处理各自的反馈,不需要反向查询或修改战斗模块内部状态。
这里要守住两个边界。首先,只有伤害真正生效后才能发布 DamageApplied,攻击失败不能伪装成伤害成功。其次,战斗结算不应依赖某个 UI 或音频监听器是否成功执行,否则只是把直接依赖隐藏到了事件分发器里。
模块解耦的目标不是让所有模块都互不认识,而是让状态所有者负责决策,让表现和附加功能独立响应。这样新增受击特效或替换 HUD 时,战斗规则可以保持稳定。