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 Console > 安全金鑰設定 中簽發安全金鑰。若未簽發安全金鑰，將無法在 App 中登入。
• 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. 重新建置 App。
• 在 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 套用到遊戲 App 發佈的時間。

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 更新至最新版本。

Hotfix 版本更新¶

當 SDK 發佈套件中僅部分 SDK 檔案更新為 v4.25.5.x 這類 Hotfix 版本時，SDK 最新版本會同時提供已更新的 Hotfix SDK 檔案（例如：Hive SDK v4 Unity iOS 25.5.2）與未更新的舊版 SDK 檔案。

此時，若不使用 SDK Manager 而採手動安裝方式更新 SDK 發佈套件，可參考 SDK Unity 更新指南進行更新。

使用 SDK Manager 時，所有更新對象 SDK 檔案都會自動更新為最新 Hotfix 版本。

主要變更事項¶

請查看 Hive SDK Unity 從最新版本到過往發佈版本的主要變更事項。