【后端接口】offlineplay 与 httppost：离线代练与外部服务的接口组合

实战应用：用在哪里

两个拓展型接口：offlineplay 让离线角色按代练策略继续获取收益（离线挂机商品），httppost 让游戏服与外部服务（支付回调、客服系统、数据平台）直接对话。一个对内拓展玩法的边界，一个对外拓展系统的边界。

离线代练

---离线代练 actor:玩家 time:离线时长秒
function offlineplay(actor, time) end

-- 购买离线代练卡：8 小时离线收益
function buyOfflineCard(actor)
    if not actor:TakeGold(200000) then return false, "金币不足" end
    offlineplay(actor, 8 * 3600)
    sendmsg(actor, 1, "离线代练已激活，8 小时后领取收益")
    return true
end

离线代练的收益结算在玩家上线时按离线时长折算，收益的效率低于在线打怪是商品定价的基准：花钱买便利而不是买超值。离线时长的上限（最长 24 小时）与叠加规则（同类卡刷新不叠加）是商品的规则边界。

外部服务对话

---HTTP POST url:地址 suffix:参数 head:头
function httppost(url, suffix, head) end

-- 客服工单同步：玩家在游戏内提交的举报推给客服系统
function reportToCS(actor, reportText)
    local body = "uid=" .. actor:GetUserId() .. "&content=" .. reportText
    httppost("http://cs.internal/api/ticket", body, "Content-Type: application/x-www-form-urlencoded")
    sendmsg(actor, 1, "举报已提交，将尽快处理")
    return true
end

httppost 的参数是原生的 HTTP 语义：地址、表单体、请求头，游戏服与内网客服系统的工单同步不需要中间层。外呼的超时与重试策略：外部服务不可用时的降级（本地落盘待补推）是接口封装层的责任，游戏逻辑不因外部服务的故障而阻塞。接口的调用频率与外部服务的容量匹配，举报类的低频调用安全，高频同步要考虑批量。

验证与监控

外呼的成功率与耗时监控，外部服务的健康度看板让依赖关系可视化。

踩坑记录

httppost 的响应曾经没有处理，外部服务的超时让游戏逻辑等待了 30 秒，异步化与超时上限是外呼接口封装的第一课。离线代练的收益结算曾经可以叠加离线前的在线收益，收益的时段互斥规则上线后商品的定价逻辑才成立。

上线要点

外呼接口的域名与端口进运维的防火墙白名单，游戏服的外呼能力是最小化授权。离线代练的收益上限设计要防工作室的批量套利，收益曲线对在线收益的折价是经济的护城河。外部接口的版本兼容：外部服务的接口变更要有兼容窗口，游戏服的发布节奏与外部服务解耦。

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