Android Single Instance Service を設定する

このガイドでは、Unreal Engine で Android Single Instance Service (ASIS) を設定し、Unreal Engine プロジェクトを Android アプリケーションとして作成、パッケージ化、実行する方法を説明します。

Android SDK および NDK を設定する

ASIS を設定するには、最初に Unreal Engine で Android ソフトウェア開発キット (SDK) と Android ネイティブ開発キット (NDK) を設定する必要があります。 Unreal Engine は、Android プロジェクトの開発に必要な Android SDK コンポーネントをダウンロードし、インストールするために Android Studio と Android SDK コマンドライン ツールを使用します。

Android SDK および NDK を設定するには、以下の手順に従ってください。

1. 「Android SDK および NDK を設定する」ページの指示に従います。  

2. Unreal Engine 5.5 以降を使用している場合は、以下の SDK プラットフォームおよびツールを有効にしてください。

   1. [SDK Tools (SDK ツール)] > [Android SDK Build-Tools 36 (Android SDK ビルドツール 36)] > [35.0.0] および [34.0.0]

      

   2. [SDK Tools (SDK ツール)] > [NDK (Side by side) (NDK (並行))] > [25.1.8937393]

      

   3. [SDK Platforms (SDK プラットフォーム)] > [Android 14.0 ("UpsideDownCake")]、API レベル 34

      

ASIS テンプレートから新しいプロジェクトを作成する  

Android SDK および NDK のインストール後、ASIS テンプレート プラグインを設定できます。 このプラグインは個別のアーカイブとして提供されるため、Unreal Engine のソースコードを準備するには手動での作業が必要です。

Unreal Engine のソースコードを取得する

Perforce または GitHub の UE5 Main から最新のソースコードをプルします。 Unreal Engine での Perforce または GitHub の使用について詳しくは、以下のリソースを参照してください。

• ソース コントロールとして Perforce を使用する

• Unreal Engine 5 の使用方法 - Perforce

• GitHub で Unreal Engine のソースコードにアクセスする

• Unreal Engine のソース コードをダウンロードする

• ソースから Unreal Engine をビルドする

ASIS プラグインを設定する

1. ASIS テンプレート フォルダに移動します。

1. ASIS テンプレート フォルダに移動します。

   1. Perforce を使用している場合は、「UE5_Main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService\Templates\」に移動します。

   2. GitHub を使用している場合は ue5-main ブランチにアクセスし、「ue5-main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService」に移動します。 

2. 「TP_HMI_ASIS」フォルダを「UE5_Main\Templates\」(Perforce) または「ue5-main\Templates\」(GitHub) にコピーします。

3. 以下のコードをコピーして「UE5_Main\Templates\TemplateCategories.ini」(Perforce) または「ue5-main\Templates\TemplateCategories.ini」(GitHub) に貼り付けます。

   C++

   Categories=(Key="HMI", LocalizedDisplayNames=((Language="en",Text="Automotive\nHMI &\nVehicle Cockpit using Android Single Instance Service")), LocalizedDescriptions=((Language="en",Text="Find templates for automotive vehicle cockpit using Android Single Instance Service"), Icon="TP_HMI_ASIS/Media/AutomotiveHMI_2x.png", IsMajorCategory=true)

   Copy full snippet(1 line long)

4. UnrealEditor を実行します。 Unreal プロジェクトブラウザに新しい HMI テンプレートが追加されています。

   

5. [Create (作成)] をクリックします。 プロジェクトは以下のスクリーンショットのようになります。

   

既存のプロジェクトに ASIS プラグインを追加する

既存のプロジェクトに ASIS プラグインを追加する

既存のプロジェクトに ASIS プラグインを追加するには、以下の手順に従ってください。

1.  [Edit (編集)] > [Plugins (プラグイン)] に移動し、[AndroidSingleInstanceService] を有効にします。

   

2. 以下のコードをコピーして「{Project_Name}/Config/DefaultGame.ini」ファイルに貼り付けます。

   Config

   [Staging]
   +RemapDirectories=(From="Engine/Restricted/NotForLicensees/Plugins/AndroidSingleInstanceService", To="Engine/Plugins/Runtime/AndroidSingleInstanceService")
   +RemapDirectories=(From="Engine/Restricted/NotForLicensees/Plugins/Experimental/MultiWindow", To="Engine/Plugins/Experimental/MultiWindow")

   Copy full snippet(3 lines long)

3. Unreal Engine で [Edit (編集)] > [Project Settings (プロジェクト設定)] に移動します。

4. [Plugins (プラグイン)] > [AndroidSingleInstanceService] で、以下の設定を有効にします。

   

   1. ASISProject をコンパイル

   2. asis libs の生成を有効にする

   3. AndroidSingleInstanceService を使用する

ASIS プロジェクトをパッケージ化および実行する

Unreal Engine プロジェクトで ASIS を設定すると、プロジェクトを Android アプリケーションとしてパッケージ化および実行できます。

ASIS プロジェクトを Android アプリケーションとしてパッケージ化するには、以下の手順に従ってください。

1. メインのツールバーで [Platforms (プラットフォーム)] > [Android] > [Package Project (プロジェクトをパッケージ化)] をクリックします。

   

2. [Output Log (出力ログ)] でビルドが正常に完了したことを確認します。

   

デフォルトでは、パッケージは「/Documents/UnrealProjects/_packages/ASIS_Package」に保存されます。

Android アプリケーションと Unreal Engine APK 間の通信

アプリケーションをパッケージ化すると、サンプルのクライアント アプリケーションを使用して Unreal Engine APK と通信できます。

Unreal Engine パッケージは以下の 3 つの主要部分で構成されています。

• Android サービスを含む APK。 これは、プロジェクト パッケージ ダイアログで選択したフォルダ内に配置されています。

• クライアント アプリケーションで使用される一連の ASIS ヘルパー ライブラリ。

  C++

  Binaries/Android/aars
  ├── asisclientlib-1.0.1-debug.aar
  ├── asisclientlib-1.0.1-debug.jar
  ├── asiscommon-1.0.1-debug.aar
  └── asiscommon-1.0.1-debug.jar

  Copy full snippet(5 lines long)

• サービスと通信するサンプルのクライアント アプリケーション。 これはパッケージ化された Unreal Engine プロジェクトではなく、Unreal Engine プロジェクトのバイナリ フォルダ (\Unreal Projects\{Project_Name}\Binaries\Android) に配置されています。

  

Android Studio を使用してサンプルの Android プロジェクトを開くことができます。 プロジェクトを開くと、Android のビルドプロセスが自動的に実行されます。 

また、以下のコマンドライン プロンプトを使用してプロジェクトをビルドすることもできます。

cd {Project_Name}\Binaries\Android\ExampleUseCase_{Project_Name}\
gradlew assembleDebug

このコマンドによって、APK ファイルが「{Project_Name}\Binaries\Android\ExampleUseCase_{Project_Name}\app\build\outputs\apk\debug\app-debug.apk」に生成されます。

Android Studio で Android デバイスを選択した状態で Shift + F10 キーを押すか、上部のツールバーで [Play (再生)] ボタンをクリックすることでアプリケーションを実行できます。

Android デバイスに APK をインストールするには、以下の adb コマンドを実行します。

adb install {Project_Name}.apk

デバイスのアプリケーションで [Activate View1 (アクティブビュー1)]、[Activate View2 (アクティブビュー2)]、[Activate View3 (アクティブビュー3)] をタップし、Android サービスが Unreal Engine アプリケーションと通信していることを確認します。