Unreal Engineプロジェクトに Genvid MILE SDK をインストールする。¶
このセクションでは、 Genvid MILE SDK をアンリアル・エンジン 4 または 5 のプロジェクトに統合するために必要な最初の手順について説明します。
In This Section
はじめに¶
Genvid SDK は、現在 Unreal Engine 4.15 から 5.0 をサポートしています。各Unreal Engineバージョンの最新リビジョンを使用することをお勧めします。
Unreal Engine 4.15 から 4.19 では、Visual Studio 2015 toolchain の最新版がインストールされていることを確認してください (Visual Studio 2017 のビルドツールは、Microsoft ダウンロード サイトからダウンロードできます)。
Visual Studio 2015 、 2017 toolchain のインストール手順:
- Visual C++ Build Tools 実行ファイルを起動します。
- Workloads タブで Visual C++ Build Tools を選択します。
- Summary セクションから Visual Studio 2015 を使用するには、以下のコンポーネントを選択します。
- Windows Univeral CRT SDK
- Windows 8.1 SDK
- VC++ 2015.3 v14.00 (v140) toolset for desktop
- .NET Framework 4.5 targeting pack
Unreal Engine 4.20 から 4.27 では、Visual Studio 2017 toolchain の最新版がインストールされていることを確認してください (Visual Studio 2017 のビルドツールは、Microsoft Visual Studio Essentials download サイトからダウンロードできます。ログインには、最低でも無料のアカウントが必要です)。
Unreal Engine 4.25 以降の場合は、Visual Studio Essentials 2019 の使用をお勧めします (Visual Studio Essentials 2019 は、Microsoft Visual Studio のダウンロードページ から入手できます)。詳細については、Unreal Engine 4.25 リリースノート の Platform SDK Upgrades セクションを参照してください。
注釈
Visual Studio 2015 がコンピュータにインストールされていない場合、Unreal Engine Cube Sample のビルド時に次の 2 つの警告メッセージが表示されます。これらは予期されるものであり、ビルドの生成を妨げるものではありません。安心して無視してください。
警告メッセージ
CommandEnvironment.SetupBuildEnvironment: WARNING: C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Devenv.com does not exist. CommandEnvironment.SetupBuildEnvironment: WARNING: Assuming no solution compilation capability.
ゲームフォルダにインストールする¶
注釈
このセクションでは、ゲームの .uproject ファイルが存在するフォルダを UE4_PROJ_ROOT と呼んでいます。
Genvid プラグインは engine-integration/ue4/ で見つけることができます。プラグインをインストールするには、ゲームのプラグインディレクトリ UE4_PROJ_ROOT/Plugins/ にプラグインをコピーします。
GenvidPlugin プラグインは、Genvid ライブラリの機能を公開するために使用されます。このプラグインは engine-integration/ue4/GenvidPlugin で見つけることができます。
Genvid プラグインは、C++ コードと Unreal Engine ブループリントの両方で Genvid 機能をより簡単に使用できるようにするためのラッパーです。このプラグインは engine-integration/ue4/Genvid で見つけることができます。
注釈
以前は、 Genvid プラグインは、 UE4_PROJ_ROOT/Source/ にコピーされたモジュールでした。バージョン 1.39.0 以降では、別のプラグインになりました。1.39.0 よりも古いバージョンからアップグレードする場合は、 UE4_PROJ_ROOT/Source/Genvid フォルダを削除する必要があります。
SDK の新バージョンにアップデートする場合で、プラグインフォルダを丸ごとコピーしたくない場合は、以下の Genvid Native API ファイルをコピーする必要があります。
api/native/include/genvid.h->UE4_PROJ_ROOT/Plugins/GenvidPlugin/Source/ThirdParty/GenvidSDK/include/genvid.hUE4_PROJ_ROOT/Plugins/GenvidPlugin/ThirdParty/GenvidSDK/include/genvid.hUE4_PROJ_ROOT/Plugins/Genvid/Source/ThirdParty/GenvidLib/GenvidSDKInterface/include/genvid.hこれは Genvid Native SDK のヘッダーファイルで、すべての関数と型を宣言しています。api/native/Win64/Genvid.lib->UE4_PROJ_ROOT/Plugins/GenvidPlugin/ThirdParty/GenvidSDK/Win64/Genvid.libUE4_PROJ_ROOT/Plugins/GenvidPlugin/Source/ThirdParty/GenvidSDK/Win64/Genvid.libリンク時に使用する64ビットインポートライブラリです。ランタイムには、関連するGenvid.dllが必要です。api/native/Win64/Genvid.dll->UE4_PROJ_ROOT/Plugins/GenvidPlugin/ThirdParty/GenvidSDK/Win64/Genvid.dllUE4_PROJ_ROOT/Plugins/GenvidPlugin/Source/ThirdParty/GenvidSDK/Win64/Genvid.dll実行時に使用する64ビット共有ライブラリです。api/native/Win32/Genvid.lib->UE4_PROJ_ROOT/Plugins/GenvidPlugin/ThirdParty/GenvidSDK/Win32/Genvid.libUE4_PROJ_ROOT/Plugins/GenvidPlugin/Source/ThirdParty/GenvidSDK/Win32/Genvid.libリンク時に使用する32ビットインポートライブラリです。ランタイムには、関連するGenvid.dllが必要です。api/native/Win32/Genvid.dll->UE4_PROJ_ROOT/Plugins/GenvidPlugin/ThirdParty/GenvidSDK/Win32/Genvid.dllUE4_PROJ_ROOT/Plugins/GenvidPlugin/Source/ThirdParty/GenvidSDK/Win32/Genvid.dll実行時に使用する32ビット共有ライブラリです。
engine-integration/ue4/ で、必要なファイルを簡単にコピーする Python スクリプトを提供しています。一度にすべてのファイルをコピーするには、次のコマンドを実行します。
py copy-ue4-plugin.py checkout {UE4_PROJ_ROOT}
スクリプトは、コピーされたファイルで更新されるマニフェスト ファイルを作成します。以前のマニフェスト ファイルが検出された場合、新しいファイルをコピーする前に、そのコンテンツ内のすべてのファイルをクリーンアップします。
注釈
SDK バージョン 1.25 をスタートすると、マニフェストファイルは、プラグインフォルダではなくアプリケーションフォルダに配置されます。既存のマニフェストファイルをアプリケーションフォルダに移動して使用してください。
--dry-run オプションで、スクリプトの動作を実行前に確認することができます。詳細は、 copy-ue4-plugin.py を参照してください。
全てのファイルをコピーしたら（必要であれば Git リポジトリから Unreal Engine を取得）、 GenerateProjectFiles.bat を再度実行すれば Genvid Plugins にアクセスできるはずです。