《Cocos 游戏联机实战》目录

目录

欢迎来到《Cocos 游戏联机实战》。前三卷把单机做透了：卷一从零手写 mini2d 看懂引擎怎么工作，卷二用 Cocos Creator 3.8 把《方块冲刺》做成能发布到 H5 / 微信小游戏 / 原生的产品，卷三回过头把引擎本身当研究对象。这一卷给同一个游戏加联机——把它改成双人竞速。

本卷只写客户端侧。 这句话不是省略，而是本卷的定位：站内 game/server/ 已有 315 篇服务端文章，书稿《游戏服务端编程实践》另有 43 篇，服务端实现（网关、AOI 服务、匹配服务、战斗裁决）那里已经讲透，本卷一律不重复。凡涉及服务端，只给消息格式与接口约定——「客户端发什么、服务端回什么」，至于服务端怎么实现，交接给那两处。

那客户端侧还剩什么？剩下的是联机里最难、也最考验工程判断的部分：确定性模拟、快照 diff、插值与外推、预测与回滚、时钟同步、协议编解码、弱网降级、重连状态机、客户端权威边界。这些全在客户端，也全都能写成可跑的代码。

本页给出全书的阅读路线。你可以从第 1 章 1.1 开始顺序通读，也可以先看下面的三条路径，挑一条最合你胃口的走法。

这一卷写给谁

前置知识：读完卷一与卷二，或已具备等价基础（看得懂 TypeScript 组件脚本、走过一次完整发布流程）。卷三不是必需——本卷只在需要时才引用卷三的内部机制结论。建议本机安装 Cocos Creator 3.8——本卷有少量工程配置与房间配置片段，命令行无法复现；但占本卷主体的 L1 纯逻辑与 L2 组件脚本都能独立验证。

本卷与前三卷的分工

四卷本里，卷四是最独立的一卷：前三卷都在回答「引擎怎么用」，卷四回答「两个客户端怎么对上」。四卷各回答一个问题：

所以卷四不重做游戏，也不重做引擎。 它把卷二那个产品当素材，加一层网络：帧循环沿用卷一 4.2 的固定步长累积器，工程设定沿用卷二那套，区别只在于——前三卷的世界里只有一个玩家，卷四的世界里有两个，而这两个人隔着网络、时钟不同步、还会丢包。

如果你只读过卷一，卷四照样能读：第 1 章的网络分层与第 2 章的确定性模拟都不依赖卷二的具体工程细节。但第 9–10 章的表现与综合项目会频繁引用卷二的产品形态，建议至少先扫一遍卷二的目录页 。

动手前的环境准备

本卷的验证分三层（详见下面的「可验证口径」），环境要求按层不同：

没有编辑器、没有服务端也能读全部内容。 本卷主体是 L1：网络逻辑与引擎无关，用假传输层 + 假时钟就能在 Node 里完整验证。这也是本卷刻意设计的——联机逻辑必须先能脱离网络单独测试，才谈得上可靠。

三条阅读路径

路径 A：完整通读（约 6 周）

最完整的一条。从网络分层讲到双人竞速综合项目，每章都在回答「客户端该做什么」。

第 1–4 章（基础、帧同步、状态同步、预测和解）→ 第 5–6 章（重连、匹配与房间）
→ 第 7–8 章（调试压测、反作弊与安全）→ 第 9–10 章（表现与综合项目）

适合要把联机一次做对的读者。第 4 章（客户端预测与和解）是全卷的枢纽，前三章讲清「世界怎么对齐」，第 4 章讲「对齐之前客户端先怎么动」。

路径 B：按主题跳读（约 3 周）

已经有明确目标的话，按下面的分组跳读：

同步方向：1 → 2 → 3 → 4
容错方向：5 → 6
工程方向：7 → 8
表现方向：9 → 10

每组内部是递进的，组之间可以独立看。同步方向建议从第 1 章读起——不先理解权威边界与协议选型，后面看预测与和解容易云里雾里。

路径 C：按问题查（随时）

不打算通读，只在遇到具体问题时翻对应章节。下节「常见问题速查」就是为这条路准备的。

贯穿项目：《方块冲刺》（联机形态）

卷四沿用卷二、卷三那套工程设定，不得前后矛盾：工程名 block-dash、包名 com.example.blockdash、设计分辨率 960 × 540（fitHeight + SHOW_ALL）、目标平台 H5 / 微信小游戏 / 原生、分包 bundle-levels、存档键 blockdash.save.v1。

卷四在这套设定上加联机，新增的固定项为：

全书共用这一套设定，不得前后矛盾。 尤其要守住两个口径：传输层必须抽象成 Transport 接口（否则代码没法单测），权威在服务端（客户端的预测只是「先动一下」，不是「说了算」）。

可验证口径（本卷的核心设计）

联机代码最容易写成一堆「看起来对但跑不起来」的时序图。本卷的应对是：把能脱离网络的逻辑全部抽成 L1，用假传输层 + 假时钟真跑单测。

这意味着什么？ 本卷的每一段网络逻辑，都至少有一层可验证性：能写成纯逻辑的就写成纯逻辑并配单测，能写成组件脚本的就过类型检查，只有工程配置与房间配置才落到「需编辑器」这一档。凡是「服务端如何裁决」的话题，本卷只写约定，明确交接给站内服务端专题与书稿。

版本与技术口径

关于「可擦除语法」：Cocos 的脚本编译链只剥离类型，所以 enum、namespace、构造函数参数属性这类「需要生成运行时代码」的写法不要用。本书一律用 const 对象 + as const 代替 enum——这一点在联机代码里尤其重要，因为协议常量与消息类型定义最容易顺手写成 enum。

全书结构

全书 10 章分四个部分，前 9 章每章 3 节、第 10 章 2 节，共 29 节。此外有 1 篇目录（本页）。序与前言见卷一。

第一部分：同步基础（第 1–4 章）

先建立正确的联机心智模型，再依次看两条同步路线与客户端预测。

第二部分：容错与房间（第 5–6 章）

联机不是理想网络。这一部分处理断线、超时与匹配房间。

第三部分：调试与安全（第 7–8 章）

把联机问题变成可复现、可定位、可防御的工程问题。

第四部分：表现与收官（第 9–10 章）

把同步做进画面，再合成一个完整的双人竞速。

六周学习计划

按路径 A 走，一个参考排期：

常见问题速查

学完之后你能做什么

走完全书，你应该具备这几项能力——它们也是本卷隐含的验收标准：

• 说得清权威边界：拿到一个联机需求，能立刻判断哪些逻辑必须在服务端、哪些可以放客户端。
• 写得出可测的同步逻辑：确定性模拟、快照 diff、预测与和解都能脱离网络单测，而不是只能联调时碰运气。
• 处理得了弱网：知道丢包、延迟、抖动分别会破坏什么，以及各自该用什么策略兜住。
• 做得出联机表现：能把同步数据变成平滑的插值动画与清晰的网络状态提示，而不是把技术指标直接甩给玩家。
• 守得住安全底线：清楚客户端永远不可信，知道客户端侧能做什么、以及为什么真正的裁决必须在服务端。

这些能力无法只靠读获得，本卷的每一节都尽量给出可跑的 L1 代码与单测，方便你边读边试。

相关阅读

• 游戏服务端编程实践 — 服务端实现的书稿，本卷的服务端约定与它对接
• 游戏开发专题 — 站内游戏开发的专题文章总入口
• 游戏服务端专题 — 网关、AOI、匹配与战斗裁决的服务端讨论
• TypeScript 专题 — 类型系统与工程实践
• 书稿专题 — 全部在线电子书与创作手记

准备好了就翻开第 1 章 1.1 网络分层、拓扑与权威边界 开始。若还没读卷二，建议先看《Cocos 游戏开发实战》目录 。