简介
本文档包含 Combo Game 对接相关的流程、定义、接口、格式等说明，以供商户开发人员完成对接流程。
术语定义
商户
使用 Combo Game 服务的公司主体。
App
商户在 Combo Game 后台创建的应用，不同 App 数据完全隔离，商户可申请创建多个 App 用于互不关联的应用场景或用于不同货币的使用场景。
App 回调地址
商户 Combo Game 后台的 App 设置中配置的两个回调地址，在获取用户信息和更新钱包余额时，Combo Game 会访问 App 回调地址，详情请见后续说明。
对接流程
- 联系商务创建测试环境商户号和 App，获取 AppKey，配置回调地址；
- 开发人员根据本文档进行对接；
- 测试环境验证通过后，通知 Combo Game 技术人员进行确认；
- 联系商务签约，开通正式环境商户号和 App，获取正式 AppKey，配置正式回调地址；
- 正式环境验证通过后即可上线。
环境说明
Combo Game 有完全独立的测试和正式环境，请先在测试环境对接验收通过后，再联系商务进行正式环境对接。
游戏地址格式
不同游戏有不同的域名和路径，拼接上固定后缀即可组成完成访问路径
{GAME_URL_PREFIX}?appId=xxx&userId=xxx&token=xxx&roomID=xxx&locale=xxx| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| GAME_URL_PREFIX | string | 是 | 游戏 URL，可登陆后台在游戏列表页找到 |
| appId | int | 是 | 商户 App ID |
| userId | string | 是 | 用户 ID |
| token | string | 是 | 商户提供的用户鉴权 token |
| roomId | string | 否 | 用户当前所在的房间 ID |
| locale | string | 否 | 不传时默认英语，不支持的语言显示英语，可以是 en 或者 en-US 格式 |
支持的语言
| locale | 语言中文名 | 说明 |
|---|---|---|
| en | 英语 | 默认语言，如果传入的 locale 不支持则使用英语 |
| ar | 阿拉伯语 |
注意，部分游戏可能不支持全部语言
技术对接说明
Android 端
根据后续文档说明暴露 Javascript Bridge 以供 Combo Game 调用，同时需要在用户的金币发生非游戏原因的变动时，调用 H5 提供的 Javascript 函数通知游戏刷新余额。
iOS 端
根据后续文档说明注册 Javascript Message Handler 以供 Combo Game 调用，同时需要在用户的金币发生非游戏原因的变动时，调用 H5 提供的 Javascript 函数通知游戏刷新余额。
后端
根据后续文档说明实现 getUserInfo 和 updateBalance 两个回调接口，以供 Combo Game 调用。