多人游戏与网络同步 / 系统课时

进入游戏前怎样避免版本不一致

进入游戏前怎样避免版本不一致

玩家已经组进同一房间,却可能因为客户端代码、联机协议或地图资源版本不同,在加载游戏后才出现断线、字段解析失败或场景错位。更稳妥的做法是在进入游戏前集中完成兼容校验,只让满足当前房间要求的客户端继续加载。

学习目标

  • 区分客户端版本、协议版本和地图资源版本各自解决的问题
  • 设计进入游戏前的兼容检查结果与阻断规则
  • 用可运行代码验证兼容、需更新和资源不匹配三类结果

三类版本不能混成一个数字

客户端版本描述应用本身,例如 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 示例把三个检查集中在一个函数中,并保持检查顺序稳定。

js
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));
}

预期输出

text
{ ok: true, reason: 'COMPATIBLE' }
{ ok: false, reason: 'CLIENT_UPDATE_REQUIRED' }
{ ok: false, reason: 'MAP_RESOURCE_MISMATCH' }

这里把应用版本最低门槛和协议精确匹配分开,是为了避免错误地把所有版本都套进同一套比较规则。真实项目如果允许多个协议版本共存,可以把单个 protocolVersion 扩展成服务端明确公布的兼容集合,但客户端仍应依据服务端规则判断,而不是自行猜测“相差 1 应该也能用”。

失败后应该停在哪个状态

客户端版本过旧通常无法在当前流程中自行修复,应保持房间信息并进入 updateRequired,禁止发送开始游戏请求。协议不一致也应直接阻断,因为继续加载只会把错误推迟到网络消息解析阶段。

地图资源不一致则不同。如果客户端支持资源更新,可以进入 repairingResources 或 downloadingMap,完成后重新计算资源版本,再走一次完整兼容检查。不要下载完成后直接跳过校验进入场景,因为下载中断、缓存命中错误或清单未更新都可能让资源仍不一致。

在多人同时开局时以服务端要求为准

进入游戏前的最终要求应由当前房间或游戏服务端给出。客户端本地可以提前做预检,但不能把本地缓存的最低版本、协议号或地图版本当作权威值,因为房间可能在客户端打开大厅后已经切换地图或升级服务端。

因此稳定链路是:取得最新房间启动信息,执行兼容校验,必要时更新或修复,再重新取得或确认启动信息,最后才进入游戏场景。这样版本错误会被限制在可解释、可恢复的进入门槛上,而不是等玩家加载完成后才以断线或异常数据的形式暴露。

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

目录与阅读设置

阅读设置

17

记录一个想法

进入游戏前怎样避免版本不一致

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

登录哪都通