【网络通信】服务器时间同步：客户端校时的协议设计

---校时协议：请求带客户端时间，响应带服务器时间
function TimeSync.request(actor)
    local t0 = os.clock()
    SL:SendNetMsg(MSGID.TIME_REQ, math.floor(t0 * 1000), 0, 0, "")
end

---服务器的响应：回传两端的时刻
SL:RegisterLuaNetMsg("TIME_ACK", function(data)
    local d = SL:JsonDecode(data)
    if not d then return end
    local t3 = os.clock() * 1000
    -- 单向延迟 = (t3 - t0 - 服务器处理) / 2
    local offset = d.serverTime - (d.t0 +
        (t3 - d.t0) / 2)
    TimeSync.offset = offset
    TimeSync.calibrated = true
end)

---业务取时间：本地时间加偏移
function TimeSync.now()
    return os.time() * 1000 + (TimeSync.offset or 0)
end

---周期校准：每 10 分钟微调一次
setontimerex(120, 600)
function TimeSync.periodic()
    TimeSync.request()
end

---倒计时的统一读取：活动剩余时间
function TimeSync.activityLeft(endAt)
    local now = TimeSync.now()
    return math.max(0, endAt - now)
end

---校准失效的兜底：偏移突变即重校
function TimeSync.checkDrift()
    if math.abs(TimeSync.offset -
        (TimeSync.lastOffset or TimeSync.offset)) > 2000 then
        Ops.alert('时间偏移突变，重新校准')
        TimeSync.request()
    end
end