Unity Ads SDK API 弃用策略#

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

为了确保 Unity Ads 提供优化且一致的开发体验，它必须不断发展和扩展 SDK 及其 API 类。随着我们适应平台和市场变化，API 类变得过时，需要由更有效的版本替换。

如果 Unity Ads 想要删除 API 类，或以破坏先前支持的功能的方式更改 API 类，Unity 将尽力

• 将 API 标记为已弃用，在发行说明中记录弃用情况，以及（如果适用）更新文档和示例，以在下一个主要或次要版本中提供首选的替代方案。
• 在将来的主要版本中删除弃用的 API；以及
• 尽力提供至少三个（3）月的删除弃用 API 的通知，方法是使用弃用通知（请参阅有关通知的部分）。

例外#

对上述弃用指南的例外情况是，

• Unity Ads 必须由于适用法律或其合同项下的权利变更而删除 API；
• 继续提供该功能可能会造成安全、合规性、数据隐私或其他监管风险，或以其他方式使 Unity 及其第三方合作伙伴和客户面临任何责任或损害风险（由 Unity 全权决定）；或
• 继续提供该功能可能会给 Unity 或其第三方合作伙伴和客户造成巨大的经济或技术负担（包括通过过度使用或威胁任何基础 Unity 服务的完整性、性能或可用性），由 Unity 全权决定。

通知#

如果 API 变得过时，Unity Ads 将尽力通过以下一种或多种方式提供弃用通知

• 对Unity Ads 货币化仪表板的开发者通信。该帖子将包含弃用通知、替代 API（如果可用）以及目标 SDK 版本以供删除；
• 包含替代 API（如果可用）的官方技术文档更新；或
• 更新 SDK 变更日志，在其中包含指向有关哪些类已弃用、适用替换类以及预计的寿终正寝日期的更详细信息的链接。

预期情况#

只要有可能，API 类及其支持的功能都会以与早期版本兼容的方式维护。如果必须以不向后兼容的方式更改某些内容，Unity Ads 将创建一个新的资源、媒体类型或版本，并且旧的资源或媒体类型将根据 API 弃用策略进行维护。

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

• 要删除的 API
• 它被弃用的 SDK 版本
• 用于替代类似功能的 API
• 它被删除（或将被删除）的 SDK 版本
• 弃用的原因

对这些指南的更改#

这些指南可能会在未经通知的情况下更改，Unity 保留随时根据其自行决定修改其 API 弃用流程的权利。

定义和概念#

弃用#

已弃用的 API 类仍然可以使用，但不再向前支持，将在将来的版本中删除。

弃用通知#

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

语义版本控制#

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

API 向后兼容性#

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