シーンをカスタマイズするためのサポートパッケージのインストール

Unreal^® Editor のインストール環境でシーンをカスタマイズし、Simulink^® でそのシーン内でシミュレートするには、まず Automated Driving Toolbox Interface for Unreal Engine Projects をインストールする必要があります。

メモ

以下のインストール手順は "R2025a" に適用されます。以前のリリースを使用している場合は、他のリリースのドキュメンテーションを参照してください。

ソフトウェアおよびハードウェア要件の確認

サポートパッケージをインストールする前に、ご使用の環境がUnreal Engine シミュレーション環境の要件と制限に記載されている最小ソフトウェアおよびハードウェア要件を満たしていることを確認してください。

サポートパッケージのインストール

Automated Driving Toolbox™ Interface for Unreal Engine^® Projects サポートパッケージをインストールするには、次の手順に従います。

MATLAB^® [ホーム] タブの [環境] セクションで [アドオン] 、 [アドオンの入手] を選択します。
[アドオンエクスプローラー] ウィンドウで Automated Driving Toolbox Interface for Unreal Engine Projects サポートパッケージを検索します。[インストール] をクリックします。

メモ
インストールフォルダーに対する書き込み権限がなければなりません。

サポートパッケージを使用したシーンのカスタマイズの設定

Automated Driving Toolbox Interface for Unreal Engine Projects サポートパッケージには、次のコンポーネントが含まれています。

プラグイン

AutoVrtlEnv フォルダー — AutoVrtlEnv.uproject ファイルおよび対応するサポートファイルが含まれている Unreal Engine プロジェクトフォルダー。このプロジェクトには、Simulation 3D Scene Configuration ブロックの [シーン名] パラメーターから選択できる、あらかじめ用意されたシーンの編集可能版が含まれています。Simulink から .uproject ファイルを開く必要があります。
MathWorkSimulation — Simulink と Unreal Editor 間の接続を確立するプラグイン。コシミュレーションに必要です。
MathWorksAutomotiveContent — Unreal Editor を使用して変更できる自動車関連オブジェクトの要素を含むプラグイン。コシミュレーションに必要です。
RoadRunnerMaterials — RoadRunner シーンで使用されるオブジェクトおよびベースマテリアルの特徴を含むプラグイン。

RoadRunner プロジェクト

RoadRunnerProject フォルダー — RoadRunner シーン編集ソフトウェアを使用して直接編集できる、あらかじめ用意されたシーンが含まれているフォルダー。このフォルダーには次のサブフォルダーがあります。

- Scenes — あらかじめ用意されたすべてのシーンのシーンファイルが含まれているフォルダー。
- Assets — あらかじめ用意されたシーンの作成に使用されたアセットが含まれているフォルダー。

シーンのカスタマイズを設定するには、AutoVrtlEnv プロジェクトおよび MathWorksSimulation プラグインフォルダーをローカルマシンにコピーする必要があります。

サポートパッケージのインストールと設定が終わったら、シーンのカスタマイズを開始できます。Automated Driving Toolbox Interface for Unreal Engine Projects サポートパッケージの以前のリリースを使用して開発されたプロジェクトを使用する場合は、現在サポートされている Unreal Editor バージョンとの互換性をもたせるためにプロジェクトを移行する必要があります。以前のサポートパッケージを使用して開発したプロジェクトの移行を参照してください。それ以外の場合は、Customize Scenes Using Simulink and Unreal Editorを参照してください。

ローカルフォルダーへの `AutoVrtlEnv` プロジェクト、および `MathWorksSimulation` と `MathWorksAutomotiveContent` のプラグインのコピー

シーンをカスタマイズできるように、ローカルマシンのフォルダーにサポートパッケージのコンポーネントをすべてコピーし、環境を構成するには、関数 copyExampleSim3dProject を使用します。たとえば、次のコードはプロジェクトファイルを C:\project にコピーします。

localFolder = "C:\project"
sim3d.utils.copyExampleSim3dProject(localFolder);

プラグインファイルは既定の場所である c:\Program Files\Epic Games\UE_5.3\Plugins\Marketplace\Mathworks にコピーされます。Unreal Engine を別の場所にインストールする場合は、引数 PluginDestination を指定します。

(オプション) ローカルフォルダーへの `RoadRunnerProject` プロジェクトフォルダーのコピー

RoadRunner を使用して、あらかじめ用意されたシーンを直接編集するには、RoadRunnerProject プロジェクトをローカルマシンにコピーします。

プロジェクトが含まれているサポートパッケージフォルダーのパスを指定します。また、プロジェクトをコピーする先のローカルフォルダーを指定します。次のコードでは、前のセクションと同じサポートパッケージパスとローカルフォルダーパスを使用しています。
```
rrProjectSupportPackageFolder = fullfile( ...
    matlabshared.supportpkg.getSupportPackageRoot, ...
    "toolbox","shared","sim3dprojects","spkg","roadrunner", ...
    "RoadRunnerProject");
rrProjectLocalFolder = fullfile(localFolder,"roadrunner/RoadRunnerProject");
```
サポートパッケージフォルダー内の RoadRunnerProject プロジェクトをコピー先のローカルフォルダーにコピーします。
```
if ~exist(rrProjectLocalFolder,"dir")
    copyfile(rrProjectSupportPackageFolder,rrProjectLocalFolder);
end
```
これで、あらかじめ用意されたシーンおよびアセットがすべて、指定したローカルフォルダーに配置されました。

Linux プラットフォームでの環境の構成

Linux^® プラットフォームでシーンをカスタマイズできるように環境を構成するには、次を行います。

フォルダー構造 /UnrealEngine/UnrealEngine-5.3/UnrealEngine/Engine/... を指定して、ルートディレクトリに Unreal Editor をインストールします。
copyExampleSim3dProject を使用して、サポートパッケージのコンポーネントをコピーし、PluginDestination を /UnrealEngine/UnrealEngine-5.3/UnrealEngine/Engine/Plugins/Marketplace/Mathworks に指定します。
Unreal Editor を .uproject ファイルの既定のアプリケーションに設定します。
たとえば、AutoVrtlEnv.uproject に移動します。
- AutoVrtlEnv.uproject ファイルを右クリックし、[Open With] を選択してから、[Open With Other Application] を選択します。
- [Browse] をクリックし、Unreal Editor アプリケーションを選択します。[Open With] ダイアログボックスで、[Use as default for this kind of file] を選択します。