接入游戏，连接发行

01　准备接入资料

向平台接入负责人获取 AAR、游戏 ID、渠道编码和后端授权配置。最低 Android API 23，Java 8。游戏保留自己的账号和角色系统。

02　集成 Android SDK

将 qufutong-sdk-0.1.0.aar 放入 app/libs 并添加依赖：

dependencies {
    implementation files('libs/qufutong-sdk-0.1.0.aar')
}

同一进程复用一个 SDK 实例，由稳定的生命周期持有者管理：

QufutongSdk sdk = new QufutongSdk(
    context, "https://sdk.qufutong.com",
    gameId, channelCode, false
);

AAR 声明 INTERNET 权限。渠道包内的标记提供游戏、渠道及包 ID。使用 getGameId()、getChannelCode()、getPackageId() 取得归属信息。

03　由游戏后端申请会话

后端验证玩家身份，并依据可信发行记录核对游戏、渠道和包归属。不要直接信任客户端提交的玩家 ID 或归属字段。签发接口当前信任授权调用方，发行记录核对需由游戏后端完成。

POST /api/v1/sdk-sessions
Authorization: Bearer <服务端授权凭证>
Content-Type: application/json

{
  "player_id": "已认证玩家ID",
  "game_id": "游戏ID",
  "channel_code": "渠道编码",
  "package_id": "渠道包ID"
}

成功返回 HTTP 201，包含 token 和 session。将短期 token 交给对应玩家客户端，再调用 sdk.login(playerToken, callback)。

04　绑定业务生命周期

SDK 会话验证成功后上报登录；进入游戏或回到前台上报活跃；角色创建与等级变化调用相应事件。回调在主线程，入队成功与服务端确认分别处理。

会话约一小时有效。应用重开或收到 http_401 时，向游戏后端重新获取 token 并登录 SDK。会话续期不应额外产生业务登录事件。

退出账号调用 sdk.logout()，保留原账号待发队列；持有者结束时调用 sdk.close()。完整事件字段见事件接口与补传。