SDK介绍
- 中间件 SDK用于安卓微端游戏联运，通过JS与原生SDK之间调用实现，此种接入方式可以由平台技术人员打包,减少CP对接时间提高效率
- 中间件 SDK主要提供用户系统、支付系统、游戏攻略、游戏礼包等功能。
- 中间件 SDK适用于安卓操作系统16以上（包括16）的安卓设备（手机、平板、模拟器）
注意事项
- 接口参数大小写敏感
- request 和 response的编码格式均为 UTF-8
前期准备
1.SDK接入技术人员仔细阅读该对接文档
2.CP提供支付回调地址。
3.获取SDK平台配置参数：
| 字段 | 描述 |
|---|---|
| app_id | 游戏ID |
| app_key | 游戏KEY |
| client_id | 客户端ID |
| client_key | 客户端KEY |
接入步骤
中间件 SDK引入
获取JS文件地址 sdk，引入到H5游戏工程中
接口调用
中间件 SDK提供对象（DJSDK）供外部使用。
提供游戏入口地址
CP技术人员接入完中间件SDK后，提供游戏入口地址给SDK开发人员，SDK开发人员会将游戏地址打包为APK文件，并且实现初始化/登录等功能，并将登录成功后的结果以参数拼接方式通过游戏地址传给CP进行登录验证。验证成功后进入游戏。
地址示例：
http://xx/loginH5Game?mem_id=118976&token=am43uapq0un27r5tup2hfmk913&appid=1&age=xxx
| 字段 | 描述 |
|---|---|
| mem_id | 用户ID |
| token | 登录验证toke |
| appid | 游戏ID |
| age | 年龄(为0表示用户未实名认证) |
接口说明
1. 支付
DJSDK.qfPayProduct(parameters);
参数说明
| 参数名 | 类型 | 参数说明 |
|---|---|---|
| serverInfo | String | 区服ID(已过时,新版本请使用areaID) |
| productName | String | 产品名称 |
| productDiscrible | String | 产品描述 |
| roleID | String | 角色ID |
| attachString | String | 扩展参数（CP订单号） |
| orderId | String | 订单ID（已过时，新版本请使用attachString） |
| amount | String | 支付金额 |
| productId | String | 内购ID(注:iOS必填,Android不填) |
| areaID | String | 区服ID |
| areaName | String | 区服名称 |
| roleName | String | 角色名称 |
支付说明
中间件SDK最终的支付逻辑使用原声安卓SDK逻辑进行支付。
注：Android端：productId可填可不填，iOS端必须填写完整示例
DJSDK.qfPayProduct({
serverInfo: "区服ID", productName: "产品名称", productDiscrible: "产品详情",
roleID: '角色ID', attachString: 'CP订单号', orderId: "CP订单号", amount: "0.01",productId: "内购ID",
areaID: "区服ID",areaName:"区服名称",roleName:"角色名称
})
2. 创角
DJSDK.qfSynchroRoleInfo(parameters);
参数说明
| 参数名 | 类型 | 参数说明 |
|---|---|---|
| roleID | String | 角色ID |
| roleName | String | 角色名字 |
| roleRank | String | 角色等级 |
| areaID | String | 区服ID |
| areaName | String | 区服名称 |
创角接口说明
在完成初始化并已经获取到SDK实例的情况下，用户创建角色/角色升级时调用。
注：平台需要进行数据分析，因此该接口请务必调用完整示例
DJSDK.qfSynchroRoleInfo({
roleID: '角色ID', roleName: '角色名称', roleRank: '99',
areaID: '区服ID', areaName: '区服名称'
})