SDK v4 Unity¶
本頁面提供 Unity 引擎專案的最新 SDK 版本、安裝指南，以及各 SDK 發行版本的主要變更內容。
SDK 最新版本¶
請下載適用於您的 Unity 引擎專案各目標作業系統環境的最新 SDK 版本。
※ 安裝各目標作業系統的 SDK 發佈檔案時，必須同時安裝 Unity Interface。
| 目標作業系統 | 最新版本 | 發佈日期 |
|---|---|---|
| Unity Interface | Hive SDK v4 Unity Interface 25.5.1 | 2025-07-23 |
| Android | Hive SDK v4 Unity Android 25.5.1 | 2025-07-23 |
| iOS | Hive SDK v4 Unity iOS 25.5.2 | 2025-07-30 |
| Windows | Hive SDK v4 Unity Windows 25.5.0 | 2025-09-10 |
各版本限制與相依性¶
- 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 更新指南。
Warning
若僅部分 SDK 檔案升級為最新版本，請先刪除該版本之前已安裝的 SDK 檔案，且請勿刪除或變更未更新的 SDK 檔案。
使用 SDK Manager，僅相關 SDK 檔案會自動升級為最新 hotfix 版本。
主要變更內容¶
本節說明自最新版本起，各 SDK 發佈版本的主要變更內容。