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

网络消息进入本地系统放哪里

网络消息进入本地系统放哪里

多人游戏客户端经常需要把服务器发来的角色状态、战斗结果和房间通知交给本地模块处理。如果网络回调直接修改游戏对象或广播协议消息,线程安全与模块耦合问题会同时出现。本课建立网络适配器与主线程消息队列之间的边界,让协议数据经过校验和状态应用后,再转换为本地业务事件。

学习目标

  • 说明网络协议消息与客户端业务事件的区别。
  • 设计网络接收、数据校验、线程切换和业务派发的入站链路。
  • 实现一个包含消息队列、序号检查和本地状态更新的 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。

csharp
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 的旧快照被拒绝。

text
HUD: p1 HP=75
Ignored stale packet

这个例子中,HealthPacket 是协议数据对象,包含网络层需要的版本号和消息序号;HealthChanged 是本地业务事件,仅保留订阅者关心的玩家 ID 与当前生命值。

示例使用 Task.Run 模拟后台接收,并在接收任务结束后消费队列,因此不是持续运行的 Socket 客户端。实际项目应当由网络回调持续入队,再由游戏主线程的每帧更新逻辑按预算出队处理。

乱序、坏包和断线如何处理

消息适配器需要考虑几个容易忽略的边界。

  • 协议版本不匹配:在解析阶段拒绝不支持的版本,或通过明确的版本转换器生成当前 DTO,不能把未知字段直接解释成业务结果。
  • 数据格式不合法:检查 JSON 解析异常、字段范围和必要标识;真实接收循环应捕获 JsonException 并按协议处理错误,避免单个坏包使接收任务意外终止。
  • 消息乱序或重复:依据协议定义的序号、服务器 Tick 或实体版本判断新旧。序号比较必须针对正确的会话与状态流,不能无条件使用一个全局计数器。
  • 断线重连:重新建立会话后清理或隔离旧队列消息,根据协议重置序号基线,并等待可信的完整快照恢复状态。
  • 消息积压:正式客户端应为队列设置容量或处理预算,并明确溢出策略。可靠业务消息不能简单丢弃;允许覆盖的最新状态快照则可以按实体合并。

网络身份也不能仅凭 DTO 中的 PlayerId 字段判断。真实服务器通信应使用已认证连接和协议规定的授权关系,客户端再据此确认消息所属实体。示例中的固定玩家 ID 只用于说明最小入站流程。

什么情况下才发布本地事件

本地事件的发布时间应该由业务语义决定,而不是由网络接收动作决定。收到生命值快照但数值没有变化时,可以更新同步序号而不发布 HealthChanged;收到已经处理过的战斗结算消息,也不应该再次播放奖励动画。

对于状态快照,通常先将权威状态应用到客户端模型,再发布状态变化事件。对于战斗指令确认、背包操作结果等消息,还需要根据协议中的请求标识和结果状态完成匹配,不能一律套用生命值快照的处理方式。

验证这个边界时,可以分别注入正常消息、过期消息、重复消息和不支持版本的消息,检查客户端最终状态以及业务事件触发次数。网络协议可以变化,HUD 和音效系统却应始终只面对稳定的本地业务语义,这正是网络适配层存在的价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

网络消息进入本地系统放哪里

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

登录哪都通