Unity Ads SDK API 弃用政策#

Unity 鼓励您在开发时使用最能满足您需求的 API 集。但是，仍然鼓励所有开发者尽可能频繁地更新到最新的 SDK 版本。

为了确保 Unity 广告提供一致的最佳开发体验，必须继续发展和扩展 SDK 及其 API 类。随着我们适应平台和市场的变化，API 类会变得过时，需要替换为更高效的版本。

如果 Unity Ads 打算移除某个 API 类，或以破坏先前支持的功能的方式对其进行更改，Unity 将努力做到：

• 将 API 标记为已弃用，在发行说明中记录此弃用，并（如果适用）更新文档和示例，以便在下一个主要或次要版本中提供偏好的替代方案。
• 在未来的主要版本中移除已弃用的 API。
• 以合理的方式尽可能通过使用弃用通知（请参阅通知部分）提供不少于三 (3) 个月的关于移除已弃用 API 的通知。

例外#

上述弃用准则的例外情况如下：

• 由于适用法律或合同权利发生变化，Unity Ads 必须移除 API。
• 继续提供相关功能可能会产生安全性、合规性、数据隐私或其他监管风险，或在其他方面使 Unity 和/或其第三方合作伙伴和客户面临任何责任或损害风险（由 Unity 自行确定）。
• 继续提供相关功能可能会给 Unity 或其第三方合作伙伴和客户带来巨大的经济或技术负担（包括加重任何基础 Unity 服务的负担或威胁其完整性、性能或可用性；由 Unity 自行确定）。

通知#

如果 API 过时，Unity Ads 将以合理的方式尽可能通过以下一种或多种方式提供弃用通知：

• 开发者在 Monetization（变现）后台上发布帖子。该帖子将包含弃用通知、替代 API（如果可用）以及要移除的目标 SDK 版本。
• 官方在技术文档更新中说明替代 API（如果可用）；或
• 更新 SDK 变更日志中的一个部分以提供一些链接，通过这些链接即可查看要弃用的类、适用的替换类以及预计的生命周期结束日期等更多详细信息。

期望#

在维护 API 类及其支持的功能时，我们希望尽可能确保与早期版本兼容。如果需要以不向后兼容的方式更改某些内容，Unity 广告会创建新资源、媒体类型或版本，并根据 API 弃用政策维护旧资源或媒体类型。

Unity Ads 将为所有已宣布的 API 弃用情况提供以下信息：

• 要移除的 API
• 已弃用的 SDK 版本
• 具有类似功能的换用 API
• 已移除（或将要移除）的 SDK 版本
• 弃用原因

这些准则的变更#

这些准则如有更改，恕不另行通知，Unity 保留自行决定随时修改其 API 弃用流程的权利。

定义和概念#

弃用#

已弃用的 API 类仍可使用，但未来将不再受支持，并将在未来的版本中移除。

弃用通知#

提供在即将发布的 SDK 版本中将替换 API 类的预先通知。这是开发者升级代码的好时机。

语义版本控制#

Unity Ads SDK 遵循语义版本控制标准。只会在发布的主要版本中移除 API 类。

API 向后兼容性#

Unity 尝试提供 API 参考中介绍的所有公共 API 的向后兼容性。开发者必须使用 API 参考中列出的支持的 API 来确保兼容性。