跳轉至

Unreal Engine 4

在虛幻引擎開發中使用的 Hive SDK 由 介面包和每個目標操作系統(Android、iOS、Windows)的平臺包 組成。因此,您可以選擇並安裝僅與您的遊戲應用目標操作系統相匹配的介面包和平臺包。

  • Hive SDK 虛幻引擎 4 介面(預設安裝)
  • Hive SDK 虛幻引擎 4 平台(僅安裝針對您的目標操作系統的平臺包)
    • Hive SDK 虛幻引擎 4 安卓
    • Hive SDK 虛幻引擎 4 iOS
    • Hive SDK 虛幻引擎 4 Windows
Note

有關插件和模塊的更多信息,這些是虛幻引擎項目的組件,請參見以下鏈接。

Hive SDK 安裝

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

Hive SDK Unreal Engine 4 最新版本 下載與您的遊戲應用目標操作系統相匹配的介面包和平台包。

步驟 2. 安裝介面套件

  1. 解壓下載的 Hive SDK v4 UE4 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 UE4 {Target OS} 26.x.x.zip 文件,并根据您的目标操作系统将生成的文件夹添加到下面的虚幻引擎项目路径中。

  • 路徑: /Plugins/HIVESDK/Source
    <project_root>
    └─ Plugins
            └─ Source
                    ├─ HiveSDK
                    ├─ HiveSDKAndroid    (可選)
                    ├─ HiveSDKiOS        (可選)
                    └─ HiveSDKWindows    (可選)
    
Note

在打包階段,Hive SDK 在構建您的遊戲應用後創建可執行文件 (.apk_, _.IAP, *.exe 等),上述路徑中添加的平臺包的代碼和資源會自動包含在每個目標操作系統的可執行文件中。

套件相容性

介面和平台套件即使版本不同,也可以相容,遵循以下套件應用規則。

  • 兼容性僅在 major.minor.patch 版本格式的 patch 版本級別上受到支持。如果 majorminor 版本不匹配,則它們不兼容。
    • 示例 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. 刪除 Unreal Engine /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(delete)"});
              }
      }
      

由於刪除介面套件會改變專案結構,因此您必須重新啟動 Unreal Editor 以執行新的編譯。
當您重新啟動 Unreal Editor 時,編譯會根據變更的專案結構自動進行。然而,如果從先前的專案結構編譯的二進位檔仍然緩存在 IntermediateBinaries 資料夾中,則會發生構建錯誤。在這種情況下,請刪除 IntermediateBinaries 資料夾,然後重新啟動 Unreal Editor 以重新編譯和重建。

刪除平台套件

選擇並刪除安裝在虛幻引擎 /Plugins/HIVESDK/Source 路徑中的平台套件。

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

由於刪除平台包會改變項目結構,請重新啟動虛幻編輯器以進行編輯器重建。

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

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


注意事項

當您重新啟動虛幻編輯器時,您可以在虛幻引擎中安裝內建插件。然而,使用 CEF(Chromium 嵌入式框架)的 WebBrowser 不能應用,因為它與 Hive SDK 中應用的 CEF 發生衝突。

Warning

WebBrowser CEF 目前未被更新或維護,因此應用它可能會面臨安全問題。