デコシノニッキ

ホロレンジャーの戦いの記録

MR Learning Base Module で学ぶHoloLens 2アプリ開発 その1 動作確認

※ この記事は2019/02/26時点のものを参考に書いています

公式からチュートリアルが公開されました。

docs.microsoft.com

その1では環境セットアップから,アプリをデプロイするまでのフローを扱います。
HoloLens 1で開発した人は,ほとんど飛ばし読みできます。MRTKとビルドの部分だけ参考にしてください。

画像は先のリンクのものを利用しています。

Instructions

Unityプロジェクトを作る

  1. Unityを立ち上げます
  2. Newを選択します
    f:id:haikage1755:20190501162814p:plain:w450

  3. プロジェクト名を入れます(例 "Mixed RealityBase")
    f:id:haikage1755:20190501163104p:plain:w450

  4. プロジェクトを保存する場所を入力します

    f:id:haikage1755:20190501163136p:plain:w450

  5. プロジェクトが3Dであることを確認します

    f:id:haikage1755:20190501163213p:plain:w450

  6. Create Project を押します

    f:id:haikage1755:20190501163244p:plain:w450

Windows Mixed Reality向けにプロジェクト設定を行う

1.File>Build SettingsからBuild Settings Window を立ち上げます

f:id:haikage1755:20190501163415p:plain:w450

2."Universal Windows Platform"を選択し,"Switch Platform"を押してプラットフォームを切り替えます。HoloLens 2でアプリを実行するためにはUWPであることが必須です。

f:id:haikage1755:20190501163557p:plain:w450

3.Build Window の Player Settingsを押して,InspectorパネルのXR Settingsから"Virtual Reality Supported"を有効にしてください。"Virtual Reality Supported"は立体視を有効にするのでARにも適用されます。
f:id:haikage1755:20190501164002p:plain:w450

4.InspectorパネルのPublish Settings内にあるCapabilitiesのセクションで"Spatial Perception"を有効にします。Spatial Perceptionを有効にすることでSpatial mapping のメッシュを可視化することができるようになります。
f:id:haikage1755:20190501164246p:plain:w450

Mixed Reality Toolkitを導入する

  1. Mixed Reality Toolkit Unity Packageをダウンロードし,保存します。
  2. Assets>Import>Custom PackageからMixed Reality Toolkit をインポートします。ダウンロードしたパッケージを開き,インポートを開始します。インポートには数分かかります。

    f:id:haikage1755:20190501164608p:plain:w450

    f:id:haikage1755:20190501164619p:plain:w450

3.ポップアップウィンドウで,"Import"をクリックしMRTKをインポートします。すべてのアイテムにチェックが入っていることを確認してください。Mixed Reality Toolkit default settings を有効にするか尋ねられた場合,"Apply"を押してください。

f:id:haikage1755:20190501165250p:plain:w450

f:id:haikage1755:20190501165318p:plain:w450

Mixed Reality Toolkit を設定する

1.メニューバーのMixed Reality Toolkit > Configure からConfigureを選択してください。
f:id:haikage1755:20190501165559p:plain:w450
2.Mixed Reality Toolkitによってシーンにいくつかの新規アイテムの追加と変更が行われます。File>Save As からBase Sceneなどの名前で今のシーンを名前付き保存してください。プロジェクトのAssetフォルダの「Scenes」フォルダに保存して整理してください。

f:id:haikage1755:20190501165912p:plain:w450

f:id:haikage1755:20190501165926p:plain:w450

アプリケーションをデバイスにビルドする

  1. File>Build Settingsからbuild settings window を開いてください。(頻繁に使うのでショートカットCtr+Shift+Bを覚えておくと便利です)

    f:id:haikage1755:20190501170248p:plain:w450

    2.“Scenes in Build”の一覧に"Add Open Scenes"ボタンを押してシーンを追加してください 3.Build buttonを押してビルド処理を開始します

    f:id:haikage1755:20190501170512p:plain:w450

    4.アプリケーション用に新しい名前でフォルダを作ってください。画像ではアプリを格納する"App"が生成されています。"Select Folder"を押して,新しく作ったフォルダを選択してください。ビルドが完了したら,"Build Settings"ウィンドウを閉じることができます。

    f:id:haikage1755:20190501170534p:plain:w450

Note: ビルドに失敗した場合,再度ビルドを行うかUnityを一度立ち上げなおして再度ビルドしてみてください。"Error: CS0246 = The tyoe or namespace name “XX” could not be found (are you missing a using directive or an assembly reference?)" と表示された場合は,Windows 10 SDK (10.0.18362.0)をインストールする必要があります。

5.ビルドが終わったら,新しく作ったフォルダを開きます。"MixedRealityBase.sln(自分で作成したUnityプロジェクト名)"ソリューションファイルをVisual Studioで開いてください。

f:id:haikage1755:20190501171458p:plain:w450

6.HoloLens2をPCにUSBで接続してください。このレッスンではHoloLens2デバイスでデプロイのテストを行いますが,HoloLens2 emulatorでデプロイしたりサイドローディング用のパッケージを作成することもできます。

7.デプロイする前に,デバイスがDeveloper Modeであることを確認してください。HoloLens2にはじめてビルドする場合,Visual StudioはHoloLens 2とpinを使ってペアリングするかを尋ねてきます。こちらに従ってDeveloper modeの設定やペアリングを行ってください。

8."Release"且つ"ARM"アーキテクチャが選択されていることを確認してください。

f:id:haikage1755:20190501172555p:plain:w450

9.最後にDebug>Start without Debuggingからビルドを行います。"Start Without Debugging"を選択し,ビルドに成功すると即座にデバッグ情報を表示せずにアプリが開始します。アプリケーションが動作している間USBを取り外すことができます。アプリが自動で立ち上がらないようにBuild>Deployから配置をするだけもできます。

f:id:haikage1755:20190501172940p:plain:w450

www.tattichan.work

[デコシノニッキ]は、Amazon.co.jpを宣伝しリンクすることによってサイトが紹介料を獲得できる手段を提供することを目的に設定されたアフィリエイト宣伝プログラムである、Amazonアソシエイト・プログラムの参加者です。」