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

满员与关闭房间如何即时显示

满员与关闭房间如何即时显示

玩家是否能加入房间,不应等到点击按钮后才知道。客户端应根据房间的开放状态、当前人数和容量即时派生“可加入”状态,并在收到房间更新时立刻刷新卡片,同时仍把最终准入判断交给服务端。

学习目标

  • 从房间状态与容量字段稳定派生可加入条件
  • 在房间更新到达时立即刷新按钮和原因提示
  • 区分客户端预判与服务端最终准入校验

不把“可加入”当成独立真相

最容易出错的做法,是服务端给出 status、players、capacity,客户端又单独维护一个 joinable 布尔值。只要其中一个字段更新而 joinable 没同步,就会出现“已经满员但按钮仍可点”或“房间重新空出位置却仍不可加入”。

示例约定房间状态使用 open 和 closed。接入真实项目时应沿用服务端协议中的实际枚举值,不要自行猜测。基础规则可以写成:状态必须开放,且当前人数小于容量;只要任一条件不满足,按钮立即不可用。

房间状态 人数 客户端展示
open 1/4 可加入
open 4/4 满员,不可加入
closed 1/4 已关闭,不可加入

房间字段更新到可加入状态的派生数据流

用派生状态驱动按钮

实时通道可以是 WebSocket、SSE 或短轮询;无论传输方式是什么,收到更新后都应先合并房间字段,再重新计算展示状态。下面用 Node.js 内置的 EventEmitter 模拟服务端推送,重点展示状态派生逻辑。

js
const { EventEmitter } = require("node:events");

function toRoomView(room) {
  if (room.status !== "open") {
    return { ...room, joinable: false, reason: "已关闭" };
  }

  if (room.players >= room.capacity) {
    return { ...room, joinable: false, reason: "已满员" };
  }

  return { ...room, joinable: true, reason: "" };
}

class RoomStore {
  constructor(initialRooms) {
    this.rooms = new Map(initialRooms.map((room) => [room.id, room]));
  }

  render(id) {
    const view = toRoomView(this.rooms.get(id));
    const state = view.joinable ? "可加入" : `不可加入:${view.reason}`;
    console.log(
      `${view.id} | ${view.players}/${view.capacity} | ${view.status} | ${state}`
    );
  }

  applyUpdate(update) {
    // 推送可能只带变化字段,所以先与已有快照合并,再派生 UI 状态。
    const current = this.rooms.get(update.id);
    this.rooms.set(update.id, { ...current, ...update });
    this.render(update.id);
  }
}

const stream = new EventEmitter();
const store = new RoomStore([
  { id: "r1", status: "open", players: 2, capacity: 2 },
  { id: "r2", status: "closed", players: 1, capacity: 4 },
  { id: "r3", status: "open", players: 1, capacity: 4 }
]);

stream.on("room:update", (update) => store.applyUpdate(update));

console.log("初始:");
store.render("r1");
store.render("r2");
store.render("r3");

console.log("推送更新:");
stream.emit("room:update", { id: "r3", players: 4 });
stream.emit("room:update", { id: "r1", players: 1 });

预期输出:

text
初始:
r1 | 2/2 | open | 不可加入:已满员
r2 | 1/4 | closed | 不可加入:已关闭
r3 | 1/4 | open | 可加入
推送更新:
r3 | 4/4 | open | 不可加入:已满员
r1 | 1/2 | open | 可加入

这里没有把 joinable 写回房间实体,而是每次从最新字段计算,因此不会产生两份需要同步的真相。

更新事件要先合并再判断

实际推送经常是增量事件,例如只告诉客户端 players 从 3 变成 4,而不重复发送 status 和 capacity。如果直接拿这个局部对象计算,就会因为字段缺失得出错误结果。正确顺序是“找到现有房间 → 合并变更字段 → 校验数据 → 派生展示”。

客户端还应把异常数据视为不可加入,例如容量缺失、容量小于等于 0、人数为负数,或收到协议中未知的状态值。不要为了让按钮可点而自行补默认容量;协议数据不可信时,保守地禁用加入并等待下一次完整快照更安全。

即时禁用按钮仍不是最终权限校验

房间列表再实时,也存在网络延迟:玩家看到 1/2 时,另一个玩家可能正好占用最后一个位置。因此“按钮可点击”只代表客户端根据当前快照判断值得尝试,不代表已经获得席位。

点击加入后,服务端仍必须原子地检查房间是否开放、是否还有容量以及其他实际准入条件。若加入失败,客户端应按服务端真实错误结果更新提示,并请求或等待最新房间状态,而不是继续相信点击前的本地快照。

这样设计后,满员和关闭状态会尽早反映在列表上,减少无效点击;即使并发加入发生在最后一刻,服务端仍保留最终一致性的决定权。

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

目录与阅读设置

阅读设置

17

记录一个想法

满员与关闭房间如何即时显示

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

登录哪都通