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

把大厅到房间画成客户端状态机

把大厅到房间画成客户端状态机

创建、加入、离开房间如果只靠几个布尔值控制按钮,很容易出现重复请求、离房过程中再次加入、请求失败后界面卡死等问题。把流程收敛为有限状态机后,每个时刻只有一个明确状态,并且只允许少量合法转换。

学习目标

  • 用 Idle、Joining、InRoom、Leaving 表达客户端会话阶段
  • 为成功、失败和用户操作定义允许发生的状态转换
  • 用单一转换入口拒绝重复点击和非法并发操作

状态描述阶段,不描述按钮

Idle 表示客户端当前不在任何房间,可发起创建或加入;Joining 表示已经提交加入或创建请求,必须等待结果;InRoom 表示已确认拥有房间成员身份;Leaving 表示离房请求进行中。按钮是否可点、是否显示加载动画,都应从这些状态派生,而不是反过来决定状态。

大厅到房间的客户端状态机

状态机的价值在于把“现在允许做什么”变成可验证规则。例如 Joining 时再次点击加入不会产生第二个请求,Leaving 时也不会立即切到 Idle,因为服务器还没有确认成员身份已经解除。

把允许的转换写成规则

最小规则可以保持得很小:

当前状态 事件 下一状态
Idle JOIN_REQUEST Joining
Joining JOIN_SUCCEEDED InRoom
Joining JOIN_FAILED Idle
InRoom LEAVE_REQUEST Leaving
Leaving LEAVE_SUCCEEDED Idle
Leaving LEAVE_FAILED_STILL_MEMBER InRoom

最后一条只适用于服务端明确确认“仍然是该房间成员”的情况。如果离房请求超时、网络中断,客户端其实不知道服务端是否已经处理成功,此时不应仅凭超时就假设仍在房间,而应重新查询成员身份再决定落到哪个稳定状态。

用单一入口执行转换

下面示例把所有转换收敛到 transition,非法事件直接抛错。这样 UI、快捷键或网络回调都不能绕过规则修改状态。

js
function transition(state, event) {
  switch (state.status) {
    case "Idle":
      if (event.type === "JOIN_REQUEST") {
        return { status: "Joining", roomId: event.roomId };
      }
      break;

    case "Joining":
      if (event.type === "JOIN_SUCCEEDED") {
        return { status: "InRoom", roomId: state.roomId };
      }
      if (event.type === "JOIN_FAILED") {
        return { status: "Idle" };
      }
      break;

    case "InRoom":
      if (event.type === "LEAVE_REQUEST") {
        return { status: "Leaving", roomId: state.roomId };
      }
      break;

    case "Leaving":
      if (event.type === "LEAVE_SUCCEEDED") {
        return { status: "Idle" };
      }
      if (event.type === "LEAVE_FAILED_STILL_MEMBER") {
        return { status: "InRoom", roomId: state.roomId };
      }
      break;
  }

  throw new Error(`Illegal transition: ${state.status} + ${event.type}`);
}

let state = { status: "Idle" };
state = transition(state, { type: "JOIN_REQUEST", roomId: "room-42" });
state = transition(state, { type: "JOIN_SUCCEEDED" });
state = transition(state, { type: "LEAVE_REQUEST" });
state = transition(state, { type: "LEAVE_SUCCEEDED" });

console.log(state.status);

try {
  transition(state, { type: "LEAVE_REQUEST" });
} catch (error) {
  console.log(error.message);
}

预期输出

text
Idle
Illegal transition: Idle + LEAVE_REQUEST

实际项目可以把 roomId、错误信息和请求操作 ID 放进状态对象,但不要用大量互相独立的 isJoining、isLeaving、hasRoom 布尔值表达同一件事,否则很容易组合出逻辑上不可能的状态。

让网络回调也服从状态机

状态机还需要处理异步请求的“晚到结果”。例如用户开始加入房间后请求超时,客户端已回到 Idle 并发起另一次加入,此时第一条请求的成功响应才到达。网络层应给每次操作分配 operationId,回调写状态前确认它仍属于当前操作;否则即使转换表正确,过期回调仍可能污染新会话。

界面层只读取状态:Idle 显示可加入操作,Joining 和 Leaving 显示进行中并禁用冲突动作,InRoom 显示房间内容。这样创建、加入和离房的行为边界都集中在一处,后续增加重连或房主迁移时也有明确的扩展位置。

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

目录与阅读设置

阅读设置

17

记录一个想法

把大厅到房间画成客户端状态机

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

登录哪都通