SDK v4 Unity¶

本页面为Unity引擎项目提供最新SDK版本、应用指南以及各SDK发行版本的主要变更内容。

SDK最新版本¶

请为您的Unity引擎项目的每个目标操作系统环境下载最新的SDK版本。

※ 安装各目标操作系统的SDK分发文件时，必须同时安装Unity Interface。

各版本限制与依赖¶

• Hive SDK v4 Unity 25.0.0及以上版本必须申请安全密钥
  • 由于认证安全协议变更，使用Hive SDK v4 Unity 25.0.0及以上版本时，必须在Hive Console > Security Key Settings中申请安全密钥。未申请安全密钥将无法登录应用。
• Hive SDK v4 Unity 25.1.3及以上版本需变更PG支付实现
  • Android&iOS 25.1.3及以上或Windows 25.1.0及以上，如需实现PG支付，请参考PG支付流程并更新PG支付实现代码。
• Hive SDK v4 Unity 25.4.0及以上版本使用SDK Manager时，请升级到SDK Manager v2.0.0及以上

SDK分发包应用指南¶

自SDK v4 Unity 25.5.1起，SDK分发包分为Interface包和Platform OS包，共提供4个文件：

• Hive SDK v4 Unity Interface 25.5.x
• Hive SDK v4 Unity Android 25.5.x
• Hive SDK v4 Unity iOS 25.5.x
• Hive SDK v4 Unity Windows 25.5.x

分离后的SDK文件即使版本不同，也可根据包应用规则兼容使用。若版本兼容，可部分更新SDK分发包，从而缩短SDK应用到游戏发布的时间。

SDK分发包的应用顺序如下：

1) 参考包应用规则，确认要下载的Hive SDK v4 Unity Interface 25.5.x文件与目标OS的SDK文件（如Hive SDK v4 Unity Windows 25.5.x）之间的兼容性。
2) 下载并导入要应用的Hive SDK v4 Unity Interface 25.5.x文件到项目中。在Unity引擎开发环境中，无论目标OS类型如何，必须应用该文件。
3) 下载并导入与Hive SDK v4 Unity Interface 25.5.x文件兼容的SDK文件。

使用SDK Manager可更快速、便捷地完成上述1)~3)步骤。请参考使用SDK Manager升级SDK以升级到最新版本。

Hotfix版本更新¶

如仅部分SDK文件升级为hotfix版本（如v4.25.5.x），SDK最新版本将同时提供未更新的旧SDK文件和已更新的hotfix版本SDK文件（如Hive SDK v4 Unity iOS 25.5.2）。

如手动（非SDK Manager）更新SDK分发包，请参考SDK Unity更新指南。

使用SDK Manager，仅相关SDK文件会自动升级为最新hotfix版本。

主要变更内容¶

本节介绍从最新版本开始，各SDK发行版本的主要变更内容。

• Unity Android & iOS
• Unity Windows