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

先做通一个创建房间流程

先做通一个创建房间流程

创建房间的第一版不需要先做复杂表单或邀请系统,目标是把“提交参数、收到房间响应、更新客户端状态”完整跑通。只要这条链路可验证,后面再增加密码、地图、队伍规则或权限字段时就有稳定基线。

学习目标

  • 设计创建房间请求的最小参数和成功响应。
  • 在客户端明确区分 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 后直接运行。

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

预期输出

text
idle -> creating
creating -> joined
roomId=room-001, name=双排练习房, members=1/4

这个结果同时证明三件事:请求参数通过校验,服务端返回了可识别的新房间,客户端只在拿到成功响应后进入 joined。若把 capacity 改成 1,服务端会返回 400,客户端则进入 error,可以用来验证失败分支没有误写成功状态。

成功响应之后只更新必要状态

创建成功后,客户端至少要保存新 roomId,并把当前房间对象写入房间作用域状态。如果大厅页仍然保留在返回栈中,可以同步把新房间摘要插入当前大厅列表;但不要因此把完整成员实时数据复制进大厅列表。

真正的成员实时订阅应该在 joined 状态建立,并与当前 roomId 绑定。这样即使后续创建接口增加更多配置字段,请求流程仍保持稳定:提交创建参数,确认服务端创建成功,再进入具体房间并开始房间级同步。

创建失败时保持状态可恢复

失败处理的关键不是显示多少错误文案,而是保证状态可再次操作。网络异常、参数校验失败或服务端拒绝创建时,应清空未完成的房间对象,把错误保存到独立字段,并允许用户修正参数后重新从 idle 或可重试状态发起请求。

第一版先把这条最小链路跑通,比一次性加入密码、地图、机器人和邀请逻辑更重要。只要请求、响应和状态迁移有可重复的验证路径,后续字段增长就只是扩展协议,而不是重新猜测客户端流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

先做通一个创建房间流程

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

登录哪都通