演習 - リソースをインポートして構成する

10 分

Mixed Reality Feature Tool をインストールする

Mixed Reality Toolkit をプロジェクトにインポートするには、Mixed Reality Feature Tool を使用します。 Mixed Reality Feature Tool によって、開発者は機能パッケージの検出、更新、インポートを行うことができます。名前またはカテゴリでパッケージを検索し、それらの依存関係を確認し、インポートする前にプロジェクトマニフェストファイルに提案された変更を確認することができます。

Microsoft ダウンロードセンターから Mixed Reality Feature Tool の最新バージョンをダウンロードします。
ダウンロードの終了後、MixedRealityFeatureTool.exe ファイルを開き、これを使用して Mixed Reality Feature Tool を起動します。

Note

Mixed Reality Feature Tool を実行する前に、.NET 6.0 ランタイムをインストールすることが必要な場合があります。

MRTK Unity Foundation パッケージをインポートする

Mixed Reality Feature Tool で、[開始] を選択します。
[参照] ボタン (下の図の "3 ドット" ボタン) を選択し、プロジェクトに移動して開きます。

フォルダーを選択すると、このツールにより、有効な Unity プロジェクトフォルダーであることが確認されます。
[機能の検出] を選択します。

Note

ツールがフィードからパッケージを更新するまで、数秒間待つことが必要な場合があります。
[機能の検出] ページには、利用可能なパッケージグループの一覧が表示されることに注意してください。
[Platform Support (0 of 5)] の左側にある [+] ボタンを選択して、Mixed Reality OpenXR プラグインの最新バージョンを選択します。
すべての機能が選択されるように、MRTK3 の右側にある [すべて選択] ボタンを選択します。

Note

非推奨のマークが付けられているパッケージが表示された場合は、それらを削除し、[設定]>[機能]>[非推奨のパッケージを表示] の選択が解除されていることを確認する必要があります。
選択したら、[機能の取得] を選択します。
[検証] を選択して、選択したパッケージを検証します。 [検証の問題は検出されませんでした] というダイアログが表示されます。その後、[OK] を選択します。
[機能のインポート] ページの左側にある [機能] の列に、選択したパッケージが表示されます。右側の [必須の依存関係] 列に、依存関係が表示されます。これらの項目の [詳細] リンクを選択すると、詳細を確認できます。
次に進む準備ができたら、[インポート] を選択します。[確認と承認] ページで、パッケージに関する情報を確認できます。
[承認] を選択します。
終了を選択します。
Unity エディターに戻り、UI の空白領域を選択します。パッケージがインポートされているというメッセージを示す進行状況バーが表示されます。

Unity プロジェクトを構成する

Unity によってパッケージがインポートされた後、エディターを再起動してバックエンドを有効にするかどうかを確認する警告が表示されます。 [はい] を選択します。
Unity が、XR InteractionLayerMask のメソッドの更新について尋ねるメッセージを表示します。[I Made a Backup, Go Ahead!] ボタンを選択し、Unity の再起動を待ちます。
メニューバーで、[Mixed Reality]>[Project]>[Apply recommended project settings for HoloLens] を選択します。
メニューバーで、[編集]>[プロジェクトの設定...] を選択します。[XR Plug-in Management] を選択します。 [Initialize XR on Startup] が選択されていることを確認してから、[Plugin Providers] で [OpenXR] を選択します。
OpenXR プラグインが読み込まれ、[OpenXR] の下に 2 つの項目が表示されます。最初の項目である [Microsoft HoloLens 機能グループ] を選択します。黄色の感嘆符を選択します。
[すべて修正] を選択します。

一部の警告が残る場合があります。ここでは無視してください。
[XR Plug-in Management] で [OpenXR] を選択します。
追加されていない場合は、[Interaction Profiles] (対話式操作プロファイル) で、[Microsoft Hand Interaction] (Microsoft ハンド対話式操作) と [Eye Gaze Interaction Profile] (視線入力対話式操作プロファイル) を追加します。
左側の [Microsoft Hololens] が選択され、右側の [ハンドトラッキング]、[Mixed Reality 機能]、[モーションコントローラーモデル] が選択されていることを確認します。
[Eye Gaze Interaction Profile] (視線入力対話式操作プロファイル) の警告記号を選択して、[Project Validation] (プロジェクトの検証) ウィンドウに戻ります。 [UWP プラットフォーム] タブ (タブには Windows のロゴが表示されます) で操作していることを確認し、[すべて修正] を選択して検証の問題を解決します。 [すべて修正] を選択した後も問題が残る可能性があります。その場合は、もう一度 [すべて修正] を選択し、[Scene specific] (シーン固有) のマークが付けられている問題はすべて無視します。次に、残りの問題に関する推奨事項 (存在する場合) を読み、必要な変更を加えます。
[プロジェクト設定] で [MRTK3] を選択し、有効なプロファイルがあるかどうかを確認します。ない場合は、プロジェクトのパッケージ (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) で MRTKProfile を検索し、プロファイルに割り当てます。

プロジェクトの設定を構成する

メニューバーで、[編集]>[プロジェクト設定] を選択します。
[プロジェクト設定] ウィンドウの左側の列で、[プレーヤー] を選択します。
[プレーヤー] ウィンドウで、[製品名] は "MRTK チュートリアル" であることに注意してください。これはプロジェクト名から取得され、HoloLens の [スタート] メニューに表示される名前になります。

ヒント

開発中にアプリを見つけやすくするには、名前の前にアンダースコアを追加すれば、リストの先頭に表示されます。
[公開の設定] ドロップダウンを選択し、[パッケージ名] フィールドに適切な名前 (例: MRTK-Tutorials-Getting-Started) を入力します。

注意

パッケージ名は、アプリの一意の識別子です。以前にインストールしたバージョンのアプリが同じ名前で上書きされないようにするには、アプリを展開する前にこの識別子を変更する必要があります。
[Project Settings](プロジェクト設定) ウィンドウを閉じます。

シーンを作成して MRTK を構成する

メニューバーで、[ファイル]>[新しいシーン] の順に選択します。 [基本 (組み込み)] オプションを選択し、[作成] を選択します。
[プロジェクト] ウィンドウで [パッケージ]>[MRTK Input] (MRTK 入力)>[アセット]>[Prefabs] (プレハブ) フォルダーに移動します。プレハブ MRTK XR リグ をシーン階層にドラッグします。
MRTK XR リグ ゲームオブジェクトには既にカメラが含まれているため、メインカメラ ゲームオブジェクトを削除します。
MRTK 入力シミュレーター ([パッケージ]>[MRTK Input] (MRTK 入力)>[シミュレーション]>[Prefabs] (プレハブ)) プレハブをシーンに追加します。

Note

この手順はオプションですが、エディタ内シミュレーションでは必須です。
メニューバーから、[ファイル]>[名前を付けて保存...] の順に選択します。
[資産]>[シーン] フォルダーに移動し、プロジェクトに名前を付け、プロジェクトを保存します。