多人游戏与网络同步 / 系统课时
房间里退出与短暂掉线怎区分
房间里退出与短暂掉线怎区分
多人游戏里,连接消失不等于玩家主动退出。若服务端在一次心跳超时后立即删除房间成员,短暂切网、应用切后台或 Wi-Fi 抖动都会变成“退房”。本节建立主动离开、暂时离线和真正离开的状态边界,并用离线保留窗口保护玩家原有房间身份。
学习目标
- 区分主动离开与网络掉线在服务端语义上的差异
- 设计离线保留窗口以及到期后的资源回收规则
- 用可执行状态模型验证断线恢复和主动退出不会互相混淆
不要用连接状态代表房间身份
WebSocket、TCP 或其他实时连接只表示当前传输通道是否可用,房间成员身份则是更长生命周期的业务状态。一个玩家可能已经没有可用连接,但仍应在几十秒内保留队伍槽位、角色归属和比赛席位。
服务端至少应区分三个业务状态:ACTIVE 表示成员在线且可以正常收发游戏消息;OFFLINE_GRACE 表示连接已失效,但成员身份仍被保留;LEFT 表示玩家明确退出,或离线保留窗口已经到期,房间可以回收其位置。

主动离开和掉线要走不同入口
主动离开通常来自可信的 LeaveRoom 请求。服务端确认请求属于当前玩家后,可以立即把成员标记为 LEFT,释放席位并广播离开事件。此时即使旧客户端稍后带着恢复凭据回来,也不应把已经主动退出的身份恢复。
掉线则通常由心跳超时、连接关闭或网关检测到的传输异常触发。服务端只把成员切换到 OFFLINE_GRACE,同时记录恢复截止时间,例如当前时间加 30 秒。房间逻辑可以暂停该玩家的输入,但暂时保留成员 ID、队伍、角色和必要的恢复凭据。
用截止时间控制保留窗口
离线保留窗口应以服务端时间为准。进入 OFFLINE_GRACE 时写入 grace_deadline;恢复请求到达时,只有当前时间尚未超过截止点且恢复凭据有效,才能重新绑定新连接。后台清理任务则把已经超时的成员转成 LEFT。
下面的 Python 示例用一个最小状态机模拟这三种状态。代码不依赖第三方库,可以直接运行。
from dataclasses import dataclass
from enum import Enum
class Presence(str, Enum):
ACTIVE = "ACTIVE"
OFFLINE_GRACE = "OFFLINE_GRACE"
LEFT = "LEFT"
@dataclass
class RoomMember:
user_id: str
state: Presence = Presence.ACTIVE
grace_deadline: float | None = None
def transport_lost(self, now: float, grace_seconds: int = 30) -> None:
if self.state == Presence.ACTIVE:
self.state = Presence.OFFLINE_GRACE
self.grace_deadline = now + grace_seconds
def resume(self, now: float) -> bool:
# 主动退出后不能靠重新连接恢复房间身份。
if self.state != Presence.OFFLINE_GRACE:
return False
if self.grace_deadline is None or now > self.grace_deadline:
self.state = Presence.LEFT
self.grace_deadline = None
return False
self.state = Presence.ACTIVE
self.grace_deadline = None
return True
def leave_room(self) -> None:
self.state = Presence.LEFT
self.grace_deadline = None
def expire_if_needed(self, now: float) -> None:
if (
self.state == Presence.OFFLINE_GRACE
and self.grace_deadline is not None
and now > self.grace_deadline
):
self.state = Presence.LEFT
self.grace_deadline = None
member = RoomMember("player-42")
member.transport_lost(now=100.0)
print(member.state.value, member.resume(now=120.0), member.state.value)
member.transport_lost(now=200.0)
member.expire_if_needed(now=231.0)
print(member.state.value)
member = RoomMember("player-42")
member.leave_room()
print(member.state.value, member.resume(now=300.0))预期输出:
OFFLINE_GRACE True ACTIVE
LEFT
LEFT False第一段说明玩家在 30 秒窗口内恢复成功;第二段说明保留窗口过期后身份被释放;第三段说明主动离开是终态,不能被普通重连重新激活。
房间逻辑只在真正离开时回收身份
实际服务端通常还需要把状态变化与房间资源绑定。进入 OFFLINE_GRACE 时,可以停止接受该玩家的新输入并标记离线,但不要立即删除 memberId、队伍位置或比赛座位。只有收到主动退出,或清理任务确认保留窗口到期,才执行成员删除、席位释放和最终离开广播。
恢复时也不要重新执行普通加入流程,而应根据旧的成员身份把新连接重新绑定到原成员。这样才能避免玩家短暂掉线后被分配新座位、重复出现在成员列表,或者因房间已满而无法回到自己原来的位置。
当服务端把传输连接和房间成员身份拆开后,连接异常只改变在线状态,主动退出或保留窗口到期才真正结束房间身份。这个边界也是后续安全实现 Resume、状态补发和重复请求处理的基础。