SDK Unity¶

本页面介绍在 Unity 引擎环境下开发时可用的 Android、iOS、Windows SDK v4 最新版本、安装与更新指南，以及各 SDK 版本的主要变更事项。

SDK 最新版本¶

请将各目标 OS 对应的最新 SDK 版本应用到 Unity 引擎项目中。

※ 安装各目标 OS 的 SDK 发布包时，务必同时安装 Unity Interface。

请在开发环境中确认各版本的开发环境与库依赖关系。

必须确认事项¶

• Hive SDK v4 Unity 25.0.0 及以上版本必须签发安全密钥
  • 由于认证安全协议变更，使用 Hive SDK v4 Unity 25.0.0 及以上版本时，必须在 Hive 控制台 > 安全密钥设置 中签发安全密钥。若未签发安全密钥，将无法在应用中登录。
• Hive SDK v4 Unity 25.1.3 及以上版本需变更 PG 支付实现
  • 若要在 Android&iOS 25.1.3 及以上，或 Windows 25.1.0 及以上实现 PG 支付，请参考PG 支付流程并修改 PG 支付实现代码。
• Hive SDK v4 Unity Windows 25.8.1 及以上版本存在点击促销全屏横幅后链接跳转异常的问题。要解决该问题，请按以下方式替换全屏横幅用 HTML 文件。
  1. 下载并解压包含修复版 HTML 文件夹的压缩包。
  2. 复制整个文件夹并覆盖到 Hive_SDK_UnityPlugin\Assets\Hive_SDK_v4\Plugins\Windows\additional 路径下。
  3. 重新构建应用。
• 在 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 类型为何，都必须应用 Hive SDK v4 Unity Interface 25.5.x 文件。
3) 下载与已下载 Hive SDK v4 Unity Interface 25.5.x 文件兼容的 SDK 文件，并导入到项目中。

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

热修复版本更新¶

当 SDK 发布包中仅部分 SDK 文件更新为 v4.25.5.x 这类热修复版本时，SDK 最新版本会同时提供已更新的热修复 SDK 文件（例如：Hive SDK v4 Unity iOS 25.5.2）以及未更新的旧版 SDK 文件。

此时，如不使用 SDK Manager 而采用手动安装方式更新 SDK 发布包，可参考 SDK Unity 更新指南进行更新。

若使用SDK Manager，所有更新对象 SDK 文件都会自动更新为最新热修复版本。

主要变更事项¶

请查看 Hive SDK Unity 从最新版本到历史发布版本的主要变更事项。