多人游戏与网络同步 / 系统课时
满员与关闭房间如何即时显示
满员与关闭房间如何即时显示
玩家是否能加入房间,不应等到点击按钮后才知道。客户端应根据房间的开放状态、当前人数和容量即时派生“可加入”状态,并在收到房间更新时立刻刷新卡片,同时仍把最终准入判断交给服务端。
学习目标
- 从房间状态与容量字段稳定派生可加入条件
- 在房间更新到达时立即刷新按钮和原因提示
- 区分客户端预判与服务端最终准入校验
不把“可加入”当成独立真相
最容易出错的做法,是服务端给出 status、players、capacity,客户端又单独维护一个 joinable 布尔值。只要其中一个字段更新而 joinable 没同步,就会出现“已经满员但按钮仍可点”或“房间重新空出位置却仍不可加入”。
示例约定房间状态使用 open 和 closed。接入真实项目时应沿用服务端协议中的实际枚举值,不要自行猜测。基础规则可以写成:状态必须开放,且当前人数小于容量;只要任一条件不满足,按钮立即不可用。
| 房间状态 | 人数 | 客户端展示 |
|---|---|---|
open |
1/4 |
可加入 |
open |
4/4 |
满员,不可加入 |
closed |
1/4 |
已关闭,不可加入 |

用派生状态驱动按钮
实时通道可以是 WebSocket、SSE 或短轮询;无论传输方式是什么,收到更新后都应先合并房间字段,再重新计算展示状态。下面用 Node.js 内置的 EventEmitter 模拟服务端推送,重点展示状态派生逻辑。
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 });预期输出:
初始:
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 时,另一个玩家可能正好占用最后一个位置。因此“按钮可点击”只代表客户端根据当前快照判断值得尝试,不代表已经获得席位。
点击加入后,服务端仍必须原子地检查房间是否开放、是否还有容量以及其他实际准入条件。若加入失败,客户端应按服务端真实错误结果更新提示,并请求或等待最新房间状态,而不是继续相信点击前的本地快照。
这样设计后,满员和关闭状态会尽早反映在列表上,减少无效点击;即使并发加入发生在最后一刻,服务端仍保留最终一致性的决定权。