多人游戏与网络同步 / 系统课时
进入游戏前怎样避免版本不一致
进入游戏前怎样避免版本不一致
玩家已经组进同一房间,却可能因为客户端代码、联机协议或地图资源版本不同,在加载游戏后才出现断线、字段解析失败或场景错位。更稳妥的做法是在进入游戏前集中完成兼容校验,只让满足当前房间要求的客户端继续加载。
学习目标
- 区分客户端版本、协议版本和地图资源版本各自解决的问题
- 设计进入游戏前的兼容检查结果与阻断规则
- 用可运行代码验证兼容、需更新和资源不匹配三类结果
三类版本不能混成一个数字
客户端版本描述应用本身,例如 2.8.1;协议版本描述客户端与服务端交换的数据结构和语义,例如 17;地图资源版本描述某张地图实际加载的数据,例如内容清单哈希 map-arena-9f2c。它们变化的原因不同,兼容策略也不应相同。
客户端版本通常用来执行最低版本门槛。例如房间要求至少 2.8.0,低于该版本的客户端应先更新。协议版本更适合严格匹配:如果服务端按协议 17 返回字段,而客户端只理解 16,即使应用版本号看起来接近,也不能安全进房。资源版本则应校验当前房间真正要加载的地图内容,而不是只比较地图名称。
| 校验项 | 客户端持有 | 房间或服务端要求 | 常见处理 |
|---|---|---|---|
| 客户端版本 | 2.8.1 |
最低 2.8.0 |
低于门槛时阻止进入并提示更新 |
| 协议版本 | 17 |
17 |
不一致时直接阻止进入 |
| 地图资源版本 | map-arena-9f2c |
map-arena-9f2c |
不一致时下载或修复资源 |
把校验放在场景加载之前
兼容检查应位于“已经获得房间要求”与“开始加载游戏场景”之间。客户端先读取自己的版本信息,再与房间返回的最低客户端版本、协议版本以及目标地图资源标识逐项比较。只有全部通过,状态才能从 checkingCompatibility 进入 loadingGame。

这样安排还有一个好处:兼容失败时仍停留在房间上下文中,可以展示明确原因,也可以在资源下载完成后再次检查,而不必先创建游戏场景再回滚。
用明确结果代替一个布尔值
只返回 true 或 false 会让 UI 不知道该提示升级、修复资源还是重新加入。兼容层更适合返回带原因的结果。下面的 JavaScript 示例把三个检查集中在一个函数中,并保持检查顺序稳定。
function parseVersion(version) {
const parts = version.split(".").map(Number);
if (parts.length !== 3 || parts.some(Number.isNaN)) {
throw new Error(`invalid semantic version: ${version}`);
}
return parts;
}
function compareVersion(left, right) {
const a = parseVersion(left);
const b = parseVersion(right);
for (let i = 0; i < 3; i += 1) {
if (a[i] !== b[i]) return a[i] - b[i];
}
return 0;
}
function checkCompatibility(client, requirement) {
if (compareVersion(client.appVersion, requirement.minimumClientVersion) < 0) {
return { ok: false, reason: "CLIENT_UPDATE_REQUIRED" };
}
if (client.protocolVersion !== requirement.protocolVersion) {
return { ok: false, reason: "PROTOCOL_MISMATCH" };
}
if (client.mapResourceVersion !== requirement.mapResourceVersion) {
return { ok: false, reason: "MAP_RESOURCE_MISMATCH" };
}
return { ok: true, reason: "COMPATIBLE" };
}
const requirement = {
minimumClientVersion: "2.8.0",
protocolVersion: 17,
mapResourceVersion: "map-arena-9f2c"
};
const clients = [
{ appVersion: "2.8.1", protocolVersion: 17, mapResourceVersion: "map-arena-9f2c" },
{ appVersion: "2.7.9", protocolVersion: 17, mapResourceVersion: "map-arena-9f2c" },
{ appVersion: "2.8.1", protocolVersion: 17, mapResourceVersion: "map-arena-old" }
];
for (const client of clients) {
console.log(checkCompatibility(client, requirement));
}预期输出
{ ok: true, reason: 'COMPATIBLE' }
{ ok: false, reason: 'CLIENT_UPDATE_REQUIRED' }
{ ok: false, reason: 'MAP_RESOURCE_MISMATCH' }这里把应用版本最低门槛和协议精确匹配分开,是为了避免错误地把所有版本都套进同一套比较规则。真实项目如果允许多个协议版本共存,可以把单个 protocolVersion 扩展成服务端明确公布的兼容集合,但客户端仍应依据服务端规则判断,而不是自行猜测“相差 1 应该也能用”。
失败后应该停在哪个状态
客户端版本过旧通常无法在当前流程中自行修复,应保持房间信息并进入 updateRequired,禁止发送开始游戏请求。协议不一致也应直接阻断,因为继续加载只会把错误推迟到网络消息解析阶段。
地图资源不一致则不同。如果客户端支持资源更新,可以进入 repairingResources 或 downloadingMap,完成后重新计算资源版本,再走一次完整兼容检查。不要下载完成后直接跳过校验进入场景,因为下载中断、缓存命中错误或清单未更新都可能让资源仍不一致。
在多人同时开局时以服务端要求为准
进入游戏前的最终要求应由当前房间或游戏服务端给出。客户端本地可以提前做预检,但不能把本地缓存的最低版本、协议号或地图版本当作权威值,因为房间可能在客户端打开大厅后已经切换地图或升级服务端。
因此稳定链路是:取得最新房间启动信息,执行兼容校验,必要时更新或修复,再重新取得或确认启动信息,最后才进入游戏场景。这样版本错误会被限制在可解释、可恢复的进入门槛上,而不是等玩家加载完成后才以断线或异常数据的形式暴露。