v1.0.0 (2026-08-15 18:56)
玩家退出游戏 (Exit Game) ✓ 已完成
概述
- 接口说明:玩家在游戏内点击"返回大厅/退出游戏"或关闭游戏页面时调用,后端会通知 Hub 踢出玩家并释放本地游戏锁。
调用关系说明
NOTE
退出游戏接口内部调用 Hub 的 /papi/v1/player/reclaim 完成踢出与余额回收,member_id 传玩家原生用户名(username,与游戏启动接口 /papi/v1/game/launch 一致);Hub 回收成功后清零玩家活跃钱包余额并触发 /settle 回调退回资金,随后回调包网的 /api/v1/callback/offline 通知下线(记录游玩日志),玩家无需关心这些回调。
1. POST - 退出游戏
- 路径:
/client/games/exit
请求 Header
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | String | 是 | Bearer Token(玩家 JWT,必须已登录) |
请求参数
无(玩家身份从 JWT 获取)
响应示例
json
{
"status": true,
"code": 0,
"data": null,
"msg": "Success"
}NOTE
退出成功不返回玩家余额;玩家退出后的最终余额请调用 GET /client/member/getBalance 获取。Hub 回收金额(reclaimed_amount)仅由后端用于对账审计。
错误响应示例
json
{
"status": false,
"code": 7,
"data": {},
"msg": "退出游戏失败,请稍后再试"
}NOTE
msg 会根据玩家语言自动返回(优先取 JWT 的 language claim、x-language 请求头或玩家档案语言),以上为中文(zh_cn)示例。