# Unity Ads SDK 变更日志 > 为原生 iOS 和 Android 开发者追踪 Unity Ads SDK 版本发布，以便他们集成该 SDK 实现应用变现。请参阅相应版本的新功能、变更和错误修复的详细信息。 > **Note:** > > 从 2026 年 4 月 1 日开始，通过广告旧版软件包直接集成使用 Unity Ads 进行变现的应用可能会降低广告效果。为避免性能下降，请切换到将 Unity Ads 集成为出价者。 > > Unity Ads 网络将继续支持所有使用直接集成的应用程序并提供填充。但是，为了最大限度提高收入和效果，建议的最佳做法是为 Unity 的广告聚合平台 LevelPlay [安装广告服务](/grow/levelplay/sdk/unity/package-integration.md.md)聚合软件包。 ## 4.20.0 版本 - 2026-08-14 发布##version-4.20.0---released-2026-08-14 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Android | * 提高了广告加载的可靠性和整体性能。 * 修复了 Android 8 上的崩溃问题，并减少了“应用无响应”(ANR) 错误。 * 增加了对带有 R8 代码缩减功能的 Android Gradle Plugin 9 的支持。如果您正在升级或计划升级到带有 isMinifyEnabled = true 的 Android Gradle Plugin 9 / AGP 9，请安装 Unity Ads SDK 4.20.0。如果您在使用低于 4.20.0 的 Unity Ads SDK 版本配合带有 isMinifyEnabled = true 的 Android Gradle Plugin 9，则必须 将所需的保留规则添加到您自己的 ProGuard 配置中，否则 Unity 的诊断和操作事件将在 R8 下被静默丢弃。 | | iOS | - 提高了广告加载的可靠性和整体性能。 - 修复了当上一个广告周期的产品页仍处于打开状态时，再次呈现 App Store 产品页导致的崩溃问题，以及其他稳定性修复。 | ## 4.19.0 版本 - 2026-06-26 发布##version-4.19.0---released-2026-06-26 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------------------------------- | | Android | * 将 Kotlin 升级至 2.1.x。 * 修复了错误并进行了稳定性改进。直接集成发布商：请参阅 Unity Ads 4.19.0 Android API 参考，以了解 Java 和 Kotlin 中已弃用的 API。 | | iOS | - 修复了错误并进行了稳定性改进。直接集成发布商：请参阅 Unity Ads 4.19.0 iOS API 参考，以了解 Swift 和 Objective-C 中已弃用的 API。 | | Unity | * 修复了隐私 API 以实现优雅处理。 | ## 4.18.1 版本 - 2026-05-28 发布##version-4.18.1---released-2026-05-28 | **平台** | **注意** | | ------- | --------------- | | Android | * 没有变化。 | | iOS | - 修复了一个罕见的崩溃问题。 | ## 4.18.0 版本 - 2026-05-06 发布##version-4.18.0---released-2026-05-06 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------ | | Android | * 改进了诊断和可观测性。 * 提高了广告加载的可靠性和整体性能。 | | iOS | - 减少了在运行 iOS 18 以下版本的设备上的崩溃。 - 将构建 iOS SDK 所需的最低 Xcode 版本更新为 26.0.1。 - 改进了诊断和可观测性。 - 提高了广告加载的可靠性和整体性能。 | ## 4.17.0 版本 - 2026-03-04 发布##version-4.17.0---released-2026-03-04 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Android | * 为 Kotlin 和 Java 添加了新的测试版公共 API。有关更新后的 Unity Ads 隐私 API 的详细信息，请参阅 [Beta privacy API update guide](/grow/ads/privacy/beta-privacy-api/unity-ads-sdk-beta-privacy-api-update-guide.md)。 | | iOS | - 为 Swift 和 Objective-C 添加了新的测试版公共 API。有关更新后的 Unity Ads 隐私 API 的详细信息，请参阅 [Beta privacy API update guide](/grow/ads/privacy/beta-privacy-api/unity-ads-sdk-beta-privacy-api-update-guide.md)。 - 降低了网络请求期间的内存使用量。 | | Unity | * 在 Unity 编辑器 6.5 中增加了对新 Swift Xcode 项目类型的支持。 | ## 4.16.6 版本 - 2026-01-22 发布##version-4.16.6---released-2026-01-22 | **平台** | **注意** | | ------- | ------------------------------ | | Android | * 优化了 ANR 处理，从而提升部分低内存设备上的稳定性。 | | iOS | - 没有变化。 | ## 4.16.5 版本 - 2025-12-04 发布##version-4.16.5---released-2025-12-04 | **平台** | **注意** | | ------- | ---------------------------------------------------------------------- | | Android | * 提升了低内存设备上的性能。 * 改进了横幅广告行为，防止全屏切换。 * 修复了在无法访问 Play 应用商店的设备上可能发生崩溃的问题。 | | iOS | - 没有变化。 | ## 4.16.4 版本 - 2025-11-14 发布##version-4.16.4---released-2025-11-14 | **平台** | **注意** | | ------- | --------------------------------------------------------------- | | Android | * 修复了低内存设备上因内存不足导致的崩溃问题，提升应用稳定性。 * 修复了广告交互过程中返回按钮可能出现异常行为的问题。 | | iOS | - 改进了应用内购 (IAP) 事件处理。 | | Unity | * 修复了在使用 Unity 编辑器 6.0 或更高版本且仅集成 Unity Ads 的项目中导致横幅广告无法正确刷新的问题。 | ## 4.16.3 版本 - 2025-10-10 发布##version-4.16.3---released-2025-10-10 | **平台** | **注意** | | ------- | ------------------------ | | Android | * 优化了初始化期间检测到问题时使用的回退逻辑。 | | iOS | - 没有变化。 | ## 4.16.2 版本 - 2025-10-02 发布##version-4.16.2---released-2025-10-02 | **平台** | **注意** | | ------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Android | * 更新了横幅 API 以改善与聚合平台的兼容性，从而实现更流畅的横幅集成。 * 更新了 Google Play Billing Library v8 的应用内购支持，从而确保交易更顺畅。 * 修复了 Open Measurement 影响程序化广告系列的错误。 | | iOS | - 为已集成积分墙 SDK 的应用启用了积分墙广告。 | ## 4.16.1 版本 - 2025-08-13 发布##version-4.16.1---released-2025-08-13 | **平台** | **注意** | | ------- | -------------------------- | | Android | * 减少了 Unity Ads SDK 初始化时间。 | | iOS | - 减少了 Unity Ads SDK 初始化时间。 | ## 4.16.0 版本 - 2025-07-23 发布##version-4.16.0---released-2025-07-23 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------ | | Android | * 改进了处理方式以确保广告在应用屏幕关闭后可以正确展示。 * 添加了使 Android 发行商能够使用 Unity Ads 推广积分墙的功能。 | | iOS | - 将最低目标 iOS 版本升级到了 13。 | ## 4.15.1 版本 - 2025-07-02 发布##version-4.15.1---released-2025-07-02 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------ | | Android | * 修复了可能拒绝在会话中展示后续广告的广告生命周期问题。 * 更新了 Proguard 使用者文件以改进 Acquire Optimizations（投放优化）支持。 | ## 4.15.0 版本 - 2025-05-28 发布##version-4.15.0---released-2025-05-28 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Android | * 添加了对 [Android 内容全屏显示](https://developer.android.com/develop/ui/views/layout/edge-to-edge)功能的支持。 * 新增了支持广告格式的 `getToken` API。通过提供广告格式，可以优化广告加载流程，从而加快广告投放速度。 * 改进了资源内存使用方式。 * 改进了错误处理。 * 修复了低端设备上的流式广告性能问题。 | | iOS | - 新增了支持广告格式的 `getToken` API。通过提供广告格式，可以优化广告加载流程，从而加快广告投放速度。 - 优化了 `Show` 错误消息以提高聚合错误消息的一致性。 - 改进了资源内存使用方式。 - 修复了在没有广告展示时出现的错误消息 `Cannot show the ad while another is already being shown` 的行为。 | > **Note:** > > 2025 年 4 月 24 日或之后在 Apple App Store 中发布或更新应用程序的 iOS 应用发行商需要更新到最低 Xcode 版本 16.1。如需了解更多信息，请参阅 Apple 对于上传到 App Store Connect 的应用程序的 > > [SDK 最低要求](https://developer.apple.com/news/upcoming-requirements/?id=02212025a) > > 。 ## 4.14.2 版本 - 2025-04-16 发布##version-4.14.2---released-2025-04-16 | **平台** | **注意** | | ------- | ----------------------------------------------------------- | | Android | * 重构并优化了信号收集系统以提高性能。 * 改进了对某些广告平台 A/B 测试方案的支持。 | | iOS | - 添加了防护措施以防止一些 iOS 应用中出现某种影响到用户获取功能改进的问题。 - 修复了影响横幅错误报告的问题。 | ## 4.14.1 版本 - 2025-03-24 发布##version-4.14.1---released-2025-03-24 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------------------------------------------------- | | Android | * 增强了发行商极端情况下的错误报告机制。 * 将 Protobuf 依赖关系从 v3.21.12 升级到 v3.25.6 以解决[已知的安全漏洞](https://access.redhat.com/security/cve/cve-2024-7254)。 | | iOS | - 没有变化。 | > **Important:** > > 强烈建议所有 Android 发行商将其 Protobuf 版本更新到 > 3.25.6 或更高版本以免出现安全问题。 ## 4.14.0 版本 - 2025-03-11 发布##version-4.14.0---released-2025-03-11 | **平台** | **注意** | | ------- | --------------------- | | Android | * 添加了从视频广告位中推广积分墙的功能。 | | iOS | - 没有变化。 | > **Note:** > > 请联系您的客户经理或 [Unity Ads 支持部门](https://support-ads.unity.com/s/ContactUs)以详细了解如何在视频广告位中推广积分墙。 ## 4.13.2 版本 - 2025-02-25 发布##version-4.13.2---released-2025-02-25 | **平台** | **注意** | | ------- | ------------------ | | Android | * 没有变化。 | | iOS | - 优化了某些场景中的广告展示机会。 | ## 4.13.1 版本 - 2025-01-29 发布##version-4.13.1---released-2025-01-29 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------ | | Android | * 修复了尝试在初始化完成回调中重新初始化 SDK 时可能发生的崩溃。 | | iOS | - 修复了与 Unity Ads 框架中的 `UnityAdsCommon.h` 文件相关的框架警告。 - 修复了多次调用初始化时不会触发初始化回调的问题。 | ## 4.13 版本 - 2025-01-14 发布##version-4.13---released-2025-01-14 | **平台** | **注意** | | ------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Android | * 修复了横幅广告的潜在错误 `Null Pointer Error`。 * 修复了 Android Player 中潜在的反序列化问题。 * 改进了初始化失败的报告机制。 * 修复了出现错误消息后的操作性消息事件重试问题。 * 改进了数据请求以降低报告复杂性。 | | iOS | - 修复了更改设备静音状态时可能导致崩溃的问题。 - 标准化了指标名称以降低报告复杂性。 | ## 4.12.5 版本 - 2024-11-21 发布##version-4.12.5---released-2024-11-21 | **平台** | **注意** | | ------- | -------------------------------------- | | Android | * 修复了一个问题以改进内部计数器。 | | iOS | - 修复了一个问题以改进内部计数器。 - 更新了 iOS 缓存文件夹的位置。 | ## 4.12.4 版本 - 2024-10-23 发布##version-4.12.4---released-2024-10-23 | **平台** | **注意** | | ------- | ----------------------------------------------------------------------------------------------------------------------------------- | | Android | * 修复了在清空诊断事件时发生的崩溃。 * 修复了与 Google Play Billing Library 通信期间发生的崩溃。 * 修复了在调用 `IUnityAdsInitializationListener` 之前未设置内部状态而导致后续会话错误的问题。 | | iOS | - 修复了在关闭 AppSheet 时导致 UI 无响应的问题。 | ## 4.12.3 版本 - 2024-9-20 发布##version-4.12.3---released-2024-9-20 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Android | * 修复了导致横幅广告展示时出现 `NullPointerException` 的问题。 * 修复了 `ShowOptions` 序列化有时导致崩溃的问题。 * 修复了 `getToken` 中某些情况下导致返回 null 令牌的竞争条件。 * 调整了打包方式，以便在使用 ProGuard 时实现更好的代码压缩效果。 | | iOS | - 修复了某些移动设备在发出请求时携带错误 User Agent（用户代理）的问题。 - 修复了调用 `getSharedSessionId` 时有时会发生的崩溃。 - 修复了发送某些诊断指标时有时会发生的崩溃。 - 修复了在播放期间检测静音状态时有时会发生的崩溃。 | ## 4.12.2 版本 - 2024-8-06 发布##version-4.12.2---released-2024-8-06 | **平台** | **注意** | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Android | * 修复了 Proguard 代码压缩过程导致运行时异常的问题。 * 修复了计费服务断开连接时可能在某些配置中导致崩溃的问题。 * 修复了因外部原因销毁活动时广告播放器仍然报告“播放完成”事件的问题。 * 修复了广告展示失败导致无法开始后续广告展示的问题。 * 修复了广告展示方向无法根据设备方向进行更新而导致结束页方向错误的问题。 | | iOS | - 修复了有时可能导致 `Show` 方法即使在成功展示广告后也会报告超时的问题。 - 修复了某些平板电脑在桌面模式下使用时无法正确报告用户代理字符串的问题。 - 修复了广告展示方向无法根据设备方向进行更新而导致结束页方向错误的问题。 | ## 4.12 版本 - 2024-07-17 发布##version-4.12---released-2024-07-17 | **平台** | **注意** | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Unity | * (iOS) 添加了对 Apple 隐私清单更新的支持，以确保发行商满足 App Store 提交要求。 * (iOS) 增加了横幅广告需求。 * (iOS) 移除了对已弃用的 `openURL` 方法的调用。 * (iOS) 修复了在中国使用的设备在某些 iOS 版本上出现的位置检测问题。 * (Android) 添加了 Java 8 作为将 Unity Ads SDK 添加到项目中的最低要求。 * (Android) 提高了横幅广告生命周期性能。 * (Android) 减少了网络请求。 -（iOS、Android）修复了多个错误并进行了改进。 | > **Important:** > > 此 SDK 版本包含面向 C# 开发者的 Apple 隐私清单更新， > 无计划对该包进一步更新。 ## 4.12.1 版本 - 2024-07-04 发布##version-4.12.1---released-2024-07-04 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------ | | Android | * 优化了数据缓存行为。 * 改进了一些服务的数据获取时间和效率。 * 改进了 Acquire Optimization（投放优化）功能的性能。 | | iOS | - 添加了更多网络指标以提高下游性能。 - 扩展了 Apple podspec 以覆盖更多用例。 | ## 4.12 版本 - 2024-05-31 发布##version-4.12---released-2024-05-31 | **平台** | **注意** | | ------- | -------------------------------------------------------------------------------------------- | | Android | * 增强了在适用情况下对多店广告系列的支持和定向投放。 * 移除了对 Koin 的依赖，因为它会在使用 EDM4U 时导致传递依赖解析问题。 * 修复了读取损坏的缓存数据时发生的崩溃。 | | iOS | - 修复了 `UADSGenericMediator` 类中发生的崩溃。 | ## 4.11.3 版本 - 2024-05-10 发布##version-4.11.3---released-2024-05-10 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------- | | Android | * 修复了在 `AndroidSessionRepository` 初始化代码块中导致 `NullPointerException` 的潜在竞争条件。 * 从 Unity Ads SDK 中移除了所有 BOM 依赖项。 | | iOS | - 没有变化。 | ## 4.11.2 版本 - 2024-05-05 发布##version-4.11.2---released-2024-05-05 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------ | | Android | * 调整了 Kotlin 依赖版本，该版本在 4.11.0 中发生了更改，导致在使用 EDM4U 包解析器解析 Unity Ads 依赖关系时出现无限循环。 | | iOS | - 没有变化。 | ## 4.11.1 版本 - 2024-05-05 发布##version-4.11.1---released-2024-05-05 | **平台** | **注意** | | ------- | --------------------- | | Android | * 修复了导致运行时缺少依赖项的构建问题。 | | iOS | - 没有变化。 | ## 4.11 版本 - 2024-05-02 发布##version-4.11---released-2024-05-02 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------- | | Android | * 修复了初始化期间发生的 `Out of Memory Exception` 问题。 * 修复了 HTTP 响应标头损坏时发生的崩溃。 | | iOS | - 添加了对 Open Measurement 的支持，允许发行商使用第三方可视性提供商来验证展示量和点击量数据。 - 移除了对已弃用的 `openUrl` 方法的调用。 | ## 4.10 版本 - 2024-03-25 发布##version-4.10---released-2024-03-25 | **平台** | **注意** | | ------- | ---------------------------------------------------------------------------------------------------- | | Android | * 修复了横幅广告加载的回调被触发两次的错误。 * 修复了导致一部分使用 Unity Ads SDK 4.9.3 的发行商受到影响的 `java.lang.NoSuchMethodError` 问题。 | | iOS | - 添加了对 Apple 隐私清单更新的支持，以确保发行商满足新的 App Store 提交要求。 - 修复了初始化期间获取令牌时发生的崩溃。 - 修复了网络请求重试时服务器报错的问题。 | > **Note:** > > 2024 年 4 月 1 日或之后在 Apple App Store 中发布或更新应用程序的 iOS 应用发行商需要更新到最低 Xcode 版本 15 和最低目标 iOS 版本 12.0。请参阅 [Apple 关于 App Store 提交的隐私更新](https://developer.apple.com/news/?id=3d8a9yyh)，了解更多信息。 ## 4.9.3 版本 - 2024-02-23 发布##version-4.9.3---released-2024-02-23 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Android | * 修复了运行 R8 时出现的与缺失 Android 隐私沙盒类有关的错误。 * 修复了在初始化 SDK 之前调用 `getVersion` 时发生的 `IllegalStateException` 问题。 * 修复了清空排队的诊断指标时发生的崩溃。 * 修复了 SDK 4.9.2 中某些未使用 Gradle 作为依赖项管理工具的发行商遇到的构建依赖项问题。 | | iOS | - 修复了在中国使用的设备在某些 iOS 版本上出现的位置检测问题。 | ## 4.9.2 版本 - 2023-11-08 发布##version-4.9.2---released-2023-11-08 | **平台** | **注意** | | ------- | --------------------------------------------- | | Android | * 没有变化。 | | iOS | - 修复了使用 Xcode 15 进行构建并以 iOS 12 以下版本为目标时出现的问题。 | ## 4.9.1 版本 - 2023-10-13 发布##version-4.9.1---released-2023-10-13 | **平台** | **注意** | | ------- | ------------------------------------- | | Android | * 修复了 `getToken` 监听器超时和 null 令牌响应的问题。 | | iOS | - 没有变化。 | ## 4.9 版本 - 2023-09-27 发布##version-4.9---released-2023-09-27 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Android | * 添加了更多横幅广告需求。 * 添加了对可选负载流程进行测试的支持，降低了在高延迟条件下超时的几率。 * 修复了一个错误，使横幅广告 `no_fill` 响应不作为内部错误返回。 * 修复了示例应用**横幅隐藏**按钮的问题。 * 修复了诊断指标的问题，现在可以发送诊断指标了。 * 修复了异常处理程序重新抛出未处理异常的问题。 * 修复了当 `AdUnityActivity` 被销毁时抛出 null 指针异常的问题。 | | iOS | - 增加了横幅广告需求。 - 修复了由于未实现的委托方法而导致的崩溃，这些方法应该是可选的。 - 修复了诊断指标的问题，现在可以发送诊断指标了。 | ## 4.8 版本 - 2023-06-27 发布##version-4.8---released-2023-06-27 | **平台** | **注意** | | ------- | ----------------------------------------------------------------------------------------- | | Android | * 添加了 `onBannerShown` 回调方法，使得发行商可以使用第三方聚合来获得更加准确的横幅广告展示报告。 | | iOS | - 添加了 `bannerViewDidShow` 委托方法，使得发行商可以使用第三方聚合来获得更加准确的横幅广告展示报告。 - 在设置方向之前添加了一个用于防止崩溃的保护措施。 | ## 4.7.1 版本 - 2023-05-08 发布##version-4.7.1---released-2023-05-08 | **平台** | **注意** | | ------- | ----------------------------------------------------------------------------------- | | Android | * 修复了需要使用更新的 `Gradle` 构建版本来构建 Android 项目的更改，该更改与当前 LTS Unity 编辑器附带的 `Gradle` 版本不兼容。 | | iOS | - 为 `viewId` 添加了安全检查，以防止在取消分配横幅对象时发生异常。 | ## 4.7.0 版本 - 2023-05-02 发布##version-4.7.0---released-2023-05-02 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------- | | Android | * 添加了 Java 8 作为将 Unity Ads SDK 添加到项目中的最低要求。 * 修复了 `VolumeChange` 内部监听器中潜在的竞争条件。 | | iOS | - 没有变化。 | ## 4.6.1 版本 - 2023-03-16 发布##version-4.6.1---released-2023-03-16 | **平台** | **注意** | | ------- | -------------------- | | iOS | * 添加了对 Xcode 13 的支持。 | | Android | - 减少了网络请求。 | > **Important:** > > 未来的 SDK 版本中将要求 Java 8+ 目标。 ## 4.6.0 版本 - 2023-02-23 发布##version-4.6.0---released-2023-02-23 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------- | | iOS | * 更新了支持库版本以保持需求性能。 * 优化了 Swift 的性能。 * 提高了横幅广告生命周期性能。 * 修复了一个问题以允许使用以前版本的 Unity Ads SDK。 | | Android | - 提高了横幅广告生命周期性能。 - 修复了当应用程序上下文的缓存目录文件路径为 null 时的 `NullPointerException` 问题。 | ## 4.5.0 版本 - 2022-12-19 发布##version-4.5.0---released-2022-12-19 > **Note:** > > Unity Ads 从 SDK 4.5.0 版本开始有新的依赖关系。如果没有正确解决依赖关系，则手动添加已链接的 aar 文件将导致运行时错误。建议使用包管理系统（比如 Gradle）来管理依赖关系。详情请参阅 [Android SDK 集成步骤](/grow/ads/android-sdk.md)。 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------- | | iOS | * 减少了初始化期间发生的请求数量。 * 更新了请求重试逻辑，使其在某些已知错误条件下兼容。 | | Android | - 减少了初始化期间发生的请求数量。 - 引入了对 Kotlin 的依赖。 - 改进了在后台放置应用时对计时器的处理。 - 修复了媒体播放器在无效状态下播放视频时发生的崩溃。 | ## 4.4.2 版本 - 2023-03-29 发布##version-4.4.2---released-2023-03-29 > **Important:** > > 这是为使用 Unity 的开发者计划的最后一次包更新。Unity > Ads SDK 的后续更新仅适用于 iOS 和 Android > 开发者。 | **平台** | **注意** | | ------ | -------------------------------------------------------------------------------------- | | Unity | * 删除了将用户导向到 Unity 聚合的重定向弹窗。 * 修复了当应用程序上下文的缓存目录文件路径为 null 时的 `NullPointerException` 问题。 | ## 4.4.1 版本 - 2022-10-05 发布##version-4.4.1---released-2022-10-05 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity | * 从 Unity 2020 及更高版本的 Services（服务）窗口中移除了测试模式。 * 在 Unity 编辑器的弹出对话框中添加了 batchmode 检查。 * 在 Unity 编辑器 2022.2 及更高版本中，将 `Arial.ttf` 重命名为 `LegacyRuntime.ttf`，以便支持运行模式。 | | iOS | - 生成了游戏会话 ID 并保存到存储中。 - 向最小设备读取器添加了 `sdkVersion` 和 `sdkVersionName`。 - 在 Objective-C 中通过反射机制使用 Swift。 | | Android | * 添加了一个实验以移除媒体播放所需的手势。 * 使用与 WebView 相同的方式生成了 `sessionID` 并将其保存到 `unifiedconfig.data`。 * 修复了不存在远程或本地文件时的 `ConfigurationReader`。 * 修复了 Android 8.1 中 `TimeZone` API 存在问题可能发生的崩溃。 * 移除了当缺少用于实验对象的应用规则时误报为错误的日志消息。 | ## 4.4.0 版本 - 2022-09-06 发布##version-4.4.0---released-2022-09-06 | **平台** | **注意** | | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity | * 修复了示例应用的锚点以使其在横屏模式下能够正常工作。 * 更新了屏幕方向 API。 * 聚合迁移文案变更。 | | iOS | - 添加了网络性能改进。 | | Android | * 在新的 `Load`/`Show` 指标中添加了缺失的标签，以避免被丢弃。 * 使重试指标标签与 iOS 保持一致。 * 将令牌类型移到了 `TokenListenerState` 类中。 * 反转操作顺序，以测试它是否会影响令牌延迟指标。 * 修复了被 ProGuard 混淆的 `BannerPosition`。 * 修复了并行收集信号时信号存储中的潜在并发性问题。 * 恢复了 Proguard 规则。 | ## 4.3.0 版本 - 2022-07-25 发布##version-4.3.0---released-2022-07-25 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Unity | * 从 Project Settings Ads（项目设置广告）窗口移除了切换按钮。 * 修复了 Unity 编辑器 2022.1f1 版本中 Project Settings（项目设置）窗口的问题。 | | iOS | - 发布到 Artifactory。 - 添加了对 `SKOverlayAppConfiguration` 的其他标识符的支持。 - 修复了与 `UADSTimer` 相关的崩溃。 - 修复了广告在开始展示时触发 `show failed` 回调并被关闭的错误。 | | Android | * 调整了 Proguard 混淆规则。 * 在配置请求前引入了隐私请求。 * 引入了 `UnityAdsShowError.TIMEOUT` 以修复在指定时间范围内无法展示广告的问题。 * 修复了当收到用于投放优化的 null 采购清单时可能出现的 NPE 问题。 * 修复了 `Load` 和 `Show` 超时机制以考虑生命周期。 * 添加了 config 和 WebView 中的重试次数指标。 * 修复了重试指标标签覆盖其他标签（而不是合并）的问题。 * 弃用了 `setAppCacheEnabled`。 | ## 4.2.1 版本 - 2022-05-11 发布##version-4.2.1---released-2022-05-11 | **平台** | **注意** | | ------- | ------------------------- | | iOS | * 修复了与 `UADSTimer` 相关的崩溃。 | | Android | - 没有变化。 | ## 4.2.0 版本 - 2022-05-06 发布##version-4.2.0---released-2022-05-06 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity | * 添加了一个示例应用。 * `Show Listener` 现在返回正确的回调状态。 * 确保了在主线程上触发回调。 | | iOS | - 添加了对 `AppDelegate supportedInterfaceOrientationsForWindow` 的检查。 | | Android | * 为 Unity Acquire 添加了优化功能。 * 改进了令牌解析请求的初始化时间。 * 修复了对可能的 null 监听器进行安全检查的问题。 * 修复了在监听器中使用 `GetToken` 时可能出现的死锁。 * 对 `WebViewApp.java` 中的字符串处理做了小的改进。 | ## 4.1.0 版本 - 2022-03-17 发布##version-4.1.0---released-2022-03-17 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------- | | Unity | * 修复了 `IUnityAdsShowCallback` 在编辑器运行模式中重复调用的问题。 | | iOS | - 为 `getToken` 公共 API（Beta 版）添加了回调。 - 改进了令牌的可用性。 | | Android | * 为 `getToken` 公共 API（Beta 版）添加了回调。 * 改进了令牌的可用性。 * 向 `AndroidManifest.xml` 添加了 `AD_ID`。 | ## 4.0.1 版本 - 2022-02-02 发布##version-4.0.1---released-2022-02-02 | **平台** | **注意** | | ------- | ---------------------------------------------------------------------------------------- | | Unity | * 修复了在主线程上不执行回调时发生的崩溃。 * 修复了当 Unity Ads 包含在 tvOS 构建中时发生的崩溃。 | | iOS | - 修复了当 SDK 试图调用 null 回调时发生的崩溃。 | | Android | * 移除了 ARCore 依赖关系。 * 修复了使用 Acquire Optimization（投放优化）功能时发生的崩溃。 * 移除了对 Android ID 的检索和使用。 | ## 4.0.0 版本 - 2021-11-30 发布##version-4.0.0---released-2021-11-30 | **平台** | **注意** | | ------- | -------------------------------------------------------------------------------------------------- | | Unity | * 修复了 Windows 中 GameID（游戏 ID）文本字段中断的问题。 * 从编辑器的 Top Menu（顶部菜单）中移除了 ENABLE\_EDITOR\_GAME\_SERVICES。 | | iOS | - 修复了从多个线程提交到元数据存储时发生的崩溃。 | | Android | * 修复了在 Unity Ads 以空活动进行初始化时可能发生崩溃的问题。 | ## 3.7.5 版本 - 2021-07-20 发布##version-3.7.5---released-2021-07-20 | **平台** | **注意** | | ------- | -------------------------------------- | | Android | * 修复了使用 null GameID（游戏 ID）重新初始化时发生的崩溃。 | ## 3.7.3 版本 - 2021-05-26 发布##version-3.7.3---released-2021-05-26 | **平台** | **注意** | | ------- | --------------------------------------------------------------------- | | Unity | * 修复了导致默认广告位无法显示的错误。 | | iOS | - 修复了 `placementId` 变为 null 时可能发生的崩溃。 - 修复了尝试从后台线程访问 UIKit 时显示的警告。 | | Android | * 修复了展示广告时与 `IllegalStateException` 相关的崩溃。 * 修复了尝试同时加载多个广告而导致加载错误的问题。 | ## 3.7.1 版本 - 2021-03-31 发布##version-3.7.1---released-2021-03-31 | **平台** | **注意** | | ------ | ---------------------------- | | iOS | * 修复了 iOS 内存消耗问题以减轻对设备性能的影响。 | ## 3.7.0 版本 - 2021-03-19 发布##version-3.7.0---released-2021-03-19 | **平台** | **注意** | | ------ | -------------------------------------------------------- | | Unity | * 为公共 API 上的 `Show` 方法签名添加了回调。 * 改进了 `Load` 方法回调以包含错误消息。 | ## 3.6.2 版本 - 2020-12-10 发布##version-3.6.2---released-2020-12-10 | **平台** | **注意** | | ------- | ----------------------------------------------- | | Android | * 修复了由 `ConcurrentModificationException` 导致的崩溃。 | ## 3.6.0 版本 - 2020-11-12 发布##version-3.6.0---released-2020-11-12 | **平台** | **注意** | | ------- | ---------------- | | iOS | * 添加了实验性的集成 API。 | | Android | - 添加了实验性的集成 API。 | ## 3.5.1 版本 - 2020-11-05 发布##version-3.5.1---released-2020-11-05 | **平台** | **注意** | | ------ | ----------------------- | | iOS | * 更新了对 SKAdNetwork 的支持。 | ## 3.5.0 版本 - 2020-08-24 发布##version-3.5.0---released-2020-08-24 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Unity | * 更新了 Unity Ads SDK 许可信息。 * 修复了在某些设备上调用两次 `IUnityAdsListener` 接口方法的问题。 | | iOS | - 添加了新的后台下载 WebView 更新。 - 更新了 Unity Ads SDK 许可信息。 - 修复了在 iOS14 上的 StoreKit 中按下 \*\*Done（完成）\*\*按钮时广告会自动关闭的问题。 | | Android | * 添加了新的后台下载 WebView 更新。 * 更新了 Unity Ads SDK 许可信息。 * 将 `targetSdkVersion` 更新到 29。 * 修复了 AdUnit 视图在系统弹窗后无法恢复焦点的错误。 * 修复了广告关闭后 Android 背景音频无法恢复的问题。 * 修复了结束页显示空白页的问题。 | ## 3.4.9 版本 - 2020-07-24 发布##version-3.4.9---released-2020-07-24 | **平台** | **注意** | | ------- | ---------------------------------------------------- | | Unity | * 修复了在不受支持的平台上工作时发生的错误。 | | Android | - 修复了 Android API 级别 30 中使用 `getNetworkType` 时的一个崩溃。 | ## 3.4.6 版本 - 2020-06-04 发布##version-3.4.6---released-2020-06-04 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------- | | Unity | * 修复了 Unity 编辑器 2020.1 及更高版本中在不受支持的平台上进行构建的错误。 * 移除了 `UnityEditor.Advertisement.dll`。 | | iOS | - 修复了调用 `addDelegate` 时发生的崩溃。 - 修复了 iOS 广告不遵循静音设置的错误。 | | Android | * 修复了 `InitializationState` 内存不足崩溃问题。 * 修复了因不安全 SSL 导致的 GooglePlayStore 拒绝。 * 修复了 Android `readFileBytes` 崩溃。 | ## 3.4.4 版本 - 2020-03-02 发布##version-3.4.4---released-2020-03-02 | **平台** | **注意** | | ------ | ------------------------------------------ | | Unity | * 修复了 Unity 编辑器中缺少 `UnityEngine.UI` 引用的问题。 | ## 3.4.2 版本 - 2020-01-05 发布##version-3.4.2---released-2020-01-05 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------- | | Unity | * 修复了在运行模式下使用无效 GameID（游戏 ID）时不会调用错误回调的问题。 | | iOS | - 修复了 `onUnityAdsError` 异常：没有这样的代理方法。 - 修复了在某些 Android 设备上发生的 `BufferredInputStream.Read()` 中的 `FatalException` 问题。 | | Android | * 修复了为进行调试而构建时出现的 `UnityAdsCopyString` 和 `NSStringFromIl2CppString` 错误。 * 修复了当强制使用横向模式时意外缩放横幅广告的问题。 | ## 3.4.1 版本 - 2019-12-13 发布##version-3.4.1---released-2019-12-13 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------- | | Unity | * 修复了多次执行运行模式后不会在编辑器中触发回调的问题。 * 修复了编辑器画布不会显示在场景中所有其他对象之上的问题。 * 修复了占位游戏对象在用户场景中为可见状态的问题。 | | Android | - 修复了不会在 Android 设备上调度回调的问题。 | ## 3.4.0 版本 - 2019-12-09 发布##version-3.4.0---released-2019-12-09 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Unity | * 在 Asset Store（资源商店）包中添加了关于升级到 packman 的警告消息。 * 在 Unity 2020.1 及更高版本的 Services（服务）窗口中恢复了 `TestMode` 标志。 * 弃用了 Monetization 类。 * 修复了编辑器中的测试广告按钮无法阻止点击事件传播的问题。 * 修复了在 Unity 编辑器中运行时每个广告位仅调用一次 `OnUnityAdsReady` 的问题。 * 修复了关于 SDK 3.3.1 的 Google Play 崩溃报告。 | | iOS | - 弃用了 Monetization 类。 - 移除了关于 Monetization 的示例应用。 - 弃用了将监听器作为参数的初始化方法，而采用不带监听器的初始化方法。 - 修复了 iOS `isWiredHeadsetOn` 内存泄漏。 - 修复了在使用无效 GameID（游戏 ID）进行初始化时不会触发 iOS 回调 `unityAdsDidError` 的问题。 - 修复了升级到 SDK 3.3.0 后应用崩溃率增加的问题。 - 修复了 IronSource 广告因第三方原因重复计算广告展示次数的问题。 | | Android | * 弃用了 Monetization 类。 * 移除了关于 Monetization 的示例应用。 * 弃用了将监听器作为参数的初始化方法，而采用不带监听器的初始化方法。 * 修复了 Google/Admob 应用在 SDK 3.1.0 中崩溃的问题。 * 修复了关于 SDK 3.3.1 的 Google Play 崩溃报告。 * 修复了 `Listener.sendErrorEvent`。 * 修复了重新初始化总是被屏蔽至少 10 秒的错误。 * 修复了 IronSource 广告因第三方原因重复计算广告展示次数的问题。 | ## 3.3.0 版本 - 2019-09-26 发布##version-3.3.0---released-2019-09-26 | **平台** | **注意** | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity | * 修复了不能在主线程上执行回调的问题。 * 修复了在回调中调用 `RemoveListener` 会导致崩溃的问题。 | | iOS | - 弃用了 UI WebView。因 Apple iOS 13 更新，Unity Ads 不再支持 iOS 7 和 8。 - 添加了新的横幅广告 API，通过 `UADSBannerView` 类实现横幅广告优化。这个新的 API 支持在一个广告位放置多个横幅，具有灵活定位能力。 - 修复了 iOS 13 AppSheet 崩溃。 | | Android | * 添加了新的横幅广告 API，通过 UADSBannerView 类实现横幅广告优化。这个新的 API 支持在一个广告位放置多个横幅，具有灵活定位能力。 * 修复了 WebView `onRenderProcessGone` 崩溃。 | ## 3.2.0 版本 - 2019-07-22 发布##version-3.2.0---released-2019-07-22 | **平台** | **注意** | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity | * 添加了 OMID 可视性集成。Unity 现在通过了 IAB 认证，并具有 VAST 可视性。 * 在 SDK 中添加了一条错误消息，提示您如果同时安装了 Package Manager（包管理器）和 Asset Store（资源商店）版本的 Unity Ads，则应移除一个 SDK 实例。 * 修复了 2017 年之前 Unity 版本的 Android java 代理使用问题，解决了多个监听器崩溃的问题。 | | iOS | - 添加了 OMID 可视性集成。Unity 现在通过了 IAB 认证，并具有 VAST 可视性。 | | Android | * 添加了 OMID 可视性集成。Unity 现在通过了 IAB 认证，并具有 VAST 可视性。 | ## 3.1.1 版本 - 2019-05-16 发布##version-3.1.1---released-2019-05-16 | **平台** | **注意** | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity | * 添加了对多个监听器的支持。 * 添加了 `ASWebAuthenticationSession` 支持。 * 修复了在构建包含其他平台广告的项目时 Playstation 和 Xbox 试图访问 `UnityAdsSettings` 而抛出的错误。 * 将测试模式资源文件夹移到了仅编辑器可用范围。 | | iOS | - 已将 iOS 二进制文件更新到 3.1.0。 - 添加了对多个监听器的支持。 - 通过更新使 iOS 音量变化事件可以被正确捕获。 - 修复了 `USRVStorage` json 异常。 - 更新了 Analytics `onLevelUp` 以接受字符串而不是整型值。 | | Android | * 已将 Android 二进制文件更新到 3.1.0。 * 添加了对多个监听器的支持。 * 修复了横幅广告内存泄漏问题。 * 修复了 Android SDK 版本低于 23 时 `GetDeviceId` 出现的问题。 * 更新了 Analytics `onLevelUp` 以接受字符串而不是整型值。 * 修复了 `AdUnitActivity.onPause` 中可能导致崩溃的问题。 | ## 3.0.3 版本 - 2019-03-15 发布##version-3.0.3---released-2019-03-15 | **平台** | **注意** | | ------- | ---------------------------------------------- | | Unity | * 修复了在项目中使用 Unity Ads 横幅广告时 Unity 编辑器中的内存泄漏问题。 | | iOS | - 更新了 iOS 二进制文件。 - 修复了 iOS 平台内购集成中未捕获异常的问题。 | | Android | * 更新了 Android 二进制文件。 | ## 3.0.2 版本 - 2019-02-26 发布##version-3.0.2---released-2019-02-26 | **平台** | **注意** | | ------- | ------------------------------------------------------------ | | Unity | * 修复了 Windows 平台返回错误结果的构建问题。 * 修复了 Unity Ads 包与 Moq 框架之间的冲突。 | | iOS | - 更新了 iOS 二进制文件。 | | Android | * 更新了 Android 二进制文件。 | ## 3.0.1 版本 - 2019-01-25 发布##version-3.0.1---released-2019-01-25 | **平台** | **注意** | | ------- | ----------------------------------------------- | | Unity | * 集成了 Ads 3.0.1 SDK。 | | iOS | - 添加了用于设置横幅广告位置的 API。 - 修复了 3.0.0 SDK 中发现的各种错误。 | | Android | * 更新了 Android 二进制文件。 * 修复了 3.0.0 SDK 中发现的各种错误。 | ## 3.0.0 版本 - 2018-10-18 发布##version-3.0.0---released-2018-10-18 | **平台** | **注意** | | ------- | ------------------------------------------------------------------------------------------- | | iOS | * 添加了 Unity Monetization 平台。 * 添加了个性化广告位。 * 添加了横幅广告。 * 添加了 AR 广告。 * 修复了 2.3.0 SDK 中发现的各种错误。 | | Android | - 添加了 Unity Monetization 平台。 - 添加了个性化广告位。 - 添加了横幅广告。 - 添加了 AR 广告。 - 修复了 2.3.0 SDK 中发现的各种错误。 | ## 2.3.2 版本 - 2018-11-21 发布##version-2.3.2---released-2018-11-21 | **平台** | **注意** | | ------ | ----------------------------------------------------------------------------------- | | Unity | * 将 Ads 2.3.0 SDK 与 Unity 2019.X 集成。 * 修复了平台依赖关系的错误，使您能够在 iOS 或 Android 以外的其他平台上构建。 | | iOS | - 修复了 Xcode 中的错误，使您能够在 tvOS 平台上成功运行。 | ## 2.3.1 版本 - 2018-11-15 发布##version-2.3.1---released-2018-11-15 | **平台** | **注意** | | ------ | -------------------------------------------------------------------------------------------------- | | Unity | * 更新到 Ads 2.3.0 SDK。 * 更新了多线程的请求 API。 * 更新了用于 Ads 和 IAP SDK 通信的 `SendEvent` API。 * 添加了新的 Unity 集成。 | ## 2.3.0 版本 - 2018-07-12 发布##version-2.3.0---released-2018-07-12 | **平台** | **注意** | | ------- | --------------------------------- | | iOS | * 改进了对 HTTP 请求的处理。 * 修复了错误并进行了优化。 | | Android | - 改进了对 HTTP 请求的处理。 - 修复了错误并进行了优化。 | ## 2.2.1 版本 - 2017-04-23 发布##version-2.2.1---released-2017-04-23 | **平台** | **注意** | | ------- | ------------------------ | | iOS | * 修复了 iOS 和 Android 的问题。 | | Android | - 修复了 iOS 和 Android 的问题。 | ## 2.2.0 版本 - 2017-03-22 发布##version-2.2.0---released-2017-03-22 | **平台** | **注意** | | ------- | ------------------------------------------------------------- | | iOS | * 添加了对内购推荐的支持。 * 改进了对缓存的处理。 * 增加了以不同格式显示广告的灵活性。 * 修复了几个罕见的崩溃。 | | Android | - 添加了对内购推荐的支持。 - 改进了对缓存的处理。 - 增加了以不同格式显示广告的灵活性。 |