初始化

业务场景

游戏启动即调用,SDK 会完成内部的激活和初始化相关的配置

注意事项

  • 游戏版本强制更新的注意点:
    当 CP 需要对游戏进行强制更新时(即用户只能进新版本游戏包),必须使用 SDK 的更新机制。请提前通知我方运营团队,由运营团队在 SDK 后台配置相应的更新内容。请勿启用游戏自身的强制更新功能,以免影响游戏用户数据以及用户归因。

  • 初始化接口调用顺序注意点:
    其他接口(如无特殊说明)调用都必须在 SDK 初始化成功后,才能调用。

流程图

接口介绍

init(cfg: EworldSDK.InitConfig): void

调用示例

const cfg: EworldSDK.InitConfig = {
  appId: 'xxxxx',
  appSecretKey: 'xxxxx',
  islandscape: false,
  onSuccess: (initData) => {
    // 初始化成功,可以调用其他接口
  },
  onFailed: (err) => {
    // 初始化失败
};
SDKManager.init(cfg);

参数说明

入参:InitConfig cfg

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

出参:InitData initData

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

错误码

错误码说明
-100000网络不可用,请检查网络
-100006参数错误,请检查初始化参数
-100021参数错误或不全,请检查初始化参数

FAQ

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

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