游戏客户端架构 / 系统课时
网络消息进入本地系统放哪里
网络消息进入本地系统放哪里
多人游戏客户端经常需要把服务器发来的角色状态、战斗结果和房间通知交给本地模块处理。如果网络回调直接修改游戏对象或广播协议消息,线程安全与模块耦合问题会同时出现。本课建立网络适配器与主线程消息队列之间的边界,让协议数据经过校验和状态应用后,再转换为本地业务事件。
学习目标
- 说明网络协议消息与客户端业务事件的区别。
- 设计网络接收、数据校验、线程切换和业务派发的入站链路。
- 实现一个包含消息队列、序号检查和本地状态更新的 C# 示例。
网络报文不等于本地业务事件
假设服务器发送一条生命值快照,包含协议版本、玩家 ID、当前生命值和消息序号。它首先是一份网络数据,客户端需要检查格式、来源、协议兼容性和消息时效性,然后才能判断是否改变本地状态。
本地业务事件 HealthChanged 表达的则是另一件事:客户端状态已经应用了一次有效变化,相关模块可以更新生命条、播放反馈或记录战斗信息。
这两类消息不应该直接复用同一个事件类型。
| 对比维度 | 网络协议消息 | 本地业务事件 |
|---|---|---|
| 来源 | 服务器或网络连接 | 客户端业务系统 |
| 主要字段 | 版本、序号、协议数据 | 业务标识、变化结果 |
| 是否可信 | 必须按协议和连接上下文校验 | 已通过本地业务处理 |
| 消费对象 | 网络适配器、状态同步器 | HUD、特效、音效等模块 |
如果把网络 DTO 直接扔进全局事件总线,每个订阅者都需要理解协议版本、乱序和字段兼容规则。协议一旦升级,业务模块就可能被迫一起修改。
更稳妥的方式是在网络层和本地事件系统之间设置专门的适配边界。
网络适配器与主线程队列
网络消息的入站处理可以拆成两个执行区域:后台接收区域和主线程业务区域。后台线程负责收取字节、解析协议与初步校验;主线程负责最终时效检查、状态变更和本地事件派发。
两者之间通过线程安全队列传递不可变的协议 DTO。这样网络回调不用直接访问游戏对象,也不会在 IO 线程触发依赖主线程的 HUD 或场景逻辑。

这种分层也明确了队列中应该放什么。队列适合承载已经解析、完成基础格式检查的协议对象,而不是 UI 命令或尚未确定的业务成功事件。
主线程每帧取出消息后,仍需检查消息是否过期、是否对应当前会话及实体,然后交给相应的状态同步器。只有状态真正发生变化,才生成可供本地模块消费的业务结果事件。
用 C# 模拟完整入站流程
下面使用 .NET 8 的 ConcurrentQueue<T> 与 System.Text.Json 模拟网络接收。示例通过 JSON 序列化生成两条模拟网络报文,后台任务负责反序列化与入队,主线程负责状态应用和事件发布。
两条消息分别具有序号 2 和序号 1。较新的消息先到达,因此第二条消息应被识别为过期数据,不能把生命值从 75 错误覆盖成 20。
创建 .NET 8 控制台项目,将代码保存为 Program.cs。
using System;
using System.Collections.Concurrent;
using System.Text.Json;
using System.Threading.Tasks;
var incoming = new ConcurrentQueue<HealthPacket>();
var events = new LocalEvents();
var state = new ClientState(events);
var jsonOptions = new JsonSerializerOptions(JsonSerializerDefaults.Web);
events.HealthChanged += e =>
Console.WriteLine($"HUD: {e.PlayerId} HP={e.CurrentHp}");
// 序列化用于模拟网络收到的JSON报文。
var wirePackets = new[]
{
JsonSerializer.Serialize(new HealthPacket(1, "p1", 75, 2), jsonOptions),
JsonSerializer.Serialize(new HealthPacket(1, "p1", 20, 1), jsonOptions)
};
await Task.Run(() =>
{
foreach (var json in wirePackets)
{
// 后台任务只解析和入队,不修改客户端业务状态。
var dto = JsonSerializer.Deserialize<HealthPacket>(json, jsonOptions);
if (dto is { Version: 1, PlayerId: "p1" } &&
dto.Hp is >= 0 and <= 100)
{
incoming.Enqueue(dto);
}
}
});
// 模拟游戏主线程在Update阶段消费网络消息。
while (incoming.TryDequeue(out var message))
{
state.Apply(message);
}
record HealthPacket(int Version, string PlayerId, int Hp, long Sequence);
record HealthChanged(string PlayerId, int CurrentHp);
sealed class LocalEvents
{
public event Action<HealthChanged>? HealthChanged;
public void Publish(HealthChanged e) => HealthChanged?.Invoke(e);
}
sealed class ClientState
{
private long _lastSequence;
private int _hp = 100;
private readonly LocalEvents _events;
public ClientState(LocalEvents events) => _events = events;
public void Apply(HealthPacket dto)
{
// 只接受比当前状态更新的快照。
if (dto.Sequence <= _lastSequence)
{
Console.WriteLine("Ignored stale packet");
return;
}
_lastSequence = dto.Sequence;
if (_hp == dto.Hp) return;
_hp = dto.Hp;
// 状态应用成功后,再广播本地业务事实。
_events.Publish(new HealthChanged(dto.PlayerId, _hp));
}
}预期输出:执行 dotnet run 后,序号 2 的生命值快照生效并触发 HUD 事件;序号 1 的旧快照被拒绝。
HUD: p1 HP=75
Ignored stale packet这个例子中,HealthPacket 是协议数据对象,包含网络层需要的版本号和消息序号;HealthChanged 是本地业务事件,仅保留订阅者关心的玩家 ID 与当前生命值。
示例使用 Task.Run 模拟后台接收,并在接收任务结束后消费队列,因此不是持续运行的 Socket 客户端。实际项目应当由网络回调持续入队,再由游戏主线程的每帧更新逻辑按预算出队处理。
乱序、坏包和断线如何处理
消息适配器需要考虑几个容易忽略的边界。
- 协议版本不匹配:在解析阶段拒绝不支持的版本,或通过明确的版本转换器生成当前 DTO,不能把未知字段直接解释成业务结果。
- 数据格式不合法:检查 JSON 解析异常、字段范围和必要标识;真实接收循环应捕获
JsonException并按协议处理错误,避免单个坏包使接收任务意外终止。 - 消息乱序或重复:依据协议定义的序号、服务器 Tick 或实体版本判断新旧。序号比较必须针对正确的会话与状态流,不能无条件使用一个全局计数器。
- 断线重连:重新建立会话后清理或隔离旧队列消息,根据协议重置序号基线,并等待可信的完整快照恢复状态。
- 消息积压:正式客户端应为队列设置容量或处理预算,并明确溢出策略。可靠业务消息不能简单丢弃;允许覆盖的最新状态快照则可以按实体合并。
网络身份也不能仅凭 DTO 中的 PlayerId 字段判断。真实服务器通信应使用已认证连接和协议规定的授权关系,客户端再据此确认消息所属实体。示例中的固定玩家 ID 只用于说明最小入站流程。
什么情况下才发布本地事件
本地事件的发布时间应该由业务语义决定,而不是由网络接收动作决定。收到生命值快照但数值没有变化时,可以更新同步序号而不发布 HealthChanged;收到已经处理过的战斗结算消息,也不应该再次播放奖励动画。
对于状态快照,通常先将权威状态应用到客户端模型,再发布状态变化事件。对于战斗指令确认、背包操作结果等消息,还需要根据协议中的请求标识和结果状态完成匹配,不能一律套用生命值快照的处理方式。
验证这个边界时,可以分别注入正常消息、过期消息、重复消息和不支持版本的消息,检查客户端最终状态以及业务事件触发次数。网络协议可以变化,HUD 和音效系统却应始终只面对稳定的本地业务语义,这正是网络适配层存在的价值。