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 初始化所需的基础环境:
| 属性 | 类型 | 描述 |
|---|---|---|
| context | Context | 必填。建议使用 ApplicationContext 以避免内存泄漏。 |
| appId | String | 必填。在 SUD 平台申请的唯一应用标识。 |
| appKey | String | 必填。在 SUD 平台申请的应用密钥。 |
| privacyConfig | SUDOPPrivacyConfig | 可选。宿主已确认的广告隐私状态;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。
