海豹平台H5游戏SDK接口说明
1 调用方法
在调用我们的SDK前,先在页面引入js:
http://bg.public.sdk.gzyouai.com:33080/static/tg/h5/js/PublicSDK.js
接口调用DEMO参考:
http://bg.public.sdk.gzyouai.com:33080/static/tg/h5/game_demo.html
2.1 用户登录/注册接口
接口说明: 用于调用海豹平台用户登录/注册窗口,用户完成登录或者注册后,在回调中告知游戏相关的帐号信息。
接口调用:PUSDK.login(callback)
参数说明:
参数 | 说明** ** | 是否必须** ** | 例子** ** |
---|---|---|---|
callback | 回调函数 | 是 | function(status, data){ } |
callback*说明:*
参数 | 说明 | 例子 |
---|---|---|
status | 状态 | 0 - 登录/注册成功 1 - 登录/注册失败 |
data | 帐号信息 | 当status=0时同时返回一个js对象 data={ userType:用户类型 openId:用户ID timestamp:时间戳 serverSign:用户的serverSign} 请使用openID+userType作为我方用户的唯一ID,serverSign用来做二次校验用 校验方法详见下方 |
返回值:无****
2.3 支付接口
接口说明: 用于调用海豹平台用户支付窗口,在调用本接口前,游戏先完成自己的下单,然后将相应的支付信息通知我们的SDK,用户完成支付后,我们会在前端返回支付结果,同时我们的服务器端也会通知游戏方的服务端,进行发货请求,请务必以服务端调用为准。
接口调用:PUSDK.pay(payInfo,callback)
参数说明:
参数 | 说明** ** | 是否必须** ** | 例子** ** |
---|---|---|---|
payInfo | 支付信息(JS对象) | 是 | 支付数据见下表 |
callback | 回调函数 | 是 | function(status, data){ } |
payInfo说明:
字段 | 说明** ** | 是否必须 |
---|---|---|
productid | 商品ID | 是 |
productname | 商品名称 | 是 |
productdesc | 商品描述 | 是 |
exchange | 兑换率 1元= 10金币 这里就填10 | 是 |
serverid | 服务器ID | 是 |
servername | 服务器名称 | 是 |
roleid | 角色ID | 是 |
rolename | 角色名称 | 是 |
rolelevel | 角色等级 | 是 |
amount | 金额(单位元,必须大于 0) | 是 |
custom | 扩展数据,如果设置,在发货接口会原样返回该数据 | 可选 |
callback说明:客户端没有支付返回通知,以服务器支付返回通知为准
返回值:无****
2.4 角色创建日志上报接口
接口说明:本接口用于角色创建日志上报。
接口调用:PUSDK.logCreateRole(serverId,serverName, roleId, roleName, roleLevel, roleCreateTime)
参数说明:
参数 | 说明** ** | 是否必须** ** | 例子** ** |
---|---|---|---|
serverId | 服务器ID | 是 | |
serverName | 服务器名称 | 是 | |
roleId | 角色ID | 是 | |
roleName | 角色名 | 是 | |
roleLevel | 角色等级 | 是 | 固定为0 |
roleCreateTime | 创角的Unix时间戳(long 秒) | 否 | 默认为当前时间 |
返回值:无****
2.5 进入游戏日志上报接口
接口说明:本接口用于进入游戏日志上报。
接口调用:PUSDK.logEnterGame(serverId,serverName, roleId, roleName, roleLevel, roleCreateTime)
参数说明:
参数 | 说明** ** | 是否必须** ** | 例子** ** |
---|---|---|---|
serverId | 服务器ID | 是 | |
serverName | 服务器名称 | 是 | |
roleId | 角色ID | 是 | |
roleName | 角色名 | 是 | |
roleLevel | 角色等级 | 是 | |
roleCreateTime | 创角的Unix时间戳(long 秒) | 否 | 默认为当前时间 |
返回值:无****
2.6 进入角色升级上报接口
接口说明:本接口用于角色升级日志上报。
接口调用:PUSDK.logRoleUpLevel(serverId,serverName, roleId, roleName, roleLevel, roleCreateTime)
参数说明:
参数 | 说明** ** | 是否必须** ** | 例子** ** |
---|---|---|---|
serverId | 服务器ID | 是 | |
serverName | 服务器名称 | 是 | |
roleId | 角色ID | 是 | |
roleName | 角色名 | 是 | |
roleLevel | 角色等级 | 是 | |
roleCreateTime | 创角的Unix时间戳(long 秒) | 否 | 默认为当前时间 |
返回值:无