星邦互娱

星邦互娱


H5游戏SDK接口

[TOC]

1. 调用方法

  • 我方通过原生APP的webview或者H5页面打开游戏地址（由游戏方提供），打开游戏地址时会自动追加参数partner_type=xxx&gameid=xxxx
  • 其中partner_type是指联运渠道ID，比如100001-谷歌 100002-三星 100003-苹果 100004-ones；gameid是指游戏id，具体列表在需要时可由平台方运营提供
  • 在调用我们的SDK前，先在页面引入js：http://sdk.wonderent.net/static/h5sdk/aksdk.js 
    <!-- 需要这样引入，不然容易造成跨域 -->
<script type="text/javascript" src="http://sdk.wonderent.net/static/h5sdk/aksdk.js"></script>

2. 接口

2.1 用户登录/注册接口（必接)

  • 接口说明： 用于调用9130平台用户登录／注册窗口，用户完成登录或者注册后，在回调中返回游戏相关的帐号信息。
  • 接口调用：AKSDK.login(callback) 参数说明：
参数说明
参数 说明 是否必须 例子
callback 回调函数 是 function(status, data){}
callback说明：
参数 说明 例子
status 状态 0 - 登录／注册成功 1 - 登录／注册失败
data 帐号信息 当status=0时同时返回一个js对象
data说明：
参数 说明 例子
userid 用户的唯一ID 123
account 帐号名 wd2784384
token 用户的唯一ID 4FU9236a872D3d23fE86871831a2adc8

2.2 用户退出登录接口（非必接)

  • 接口说明：本接口用于游戏通知SDK进行用户退出登录操作。
  • 接口调用：AKSDK.logout(callback)
参数说明:
参数 说明 是否必须 例子
callback 回调函数 是 function(status, data){}
callback说明：
参数 说明 例子
status 状态 0 - 登出成功 1 - 登出失败／注册失败 0

2.4 角色创建日志上报接口（必接)

  • 接口说明：本接口用于角色创建日志上报。
  • 接口调用：AKSDK.logCreateRole(serverId, serverName, roleId, roleName, roleLevel, roleCreateTime)
参数说明
参数 说明 是否必须 例子
serverId 服务器ID 是 1001
serverName 服务器名称 是 google服
roleId 角色ID 是 118799
roleName 角色名 是 大侠
roleLevel 角色等级 是 98
roleCreateTime 创角时间戳（精度秒） 是 1691547327

2.5 进入游戏日志上报接口（必接)

  • 接口说明：本接口用于进入游戏日志上报。
  • 接口调用：AKSDK.logEnterGame(serverId, serverName, roleId, roleName, roleLevel, roleCreateTime)
参数说明
参数 说明 是否必须 例子
serverId 服务器ID 是 1002
serverName 服务器名称 是 欧美服
roleId 角色ID 是 11769
roleName 角色名 是 大哥带飞
roleLevel 角色等级 是 120

2.6 角色升级上报接口（必接)

  • 接口说明：本接口用于角色升级日志上报。
  • 接口调用：AKSDK.logRoleUpLevel(serverId, serverName, roleId, roleName, roleLevel, roleCreateTime)
参数说明
参数 说明 是否必须 例子
serverId 服务器ID 是 1003
serverName 服务器名称 是 韩服
roleId 角色ID 是 167589
roleName 角色名 是 飞过山海
roleLevel 角色等级 是 134
roleCreateTime 创角时间戳（精度秒） 是 1691547327

2.3 支付接口（必接)

  • 接口说明： 用于调用9130平台用户支付窗口，在调用本接口前，游戏先完成自己的下单，然后将相应的支付信息通知我们的SDK，用户完成支付后，我们会在前端返回支付结果，同时我们的服务器端也会通知游戏方的服务端，进行发货请求，请务必以服务端调用为准。

  • 接口调用：AKSDK.pay(payInfo, callback)
参数说明
参数 说明 是否必须 例子
payInfo 支付信息(JS对象) 是 支付数据见下表
callback 回调函数 是 function(status, data){}
payInfo说明：
字段 说明 是否必须
cpbill 游戏订单号 是
productid 商品ID 是
productname 商品名称 是
productdesc 商品描述 是
ApplePrdId 苹果商品ID 详见补充说明1 是
serverid 服务器ID 是
servername 服务器名称 是
roleid 角色ID 是
rolename 角色名称 是
rolelevel 角色等级 是
price 金额，单位元 是
extension 扩展数据，如果设置，在发货接口会原样返回该数据 必接 公司项目传入{“cp_order_id”:”202207270907391175”}对象
  • 补充说明1: 如果需要接入苹果内购，首页需要平台方运营去苹果后台创建相应的商品清单，创建后将苹果商品ID列表交给研发，研发在调用支付的时候，根据玩家选择的商品，ApplePrdId相应传苹果商品ID就可以调用苹果支付。
callback说明：
参数 说明 例子
status 状态 0 - 支付成功 1 - 支付失败 ; 2 - 支付取消
data 帐号信息,当status=0时同时返回一个js对象 { userid:’用户ID’, account: ‘用户帐号’, cpOrderNo: ‘游戏订单号’, orderNo: ‘平台订单号’, amount: ‘金额’, extension: ‘扩展数据’}
data说明：
参数 说明 例子
userid 用户id 18782
account 用户账号 19897
cpOrderNo 游戏订单号 12632384734
orderNo 发行订单号 34838493438498
amount 金额 168
extension 扩展数据 8989

2.4 用户账号注销接口（必接)

  • 接口说明： 用于调用9130平台账户注销
  • 接口调用：AKSDK.accountCancel(callback)
参数说明
参数 说明 是否必须 例子
callback 回调函数 是 function(status, data){}
callback说明：
参数 说明 例子
status 状态 0 - 注销成功 1 - 注销失败
data 帐号信息 当status=0时同时返回一个js对象
data说明：
参数 说明 例子
userid 用户的唯一ID 123
account 帐号名 wd2784384

2.5 注册接口（非必接)

  • 接口说明： 用于调用9130平台用户注册窗口，用户完成注册后，在回调中返回游戏相关的帐号信息。
  • 接口调用：AKSDK.onLogout(callback) 参数说明：
参数说明
参数 说明 是否必须 例子
callback 回调函数 是 function(status, data){}
callback说明：
参数 说明 例子
status 状态 0 - 注册成功 1 - 注册失败
data 帐号信息 当status=0时同时返回一个js对象
data说明：
参数 说明 例子
userid 用户的唯一ID 17876
account 帐号名 wd78884

页面列表

ITEM_HTML