多人游戏与网络同步 / 系统课时
好友邀请点击后怎么验证房间
好友邀请点击后怎么验证房间
好友发来的邀请只能说明“曾经有一个可加入的房间”,不能保证点击时仍然有效。本节把过期、房间不存在、满员和版本不兼容串成一条验证链,并明确哪些判断可由客户端提前完成、哪些必须由服务端最终确认。
学习目标
- 设计邀请点击后的验证顺序,避免直接跳转房间后再报错
- 区分客户端预检查与服务端权威校验,正确处理房间状态变化
- 把不同失败原因映射成稳定的客户端状态和可理解提示
邀请只是入口,不是加入凭证
一条邀请通常至少能关联到目标房间,并带有失效时间等信息。客户端收到邀请后可以展示房间名称、邀请人和剩余时间,但这些缓存信息不能证明房间现在仍然存在,也不能证明还有空位。
点击邀请后的合理链路是:先做不依赖网络的快速检查,再获取服务端最新状态,确认条件通过后才进入真正的加入阶段。这样可以避免界面先切到房间页,随后又因为满员或版本错误被弹回大厅。

按稳定顺序处理失败原因
客户端可以先根据本地保存的失效时间判断邀请是否明显过期,从而减少无意义请求;但服务端仍要根据自己的时间和邀请记录再次校验,因为用户设备时间可能不准确。
拿到最新房间状态后,再处理会随时间变化的条件。建议把失败原因保持为稳定的机器码,界面层再负责转换为文案。
| 原因码 | 含义 | 客户端处理 |
|---|---|---|
invite_expired |
邀请已经失效 | 停留在大厅并提示重新邀请 |
room_not_found |
房间已解散或不可查询 | 移除或标记该邀请不可用 |
version_mismatch |
房间版本与当前客户端不兼容 | 阻止加入并提示更新或切换版本 |
room_full |
当前成员数已达到容量 | 不发送后续加入动作,允许稍后重试 |
用一个验证函数统一客户端分支
客户端最好让邀请卡片、通知弹窗和大厅列表共用同一套判断结果,而不是各写一组条件。下面用一个纯函数演示四种核心失败分支;实际项目中传入的 room 应来自服务端最新快照,而不是 오래未刷新的本地缓存。
function validateInvite({ invite, room, clientVersion, nowMs }) {
// 本地过期判断用于快速失败,服务端仍应再次校验邀请有效期。
if (nowMs >= invite.expiresAt) {
return { ok: false, reason: "invite_expired" };
}
if (room === null) {
return { ok: false, reason: "room_not_found" };
}
// 版本规则由游戏自身定义,这里采用必须完全相同的示例策略。
if (room.gameVersion !== clientVersion) {
return { ok: false, reason: "version_mismatch" };
}
if (room.memberCount >= room.capacity) {
return { ok: false, reason: "room_full" };
}
return { ok: true, roomId: room.id };
}
const baseInvite = { roomId: "room-7", expiresAt: 2000 };
const baseRoom = {
id: "room-7",
gameVersion: "1.4.0",
memberCount: 3,
capacity: 4
};
console.log(validateInvite({ invite: baseInvite, room: baseRoom, clientVersion: "1.4.0", nowMs: 1000 }));
console.log(validateInvite({ invite: baseInvite, room: null, clientVersion: "1.4.0", nowMs: 1000 }));
console.log(validateInvite({ invite: baseInvite, room: baseRoom, clientVersion: "1.3.0", nowMs: 1000 }));
console.log(validateInvite({ invite: baseInvite, room: { ...baseRoom, memberCount: 4 }, clientVersion: "1.4.0", nowMs: 1000 }));预期输出:
{ ok: true, roomId: 'room-7' }
{ ok: false, reason: 'room_not_found' }
{ ok: false, reason: 'version_mismatch' }
{ ok: false, reason: 'room_full' }这个函数适合生成客户端展示状态,但不能替代加入接口自己的校验。真正加入时,服务端需要在修改成员关系的同一条受保护流程中重新检查房间是否存在、版本是否允许以及是否还有容量,避免“验证时有空位、提交时已经满员”的竞态。
验证期间要锁住重复点击
邀请点击后可以把客户端状态从 idle 切到 validating,开始真正加入时再进入 joining。这两个状态下都应禁用同一邀请的加入按钮,避免用户连续点击产生多个并发请求。
如果验证失败,状态回到 idle 并保存明确的失败原因;加入成功后进入 inRoom,此时再切换房间界面。若用户在验证期间又点击了另一条邀请,应取消旧请求或使用请求版本号忽略旧响应,不能让较晚返回的旧结果覆盖当前选择。
最终验收时可以故意构造四种状态:过期邀请、已解散房间、版本不同和刚好满员。每一种都应停留在大厅且给出对应原因;只有最新状态全部通过并且服务端最终加入成功时,客户端才进入房间。