MRTK2 サンプル ハブ

  • [アーティクル]

MRTK2 サンプル ハブ

MRTK2 Examples Hub は、複数のシーンを簡単に体験できる Unity シーンです。 MRTK のシーン システムを使用して、シーンをロード & アンロードします。

MRTKExamplesHub.unity は、MixedRealityToolkit や MixedRealityPlayspace などの共有コンポーネントが含まれるコンテナー シーンです。 MRTKExamplesHubMainMenu.unity シーンにはキューブ ボタンがあります。

HoloLens 2 の Microsoft Store からアプリをダウンロードする

HoloLens 2 デバイスをお持ちの場合は、デバイスに直接アプリをダウンロードしてインストールできます。

英語バッジ

前提条件

MRTK Examples Hub では、シーン切り替えサービスと関連スクリプトを使用します。 Unity パッケージを介した MRTK を使用している場合は、リリース パッケージの一部である Microsoft.MixedReality.Toolkit.Unity.Extensions.x.x.x.unitypackage をインポートしてください。 リポジトリの複製を介して MRTK を使用している場合は、プロジェクトに MRTK/Extensions フォルダーが既に存在しているはずです。

MRTKExamplesHub シーンとシーン システム

MRTKExamplesHub.unity を開きます。これは、MRTK/Examples/Experimental/Demos/ExamplesHub/Scenes/ にあり、MixedRealityToolkit、MixedRealityPlayspace、LoadHubOnStartup を使用した空のシーンです。 このシーンは、MRTK のシーン システムを使用するように構成されています。 MixedRealityToolkit の下の MixedRealitySceneSystem をクリックします。 [Inspector](インスペクター) パネルにシーン システムの情報が表示されます。



ハブ階層の例

インスペクター 1

Inspector の下部に、シーン システム プロファイルで定義されているシーンの一覧が表示されます。 シーン名をクリックすると、それらをロードおよびアンロードできます。



インスペクター 2

シーン システム 3一覧内のシーン名をクリックして MRTKExamplesHub シーンを読み込む例。

シーン システム 4HandInteractionExamples シーンを読み込む例。

シーン システム 5 複数のシーンを読み込む例。

シーンの実行

シーンは、Unity のゲーム モードとデバイスの両方で動作します。 Unity エディターで MRTKExamplesHub シーンを実行し、MRTK の入力シミュレーションを使用してシーンの内容を操作します。 ビルドと展開を行うには、単に、シーン システムの一覧に含まれている他のシーンを使用して MRTKExamplesHub シーンをビルドします。 インスペクターを使用すると、[Build Settings](ビルド設定) にシーンを簡単に追加できます。 [Build Settings](ビルド設定) で、MRTKExamplesHub シーンがインデックス 0 の一覧の先頭にあることを確認します。

ビルド設定

MRTKExamplesHub がシーンをロードする方法

MRTKExamplesHub シーンには、ExamplesHubButton プレハブがあります。 プレハブには を含む InteractableFrontPlate オブジェクトがあります。 対話可能の OnClick() と OnTouch() イベントを使用して、LoadContentScene スクリプトの LoadContent() 関数がトリガーされます。 LoadContentScene スクリプトのインスペクターで、ロードするシーン名を定義できます。



シーン システム 6

シーン システム 8

シーン システム 7

このスクリプトでは、シーン システムの LoadContent() 関数を使用してシーンをロードします。 詳細については、シーン システムのページを参照してください。

MixedRealityToolkit.SceneSystem.LoadContent(contentName, loadSceneMode);

メイン メニュー シーンに戻る

メイン メニュー シーン (MRTKExamplesHubMainMenu シーン) に戻るには、同じシーン システムの LoadContent() メソッドを使用できます。 ToggleFeaturesPanelExamplesHub.prefab には、LoadContentScene スクリプトを含む "ホーム" ボタンが用意されています。 このプレハブを使用して、各シーンにカスタムのホーム ボタンを用意して、ユーザーがメイン シーンに戻れるようにします。 ToggleFeaturesPanelExamplesHub.prefab を MRTKExamplesHub シーンに配置して常に表示されるようにできます。これは、MRTKExamplesHub が共有コンテナー シーンであるためです。 各サンプル シーンで ToggleFeaturesPanel.prefab を非表示または非アクティブ化するようにします。

機能の切り替えパネルのハブのホーム ボタンの例

ボタンの追加

CubeCollection オブジェクトで、ExampleHubButton プレハブを複製 (または追加) し、[Update Collection](コレクションの更新) を GridObjectCollection でクリックします。 これにより、新しいボタンの総数に基づいて、円柱のレイアウトが更新されます。 詳細については、オブジェクト コレクションのページを参照してください。



シーン システム 9

シーン システム 10

ボタンを追加した後、LoadContentScene スクリプト (前述) でシーン名を更新します。 シーン システムのプロファイルにシーンを追加します。