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

先画出一次跨模块通信链

先画出一次跨模块通信链

角色受到伤害后,血条、受击音效和伤害统计都要响应。如果生命值模块直接调用所有反馈模块,新增功能就会不断扩大它的依赖范围。本课从一条真实的受伤调用链出发,画出模块关系,再用可运行示例验证哪些调用可以改成事件通知。

学习目标

  • 从一次角色受伤行为追踪状态修改与反馈模块之间的调用链。
  • 识别直接调用造成的依赖,并画出事件分发后的数据流。
  • 通过最小程序验证多订阅者通知,同时明确哪些调用仍应保留。

先找出一次完整的受伤过程

假设玩家角色当前有 80 点生命值,敌人攻击造成 30 点实际伤害。系统需要完成四件事:将生命值更新为 50、刷新血条、播放受击音效、累计伤害统计。

在直接调用方案中,生命值模块可能依次执行 UpdateHealthBar、PlayHitSound 和 RecordDamage。这些调用虽然直观,却要求生命值模块知道三个反馈模块的接口、初始化状态和调用方式。

当项目继续增加屏幕震动、手柄反馈、任务进度或成就统计时,生命值模块就可能成为大量外围功能的汇合点。任何反馈模块的接口变动,都可能迫使核心战斗代码一起修改。

分析时应将整个过程拆成两个阶段:生命值结算负责修改权威状态,外围反馈负责响应结算后的事实。 两者不应因为发生在同一帧,就被视为不可分割的操作。

把直接调用链和事件通知链画出来

先把生命值模块放在图中央,将攻击模块放在左侧,再把 UI、音效、统计三个模块放在右侧。每条箭头都表示一个真实的调用或数据传递关系,而不仅仅表示模块之间存在联系。

直接调用方案中,生命值模块分别指向三个反馈模块。事件通信方案中,生命值模块在完成结算后发布 CharacterDamaged,由事件分发器通知订阅者。攻击模块到生命值模块的结算请求仍保留明确调用关系。

角色受伤场景中直接调用与事件分发的数据流对比

画图时还要为关键连线标注三个问题:发送方是否需要返回值、接收方失败是否应该影响伤害结算、未来新增接收方是否需要修改发送方。

如果一条连线只是把已经完成的伤害事实告知其他系统,且发送方无需了解接收者,通常可以考虑替换成事件通知。如果连线负责验证攻击、扣除生命值或返回结算结果,则应保留明确的处理边界。

用最小程序验证一对多通知

下面使用 Node.js 内置的 EventEmitter 模拟同步事件分发。它不是特定游戏引擎的事件 API,但足以验证核心模块只发布一次事件、三个外围模块分别响应的通信关系。

将代码保存为 damage-chain.mjs,使用 Node.js 18 或更新版本运行。

js
import { EventEmitter } from 'node:events';

const bus = new EventEmitter();
const hero = { id: 'hero-01', hp: 80 };
let totalDamage = 0;

// 三个外围模块独立订阅已结算的伤害事实。
bus.on('character:damaged', ({ targetId, currentHp }) => {
  console.log(`[UI] ${targetId} HP=${currentHp}`);
});

bus.on('character:damaged', ({ actualDamage }) => {
  console.log(`[Audio] hit ${actualDamage}`);
});

bus.on('character:damaged', ({ actualDamage }) => {
  totalDamage += actualDamage;
  console.log(`[Stats] total=${totalDamage}`);
});

function applyDamage(target, requestedDamage) {
  // 无效输入不能破坏生命值状态或触发通知。
  if (!Number.isFinite(requestedDamage) || requestedDamage <= 0) return;

  const beforeHp = target.hp;
  target.hp = Math.max(0, beforeHp - requestedDamage);
  const actualDamage = beforeHp - target.hp;
  if (actualDamage === 0) return;

  // 完成状态修改后才广播,接收者不参与结算。
  bus.emit('character:damaged', {
    targetId: target.id,
    currentHp: target.hp,
    actualDamage
  });
}

applyDamage(hero, 30);
console.log(`[Core] hp=${hero.hp}`);

执行 node damage-chain.mjs。预期输出:

text
[UI] hero-01 HP=50
[Audio] hit 30
[Stats] total=30
[Core] hp=50

代码中 applyDamage 只负责伤害结算与事件发布,没有直接引用任何 UI、音效或统计处理函数。三个订阅者可以分别加入或移除,而不需要改变核心伤害计算逻辑。

注意,Node.js 的 EventEmitter.emit() 默认同步执行监听器,因此三个订阅回调会先执行,最后才打印核心模块日志。这个顺序由当前示例的同步实现决定,不代表所有游戏事件系统都会如此。异步队列可能具有不同的处理时机。

决定哪些调用值得改成事件

完成通信链后,不应把所有箭头都改为事件,而应根据业务责任分类。

  • 保留直接调用: 攻击模块请求生命值模块计算伤害;调用方需要确认请求是否成功,并取得确定的结算结果。
  • 改为事件通知: 血条刷新、受击音效和非权威的局内统计;这些模块只需要获知伤害已经发生。
  • 谨慎处理关键状态: 如果统计结果决定存档、奖励或不可丢失的任务进度,仅依赖临时内存事件并不可靠,应设计权威状态维护与可靠处理机制。

还有一个容易忽略的边界:新订阅的 UI 不能依靠过去已经发送的事件恢复当前血量。初始化时应从权威状态读取生命值,再订阅后续变化,否则界面可能在第一次伤害发生前显示错误信息。

用变化成本和故障影响检查设计

判断通信链是否拆分合理,可以尝试两个改动。首先增加一个受击震屏订阅者,检查是否完全不需要修改生命值结算函数。然后移除音效订阅者,确认伤害数值、UI 更新与统计仍能正常工作。

不过,事件机制不等于故障隔离。以上同步 EventEmitter 示例中,如果监听器抛出异常且未被处理,可能阻断后续监听器,并使 emit() 无法正常返回。实际工程需要根据事件重要性设计错误隔离、日志记录与异常恢复策略。

角色销毁或场景卸载时,也应解除不再需要的订阅,避免对象重复监听和过期回调。若不同订阅者之间存在严格先后依赖,应考虑显式协调流程,而不是依赖它们偶然的注册顺序。

一张有用的通信链图,不仅展示模块连接方式,还应解释状态归属、事件发生时机、依赖方向与失败边界。能够说清这些关系,才说明直接调用已经被真正拆解,而不只是换成了事件分发器。

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

目录与阅读设置

阅读设置

17

记录一个想法

先画出一次跨模块通信链

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

登录哪都通