跳转到内容

网络抽象与传输内核 ​

本文说明当前网络原语及其目标边界。目标角色为 gateway、loginServer、baseServer、worldServer、cell、database、machined;World 管理 Space/Cell,cell 执行模拟与 Instance,长期资料与存储分别归 Base 和 database。库原语测试通过,不等于完整玩法、跨服恢复或不停机发布已经完成。

执行摘要 ​

游戏逻辑通过明确的消息、关联 ID 和执行边界使用网络。传输到达、业务受理、模拟执行和持久确认分别表达。进程间沿用 M1 链路与契约路由,不增加平行的业务总线;客户端连接由 Gateway 持有。

1. 当前实现 ​

部件位置已有能力与边界
TCP 底座modules/net/tcpsocket、reactor 和相关消息原语
M1 链路modules/net/link握手、心跳、seq/ack、路由分发、水位、重连与对端重启事件
RPCmodules/net/linkrpc请求关联、响应、超时;不能代替业务去重
会话门面modules/net/gameconnection四通道、优先级、投递队列和恢复窗口;仍需与实际业务会话链路验收
契约编码modules/net/contract_wire按生成路由表编码/解码字段
应用编码modules/protocol当前部分应用仍使用 MessageCodec,M1 入口存在契约与应用帧转换
出站 HTTPmodules/net/httpCMake 必需 libcurl 并设置 APOLLO_HAS_CURL=1;不等于全部业务已接出
客户端接入apps/gatewayTCP 入口、准入、路由查询与 World 意图出口原型

契约 XML/XSD、生成器及 .proto 产物已经存在。protobuf/zstd 是否进入真实玩法路径,必须另行验证,不能从依赖或产物推断。

2. 游戏逻辑接口 ​

GameConnection 门面提供 send、subscribe、state、close。发送结果区分 kAccepted、kTrimmedLow 和 kBackPressured。入队成功不等于对方执行成功。

应用按契约校验身份、参数、会话及玩家权威代次,不向客户端开放任意实体写入或任意服务器寻址。Gateway 与 World 的现役业务链路仍需完成完整副本结果和状态下行接线。

3. 分层与线程 ​

  • L0 负责传输,不决定玩法准入和奖励。
  • L1 负责帧、契约编码与分发。
  • L2 负责会话、序号、恢复窗口和有界队列。
  • L3 面向逻辑层提供消息接口。

IO 与后台线程只交接意图或完成结果;Scene/Instance 的模拟写入归所属逻辑线程。WorldApp 使用有界 AcceptanceQueue,在 gameLoop 的固定位置执行意图。不能在负责泵送的线程上同步等待同一链路的 RPC。

GameConnection 库的入站队列目前具有丢旧统计;它不能据此宣称业务可靠投递。业务入口须明确过载失败与回执策略,避免将低层丢弃行为用于不可丢的结算或权威切换。

4. QoS 与背压 ​

4.1 四通道 ​

通道规则
movement易弃,同消息 ID 保留最新输入/状态
attributes有序可靠;低优先级状态允许按声明裁剪
events不可任意丢弃的事件;容量不足需要背压
control独立小预算,避免被大流量挤占

客户端通道策略与进程间链路策略不能混同。链路只识别 Control、Reliable、Droppable 分类,不根据玩法重要性擅自删除已排队的可靠业务消息。

4.2 四级水位 ​

默认链路容量为 4 MiB,控制预算为 16 KiB;占用阈值为 soft 50%、hard 75%、cut 95%。soft 起拒绝新的 Droppable;cut 起拒绝新的 Reliable,控制帧仍受独立预算约束。cut 持续时间超过上限后关闭链路。

发送方必须处理背压,不能无限重试、无限缓存或阻塞模拟。属性预算决定本拍发多少,传输水位决定还能否入队,两者分别生效。

4.3 上行校验 ​

准入、消息长度、速率和参数校验必须在进入模拟前完成。限流与风控原语存在不代表每条应用入口都已接通;玩法验收需覆盖未认证输入、伪造玩家、迟到代次和过载。

5. 机制采用边界 ​

5.1 传输与业务结果 ​

TCP 与链路确认不能替代模拟回执或持久化确认。跨重连序号去重也不能保证跨进程重启后的业务恰好执行一次。

5.2 有界投递 ​

使用显式发送结果和有界队列,调用方决定降级或重试。队列项需要关联 ID;重试仍使用原业务幂等键。

5.3 技术路线 ​

当前进程间通信使用现有 M1 自研内核。Aeron 等外部设计可提供机制参考,不作为额外部署总线或已集成依赖。

5.4 跨线程交接 ​

后台结果携带请求标识回到逻辑线程,在边界点验证目标对象、会话和权威代次后执行。对象销毁后到达的结果必须拒绝或取消。

5.5 帧处理 ​

压缩、加密和校验属于帧处理机制,其配置必须与连接版本一致。当前原语或依赖存在,不等于全部客户端链路已启用;protobuf/zstd 的业务接线仍按需求触发。

5.6 演进与容量 ​

优化限定在清晰的层内接口中,通过基准验证后引入。完成模型、共享内存和其他传输不改变业务权威,也不能以优化为由建立第二套协议事实源。

握手包含进程身份、route_version 和 authority_epoch。受理版本为本代与 compat_route_versions;APOLLO_ROUTE_COMPAT 配置窗口,窗外版本仍断开。握手放行不提供业务报文双版本解码。对端代次变化触发重启事件,由上层重建状态;同代次的断线恢复与进程重启必须区分。

Reliable 使用发送队列、接收去重与累积 ACK;Droppable 不保证重传。链接对象和它的状态由所属泵顺序推进。业务迁移还需要持久权威记录和提交结果对账。

5.8 传输模型 ​

当前内核提供 TCP 传输及可测试传输接口。就绪模型与完成模型属于 L0 实现选择,不能据接口形式宣称某平台或某内核已支持。Windows 的编译垫片也不能作为真实网络验收。

5.9 客户端安全 ​

鉴权和权威校验属于业务入口。密码、票据和安全传输须在部署前完成明确接线;原型测试账号、非空票据容忍或默认路由都不能作为生产鉴权方案。配置了 Login 准入链路时,服务不可达或应答无效应拒绝准入。

5.10 出站 HTTP ​

当前 HTTP 目标使用 libcurl,CMake 不再选择 Drogon 替代分支。同步 HTTP 不得从模拟线程直接调用;异步结果回到未来的逻辑边界,不能反向改写已完成判定。

脚本或业务发起出站请求须限制目标与超时。是否使用 curl_multi 执行层、如何取消以及如何与脚本协程交接,仍需按真实消费者接线验证;已有 poll 事件循环不等于已经接入 curl_multi。

6. 当前有效规则 ​

复用 M1 和契约路由;保留应用帧转换的现状说明;分别验收客户端会话、进程间链路和业务结果。禁止用历史实现清单推导当前能力,禁止把外部引擎角色变成 Apollo 新进程。

7. 编队、恢复与更新 ​

machined 提供本机监督重启。World 崩溃后,活动 Instance 不会自动迁移到另一进程。未经验证的活动状态按失败处理,保留已确认的资料与结算;跨机热备和自动接管不是当前能力。

Gateway 排空、World 排空、跨 Gateway 会话恢复、跨 World 权威交接、协议兼容窗口及发布回滚分别验收。持续接入、免重新登录、TCP 连接连续和活动副本连续不能互相替代。

跨服场景使用World 管理、cell 执行及 Space/Cell/Instance 模型,不要求无缝地图。任务仅维护在根目录 todo.md。

8. 关联设计 ​

  • 属性同步:快照、增量、可见性与预算。
  • Lua:逻辑线程交接和模块替换。
  • SDK 契约:编码事实源与版本边界。
  • Gateway:连接持有与更新验收。

基于 MIT 许可发布