シーンをカスタマイズするためのサポート パッケージのインストール
Unreal® Editor のインストール環境でシーンをカスタマイズし、Simulink® でそのシーン内でシミュレートするには、まず Automated Driving Toolbox Interface for Unreal Engine 4 Projects をインストールする必要があります。
メモ
以下のインストール手順は "R2022b" に適用されます。以前のリリースを使用している場合は、他のリリースのドキュメンテーションを参照してください。
ソフトウェアおよびハードウェア要件の確認
サポート パッケージをインストールする前に、ご使用の環境がUnreal Engine シミュレーション環境の要件および制限に記載されている最小ソフトウェアおよびハードウェア要件を満たしていることを確認してください。
サポート パッケージのインストール
Automated Driving Toolbox™ Interface for Unreal Engine® 4 Projects サポート パッケージをインストールするには、次の手順に従います。
MATLAB® [ホーム] タブの [環境] セクションで [アドオン] 、 [アドオンの入手] を選択します。
[アドオン エクスプローラー] ウィンドウで Automated Driving Toolbox Interface for Unreal Engine 4 Projects サポート パッケージを検索します。[インストール] をクリックします。
メモ
インストール フォルダーに対する書き込み権限がなければなりません。
サポート パッケージを使用したシーンのカスタマイズの設定
Automated Driving Toolbox Interface for Unreal Engine 4 Projects サポート パッケージには、次のコンポーネントが含まれています。
AutoVrtlEnv
フォルダー —AutoVrtlEnv.uproject
ファイルおよび対応するサポート ファイルが含まれている Unreal Engine プロジェクト フォルダー。このプロジェクトには、Simulation 3D Scene Configuration ブロックの [シーン名] パラメーターから選択できる、あらかじめ用意されたシーンの編集可能版が含まれています。MathWorkSimulation
— Simulink と Unreal Editor 間の接続を確立するプラグイン。コシミュレーションに必要です。MathWorksAutomotiveContent
— Unreal Editor を使用して変更できる自動車関連オブジェクトの要素を含むプラグイン。コシミュレーションに必要です。RoadRunnerScenes
フォルダー — RoadRunner シーン編集ソフトウェアを使用して作成されたシーンの Unreal Engine プロジェクトおよび対応する実行可能ファイルが含まれたフォルダー。このフォルダーには次のサブフォルダーがあります。RRScene
—RRScene.uproject
ファイルおよび対応するサポート ファイルが含まれている Unreal Engine プロジェクト フォルダー。このプロジェクトには、Highway Lane Following with RoadRunner Sceneの例で使用されているシーンの編集可能版が含まれています。WindowsPackage
— 実行可能ファイルRRScene.exe
およびサポート ファイルが含まれているフォルダー。この実行可能ファイルを使用して、Highway Lane Following with RoadRunner Sceneの例で説明されている Simulink モデルをコシミュレートします。
RoadRunnerMaterials
— RoadRunner シーンのオブジェクトの特徴を含むプラグイン。
シーンのカスタマイズを設定するには、AutoVrtlEnv
プロジェクトおよび MathWorksSimulation
プラグイン フォルダーをローカル マシンにコピーする必要があります。Highway Lane Following with RoadRunner Sceneの例で使用されている RoadRunner シーンをカスタマイズするには、RRScene
プロジェクトをローカル マシンにコピーし、RoadRunnerMaterials
プラグインをダウンロードしてローカル プロジェクトにコピーする必要があります。
サポート パッケージのインストールと設定が終わったら、シーンのカスタマイズを開始できます。Automated Driving Toolbox Interface for Unreal Engine 4 Projects サポート パッケージの以前のリリースを使用して開発されたプロジェクトを使用する場合は、現在サポートされている Unreal Editor バージョンとの互換性をもたせるためにプロジェクトを移行する必要があります。以前のサポート パッケージを使用して開発したプロジェクトの移行を参照してください。それ以外の場合は、Customize Scenes Using Simulink and Unreal Editorを参照してください。
ローカル フォルダーへの AutoVrtlEnv
プロジェクトのコピー、および Unreal Editor への MathWorksSimulation
と MathWorksAutomotiveContent
のプラグインのコピー
シーンをカスタマイズできるように、ローカル マシンのフォルダーにサポート パッケージのコンポーネントをすべてコピーし、環境を構成するには、関数 copyExampleSim3dProject
を使用します。たとえば、次のコードはファイルを C:\project
にコピーします。
sim3d.utils.copyExampleSim3dProject("C:\project");
(オプション) ローカル フォルダーへの RRScene
プロジェクトのコピー
RRScene
プロジェクト フォルダーでシーンをカスタマイズするには、プロジェクトをローカル マシンにコピーします。
プロジェクトが含まれているサポート パッケージ フォルダーのパスを指定します。また、プロジェクトをコピーする先のローカル フォルダーを指定します。次のコードでは、前のセクションと同じサポート パッケージ パスとローカル フォルダー パスを使用しています。
rrProjectSupportPackageFolder = fullfile( ... matlabshared.supportpkg.getSupportPackageRoot, ... "toolbox","shared","sim3dprojects","driving", ... "RoadRunnerScenes","RRScene"); rrProjectLocalFolder = fullfile(localFolder,"RRScene");
サポート パッケージ フォルダー内の
RRScene
プロジェクトをコピー先のローカル フォルダーにコピーします。if ~exist(rrProjectLocalFolder,"dir") copyfile(rrProjectSupportPackageFolder,rrProjectLocalFolder); end
これで、RRScene.uproject
ファイルとそのすべてのサポート ファイルが指定したローカル フォルダー内の RRScene
という名前のフォルダーに配置されました。例: C:\Local\RRScene
。
(オプション) Unreal Editor への RoadRunnerMaterials
プラグインのコピー
RRScene
プロジェクト フォルダー内のシーンをカスタマイズする場合は、RoadRunnerMaterials
プラグインをプラグイン プロジェクト フォルダーにコピーする必要もあります。
最新の RoadRunner プラグインが含まれた ZIP ファイルをダウンロードします。プラグインのダウンロード (RoadRunner)を参照してください。ZIP ファイルの内容をローカル マシンに解凍します。解凍したフォルダーの名前の形式は
RoadRunner Plugins x.x.x
です。ここで、x.x.x
はプラグインのバージョン番号です。RoadRunnerMaterials
プラグインのパスを指定します。このプラグインは、解凍したフォルダーのUnreal/Plugins
フォルダー内にあります。プラグインをダウンロードした場所とプラグインのバージョン番号に合わせて、次のコードを更新してください。rrMaterialsPluginFolder = fullfile("C:","Local","RoadRunner Plugins 1.0.3", ... "Unreal","Plugins","RoadRunnerMaterials");
ローカル
RRScene
プロジェクトで、プラグインをコピーするPlugins
フォルダーを作成します。次のコードでは、前のセクションで指定したローカルRRScene
プロジェクトのパスを使用しています。rrProjectPluginFolder = fullfile(rrProjectLocalFolder,"Plugins","RoadRunnerMaterials");
RoadRunnerMaterials
プラグインをローカル プロジェクトのPlugins
フォルダーにコピーします。copyStatus = copyfile(rrMaterialsPluginFolder,rrProjectPluginFolder); if copyStatus disp("Successfully copied RoadRunnerMaterials plugin to RRScene project plugins folder.") else disp("Unable to copy RoadRunnerMaterials plugin to RRScene project plugins folder.") end
サポート パッケージのインストールと設定が終わったら、シーンのカスタマイズを開始できます。Automated Driving Toolbox Interface for Unreal Engine 4 Projects サポート パッケージの以前のリリースを使用して開発されたプロジェクトを使用する場合は、現在サポートされている Unreal Editor バージョンとの互換性をもたせるためにプロジェクトを移行する必要があります。以前のサポート パッケージを使用して開発したプロジェクトの移行を参照してください。それ以外の場合は、Customize Scenes Using Simulink and Unreal Editorを参照してください。