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

房间里退出与短暂掉线怎区分

房间里退出与短暂掉线怎区分

多人游戏里,连接消失不等于玩家主动退出。若服务端在一次心跳超时后立即删除房间成员,短暂切网、应用切后台或 Wi-Fi 抖动都会变成“退房”。本节建立主动离开、暂时离线和真正离开的状态边界,并用离线保留窗口保护玩家原有房间身份。

学习目标

  • 区分主动离开与网络掉线在服务端语义上的差异
  • 设计离线保留窗口以及到期后的资源回收规则
  • 用可执行状态模型验证断线恢复和主动退出不会互相混淆

不要用连接状态代表房间身份

WebSocket、TCP 或其他实时连接只表示当前传输通道是否可用,房间成员身份则是更长生命周期的业务状态。一个玩家可能已经没有可用连接,但仍应在几十秒内保留队伍槽位、角色归属和比赛席位。

服务端至少应区分三个业务状态:ACTIVE 表示成员在线且可以正常收发游戏消息;OFFLINE_GRACE 表示连接已失效,但成员身份仍被保留;LEFT 表示玩家明确退出,或离线保留窗口已经到期,房间可以回收其位置。

主动离开与短暂掉线的房间成员状态迁移

主动离开和掉线要走不同入口

主动离开通常来自可信的 LeaveRoom 请求。服务端确认请求属于当前玩家后,可以立即把成员标记为 LEFT,释放席位并广播离开事件。此时即使旧客户端稍后带着恢复凭据回来,也不应把已经主动退出的身份恢复。

掉线则通常由心跳超时、连接关闭或网关检测到的传输异常触发。服务端只把成员切换到 OFFLINE_GRACE,同时记录恢复截止时间,例如当前时间加 30 秒。房间逻辑可以暂停该玩家的输入,但暂时保留成员 ID、队伍、角色和必要的恢复凭据。

用截止时间控制保留窗口

离线保留窗口应以服务端时间为准。进入 OFFLINE_GRACE 时写入 grace_deadline;恢复请求到达时,只有当前时间尚未超过截止点且恢复凭据有效,才能重新绑定新连接。后台清理任务则把已经超时的成员转成 LEFT。

下面的 Python 示例用一个最小状态机模拟这三种状态。代码不依赖第三方库,可以直接运行。

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))

预期输出:

text
OFFLINE_GRACE True ACTIVE
LEFT
LEFT False

第一段说明玩家在 30 秒窗口内恢复成功;第二段说明保留窗口过期后身份被释放;第三段说明主动离开是终态,不能被普通重连重新激活。

房间逻辑只在真正离开时回收身份

实际服务端通常还需要把状态变化与房间资源绑定。进入 OFFLINE_GRACE 时,可以停止接受该玩家的新输入并标记离线,但不要立即删除 memberId、队伍位置或比赛座位。只有收到主动退出,或清理任务确认保留窗口到期,才执行成员删除、席位释放和最终离开广播。

恢复时也不要重新执行普通加入流程,而应根据旧的成员身份把新连接重新绑定到原成员。这样才能避免玩家短暂掉线后被分配新座位、重复出现在成员列表,或者因房间已满而无法回到自己原来的位置。

当服务端把传输连接和房间成员身份拆开后,连接异常只改变在线状态,主动退出或保留窗口到期才真正结束房间身份。这个边界也是后续安全实现 Resume、状态补发和重复请求处理的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

房间里退出与短暂掉线怎区分

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

登录哪都通