Hololens2 MRTK2.4 でのビルド環境構築をわかりやすく(環境設定からExamplesのビルドまで)

HoloLens2 MRTK2.4
環境構築手順 2020.05.28

 Unity2019.3.14ｆ1(Unity 2018.4.XX/2019)
 Microsoft Mixed Reality Toolkit v2.4.0
 Visual Studio2019 Version 16.4.5
 Windows SDK 18362(18362以上)
()内は、公式記載の動作条件
各バージョン

 Visual Studio2019 Communityをインストール
※業務利用の場合はProfessional版が必要
 ワークロードの設定で下記を追加する
 ユニバーサル Windows プラットフォーム開発
 Unityによるゲーム開発
 Unity 2019.2 64ビットエディターのチェックを外す
Visual Studioワークロード

Visual Studioワークロード

Visual Studio個別のコンポーネント
 個別のコンポーネントで下記を追加する
 WindowsSDK(10.0.18362.0)
 WindowsSDK(10.0.17763.0)
 USBデバイスの接続
 MSVC v142 – VS 2019 C++ ARM64 ビルドツール…
 V142 ビルドツールのC++ ユニバーサル Windows…

Visual Studio個別のコンポーネント

Microsoft Mixed Reality
Toolkit v2.4.0の準備

 Untiyのパッケージをダウンロード
 Microsoft.MixedReality.Toolkit.Unity.Foundation.2.4.0.unitypackage[必須]
 Microsoft.MixedReality.Toolkit.Unity.Tools.2.4.0.unitypackage[オプション]
 Microsoft.MixedReality.Toolkit.Unity.Examples.2.4.0.unitypackage [オプション]
 Microsoft.MixedReality.Toolkit.Unity.Extensions.2.4.0.unitypackage [オプション]
https://github.com/Microsoft/MixedRealityToolkit-Unity/releases
MRTK v2.4.0パッケージ

 Unity Hubをダウンロードし
インストール
 Unity2019.3.14f1をインス
トール。UWP Build
Support(IL2CPP)にチェック
を入れます
Unityのインストール

 Unityのプロジェクトを作成します。
※深いフォルダ構成だとビルドできないので注意
 Microsoft.MixedReality.Toolkit.Unity.Foundati
on.2.4.0.unitypackageを、インポートします。
Unityプロジェクト作成

 インポート後にデフォルト設
定の適用確認が開きます。
Applyを選択して適用を行いま
す。
 メニューから呼び出す場合
MRTKのデフォルト設定

 Add Open Sceneボタンを押します
 Universal Windows Platformを選択
 設定を下記のように変更
 Target Deviceを”HoloLens”
 Archtectureを”ARM64”
 Target SDK Versionを“10.0.18362.0”
 Minimum Platform Versionを“10.0.10240.0”
 Build and Run onを”USB Device”
 Switch Platfromボタンを押します
Builed Settings
①
②
③
④

基本のGame Objectをシーンに追加
 メニューからAdd to Scene and
Configureを選択すると
 MixedRealityToolKitと
MixedRealityPlayspaceが追加されます
 Main CameraがMixedRealityPlayspace
の下に移動します

 Project Settingsを開き、
PlayerのXR Settingsに
Windows Mixed Realityを追
加します。
Virtual Reality SDKsの設定

 Optimize Windowをメニューから開きます。
Optimize Window

 Enable 16-bit depth
formatを押します。
(16ビットの深度バッファー
形式を使用することをお勧め
します。深度値の精度が低下
しますが、パフォーマンスが
良くなります。)
Depth Bufferの設定

 適当にシーンにオブジェクトを置きます。0,0,0の
位置がHololens(頭)の位置になりますので、その周
囲に適当にオブジェクトを配置します。
ビルド確認用にゲームオブジェクト
を配置します

 Microsoft.MixedRealityToolkit.Unity.Tools.2.4.0.un
itypackageをインポートします
 インポート完了するとMixed Reality Toolkitのメ
ニューにBuild Windowが追加されるので選択します
MRTKのToolsでビルド

Build Window(1/3)
 Unity Build Options
 Target Deviceを確認します

Build Window(2/3)
 APPX Build Options
 Build Platformの確認
 Multicore Buildを利用する場合は
チェック
 視線入力を行う場合は、Gaze Input
Capatilityにチェック
 環境追跡カメラ、深度カメラ、IR 反
射反射ストリームを使う場合は
Enable Reserch Modeにチェック

Build Window(3/3)
 Deploy Options
 ネットワーク接続、USB接続でのビル
ドについて接続先の設定を行います。
USB接続の場合、Target Typeを
Localにします。(USB接続経由でロー
カルネットワーク接続)
 Hololensのデバイスポータルの
UsernameとPasswordを設定します
デバイスポータルに接続するには
https://docs.microsoft.com/ja-jp/windows/mixed-reality/using-the-windows-device-portal

 Build allボタンを押下し
ます。Unityのビルドから
Visual Studioのビルド、
そしてHoloLensへのイン
ストールまで行ってくれ
ます
Build Windowでビルド
ビルド完了すると、ビルドしたパッケージが一覧表
示されます。

 Microsoft.MixedReality.Toolkit.Unity.Examples
.2.4.0.unitypackageをインポートします
Exampleを動かす

 Build Settingsを開き
HandInteractionExamplesにのみ
チェックを入れる。自分が入れた
シーンなどがある場合は削除して
おきます
ビルドの設定

HandInteractionExamples
を起動

 Examples Hubを使えば、MRTKのHand
interaction examplesやEye tracking examplesな
どのデモを複数組み込んで切り替えながら試すこ
とができます。
MRTK Exsamples Hubとは

 Microsoft.MixedReality.Toolkit.Unity.Extensio
ns.2.4.0.unitypackageをインポート
※Extensionsのシーン遷移サービスをHubで利用
しています
 Microsoft.MixedReality.Toolkit.Unity.Examples
.2.4.0.unitypackageをインポート
MRTK Examples Hub

 MRTKExsampleHubシーンを開きま
す
(AssetsMRTKExamplesExperimentalExamplesHubScene
s配下)
 Build Settingsで入れたいデモのシー
ンを追加していきます。
MRTKExsampleHubと
MRTKExsampleHubMainMenuは必ず
入れ、 MRTKExsampleHubは一番上
に来るようにします。
入れたいデモを選抜

 HierarchyからLoadHubOnStartupを選択します。
LoadContentSceneでMRTKExamplesHubMainMenuがLoad
On Startupに選択されていることを確認
初期シーンの設定

 MRTKExamplesHubシーンのButtonHubHomeで
Homeに戻るようになっています。
 ToggleFeaturesPanelExamplesHubプレハブが各
シーンに配置されてます。
ExsamplesHubのMenu

 MRTKExsamplesHubシーンのButtonHubHomeの
LoadContentSceneにMRTKExsampleHubMainMenu
を設定します。
各シーンからのMenuへの遷移

 MRTKExsampleHub上で各シーンを編集するには
MixedRealityToolkitのMixedRealitySceneSystemを選択し
Load Unlod individuallyをチェックするとサブシーンが読み込
まれます。
読込対象の各シーンを開く場合

 MRTKExsampleHubMainMenuを開きます
 選んだシーンに合わせてMenuのボタンに表示するテキストの
変更。ExampleHubButtonのSectionTitleを変更します
Hub Main Menuの設定

 選んだシーンに合わせて遷移するシーンの変更。
ExampleHubButtonのFrontPlateを選択し、コンポーネントの
LoadContentSceneを変更します
Hub Main Menuの設定

 EyeTrackingのデモの場合、Build WindowでGaze
Input Capabilityにチェックを入れてください
注意

Hololens2 MRTK2.4 でのビルド環境構築をわかりやすく(環境設定からExamplesのビルドまで)

Recommended

Recommended

More Related Content

More from 聡大久保

More from 聡大久保 (20)

Recently uploaded

Recently uploaded (20)