# 迁移到 LevelPlay Init API

> 通过更新 SDK 初始化以支持多个广告单元 API（包括插页式、横幅式和奖励广告服务），方便迁移到 ironSource Android app 中的 LevelPlay 初始化 API。

本指南介绍如何过过渡 LevelPlay 初始化 API 以允许使用多个广告单元 API。

## 先决条件##prerequisites

支持的最低 SDK 为 8.4.0。您可以在[此处](/grow/levelplay/sdk/android/sdk-integration.md)下载最新的 SDK。

## 初始化 SDK##initialize-the-sdk

要初始化 LevelPlay SDK，请执行以下步骤：

1. 实现初始化成功和失败的回调。
2. 使用 appKey 和用户 ID（如果相关）调用 LevelPlay init API。

1) **Java**

   ```java
   LevelPlayInitRequest initRequest = new LevelPlayInitRequest.Builder(appKey)
           .withUserId("UserID")
           .build();

   LevelPlayInitListener initListener = new LevelPlayInitListener() { }
       @Override
       public void onInitFailed(@NonNull LevelPlayInitError error) {
           // Recommended to initialize again
       }
       @Override
       public void onInitSuccess(LevelPlayConfiguration configuration) {
           // Create ad objects and load ads
       }
   };
   LevelPlay.init(context, initRequest, initListener);
   ```

2) **Kotlin**

   ```kotlin
   val initRequest = LevelPlayInitRequest.Builder("AppKey")
           .withUserId("UserId")
           .build()

   LevelPlay.init(context, initRequest, object :LevelPlayInitListener {
       覆盖 fun onInitFailed（报错：LevelPlayInitError) {
           // Recommended to initialize again
       }
       覆盖 fun onInitSuccess(configuration:LevelPlayConfiguration) {
           // Create ad objects and load ads
       }
   })
   ```

## LevelPlay 初始化监听器##levelplay-init-listeners

`OnInitSuccess` – 初始化成功完成时触发。收到此指示后，您可以创建和加载广告。

`OnInitFailed` – 未成功检索配置，无法加载广告服务。建议稍后尝试并初始化 LevelPlay SDK（当互联网连接可用或故障原因得到解决时）。

|     | 旧版                       | 广告单元（新）                           |
| --- | ------------------------ | --------------------------------- |
| 类   | IronSource               | LevelPlay                         |
| API | init                     | init                              |
|     | setUserID                | 应设置为 LevelPlayInitRequest 构建器的一部分 |
| 回调  | onInitializationComplete | onInitSuccess                     |
|     | -                        | onInitFailed                      |

## LevelPlay 聚合演示应用程序##levelplay-mediation-demo-app

Integration Demo 应用程序演示如何在 app 中集成 Ad Unit API。

[下载相关的演示应用程序](https://github.com/ironsource-mobile/Mediation-Demo-Apps)。

您现在可以实现新的广告单位 API。