# 已弃用的 API 类

> 了解 Unity、Android 和 iOS 中已弃用的 Unity Ads SDK 类及其替换版本和移除版本。

## Unity (C#)##unity-(c)

Unity SDK 已弃用或废弃以下 API 类：

| **要移除的 API**                                 | **弃用版本** | **改用**                                                                                                                                                                                                                                                                             | **移除版本**                | **弃用原因**                     |
| -------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------------------- |
| `IsReady()`                                  | 不适用      | 使用更新的 [`Load`](/grow/ads/unity-sdk/unity-api.md#load) 方法签名来访问加载回调。                                                                                                                                                                                                                 | 4.0.0                   | 使用 `Load` 和 `Show` 功能时不再需要。  |
| `IsReady(string placementId)`                | 不适用      | 使用更新的 [`Load`](/grow/ads/unity-sdk/unity-api.md#load) 方法签名来访问加载回调。                                                                                                                                                                                                                 | 4.0.0                   | 使用 `Load` 和 `Show` 功能时不再需要。  |
| `AddListener(IUnityAdsListener listener)`    | 不适用      | 使用 [`Initialize`](/grow/ads/unity-sdk/unity-api.md#initialize)、[`Load`](/grow/ads/unity-sdk/unity-api.md#load) 和 [`Show`](/grow/ads/unity-sdk/unity-api.md#show) 方法的监听器。                                                                                                           | 4.0.0                   | 改进了 `Load` 和 `Show` API 的回调。 |
| `RemoveListener(IUnityAdsListener listener)` | 不适用      | 使用 [`Initialize`](/grow/ads/unity-sdk/unity-api.md#initialize)、[`Load`](/grow/ads/unity-sdk/unity-api.md#load) 和 [`Show`](/grow/ads/unity-sdk/unity-api.md#show) 方法的监听器。                                                                                                           | 4.0.0                   | 改进了 `Load` 和 `Show` API 的回调。 |
| `GetPlacementState()`                        | 不适用      | 无直接替换项。                                                                                                                                                                                                                                                                            | 4.0.0                   | 改进了 `Load` 和 `Show` API 的回调。 |
| `GetPlacementState(string placementId)`      | 不适用      | 无直接替换项。                                                                                                                                                                                                                                                                            | 4.0.0                   | 使用 `Load` 和 `Show` 功能时不再需要。  |
| `IUnityAdsListener`                          | 不适用      | 使用 [`IUnityAdsInitializationListener`](/grow/ads/unity-sdk/unity-api.md#iunityadsinitializationlistener)、[`IUnityAdsLoadListener`](/grow/ads/unity-sdk/unity-api.md#iunityadsloadlistener) 和 [`IUnityAdsShowListener`](/grow/ads/unity-sdk/unity-api.md#iunityadsshowlistener) 接口。 | 4.0.0                   | 改进了 `Load` 和 `Show` API 的回调。 |
| `Show()`                                     | 不适用      | 4.0.0                                                                                                                                                                                                                                                                              | 更新了 `Load` 和 `Show` 功能。 |                              |
| `ShowOptions.resultCallback`                 | 3.1.0    | 使用 [`IUnityAdsShowListener`](/grow/ads/unity-sdk/unity-api.md#iunityadsshowlistener) 接口回调。                                                                                                                                                                                         | 4.0.0                   | 更新了 `Load` 和 `Show` 功能。      |

## Android (Java)##android-(java)

Android SDK 已弃用或废弃以下 API 类：

| **要移除的 API**                                                                                                                                                                           | **弃用版本** | **改用**                                                                                                                                                                                                                                                                                       | **移除版本** | **弃用原因**                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------- |
| `initialize(final Activity activity, final String gameId, final IUnityAdsListener listener)`                                                                                           | 3.4.0    | 使用合并的[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                    | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId)`                                                                                                                             | 3.4.0    | 使用合并的[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                    | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final IUnityAdsInitializationListener initializationListener)`                                                               | 3.4.0    | 使用合并的[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                    | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final IUnityAdsListener listener, final boolean testMode)`                                                                   | 3.4.0    | 使用合并的[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                    | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final boolean testMode)`                                                                                                     | 3.4.0    | 使用合并[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                     | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final boolean testMode, final IUnityAdsInitializationListener initializationListener)`                                       | 3.4.0    | 使用合并的[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                    | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final IUnityAdsListener listener, final boolean testMode, final boolean enablePerPlacementLoad)`                             | 3.4.0    | 使用合并的[`initialize`](/grow/ads/android-sdk/android-api.md#initialize)方法签名。                                                                                                                                                                                                                    | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad)`                                                               | 3.4.0    | 使用合并的 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize) 方法签名。                                                                                                                                                                                                                  | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Activity activity, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad, final IUnityAdsInitializationListener initializationListener)` | 3.4.0    | 使用合并的 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize) 方法签名。                                                                                                                                                                                                                  | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Context context, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad)`                                                                 | 不适用      | 使用合并的 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize) 方法签名。                                                                                                                                                                                                                  | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `initialize(final Context context, final String gameId, final boolean testMode, final boolean enablePerPlacementLoad, final IUnityAdsInitializationListener initializationListener)`   | 不适用      | 使用合并的 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize) 方法签名。                                                                                                                                                                                                                  | 4.0.0    | 由合并的 `initialize` API 替换。    |
| `setListener(IUnityAdsListener listener)`                                                                                                                                              | 3.4.0    | 使用 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize)、\[`load`][`load`](/grow/ads/android-sdk/android-api.md#load) 和 \[`show`][`show`](/grow/ads/android-sdk/android-api.md#show) 方法的监听器。                                                                                       | 4.0.0    | 改进了 `Show` 和 `Load` API 的回调。 |
| `getListener()`                                                                                                                                                                        | 3.4.0    | 使用 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize)、[`load`](/grow/ads/android-sdk/android-api.md#load) 和 [`show`](/grow/ads/android-sdk/android-api.md#show) 方法的监听器。                                                                                                         | 4.0.0    | 改进了 `Show` 和 `Load` API 的回调。 |
| `addListener(IUnityAdsListener listener)`                                                                                                                                              | 不适用      | 使用 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize)、[`load`](/grow/ads/android-sdk/android-api.md#load) 和 [`show`](/grow/ads/android-sdk/android-api.md#show) 方法的监听器。                                                                                                         | 4.0.0    | 改进了 `Show` 和 `Load` API 的回调。 |
| `removeListener(IUnityAdsListener listener)`                                                                                                                                           | 不适用      |  使用 [`initialize`](/grow/ads/android-sdk/android-api.md#initialize)[`load`](/grow/ads/android-sdk/android-api.md#load) 和 [`show`](/grow/ads/android-sdk/android-api.md#show) 方法的监听器。                                                                                                         | 4.0.0    | 改进了 `Show` 和 `Load` API 的回调。 |
| `isReady()`                                                                                                                                                                            | 3.7.1    | 使用更新的 [`load`](/grow/ads/android-sdk/android-api.md#load) 方法签名来访问加载回调。                                                                                                                                                                                                                       | 4.0.0    | 引入了具有回调的 `Load` API。         |
| `isReady(String placementId)`                                                                                                                                                          | 3.7.1    | 使用更新的 [`load`](/grow/ads/android-sdk/android-api.md#load) 方法签名来访问加载回调。                                                                                                                                                                                                                       | 4.0.0    | 引入了具有回调的 `Load` API。         |
| `getPlacementState()`                                                                                                                                                                  | 不适用      | 无直接替换项。                                                                                                                                                                                                                                                                                      | 4.0.0    | 使用 `Load` 和 `Show` 功能时不再需要。  |
| `show(final Activity activity)`                                                                                                                                                        | 3.7.0    | 使用更新的 [`show`](/grow/ads/android-sdk/android-api.md#show) 方法签名来访问 show 回调。                                                                                                                                                                                                                   | 4.0.0    | 引入了具有回调的 `Show` API。         |
| `IUnityAdsListener`                                                                                                                                                                    | 不适用      | 使用 [`IUnityAdsInitializationListener`](/grow/ads/android-sdk/android-api.md#iunityadsinitializationlistener)、[`IUnityAdsLoadListener`](/grow/ads/android-sdk/android-api.md#iunityadsloadlistener)、[`IUnityAdsShowListener`](/grow/ads/android-sdk/android-api.md#iunityadsshowlistener) 接口。 | 4.0.0    | 改进了 `Show` 和 `Load` API 的回调。 |
| `IUnityAdsExtendedListener`                                                                                                                                                            | 不适用      | 使用 [`IUnityAdsShowListener`](/grow/ads/android-sdk/android-api.md#iunityadsshowlistener) 接口。                                                                                                                                                                                                 | 4.0.0    | 改进了 `Show` 和 `Load` API 的回调。 |
| `com.unity3d.services.monetization`                                                                                                                                                    | 不适用      | 使用 [`UnityAds.java`](/grow/ads/android-sdk/android-api.md#unityads) API。                                                                                                                                                                                                                     | 4.0.0    | 不支持旧版 `Monetization` API。    |
| `com.unity3d.services.purchasing`                                                                                                                                                      | 不适用      | 无直接替换项。                                                                                                                                                                                                                                                                                      | 4.0.0    | 不支持旧版 `Monetization` API。    |

## iOS (Objective-C)##ios-(objective-c)

iOS SDK 已弃用或废弃以下 API 类：

| **要移除的 API**                                                                                                                                                                                                                 | **弃用版本** | **改用**                                                                                                                                                                                                                                                           | **移除版本** | **弃用原因**                    |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------------------- |
| `UnityAdsDelegate`                                                                                                                                                                                                           | 不适用      | 使用 [`UnityAdsInitializationDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsinitializationdelegate)、[`UnityAdsLoadDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsloaddelegate) 和 [`UnityAdsShowDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsshowdelegate) 接口。 | 4.0.0    | 由合并的 `Initialize` API 替换。   |
| `UnityAdsDelegateUtil`                                                                                                                                                                                                       | 不适用      | 使用 [`UnityAdsInitializationDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsinitializationdelegate)、[`UnityAdsLoadDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsloaddelegate) 和 [`UnityAdsShowDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsshowdelegate) 接口。 | 4.0.0    | 由合并的 `Initialize` API 替换。   |
| `UADSInAppPurchaseMetaData`                                                                                                                                                                                                  | 不适用      | 无直接替换项；但是可以使用通用的 `MetaData` 类。                                                                                                                                                                                                                                   | 4.0.0    | 由合并的 `Initialize` API 替换。   |
| `UnityAdsExtendedDelegate`                                                                                                                                                                                                   | 不适用      | 使用 [`UnityAdsInitializationDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsinitializationdelegate)、[`UnityAdsLoadDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsloaddelegate) 和 [`UnityAdsShowDelegate`](/grow/ads/ios-sdk/ios-api.md#unityadsshowdelegate) 接口。 | 4.0.0    | 由合并的 `Initialize` API 替换。   |
| ```objective-c
initialize:(NSString *)gameId
delegate: (nullable id&#x3-c;-unity-ads-delegate>)
```                                                                                                                          | 3.4.0    | 使用合并的[`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)方法签名。                                                                                                                                                                                                | 4.0.0    | 由合并的 `Initialize` API 替换。   |
| ```objective-c
initialize:(NSString *)gameId
delegate: (nullable id&#x3-c;-unity-ads-delegate>)delegate
testMode(BOOL)testMode
```                                                                                           | 3.4.0    | 使用合并的[`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)方法签名。                                                                                                                                                                                                | 4.0.0    | 由合并的 Initialize API 替换。     |
| ```objective-c
initialize:(NSString *)gameId
delegate: (nullable id&#x3-c;-unity-ads-delegate>)delegate
testMode(BOOL)testMode
enablePerPlacementLoad: (BOOL)enablePerPlacementLoad
```                                      | 3.4.0    | 使用合并的[`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)方法签名。                                                                                                                                                                                                | 4.0.0    | 由合并的 Initialize API 替换。     |
| ```text
initialize:(NSString *)gameId
testMode(BOOL)testMode
enablePerPlacementLoad: (BOOL)enablePerPlacementLoad
```                                                                                                        | 3.4.0    | 使用合并的 [`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize) 方法签名。                                                                                                                                                                                              | 4.0.0    | 由合并的 `initialize` API 替换。   |
| ```text
initialize:(NSString *)gameId
testMode(BOOL)testMode
enablePerPlacementLoad: (BOOL)enablePerPlacementLoad
initializationDelegate: (nullable id&#x3-c;-unity-ads-initialization-delegate>)initializationDelegate;
``` | 3.4.0    | 使用合并的 [`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize) 方法签名。                                                                                                                                                                                              | 4.0.0    | 由合并的 `initialize` API 替换。   |
| `show: (UIViewController *)viewController`                                                                                                                                                                                   | 3.7.0    | 使用更新的 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法签名。                                                                                                                                                                                                          | 4.0.0    | 引入了具有回调的 `show` API。        |
| ```text
show:(UIViewController *)viewController
placementId(NSString *)placementId
```                                                                                                                                       | 3.7.0    | 使用更新的 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法签名。                                                                                                                                                                                                          | 4.0.0    | 引入了具有回调的 `show` API。        |
| ```text
show:(UIViewController *)viewController
placementId(NSString *)placementId
options(UADSShowOptions *)options
```                                                                                                     | 3.7.0    | 使用更新的 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法签名。                                                                                                                                                                                                          | 4.0.0    | 引入了具有回调的 `Show` API。        |
| `getDelegate`                                                                                                                                                                                                                | 3.4.0    | 使用 [`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)、[`load`](/grow/ads/ios-sdk/ios-api.md#load) 和 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法的委托接口。                                                                                                    | 4.0.0    | 使用 `Load` 和 `Show` 功能时不再需要。 |
| `setDelegate: (id&#x3-c;-unity-ads-delegate>)delegate`                                                                                                                                                                       | 3.4.0    |  使用 [`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)[`load`](/grow/ads/ios-sdk/ios-api.md#load) 和 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法的委托接口。                                                                                                    | 4.0.0    | 使用 `Load` 和 `Show` 功能时不再需要。 |
| `addDelegate: (__nullable id&#x3-c;-unity-ads-delegate>)delegate`                                                                                                                                                            | 3.7.0    |  使用 [`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)[`load`](/grow/ads/ios-sdk/ios-api.md#load) 和 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法的委托接口。                                                                                                    | 4.0.0    | 使用 `Load` 和 `Show` 功能时不再需要。 |
| `removeDelegate: (id&#x3-c;-unity-ads-delegate>)delegate;`                                                                                                                                                                   | 不适用      |  使用 [`Initialize`](/grow/ads/ios-sdk/ios-api.md#initialize)[`load`](/grow/ads/ios-sdk/ios-api.md#load) 和 [`show`](/grow/ads/ios-sdk/ios-api.md#show) 方法的委托接口。                                                                                                    | 4.0.0    | 使用 Load 和 Show 功能时不再需要。     |
| `isReady`                                                                                                                                                                                                                    | 3.7.1    | 使用更新的 [`load`](/grow/ads/ios-sdk/ios-api.md#load) 方法签名。                                                                                                                                                                                                          | 4.0.0    | 引入了具有回调的 `load` API。        |
| `isReady: (NSString *)placementId`                                                                                                                                                                                           | 3.7.1    | 使用更新的 [`load`](/grow/ads/ios-sdk/ios-api.md#load) 方法签名。                                                                                                                                                                                                          | 4.0.0    | 引入了具有回调的 `load` API。        |
| `getPlacementState`                                                                                                                                                                                                          | 不适用      | 无直接替换项。                                                                                                                                                                                                                                                          | 4.0.0    | 使用 `Load` 和 `Show` 功能时不再需要。 |
| `getPlacementState: (NSString *)placementId`                                                                                                                                                                                 | 不适用      | 无直接替换项。                                                                                                                                                                                                                                                          | 4.0.0    | 使用 `Load` 和 `Show` 功能时不再需要。 |
| 所有 `monetization` 类                                                                                                                                                                                                          | 3.4.0    | 使用 `UnityAdvertisement.h` 类。                                                                                                                                                                                                                                     | 4.0.0    | 不支持旧版 `Monetization` API。   |
| 所有 `purchasing` 类                                                                                                                                                                                                            | 3.4.0    | 无直接替换项。                                                                                                                                                                                                                                                          | 4.0.0    | 不支持旧版 `Monetization` API。   |
