多人游戏与网络同步 / 系统课时
先做通一个创建房间流程
先做通一个创建房间流程
创建房间的第一版不需要先做复杂表单或邀请系统,目标是把“提交参数、收到房间响应、更新客户端状态”完整跑通。只要这条链路可验证,后面再增加密码、地图、队伍规则或权限字段时就有稳定基线。
学习目标
- 设计创建房间请求的最小参数和成功响应。
- 在客户端明确区分
idle、creating、joined与error状态。 - 用一个可运行示例验证请求、响应和状态迁移是否一致。
先定义最小成功条件
第一版只保留会影响创建结果的字段:目标大厅 lobbyId、房间名 name 和人数上限 capacity。服务端成功后返回新房间的唯一 roomId、规范化后的房间字段以及当前人数。客户端拿到 201 Created 后,不要只弹“创建成功”,而应把状态切换到已进入该房间。
最小验收条件可以固定为:请求只发送必要字段;服务端拒绝非法容量;成功响应包含 roomId;客户端从 idle 进入 creating,再进入 joined;失败时进入 error,且不能残留半初始化的房间对象。

用可运行脚本验证整条链路
下面的 Node.js 18+ 示例在同一文件中启动一个最小 HTTP 服务端,再用内置 fetch 模拟客户端创建房间。这样不用依赖第三方包,就能验证请求字段、201 响应和状态迁移。保存为 create-room-demo.js 后直接运行。
const http = require("node:http");
const client = {
phase: "idle",
room: null,
error: null,
};
function transition(nextPhase, patch = {}) {
console.log(`${client.phase} -> ${nextPhase}`);
Object.assign(client, patch, { phase: nextPhase });
}
const server = http.createServer(async (req, res) => {
if (req.method !== "POST" || req.url !== "/rooms") {
res.writeHead(404);
res.end();
return;
}
let raw = "";
for await (const chunk of req) raw += chunk;
// 服务端只校验本次最小流程真正需要的字段。
const input = JSON.parse(raw);
const valid =
input.lobbyId === "lobby-na" &&
typeof input.name === "string" &&
input.name.length > 0 &&
Number.isInteger(input.capacity) &&
input.capacity >= 2 &&
input.capacity <= 8;
if (!valid) {
res.writeHead(400, { "content-type": "application/json" });
res.end(JSON.stringify({ error: "INVALID_ROOM_INPUT" }));
return;
}
const room = {
roomId: "room-001",
lobbyId: input.lobbyId,
name: input.name,
memberCount: 1,
capacity: input.capacity,
};
res.writeHead(201, { "content-type": "application/json" });
res.end(JSON.stringify(room));
});
server.listen(3000, "127.0.0.1", async () => {
try {
transition("creating", { room: null, error: null });
const response = await fetch("http://127.0.0.1:3000/rooms", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({
lobbyId: "lobby-na",
name: "双排练习房",
capacity: 4,
}),
});
// 非 2xx 不能继续当作成功房间解析。
if (!response.ok) {
const problem = await response.json();
throw new Error(problem.error ?? `HTTP_${response.status}`);
}
const room = await response.json();
transition("joined", { room });
console.log(
`roomId=${room.roomId}, name=${room.name}, members=${room.memberCount}/${room.capacity}`,
);
} catch (error) {
transition("error", { room: null, error: error.message });
} finally {
server.close();
}
});预期输出
idle -> creating
creating -> joined
roomId=room-001, name=双排练习房, members=1/4这个结果同时证明三件事:请求参数通过校验,服务端返回了可识别的新房间,客户端只在拿到成功响应后进入 joined。若把 capacity 改成 1,服务端会返回 400,客户端则进入 error,可以用来验证失败分支没有误写成功状态。
成功响应之后只更新必要状态
创建成功后,客户端至少要保存新 roomId,并把当前房间对象写入房间作用域状态。如果大厅页仍然保留在返回栈中,可以同步把新房间摘要插入当前大厅列表;但不要因此把完整成员实时数据复制进大厅列表。
真正的成员实时订阅应该在 joined 状态建立,并与当前 roomId 绑定。这样即使后续创建接口增加更多配置字段,请求流程仍保持稳定:提交创建参数,确认服务端创建成功,再进入具体房间并开始房间级同步。
创建失败时保持状态可恢复
失败处理的关键不是显示多少错误文案,而是保证状态可再次操作。网络异常、参数校验失败或服务端拒绝创建时,应清空未完成的房间对象,把错误保存到独立字段,并允许用户修正参数后重新从 idle 或可重试状态发起请求。
第一版先把这条最小链路跑通,比一次性加入密码、地图、机器人和邀请逻辑更重要。只要请求、响应和状态迁移有可重复的验证路径,后续字段增长就只是扩展协议,而不是重新猜测客户端流程。