初始化
业务场景
游戏启动即调用,SDK 会完成内部的激活和初始化相关的配置
注意事项
- 初始化接口调用顺序注意点:
其他接口(如无特殊说明)调用都必须在 SDK 初始化成功后,才能调用。
流程图
无
接口介绍
SDKManager.init(Object params);
调用示例
var params = {
appId: 'xxx',
appSecretKey: 'xxx',
isLandscape: false,
onSuccess: function (initData) {
// 初始化成功
},
onFailed: function (errorInfo) {
// 游戏需要尝试间隔2秒重试3次,若未成功则提示玩家重启游戏
},
};
SDKManager.init(params);
参数说明
入参:params
参数名称 | 类型 | 说明 | 必传/可选 | 最低版本 |
---|---|---|---|---|
appId | String | 接入 SDK 申请的 AppId | 必传 | |
appSecretKey | String | 接入 SDK 申请的 appSecretKey | 必传 | |
isLandscape | Boolean | 游戏横竖版标识,true 横版,false 竖版 | 可选 |
出参:InitData initData
参数名称 | 类型 | 说明 | 最低版本 |
---|---|---|---|
appId | String | 游戏包中 SDK 实际使用的 appId | |
areaId | String | 游戏大区 Id(使用场景:先锋服) | |
channelId | String | 游戏包中 SDK 实际使用的渠道 Id | |
privacyUrl | String | 隐私协议 url | |
userAgreementUrl | String | 用户协议 url | |
auditType | Number | 游戏当前版本的审核状态,默认为 0 | |
userIPArea | Number | 游戏当前用户 ip 归属地区,默认为 0 |
错误码
无
FAQ
Q:游戏是否需要等初始化成功通知后,再继续执行游戏流程?
A:SDK 内部数据会依赖初始化成功的数据,所以建议游戏在初始化成功通知后,再继续后续的流程。
Q:SDK 初始化接口是否可以重复调用?
A:初始化接口不能重复调用,建议不要在游戏里多次调用,否则会导致数据埋点异常,影响用户数据的统计。