Unreal プロジェクトの設定

  • [アーティクル]

組み込みの HoloLens サポートを最大限に活用するため、Unreal Engine version 4.27 または 5.0 のインストールをお勧めします。

Epic Games Launcher の [ライブラリ] タブに移動し、 [起動] の横にあるドロップダウン矢印を選択して、 [オプション] をクリックします。 [対応プラットフォーム] で、 [HoloLens 2] を選択し、 [適用] をクリックします。 Unreal のインストール オプション HoloLens 2

Unreal 用 Mixed Reality Toolkit をインポートする

MRTK

Mixed Reality Toolkit (MRTK) は、Mixed Reality アプリケーション向けのオープン ソースのクロスプラットフォーム開発キットです。 MRTK には、空間でのインタラクションのための、クロスプラットフォームの入力システム、基本コンポーネント、共通の構成要素が備わっています。 このツールキットは、Microsoft HoloLens、Windows Mixed Reality イマーシブ (VR) ヘッドセット、OpenVR プラットフォームをターゲットとしたアプリケーションの開発を加速することを目的としています。

まだ複合現実プロジェクトを持っていない場合は、HoloLens 2 の作業の開始チュートリアルの最初の 3 セクションに従って、プロジェクトを MRTK 用に準備できます。

Unreal 用 MRTK ハブの概要

MRTK プラグインを取得するには、MRTK ハブを使用することをお勧めします。 これは、開発者が Microsoft Mixed Reality プラグインを検出、更新し、Unity プロジェクトに追加するための新しい方法です。 プラグインを表示し、その依存関係を確認し、Unreal Editor を離れることなくプロジェクトにそれらをインストールすることができます。

  • 新しい Microsoft Mixed Reality プラグインを検出し、Unreal プロジェクトにその依存関係と共にインストールします。
  • Microsoft Mixed Reality プラグインを最新の状態に保ちます。
  • 不要になった Microsoft Mixed Reality プラグインをプロジェクトから削除します。

Note

Unreal 用 MRTK ハブは、Unreal Engine バージョン 4.26 以降にのみ使用できます。 Unreal Engine version 4.25+ の場合、「はじめに」セクションで説明されているように、Unreal Engine マーケットプレースまたは GitHub から MRTK プラグインを取得できます。

MRTK ハブをインストールする

Unreal Engine マーケットプレースからプラグインをダウンロードし、プロジェクトを開き、 [プラグイン] メニューの [Mixed Reality] セクションでプラグインを有効にします。 ダイアログが表示されたら、エディターを再起動します。

MRTK Hub プラグインを有効にする

プロジェクトに対してプラグインが有効になると、ツールバー ボタンからハブにアクセスできます。

MRTK Hub ウィンドウを開く

Mixed Reality プラグインをインストールする

ハブを使用してプラグインをインストールするには、プロジェクトに追加するプラグインを選択し、 [インストール] ボタンを押します。 プラグインをダウンロードするには、 [Issues](問題) ボックスに競合がないことを確認し、 [Confirm](確認) を押します。 プラグインがダウンロードされると、エディターを再起動するように求めるメッセージが表示されます。

MRTK ハブを使用したプラグインのインストール

エディターが再起動したら、Mixed Reality の開発体験を続けることができます。

重要

プラグインはインストールされると、他のプロジェクトレベルのプラグインと同様に、ソース管理にチェックインされます。

Mixed Reality プラグインを更新する

ハブを使用してプラグインを更新するには、更新するプラグインを一覧から選択し、 [インストール] ボタンを押します。 更新されたプラグインをダウンロードするには、 [Issues](問題) ボックスに競合がないことを確認し、 [Confirm](確認) を押します。 更新を完了するためにエディターを再起動するように求めるメッセージが表示されます。 プラグインが更新されるため、この再起動に時間がかかる場合があることに注意してください。

MRTK ハブを使用したプラグインの更新

Mixed Reality プラグインを削除する

ハブを使用してプラグインをアンインストールするには、削除するプラグインを選択し、ドロップダウンからインストールしたバージョンを選択します。 プラグインを削除するには、 [Issues](問題) ボックスに競合がないことを確認し、 [Confirm](確認) を押します。 削除を完了するためにエディターを再起動するように求めるメッセージが表示されます。 プラグインが削除されるため、この再起動に時間がかかる場合があることに注意してください。

MRTK ハブを使用したプラグインの削除

変更の確認と非互換性の検出

ハブのウィンドウの下部セクションで、プロジェクトに対して行う正確な変更を表示できます。 ここから、プロジェクトに追加または削除されるプラグインと、変更が行われたときに問題を引き起こす可能性がある潜在的な非互換性を確認できます。

Note

問題の一覧には、Unreal エンジンのバージョンとプラグインの依存関係バージョンの非互換性が表示されますが、問題の修正プログラムは自動的に実行または提案されません。

互換性のないプラグインのインストールの試行

Unreal のロゴ画像
Mixed Reality Toolkit-Unreal (GitHub)

Note

Unreal 用の MRTK を使用しない場合は、すべての対話式操作と動作のスクリプトを開発者が自分で作成する必要があります。