多人游戏与网络同步 / 系统课时
把大厅到房间画成客户端状态机
把大厅到房间画成客户端状态机
创建、加入、离开房间如果只靠几个布尔值控制按钮,很容易出现重复请求、离房过程中再次加入、请求失败后界面卡死等问题。把流程收敛为有限状态机后,每个时刻只有一个明确状态,并且只允许少量合法转换。
学习目标
- 用
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、快捷键或网络回调都不能绕过规则修改状态。
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);
}预期输出
Idle
Illegal transition: Idle + LEAVE_REQUEST实际项目可以把 roomId、错误信息和请求操作 ID 放进状态对象,但不要用大量互相独立的 isJoining、isLeaving、hasRoom 布尔值表达同一件事,否则很容易组合出逻辑上不可能的状态。
让网络回调也服从状态机
状态机还需要处理异步请求的“晚到结果”。例如用户开始加入房间后请求超时,客户端已回到 Idle 并发起另一次加入,此时第一条请求的成功响应才到达。网络层应给每次操作分配 operationId,回调写状态前确认它仍属于当前操作;否则即使转换表正确,过期回调仍可能污染新会话。
界面层只读取状态:Idle 显示可加入操作,Joining 和 Leaving 显示进行中并禁用冲突动作,InRoom 显示房间内容。这样创建、加入和离房的行为边界都集中在一处,后续增加重连或房主迁移时也有明确的扩展位置。