initSDK

初始化 SDK

initSDK 是使用 SUDGI SDK 的核心入口。该方法负责验证应用身份（appId 与 appKey）、配置存储路径并准备运行时底层环境。

---

方法声明

/**
 * Initialize the SDK
 *
 * @param context  context
 * @param appId    appId
 * @param appKey   appKey
 * @param listener Callback listener
 */
public static void initSDK(Context context, String appId, String appKey, SUDOPInitSDKListener listener);

---

参数说明

1. SUDOPInitSDKParams

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

属性	类型	描述
context	Context	必填。建议使用 ApplicationContext 以避免内存泄漏。
appId	String	必填。在 SUD 平台申请的唯一应用标识。
appKey	String	必填。在 SUD 平台申请的应用密钥。

2. SUDOPInitSDKListener

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

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

---

代码示例

// 执行初始化
SUDOP.initSDK(context, "YOUR_APP_ID", "YOUR_APP_KEY", 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 启动阶段调用。
• 幂等性：SDK 内部处理了重复初始化的逻辑，但通常建议仅在 App 生命周期内显式调用一次。
• 生命周期：初始化成功是调用 auth 和 startGame 系列接口的前提。

---