Appearance
登录
玩家进入游戏时,KeepSDK 会请求你配置的 login_url。入参页游、H5、端游相同,用 login_key 验签。验签通过后,把 uid、app_id、server_id 等写入当前玩家会话。后面支付、聊天、打点都从会话取 uid。
页游 / H5 与端游的登录区别:
| 页游 / H5 | 端游 | |
|---|---|---|
| 动作 | 浏览器 302 到 login_url | 网关 GET login_url |
| 请求 | query 已签名,参数相同 | query 已签名,参数相同 |
| 成功 | 直接进游戏,不要回 JSON | 回 JSON(见下) |
| 失败 | 没有失败 JSON,玩家进不去即可 | code≠0、非 JSON、HTTP 非 200 |
请求方式
- 地址:后台填写的
login_url - 密钥:
login_key - 参与签名:下表字段。query 上多出来的参数不要进签
| 参数 | 必填 | 说明 |
|---|---|---|
app_id | 是 | 游戏 app_id |
uid | 是 | KeepSDK 账号,{code}:{渠道号}。进自己账号表用这个 |
server_id | 是 | 区服。没传时为 "1"。进游戏后换区请更新会话 |
adult | 是 | 1 成年,2 未成年或未知 |
client | 是 | 0 网页,1 端 / 微端 / 大厅 |
time | 是 | 时间戳秒 |
sign | 是 | 签名,见 签名 |
登录 query 只有上表字段,没有 code、channel_uid,也没有渠道票(如 openkey)。账号用 uid。
页游 / H5
网关 302 到 login_url,玩家带着已签好的 query 进游戏。不要再回调 KeepSDK,也不要回 JSON。302 上没有 ticket、没有渠道票。
端游
网关 GET 你的 login_url,参数与上表相同。验签后回 JSON,不要 302:
json
{"code": 0, "message": "ok", "data": {"ticket": "游戏签发的票"}}没有票就 data: {}。ticket 由游戏自己签发,KeepSDK 会放进客户端 GetSession,不要把渠道票写进 data。码表见 错误码。