コンテンツにスキップ

Unreal Engine 5

Unreal Engine開発環境で使用されるHive SDKは、インターフェースパッケージと各ターゲットOS(Android、iOS、Windows)のプラットフォームパッケージで構成されています。 ゲームアプリのターゲットOSに一致するインターフェースパッケージとプラットフォームパッケージのみを選択的にインストールできます。

  • Hive SDK Unreal Engine 5 インターフェース (必須)
  • Hive SDK Unreal Engine 5 プラットフォーム (ターゲット OS 用にプラットフォームパッケージのみをインストール)
    • Hive SDK Unreal Engine 5 Android
    • Hive SDK Unreal Engine 5 iOS
    • Hive SDK Unreal Engine 5 Windows
Note

プラグインやモジュールについての詳細情報は、Unreal Engineプロジェクトのコンポーネントであり、以下のリンクを参照してください。

Hive SDKのインストール

ステップ1. 最新のHive SDKバージョンをダウンロード

ターゲットOS用のインターフェースパッケージとプラットフォームパッケージを、最新の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 ファイルの圧縮を解除し、次にターゲットOSに応じて生成されたフォルダーを以下のUnreal Engineプロジェクトパスに追加します。

  • パス: /Plugins/HIVESDK/Source
    <project_root>
    └─ Plugins
            └─ Source
                    ├─ HiveSDK
                    ├─ HiveSDKAndroid    (オプション)
                    ├─ HiveSDKiOS        (オプション)
                    └─ HiveSDKWindows    (オプション)
    
Note

ハイブSDKでは、ゲームアプリをビルドした後に実行可能ファイル(.apk_、_.IPA、_*.exe_など)が作成されるパッケージング段階で、上記のパスに追加されたプラットフォームパッケージのコードとリソースが各ターゲットOSの実行可能ファイルに自動的に含まれます。

パッケージの互換性

インターフェースパッケージとプラットフォームパッケージは、バージョンが異なっていても、以下のパッケージ互換性ルールに従う限り、一緒に使用できます。

  • 互換性は、major.minor.patch バージョン形式内の 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. 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(remove)"});
              }
      }
      

インターフェースパッケージを削除した後、プロジェクト構造が変更されたため、Unreal Editorを再起動して再コンパイルする必要があります。
Unreal Editorを再起動すると、更新されたプロジェクト構造に基づいて自動的にコンパイルが進行します。この時点で、以前のプロジェクト構造からコンパイルされたバイナリが_Intermediate_および_Binaries_フォルダーにキャッシュされていると、ビルドエラーが発生する可能性があります。この場合、_Intermediate_および_Binaries_フォルダーを削除し、Unreal Editorを再起動して再コンパイルおよび再ビルドしてください。

プラットフォームパッケージを削除する

Unreal Engineの/Plugins/HIVESDK/Sourceパスにインストールされているプラットフォームパッケージを選択して削除します。

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

プラットフォームパッケージを削除した後、変更されたプロジェクト構造によりエディタを再構築するためにUnreal Editorを再起動してください。

ステップ2. 最新のパッケージバージョンをインストールする

最新バージョンのインターフェースパッケージとプラットフォームパッケージをインストールするには、Hive SDKのインストールを参照してください。


注意事項

Unreal Editorを再起動すると、Unreal Engineに組み込みプラグインをインストールできます。この時、CEF(Chromium Embedded Framework)を使用するWebBrowserは、Hive SDKで使用されるCEFと競合するため、適用できません。

Warning

WebBrowser CEFは現在、更新および管理のサポートがされていないため、適用するとセキュリティの脆弱性につながる可能性があります。