# 9.0.0 API 更改

> LevelPlay Unity SDK 9.0.0 中引入的 API 更改的详细列表。

作为原生 SDK 9.0.0 版本的一部分，我们将删除一些 API 并弃用一些现有的监听器和回调。您可以在下面找到详细的更改列表：

本文总结了 LevelPlay Unity SDK 9.0.0 版本中引入的主要 API 更改。有关完整的迁移过程，请参阅[迁移到 9.0.0+ 指南](/grow/levelplay/sdk/unity/migrate-to-9-0-0.md)。

## 9.0.0 中的关键 API 更改##key-api-changes-in-9.0.0

* 为了清晰和一致，所有面向公众的 API 已从 `IronSource` 重构为 `LevelPlay`。
* 已删除已弃用的 API。请参阅 SDK 文档以查看已删除方法的完整列表。
* `LevelPlay.Init`方法已简化，删除了广告格式参数。
* 现在使用新的配置类来创建广告单位。
* `OnAdDisplayFailed`事件现在提供了不同的`LevelPlayAdInfo`和`LevelPlayAdError`参数。

## 迁移注意事项##migration-notes

* 从低于 9.0.0 的版本升级需要额外的迁移步骤。请参阅[迁移指南](/grow/levelplay/sdk/unity/migrate-to-9-0-0.md)。
* 检查并更新所有广告格式集成（奖励、插页式、横幅）以确保兼容性。

## 从 9.0.0 中删除了 Unity 的 API##apis-removed-from-9.0.0-for-unity

### 初始化##init

|     | 旧版 – 已弃用                 | 新建                                |
| --- | ------------------------ | --------------------------------- |
| API | Ironsource.init          | LevelPlay.Init                    |
|     | setUserID                | 应设置为 LevelPlayInitRequest 构建器的一部分 |
| 事件  | onInitializationComplete | OnInitSuccess                     |

### 奖励视频##rewarded

|     | 旧版 – 已弃用                       | New（广告单元 LevelPlayRewardedAd）                                    |
| --- | ------------------------------ | ---------------------------------------------------------------- |
| 监听器 | IronsourceRewardedVideoEvents  | LevelPlayRewardedAd                                              |
| API | loadRewardedVideo              | LoadAd                                                           |
|     | showRewardedVideo              | ShowAd                                                           |
|     | isRewardedVideoAvailable       | IsAdReady                                                        |
|     | isRewardedVideoPlacementCapped | IsPlacementCapped                                                |
|     | setRewardedVideoServerParams   | LevelPlay.SetMetaData, key:”LevelPlay\_Rewarded\_Server\_Params” |
|     | clearRewardedVideoServerParams | LevelPlay.SetMetaData, key:”LevelPlay\_Rewarded\_Server\_Params” |
| 事件  | onAdReadyEvent                 | OnAdLoaded                                                       |
|     | onAdLoadFailedEvent            | OnAdLoadFailed                                                   |
|     | onAdOpenedEvent                | OnAdDisplayed                                                    |
|     | onAdClosedEvent                | OnAdClosed                                                       |
|     | onAdShowFailedEvent            | OnAdDisplayFailed                                                |
|     | onAdRewardedEvent              | OnAdRewarded                                                     |
|     | onAdClickedEvent               | OnAdClicked                                                      |
|     | onAdShowSucceededEvent         | —                                                                |

### 插页式视频##interstitial

|     | 旧版 – 已弃用                      | 新建                      |
| --- | ----------------------------- | ----------------------- |
| 监听器 | IronSourceInterstitialEvents  | LevelPlayInterstitialAd |
| 事件  | onAdReadyEvent                | OnAdLoaded              |
|     | onAdLoadFailedEvent           | OnAdLoadFailed          |
|     | onAdOpenedEvent               | OnAdDisplayed           |
|     | onAdClosedEvent               | OnAdClosed              |
|     | onAdShowSucceededEvent        | —                       |
|     | onAdShowFailedEvent           | OnAdDisplayFailed       |
|     | onAdClickedEvent              | OnAdClicked             |
| API | LoadInterstitial              | LoadAd                  |
|     | ShowInterstitial              | ShowAd                  |
|     | IsInterstitialPlacementCapped | IsPlacementCapped       |
|     | IsInterstitialReady           | IsAdReady               |

### 横幅广告##banners

|     | 旧版 – 已弃用                            | 新建（广告单元 LevelPlayBannerAd）                                             |
| --- | ----------------------------------- | ---------------------------------------------------------------------- |
| 监听器 | IronSourceBannerEvents              | LevelPlayBannerAd                                                      |
| 事件  | onAdLoadedEvent                     | OnAdLoaded                                                             |
|     | onAdLeftApplicationEvent            | OnAdLeftApplication                                                    |
|     | onAdScreenDismissedEvent            | —                                                                      |
|     | onAdScreenPresentedEvent            | OnAdDisplayed                                                          |
|     | onAdClickedEvent                    | OnAdClicked                                                            |
|     | onAdLoadFailedEvent                 | OnAdLoadFailed                                                         |
| API | IronSourceBannerLayout.createBanner | LevelPlayBannerAdView(context, “adUnitId”)                             |
|     | loadBanner                          | LoadAd                                                                 |
|     | destroyBanner                       | DestroyAd                                                              |
|     | displayBanner                       | ShowAd                                                                 |
|     | hideBanner                          | HideAd                                                                 |
|     | IronSourceBannerPosition            | LevelPlayBannerPosition.TopCenter LevelPlayBannerPosition.BottomCenter |
|     | IronSourceBannerSize                | LevelPlayAdSize                                                        |

### 横幅大小##banner-sizes

| 旧版                   | 广告单元（新）         | dp 中的尺寸                   |
| -------------------- | --------------- | ------------------------- |
| IronSourceBannerSize | LevelPlayAdSize | （Width X Height）          |
| BANNER               | BANNER          | 320 x 50                  |
| 大型                   | 大型              | 320 x 90                  |
| 矩形                   | 中矩形             | 300 x 250                 |
| SMART                | 替换为自适应广告大小（见下文） | 自动渲染广告服务以调整移动端和平板电脑的大小和方向 |

### 设置##settings

|     | 旧版 – 已弃用                                           | 新建                                               |
| --- | -------------------------------------------------- | ------------------------------------------------ |
| API | IronSource.pluginVersion                           | LevelPlay.PluginVersion                          |
|     | IronSource.unityVersion                            | LevelPlay.UnityVersion                           |
|     | IronSource.Agent.validateIntegration               | LevelPlay.ValidateIntegration                    |
|     | IronSource.Agent.setDynamicUserId                  | LevelPlay.SetDynamicUserId                       |
|     | IronSource.Agent.setAdaptersDebug                  | LevelPlay.SetAdaptersDebug                       |
|     | IronSource.Agent.setMetaData                       | LevelPlay.SetMetaData                            |
|     | IronSource.Agent.setNetworkData                    | LevelPlay.SetNetworkData                         |
|     | IronSource.Agent.SetPauseGame                      | LevelPlay.SetPauseGame                           |
|     | IronSource.Agent.launchTestSuite                   | LevelPlay.LaunchTestSuite                        |
|     | IronSource.Agent.setConsent                        | LevelPlay.SetConsent                             |
|     | IronSource.Agent.setSegment                        | LevelPlay.SetSegment                             |
|     | onApplicationPause                                 | —（此 API 从本机调用 onPause/onResume。暂停/恢复现在从生命周期中获取。) |
|     | getAdvertiserId                                    | —                                                |
|     | shouldTrackNetworkState                            | —                                                |
|     | getPlacementInfo                                   | —                                                |
|     | isBannerPlacementCapped                            | —                                                |
|     | getMaximalAdaptiveHeight                           | —                                                |
|     | getDeviceScreenWidth                               | —                                                |
| 类   | IronSourceSegment                                  | LevelPlaySegment                                 |
|     | IronSourceError                                    | LevelPlayAdError                                 |
|     | IronSourceImpressionData                           | LevelPlayImpressionData                          |
|     | IronSourceConfig                                   | —                                                |
|     | IronSourcePlacement                                | —                                                |
|     | IronSourceUtils                                    | —                                                |
|     | WaterfallConfiguration                             | —                                                |
| 事件  | IronSourceEvents.onImpressionDataReadyEvent        | LevelPlay.OnImpressionDataReady（SDK 8.10.1+ 支持）  |
|     | IronSourceEvents.onSdkInitializationCompletedEvent | LevelPlay.OnInitSuccess                          |
|     | onSegmentReceivedEvent                             | —                                                |

有关更多详细信息，请参阅[变更日志](/grow/levelplay/sdk/unity/changelog.md)。