【引擎触发】playreconnection：小退重连的会话恢复触发

实战应用：用在哪里

小退（返回登录界面再进入）与大退（关闭客户端）在传奇里的语义不同：小退保留进程内的会话上下文，重连后可以精准恢复。playreconnection 触发在小退重连的瞬间执行，会话的恢复、界面的重建、掉线期间的补偿全从这里开始。

重连的恢复

---小退重连触发
function playreconnection(actor)
    -- 恢复界面状态：刷新任务追踪与 Buff 面板
    sendmsg(actor, 1, "欢迎回来，正在恢复会话数据")
    QF_SyncQuestPanel(actor)
    QF_SyncBuffPanel(actor)
    -- 掉线期间的邮件计数刷新
    local unread = QF_CountUnreadMail(actor)
    if unread > 0 then
        sendmsg(actor, 1, "有 " .. unread .. " 封未读邮件")
    end
end

重连触发里做三类恢复：界面的数据同步（任务与 Buff 面板的重算）、离线期间的计数刷新、会话标记的续期。小退不触发大退的清理逻辑（掉落保护、组队保留），两类退出的语义边界在触发里显式区分。

会话的标记

---会话续期：小退不重置活动参与状态
function playreconnectionKeepState(actor)
    local activity = getplayvar(actor, "HUMAN", "act_session") or ""
    if activity ~= "" then
        sendmsg(actor, 1, "已恢复活动进度：" .. activity)
    end
end

活动参与的会话变量在小退后保留，玩家不必重新报名。重连的补发：掉线期间的行会战令与邮件通知按序号补发，顺序错乱的重放会被客户端的幂等处理吸收。重连的耗时统计：从重连请求到界面可用的时长 P95 控制在 3 秒内，超时的重连走全量加载路径。

验证与监控

小退重连的成功率与会话恢复的完整率监控，恢复失败的案例进崩溃上报的关联分析。

踩坑记录

小退的重连曾经触发了大退的掉落保护清理，玩家的组队与活动状态丢失，两类退出触发的判定表写清后修复。重连后的 Buff 面板曾经显示过期状态，Buff 的到期校验在重连时重新执行后一致。

上线要点

重连触发的处理清单进开发规范：会话标记续期、面板同步、离线通知三类动作是标配。重连的耗时与成功率的日报是会话管理的健康指标，玩家的重连体验是留存细节里最容易被忽略的一环。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。