> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日志

> Unity SDK 发布历史

## \[4.1.7] - 2026-07-02

### 新功能

* 新增按请求的底价（bid floor）覆盖 API，使发布商可以通过 SDK 竞价管道发送请求范围的底价控制

### SDK 更新

* 将 Android SDK 从 4.1.5 更新至 4.1.7 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#417---2026-06-25)
* 将 iOS SDK 从 3.4.5 更新至 3.4.6 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#346---2026-06-29)

## \[4.1.5] - 2026-06-20

### SDK 更新

* 将 Android SDK 从 4.1.3 更新至 4.1.5 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#415---2026-06-19)
* 将 iOS SDK 从 3.4.2 更新至 3.4.5 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#345---2026-06-12)
* 新增 Android 和 iOS 的 Pangle 适配器支持
* 新增 Android 的 MobileFuse 适配器支持

## \[4.1.3] - 2026-06-01

### SDK 更新

* 将 Android SDK 从 4.1.1 更新至 4.1.3 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#413---2026-05-31)
* 将 iOS SDK 从 3.4.1 更新至 3.4.2 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#342---2026-05-29)
* 新增 Android 和 iOS 的 Google Waterfall 和 Digital Turbine 适配器支持

## \[4.1.0] - 2026-05-27

### 新功能

* 新增 `CloudXSdk.Arbiter(bids, onCompleted)`，支持在 Unity 中发起 Trusted Arbiter 竞价
* 新增 `SetBannerExtraParameter(adUnitId, key, value)`、`SetMRecExtraParameter(adUnitId, key, value)`、`SetInterstitialExtraParameter(adUnitId, key, value)` 和 `SetRewardedExtraParameter(adUnitId, key, value)`，可为各广告格式传递网络特定参数

### SDK 更新

* 将 Android SDK 从 4.0.0 更新至 4.1.1 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#411---2026-05-27)
* 将 iOS SDK 从 3.2.0 更新至 3.4.1 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#341---2026-05-27)
* 新增 Android 和 iOS 的 Moloco 和 Verve 适配器支持

## \[4.0.0] - 2026-04-28

### 新功能

* 新增 Unity Package Manager（UPM）消费支持，使 SDK 可在内部 UPM 包中被引用。运行时和编辑器脚本现在通过程序集定义文件（`CloudX.Sdk` 与 `CloudX.Sdk.Editor`）发布。
* 移除对 `Newtonsoft.Json` 的运行时依赖。SDK 不再要求项目中存在 `com.unity.nuget.newtonsoft-json`。

### SDK 更新

* 将 Android SDK 从 3.2.0 更新至 4.0.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#400---2026-04-28)

## \[3.2.0] - 2026-04-24

### 新功能

* Unity API 新增 `DestroyInterstitial(adUnitId)` 和 `DestroyRewarded(adUnitId)`，可显式销毁并清理全屏广告实例

### SDK 更新

* 将 Android SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#320---2026-04-24)
* 将 iOS SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#320---2026-04-22)
* 新增 Android 和 iOS 的 Magnite 适配器支持

## \[3.1.0] - 2026-04-17

### 新功能

* 收益回调现在会在 Android 和 iOS 上立即触发，并且可能不在 Unity 主线程上执行

### 集成说明

* 不要在 `OnAdRevenuePaid` 中直接操作 Unity 场景或 UI API。如有需要，请先切回主线程。

### SDK 更新

* 将 Android SDK 从 3.0.0 更新至 3.1.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#310---2026-04-17)
* 将 iOS SDK 从 2.2.8 更新至 3.1.0 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#310---2026-04-16)

## \[3.0.0] - 2026-04-06

### SDK 更新

* 将 Android SDK 从 2.2.7 更新至 3.0.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#300---2026-04-06)
* 将 iOS SDK 从 2.2.7 更新至 2.2.8 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#228---2026-04-03)

## \[2.2.7] - 2026-04-02

### 新功能

* 通过更新后的 Android SDK，新增一方指标遥测在更多 SDK 调用链路中的覆盖
* 通过更新后的 iOS SDK，修复 Banner 在延迟初始化后无法显示的问题，并提升 Vungle 适配器的运行时稳定性

### 集成说明

* `2.2.6` 引入的 Unity 集成流程以及 Banner / MREC 的 placement 与 customData 调用顺序在本次发布中保持不变

### SDK 更新

* 将 Android SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#227---2026-04-02)
* 将 iOS SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#227---2026-04-01)

## \[2.2.6] - 2026-04-01

### 新功能

* 通过更新后的 Android 和 iOS SDK，为全屏广告适配器新增 `isAdReady` 支持
* 通过更新后的 iOS SDK，新增 Unity Ads 隐私同意转发支持

### 集成说明

* 对于 Unity Banner 和 MREC 广告，如果希望首次请求就带上 `placement` 和 `customData`，请在调用 `CreateBanner(...)` 或 `CreateMrec(...)` 之前先调用 `SetBannerPlacement(...)` / `SetBannerCustomData(...)` 和 `SetMrecPlacement(...)` / `SetMrecCustomData(...)`

### SDK 更新

* 将 Android SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#226---2026-04-01)
* 将 iOS SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#226---2026-03-30)

## \[2.2.4] - 2026-03-27

### 新功能

* 新增 `SetHasUserConsent(bool?)` 和 `SetDoNotSell(bool?)`，可在初始化前手动设置隐私覆盖值
* 新增 iOS 后处理逻辑：当应用尚未定义 `NSUserTrackingUsageDescription` 时，会自动写入该字段

### 修复

* 修复 Android Banner 视图初始化行为：新创建的 Banner 视图默认保持隐藏，直到您调用显示
* 修复 iOS 插屏和激励广告的展示失败回调，`OnAdShowFailed` 现在会同时返回失败的 `CloudXAd` 和对应的 `CloudXError`，与 Unity 回调约定保持一致
* 更新 Unity Demo：Banner 和 MREC 仅初始化一次，并在全屏广告加载失败或展示失败后自动重试

### SDK 更新

* 将 Android SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#224---2026-03-26)
* 将 iOS SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#224---2026-03-26)

## \[2.2.3] - 2026-03-23

### SDK 更新

* 将 Android SDK 从 2.2.2 更新至 2.2.3 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#223---2026-03-20)
* 将 iOS SDK 从 2.2.2 更新至 2.2.3 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#223---2026-03-19)
* 新增 Android 和 iOS 的 Unity Ads 适配器支持

## \[2.2.2] - 2026-03-17

### SDK 更新

* 将 Android SDK 从 2.2.1 更新至 2.2.2 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#222---2026-03-17)
* 将 iOS SDK 从 2.0.0 更新至 2.2.2 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#222---2026-03-16)
* 将 iOS 最低部署目标从 15.0 降低至 13.0
* 新增 Mintegral 适配器支持（Android + iOS）

## \[2.2.1] - 2026-03-11

### SDK 更新

* 将 Android SDK 从 2.2.0 更新至 2.2.1 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#221---2026-03-11)
* 新增 Mintegral 适配器及 Maven 仓库（Android）

## \[2.2.0] - 2026-03-10

### SDK 更新

* 将 Android SDK 从 2.0.1 更新至 2.2.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#220---2026-03-10)

## \[2.0.1] - 2026-03-04

此补丁版本增加了对 Unity Engine 2022.3 的完整兼容性。

### 兼容性

* 新增对 Unity Engine 2022.3 LTS 的支持

### SDK 更新

* 将 Android SDK 从 2.0.0 更新至 2.0.1 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#201---2026-03-04)

## \[2.0.0] - 2026-02-05

### 重大变更

* 横幅广告和 MREC 广告在创建后不再自动加载。现在必须在 `CreateBanner()` 或 `CreateMrec()` 之后显式调用 `LoadBanner()` 或 `LoadMrec()`
* `CloudXAd` 属性重命名：
  * `PlacementName` 更名为 `AdUnitId`
  * `BidderName` 更名为 `NetworkName`

### 新功能

* 为所有广告格式添加了广告位和自定义数据支持：
  * `SetBannerPlacement(adUnitId, placement)` 和 `SetBannerCustomData(adUnitId, customData)`
  * `SetMRecPlacement(adUnitId, placement)` 和 `SetMRecCustomData(adUnitId, customData)`
  * `ShowInterstitial(adUnitId, placement?, customData?)` 现在接受可选的广告位和自定义数据参数
  * `ShowRewarded(adUnitId, placement?, customData?)` 现在接受可选的广告位和自定义数据参数
* 新增 `CloudXAd` 属性：`AdFormat`、`Placement`、`NetworkPlacement`

### SDK 更新

* 将 Android SDK 从 0.12.1 更新至 2.0.0
* 将 Android 适配器从 0.12.1 更新至 2.0.0
* 将 iOS CloudXCore 从 1.3.0 更新至 2.0.0
* 将 iOS CloudXRenderer 从 1.3.0 更新至 2.0.0
* 将 iOS 适配器从 1.3.0 更新至 2.0.0

## \[0.12.1] - 2026-01-15

### 新功能

* 新增对 iOS 平台的支持

### 性能改进

* Android：BidToken 现在在后台线程生成，提升了性能

### SDK 更新

* 将 Android SDK 从 0.12.0 更新至 0.12.1

### 改进

* 重命名内部 `UnityMainThreadDispatcher` 类，避免与第三方包命名空间冲突

## \[0.12.0] - 2025-12-15

CloudX Unity SDK 初始发布