海豹平台H5游戏SDK接口说明
1 调用方法
在调用我们的SDK前,先在页面引入js:
https://download.uuufish.com/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 进入游戏日志上报接口
接口说明:本接口用于进入游戏日志上报(在创建角色后,调用角色创建日志上报接口,间隔1秒后再调用一次进入游戏日志上报接口)。
接口调用: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 秒) | 否 | 默认为当前时间 |
返回值:无