HoloLens開発環境構築

2018/1版

Unity 2017.2.1f1＋Mixed Real i ty Toolk it –Unity 2017.2.1.0

Visual studio 2017向け

2017/09/16 1

初めにこの資料は作成時点（2018年1月）でHoloLensハンズオンで使用する環境に必要な情報を整理した資料です。

HoloLensに関する開発環境や状況は日々進化しています。

最新のサポート状況、開発環境とは異なる場合がありますので常に最新情報収集を！

2017/09/16 2

アジェンダ1.HoloLens開発環境について

2.各種セットアップ

3.開発環境を確認 -ビルド～実行まで

4.ライブラリの取得

5.参考サイト集

2017/09/16 3

1.HoloLens開発環境についてHoloLensではUWPアプリケーションを開発します。HoloLensはOSとしてはWindows 10のグループに属しています。

Windows 10のアプリケーションとしてはUWP（Universal Windows Platform）が基本

HoloLensでは排他モードとウィンドウモードの２種類作成可能です。排他モード（Unityから開発）全画面でアプリケーションが起動するイメージ。

実空間を使ったMixed Realityアプリケーション

ウィンドウモード（Visual Studioで開発） Edge等のウィンドウが３次元空間に配置されたモード

空間上には複数のウィンドウを配置できる。

2017/09/16 4

2.各種セットアップHoloLensの開発に必要な環境を構築するには以下のセットアップが必要

必須Visual Studio 2017 Community Editionも可

Unity 2017.2.1f1

任意Holographic Remoting HoloLensにインストールして利用。UnityのPlayer実行時に映像をリモートでHoloLens側で確認できる（要同一ネットワーク接続）

HoloLens Emulator HoloLensのエミュレータ。実機なしに動作確認が可能（一部制限あり）

Windows 10 Pro以上必須（要Hyper-Vマネージャー）

2017/09/16 5

2.各種セットアップ2.1.Visual Studio 2017 インストーラのダウンロード

現行バージョンはVisual Studio 2017のため正式なダウンロードサイトからダウンロードしてください。

https://www.visualstudio.com/ja/downloads/

2017/09/16 6

2.各種セットアップVisual Studio 2017のインストール

インストーラを起動しセットアップします。

「ワークロード」タブで「ユニバーサルWindowsプラットフォーム開発」をチェック

「Unityによるゲーム開発」のチェックはしない

後述のUnityセットアップをする場

合不要のためチェックしない。

2.各種セットアップVisual Studio 2017のインストール

「個別のコンポーネント」タブで「Visual Studio Tools for Unity」をチェック

「インストール」を押下してインストールを実施してください。

2.各種セットアップ2.3.Unity 2017.2.1f1のインストーラのダウンロード

ダウンロードサイトhttps://unity3d.com/jp/get-unity/download/archive

Unity 2017.Xのタブを選択

Unity 2017.2.1のUnityインストーラをダウンロード

2017/09/16 9

2.各種セットアップ2.4.Unity 2017.2.1f1のインストール

起動し[Next]を選択

2.各種セットアップ2.4.Unity 2017.2.1f1のインストール

使用許諾を確認し、[同意する]にチェックし[Next]を押下します。

2.各種セットアップ2.4.Unity 2017.2.1f1のインストール

[Windows Store .NET Scripting Backend]をチェック

[Next]を押下して次に進みます。

2.各種セットアップ2.4.Unity 2017.2.1f1のインストール

インストールフォルダーが以下の設定になっていることを確認し[Next]を押下します。

（参考）

Unityはバージョン違いを同一PCにインストール可能です。通常インストール先はC:\Program Files\Unityとなるのですが、バージョンを分けて共存したい場合はフォルダーをUnity-X.X.Xのようにバージョン毎で分けてインストールします。

2.各種セットアップ2.5.Visual Studio 2017の確認

Visual Studio 2017を起動し「ファイル」-「新しいプロジェクト」を開きます。

プルダウンから「インストール済み」-「Visual C#」-「Windows ユニバーサル」を選択し左記のようにUWP用のプロジェクトテンプレートが表示されていることを確認します。

「ユニバーサルWindowsツールのインストール」のみ表示されている場合は選択しOKを押下しインストールを実施してください。

2017/09/16 15

ここまでの作業でHoloLensアプリケーションの開発が可能です。以降は任意でセットアップを実施してください

2.各種セットアップ2.6.Holographic RemotingのインストールHoloLens上のMicrosoft Storeからインストール可能

起動するとリモートアクセス用のHoloLensのIPアドレスが表示される

※用途とは異なりますが、HoloLensのアドレス調べるときに使えます。

2017/09/16 16

2.各種セットアップ2.7.HoloLens Emulatorのインストール注1：Windows 10 Pro以上（Hyper-Vが必須のため）

注2：Emulatorだけで1インスタンスあたり2GB消費します。

ダウンロードサイトhttps://developer.microsoft.com/en-us/windows/mixed-reality/install_the_tools

Visual Studio 2015未インストールでVisual Studio 2017の場合レジストリの変更が必要以下のレジストリにキーを追加します。（レジストリエディタはWindowsの検索窓からregedit.exeを入力） HKEY_LOCAL_MACHINE > SOFTWARE > Microsoft > Analog配下

HKEY_LOCAL_MACHINE > SOFTWARE > WOW6432Node > Microsoft > Analog配下

名前：OverrideHoloLensSDKPrerequisites

値：TRUE

2017/09/16 17

まずは一通りビルドするまで確認しましょう

2017/09/16 18

3.開発環境を確認 -ビルド～実行まで3.1. Unityの起動～プロジェクト作成

1. Unity を起動します。

2. [New] (新規作成) を選びます。

3. プロジェクト名(「HelloHolograms」など) を入力します。

4. プロジェクトの保存先を入力します。

5. [3D] トグルが選択されていることを確認します。

6. [Create project] (プロジェクトの作成) を選びます。

2

3

4

5

6

2017/09/16 19

（参考）タブのレイアウトを使いやすくする

1 1. [Layout]を[2 by 3]にする

2. [Project]タブの横の をクリックし[One Column Layout]を選択する。

2017/09/16 20

2

3.開発環境を確認 -ビルド～実行まで3.2.カメラの設定をする

1. [Main Camera] (メインカメラ) を選びます。

2. [Inspector] パネルの [Transform] で、[Position]を(X: 0, Y: 0, Z: 0) に変更します。

3. [Inspector] パネルの [Camera] コンポーネントで、[Clear Flags]を[Solid Color] に変更します。

4. [Background]の色を (0, 0, 0, 0) に変更します。

ポイント！HoloLensの起動時の位置は(x:0,y:0,z:0)が基本。HoloLensは黒が透過のため背景は黒をベタ塗りにする

1

2

3

4

2017/09/16 21

3.開発環境を確認 -ビルド～実行まで3.3. Cubeを配置する

1. [Hierarchy]パネルの左上隅にある [Create]ボックス

から、[3D Object] –[Cube]の順に選びます。

2. [Hierarchy]パネルで、作成した [Cube]を選びます。

3. [Inspector]パネルの [Transform]で [Position](X: 0,

Y: 0, Z: 2) に変更します。

4. [Transform]の [Rotation]を (X: 45, Y: 45, Z: 45) 、

[Scale]を (X: 0.25, Y: 0.25, Z: 0.25) に変更します。

5. [File]-[Save Scene]の順に選び、シーンに名前を付

けてから、[Save]を選びます。ポイント！Unity での 1 Scale≒1 メートルHoloLensのスウィートスポットは2m付近

12

3

45

2017/09/16 22

3.開発環境を確認 -ビルド～実行まで3.4.ビルドの設定をする-パフォーマンス

1. [Edit]、[Project Settings]、[Quality] の順に選びます。

2. Windows ストアのロゴの下にあるボックスを選び、[Very Low] をオンにします。

1

2

2017/09/16 23

3.開発環境を確認 -ビルド～実行まで3.5.ビルドの設定をする-xRサポートの設定

1. [Edit]-[Project Settings]-[Player] の順に選びます。

2. [Inspector]パネルの [Settings for Windows Store]で[XR Settings]-[Virtual Reality Supported]をチェックします。この際、SDKとして「Windows Mixed Reality」が選択されていることを確認します。

1

2

2017/09/16 24

3.開発環境を確認 -ビルド～実行まで3.5.ビルドの設定をする-Scripting Backendの設定

1. [Edit]-[Project Settings]-[Player] の順に選びます。

2. [Inspector]パネルの [Settings for Windows Store]で[Other Settings]-[Scripting Backend]を[.NET]に変更します。

1

2

2017/09/16 25

3.開発環境を確認 -ビルド～実行まで3.6. Visual Studioソリューションのエクスポート

1. [File]-[Build Settings] の順に選びます。

2. [Platform] の一覧で、[Windows Store] を選び、[Switch Platform]ボタンを押します。

3. [Target Device] を [HoloLens] に設定します。

4. [Build Type]を [D3D] に設定します。

5. [Add Open Scenes] をクリックし、シーンを追加します。

6. [Unity C# Projects]チェックボックスをオンにします。

7. [Build]をクリックします。

8. [New Folder]をクリックし、「App」という名前を付けます。

9. App フォルダーを選択し、[フォルダーの選択]をクリック。

2 3

4

5

6

7

8

9

2017/09/16 26

3.開発環境を確認 -ビルド～実行まで3.7. Visual Studioでのデプロイ（配置）

1. エクスプローラーでAppフォルダを開き、ソリューションファイル(.sln)を開きVisual Studioを起動します。

2. Visual Studio 上部のツールバーを使って、ターゲットを[Release]、 [X86] に変更します。

3. [ローカルコンピューター] の横にある矢印をクリックし、配置先を設定します。a. HoloLens-USB接続→[Device]b. HoloLens-Wifi接続→[リモートコンピューター]c. HoloLens Emulator⇒「HoloLens Emulator …」

4. [デバッグ]-[デバッグなしで開始] の順に選びます。

5. アプリケーションの配置が行われ起動されます。起動すると目の前２m付近にCubeが浮いている状態になります。

a

23

ac

2017/09/16 27

お疲れ様でした。

以上で環境構築は完了です。

以降はハンズオンや実際の開発を進めるうえで便利なライブラリの紹介です。

ハンズオンなどで以降のライブラリが必要であることが明記されている場合は

必要なバージョンをダウンロードしておきましょう。

2017/09/16 28

4.ライブラリの取得HoloLensの開発に便利なライブラリ群

Mixed Reality Toolkit - UnityHoloLens開発では必須ともいえるライブラリ

HoloLens/Windows MR Device でのMixed Reality開発に必須ともいえるライブラリ

Unityのバージョンに応じてリリース。（Unity 2017.2.1f1 → Mixed Reality Toolkit – Unity 2017.2.1.0)

2017/09/16 29

4.ライブラリの取得Mixed Reality Toolkit – unity の取得と設定

ダウンロードサイトhttps://github.com/Microsoft/MixedRealityToolkit-

Unity/releases/tag/2017.2.1.0

※Unity 2017.2.1f1用に対応する2017.2.1.0のダウンロード先

導入手順1. 上記サイトからunitypackageをダウンロード

HoloToolkit-Unity-2017.2.1.0.unitypackage

2. Unityを起動しプロジェクト作成（もしくは開く）

3. [Asset]-[Import Package]-[Custom Package]を選択しダウンロードした[HoloToolkit-Unity-2017.2.1.0.unitypackage]を全てインポートする。

2017/09/16 30

5.参考サイト集初めてHoloLensにデプロイ&開発を体験してみたいhttps://developer.microsoft.com/en-us/windows/mixed-reality/holograms_100

https://developer.microsoft.com/en-us/windows/mixed-reality/holograms_101

※100と101-Chapter 1までで雰囲気がつかめます。

開発環境https://developer.microsoft.com/en-us/windows/mixed-reality/install_the_tools

技術情報http://qiita.com/tags/HoloLens

https://github.com/HoloMagicians/HoloLensDevelopersLink

https://developer.microsoft.com/en-us/windows/mixed-reality/community

GitHubhttps://github.com/Microsoft/MixedRealityToolkit-Unity

2017/09/16 31