简体中文

English

简体中文

English

外观

Android SDK 初始化 ​

初始化时机 ​

建议在 Application 类的 onCreate() 方法中初始化优聚智汇广告 SDK，确保在应用启动时就完成初始化，为后续的广告加载做好准备。

基本初始化 ​

1. SDK初始化 ​

kotlin
class MyApplication : Application() {
    val appViewModel: AppViewModel by lazy {
        AppViewModel(this)
    }

    companion object {
        // 单例实例
        lateinit var instance: MyApplication
            private set
    }

    override fun onCreate() {
        super.onCreate()
        // 保存单例实例
        instance = this

        // 初始化SDK
        initializeSdk()
    }
    
    /**
     * 初始化SDK
     */
    private fun initializeSdk() {
        // 创建配置对象
        val config = UjuAdInitConfig(
            appId = "YOUR_APP_ID", // 必填，应用ID
            appKey = "YOUR_APP_KEY",// 必填，应用KEY
            appName = "YOUR_APP_Name",//可选
            isDebug = true, // 调试模式，建议开发时才开启
            wxAppId = "wx_xxxxx" // 微信AppId，用于微信广告渠道
        )

        // 初始化
        UjuAdSdk.init(this, config)
        // 启动SDK并监听回调
        UjuAdSdk.start(object : BaseInitListener {
            override fun onInitSuccess() {
                // SDK启动成功，此时可以开始加载广告
                appViewModel.sdkInitialized.value = true
            }

            override fun onInitFailed(error: UjuException) {
                appViewModel.sdkInitialized.value = false
                DemoLogUtils.e("SDK初始化失败: ${error.message}")
            }
        })

    }
}

初始化状态检查 ​

您可以在任何时候检查 SDK 的初始化状态：

kotlin
// 检查 SDK 是否初始化成功
if (UjuAdSdk.isInitialized()) {
    // SDK 已初始化，可以加载广告
}

常见问题 ​

Q: 初始化失败怎么办？ ​

A: 初始化失败可能的原因：

  • 网络问题：检查网络连接是否正常
  • App ID/Key 错误：确认 App ID 和 App Key 是否正确
  • 设备限制：某些设备可能被限制访问
  • 版本问题：检查 SDK 版本是否兼容

Q: 如何提高初始化成功率？ ​

A: 建议：

  • 在应用启动时尽早初始化
  • 确保网络连接稳定
  • 避免在初始化过程中进行耗时操作
  • 正确处理初始化失败的情况

最佳实践 ​

  1. 尽早初始化：在 Application onCreate 中初始化
  2. 处理失败情况：添加失败回调，确保应用正常运行
  3. 测试模式：开发阶段使用测试设备和测试广告
  4. 监控初始化：在生产环境中监控初始化成功率
  5. 版本管理：及时更新 SDK 版本

下一步 ​

完成 SDK 初始化后，您可以开始集成具体的广告类型：