初始化

业务场景

游戏启动即调用,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

参数名称类型说明必传/可选最低版本
appIdString接入 SDK 申请的 AppId必传
appSecretKeyString接入 SDK 申请的 appSecretKey必传
isLandscapeBoolean游戏横竖版标识,true 横版,false 竖版可选

出参:InitData initData

参数名称类型说明最低版本
appIdString游戏包中 SDK 实际使用的 appId
areaIdString游戏大区 Id(使用场景:先锋服)
channelIdString游戏包中 SDK 实际使用的渠道 Id
privacyUrlString隐私协议 url
userAgreementUrlString用户协议 url
auditTypeNumber游戏当前版本的审核状态,默认为 0
userIPAreaNumber游戏当前用户 ip 归属地区,默认为 0

错误码

FAQ

Q:游戏是否需要等初始化成功通知后,再继续执行游戏流程?
A:SDK 内部数据会依赖初始化成功的数据,所以建议游戏在初始化成功通知后,再继续后续的流程。

Q:SDK 初始化接口是否可以重复调用?
A:初始化接口不能重复调用,建议不要在游戏里多次调用,否则会导致数据埋点异常,影响用户数据的统计。