Skip to content

initSDK ​

初始化 SDK ​

初始化 SUDOP SDK。初始化成功后,可继续进行鉴权(auth)和启动游戏(startGame)。


方法声明 ​

java
/**
 * Initialize the SDK
 *
 * @param context  context
 * @param appId    appId
 * @param appKey   appKey
 * @param privacyConfig 可选广告隐私配置
 * @param listener Callback listener
 */
public static void initSDK(Context context, String appId, String appKey, SUDOPInitSDKListener listener);
public static void initSDK(Context context, String appId, String appKey,
                           SUDOPPrivacyConfig privacyConfig,
                           SUDOPInitSDKListener listener);

参数说明 ​

1. SUDOPInitSDKParams ​

用于配置 SDK 初始化所需的基础环境:

属性类型描述
contextContext必填。建议使用 ApplicationContext 以避免内存泄漏。
appIdString必填。在 SUD 平台申请的唯一应用标识。
appKeyString必填。在 SUD 平台申请的应用密钥。
privacyConfigSUDOPPrivacyConfig可选。宿主已确认的广告隐私状态;null 表示不主动设置。

2. SUDOPInitSDKListener ​

用于接收初始化结果的异步回调:

  • void onSuccess():SDK 基础环境初始化完成,可以进行后续的鉴权(auth)操作。
  • void onFailure(int retCode, String retMsg):初始化失败,需根据错误码排查参数或网络问题。

代码示例 ​

java
// 先从宿主 CMP 或隐私流程取得用户已确认的选择,再构造本次隐私配置。
// 以下值仅演示写法,不是默认授权;不要直接按示例值替用户作出选择。
// 任一参数可传 null:不主动设置该状态。null 不代表拒绝、撤回或重置第三方状态。
SUDOPPrivacyConfig privacyConfig = SUDOPPrivacyConfig.builder()
        // GDPR 广告相关数据处理同意:GRANTED 已同意;DENIED 拒绝或已撤回。
        // NOT_APPLICABLE 表示不适用,此项不设置;不是“默认同意”。
        .setGdprConsentStatus(SUDOPPrivacyConfig.GdprConsentStatus.NOT_APPLICABLE)
        // 是否退出个人信息销售或共享:OPTED_OUT 已退出;NOT_OPTED_OUT 未退出。
        // NOT_APPLICABLE 表示不适用;注意“已退出”不是“已同意”。
        .setDoNotSellStatus(SUDOPPrivacyConfig.DoNotSellStatus.NOT_APPLICABLE)
        // 巴西 LGPD 同意状态:GRANTED 已同意;DENIED 拒绝或已撤回。
        // NOT_APPLICABLE 表示不适用;应单独确认,不能直接复制 GDPR 的选择。
        .setLgpdConsentStatus(SUDOPPrivacyConfig.LgpdConsentStatus.NOT_APPLICABLE)
        // 年龄处理:CHILD 按儿童处理;TEEN 按青少年处理,不等同于儿童。
        // UNSPECIFIED 显式指定未设置年龄限制;null 则不主动设置,与前者不同。
        .setAgeRestrictedTreatment(SUDOPPrivacyConfig.AgeRestrictedTreatment.UNSPECIFIED)
        .build();

SUDOP.initSDK(context, "YOUR_APP_ID", "YOUR_APP_KEY", privacyConfig, new SUDOPInitSDKListener() {
    @Override
    public void onSuccess() {
        // SDK 初始化成功
        Log.i("SUDOP", "SDK initialized successfully.");
    }

    @Override
    public void onFailure(int retCode, String retMsg) {
        // 初始化失败
        Log.e("SUDOP", "SDK init failed: " + retMsg + " (Code: " + retCode + ")");
    }
});

注意事项 ​

  • 调用时机:建议在 Application.onCreate() 或主 Activity 启动阶段调用。
  • 调用次数:通常只需在 App 生命周期内初始化一次。
  • 生命周期:初始化成功是调用 auth 和 startGame 系列接口的前提。
  • 兼容重载:不传 privacyConfig 的原重载仍可使用,语义等同于传入 null。
  • 合规边界:隐私配置应使用宿主已经确认的状态,不负责判断地区、展示同意弹窗或替代 CMP。字段定义见 SUDOPPrivacyConfig。