Unreal Engine 5

在虛幻引擎開發環境中使用的 Hive SDK 包含一個 介面包和每個目標操作系統（Android、iOS、Windows）的平台包。您可以選擇性地僅安裝介面包和與您的遊戲應用目標操作系統相匹配的平台包。

• Hive SDK Unreal Engine 5 介面（必需）
• Hive SDK Unreal Engine 5 平台（僅安裝目標作業系統的平臺套件）
  • Hive SDK Unreal Engine 5 Android
  • Hive SDK Unreal Engine 5 iOS
  • Hive SDK Unreal Engine 5 Windows

Hive SDK 安裝¶

步驟 1. 下載最新的 Hive SDK 版本¶

從最新的 Hive SDK Unreal Engine 5 版本下載針對您的目標操作系統的介面包和平台包。

步驟 2. 安裝介面套件¶

1. 解壓縮下載的 Hive SDK v4 UE5 Interface 26.x.x.zip 檔案，然後將 HIVESDK 資料夾添加到以下的 Unreal Engine 專案路徑中。

   • 路徑: /Plugins<

2. 将依赖代码添加到以下路径的 Build.cs 文件中，以使用已安装的接口包。

   • 路径: /Source//.Build.cs
   • 依赖代码:

     public class HIVESDKV4Tester : ModuleRules
     {
             public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
             {
                     PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK"});
             }
     }
     

第3步。安裝平台套件¶

解壓縮下載的 Hive SDK v4 UE5 {Target OS} 26.x.x.zip 文件，然後根據您的目標操作系統將生成的文件夾添加到以下虛幻引擎項目路徑中。

• 路徑: /Plugins/HIVESDK/Source

  <project_root>
  └─ Plugins
          └─ Source
                  ├─ HiveSDK
                  ├─ HiveSDKAndroid    (可選)
                  ├─ HiveSDKiOS        (可選)
                  └─ HiveSDKWindows    (可選)
  

套件相容性¶

介面套件和平台套件可以一起使用，即使它們的版本不同，只要遵循以下的套件相容性規則。

• 兼容性仅在 patch 版本级别内支持，格式为 major.minor.patch 版本。如果 major 和 minor 版本不匹配，则这些包不兼容。
  • 示例 1：如果接口包版本为 26.1.0，则仅兼容平台包版本 26.1.x（例如，26.1.1，26.1.2）。
  • 示例 2：如果接口包版本为 26.1.0，则平台包版本 26.0.0 或 26.2.0 不兼容。

Hive SDK 更新¶

要手動更新 Hive SDK，請刪除之前安裝的 Hive SDK，然後安裝最新版本。

步驟 1. 移除 Hive SDK¶

移除接口包¶

1. 在虛幻引擎中刪除/Plugins/HIVESDK文件夾。
2. 從以下路徑的Build.cs文件中移除依賴代碼。
   • 路徑: Unreal Engine /Source//.Build.cs
   • 依賴代碼:

     public class HIVESDKV4Tester : ModuleRules
     {
             public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
             {
                     PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK(remove)"});
             }
     }
     

在移除接口包後，您必須重新啟動 Unreal 編輯器以重新編譯，因為專案結構已更改。
當您重新啟動 Unreal 編輯器時，編譯會根據更新的專案結構自動進行。此時，如果從先前專案結構編譯的二進位檔仍然緩存在 Intermediate 和 Binaries 資料夾中，則可能會發生構建錯誤。在這種情況下，請刪除 Intermediate 和 Binaries 資料夾，然後重新啟動 Unreal 編輯器以重新編譯和重建。

移除平台套件¶

選擇並刪除在/Plugins/HIVESDK/Source路徑中安裝的平臺套件，這是在Unreal Engine中。

<project_root>
└─ Plugins
        └─ Source
                ├─ HiveSDK
                ├─ HiveSDKAndroid    (optional)
                ├─ HiveSDKiOS        (optional)
                └─ HiveSDKWindows    (optional)

在移除平台包後，重新啟動虛幻編輯器以重建編輯器，因為項目結構已更改。

步驟 2. 安裝最新的套件版本¶

請參考 Hive SDK 安裝 以安裝最新版本的介面套件和平台套件。

注意事項¶

當您重新啟動Unreal Editor時，您可以在Unreal Engine中安裝內建插件。此時，使用CEF（Chromium Embedded Framework）的WebBrowser無法應用，因為它與Hive SDK使用的CEF衝突。