调用接口
设置初始化结果回调
设置游戏初始化回调函数,函数调用位置应在GameSDK.init()函数前调用,否则初始化函数回调接收不到,通过该接口游戏可获取平台的用户信息。
函数:
方法说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
func | onInit回调函数 | function | 非空 | 详见onInit函数说明 |
onInit函数说明:
当平台收到游戏调用 init 方法,平台会调用 onInit 方法将用户信息返回给游戏
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
param | init返回 | object | 非空 | Json对象,见下文 |
初始化
调用平台任何其他的函数前,都要先调用该函数请求初始化SDK。初始化结果将会通过onInit回调函数返回给游戏。
注意:调用初始化函数之前,请先注册相关回调函数,如setOnInitCB()、setOnPayCB()
等
函数:
方法说明:游戏接入游戏sdk后,在游戏初始化完成后,调用该函数通知平台,平台收到init函数后,会调用onInit函数,将用户信息返回给游戏使用。(如游戏一直展示loding,原因是未正确接入GameSDK或未调用init函数)
参数 | 含义 | 类型 | 是否为空 | 备注 |
gameId | 游戏Id | int | 非空 | 后台游戏资料中获得 |
游戏退出
调用该函数后平台会立即结束游戏并关闭游戏窗口。
函数:
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
reason | 退出原因 | int | 非空 | 1、正常退出;2、异常退出 |
设置屏幕朝向
调用该函数可以设置游戏时的屏幕显示朝向。例如横屏游戏,需调用该函数通 知平台设置横屏。
函数:
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
orientation | 朝向 | int | 非空 | 0、 横屏; 1、竖屏 |
设置支付结果回调
平台将支付结果通知给游戏,游戏需调用该函数设置好回调函数。调用时机在GameSDK.init()函数前调用。
函数:
方法说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
func | onPay回调函数 | function | 非空 | 详见onPay函数说明 |
onPay函数说明:平台会通过onPay函数通知游戏,游戏需设置好回调函数接收。
函数:
参数 | 含义 | 类型 | 是否为空 | 备注 |
param | 支付参数 | object | 非空 | Json对象,见下文 |
如需同步支付订单信息,请查看支付服务端接口。
支付
游戏调用该函数,拉起平台支付功能
函数:
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
orderId | 订单号 | string | 非空 | |
goodsName | 商品名称 | string | 非空 | |
goodsDesc | 商品描述 | string | 非空 | |
orderAmount | 商品价格 | int | 非空 | 以“分”为单位 |
extension | 透传数据 | string | 非空 | 透传发送到游戏服务器 |
notifyURL | 支付付款通知地址 | string | 非空 | 支付成功通知游戏服务器地址 |
平台调用该函数之后,平台会将支付结果通知给游戏,函数调用位置应在GameSDK.init()函数之后调用。
支付的结果将会通过onPay函数返回。游戏需在GameSDK.init()函数之前,需将支付回调函数GameSDK.setOnPayCB()设置好。
设置游戏暂停回调
游戏调用该函数设置游戏暂停回调,当平台进入后台,会调用 onPause 方法通知游戏
函数:
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
func | onPause回调函数 | function | 非空 | 详见onPause函数 |
onPause 函数说明:
当平台进入后台时,调用 onPause 函数,通知游戏
设置游戏继续回调
游戏调用该函数设置游戏继续回调,当平台从后台进入前台时,平台会调用 onResume 函数通知游戏
函数:
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
func | onResume回调 | function | 非空 | 详见onResume函数 |
onResume函数说明
当平台从后台进入前台时,平台会调用 onResume 函数通知游戏
设置音量变化回调
游戏调用该函数,设置游戏音量变化消息回调,当平台声音变化时会通知游戏 声音变化。例:平台进入后台调用 onAudio 通知游戏关闭声音,当平台进入前 台调用 onAudio 通知游戏开启声音。(建议游戏默认关闭声音,等平台调用该函 数在设置声音的开关)
函数:
方法说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
func | onAudio回调函数 | function | 非空 | 详见onAudio函数说明 |
onAudio函数说明:
平台通知游戏声音变化,例:平台进入后台调用onAudio通知游戏关闭声音,当平台进入前台调用onAudio通知游戏开启声音。函数调用位置应在GameSDK.init()函数前调用。
参数说明:
参数 | 含义 | 类型 | 是否为空 | 备注 |
param | 声音通知参数 | object | 非空 | Json对象,见下文 |
Last updated