# 迁移到 LevelPlay Init API

> 从 SDK 8.4.0 版开始，过过渡 LevelPlay 初始化 API 以支持新的广告单元 API，SDK 9.0.0+ 版需要这些 API。

本指南介绍在过渡到新的广告单元 API 时如何初始化 LevelPlay。

## 先决条件##prerequisites

支持的最低 SDK 为 8.4.0。您可以通过在 Unity Package Manager 中安装最新的广告服务聚合软件包、从 Network Manager 升级或按照[此处](/grow/levelplay/sdk/unity/package-integration.md)的说明下载最新的 SDK。

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

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

1. 删除以前引用旧版 Ironsource API 的回调和广告格式。
2. 实现初始化成功和失败的回调。
3. 使用 appKey 和用户 ID（如果相关）调用 LevelPlay init API。
4. 创建[横幅广告](/grow/levelplay/sdk/unity/banner-integration.md)、[插页式](/grow/levelplay/sdk/unity/interstitial-integration.md)广告和[奖励](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md)广告对象。

在 C# 脚本的顶部，添加 `using Unity.Services.LevelPlay;`。然后在 MonoBehaviour 的 `Start()` 方法中注册监听器并初始化 SDK：

1. **C#**

   ```csharp
   void Start()
   {
       // 注册 OnInitSuccess 和 OnInitFailed 监听器
       LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent;
       LevelPlay.OnInitFailed += SdkInitializationFailedEvent;
       // 使用 appKey 和用户 ID（如果相关）调用 LevelPlay init API
       LevelPlay.Init("YOUR_APPKEY", "UserId");
   }
   ```

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

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

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

|     | 旧版                       | 广告单元（新）        |
| --- | ------------------------ | -------------- |
| 类   | IronSource               | LevelPlay      |
| API | init                     | 初始化            |
| API | setUserID                | 应设置为 Init 的一部分 |
| 回调  | onInitializationComplete | OnInitSuccess  |
|     | -                        | OnInitFailed   |

## LevelPlay 演示场景/示例 app##levelplay-demo-scene/sample-app

Unity Demo 场景/示例应用程序演示了如何在 app 中集成 Ad Unit API。在 Unity Package Manager [软件包详细信息](https://docs.unity3d.com/Manual/upm-ui-details.html)视图中，转到 Samples 并导入 LevelPlay Sample。

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