# 迁移到 LevelPlay Init API

> 从 SDK 8.4.0 版开始，过过渡 LevelPlay 初始化 API 以支持多个广告单元 API。

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

## 先决条件##prerequisites

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

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

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

1. 使用 appKey 和用户 ID（如果相关）调用 LevelPlay init API。
2. 定义完成处理程序的成功和失败。

1) **Objective-C**

   ```objective-c
       // 使用 app 密钥创建请求构建器。添加 User ID（如果可用）。
       LPMInitRequestBuilder *requestBuilder = [[LPMInitRequestBuilder alloc] initWithAppKey:@"appKey"];
       [requestBuilder withUserId:@"UserId"];

       // Build the initial request
       LPMInitRequest *initRequest = [requestBuilder 构建];
       // Initialize LevelPlay with the prepared request
       [LevelPlay initWithRequest:initRequest 完成：^(LPMConfiguration *_Nullable 配置，NSError *_Nullable 报错){
           if(error) {
               // There was an error on initialization.采取必要的操作或重试。
           } else {
           // Initialization was successful.现在可以创建广告对象和加载广告服务。
           }
       }];
   ```

2) **Swift**

   ```swift
       // 使用 app 密钥创建请求构建器。添加 User ID（如果可用）。
       let requestBuilder = LPMInitRequestBuilder(appKey："appKey")
               .withUserId("UserId")
       // 构建初始请求
       let initRequest = requestBuilder.build()
       // 使用准备好的请求初始化 LevelPlay 
       LevelPlay.initWith(initRequest) 
       { config，报错
           if let error = error {
               // 初始化时报错。采取必要的操作或重试。
           } else {
               // 初始化成功。现在可以创建广告对象和加载广告服务。
       }
   }
   ```

## 初始化结果##initialization-result

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

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

|     | 旧版                       | 广告单元（新）                         |
| --- | ------------------------ | ------------------------------- |
| 类   | IronSource               | LevelPlay                       |
| API | initWithAppKey           | initWithRequest                 |
|     | setUserID                | 应设置为 LPMInitRequestBuilder 的一部分 |
| 回调  | onInitializationComplete | 完成                              |
|     | -                        | error                           |

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

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

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

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