【 Microsoft HoloLens 】Mixed Reality Toolkit-Unity ( MRTK ) の「BoundingBox」サンプルを動かしてみた。

# はじめに
本記事では、
「__1. Mixed Reality Toolkit-Unity (以下、MRTK) の導入方法__」と、
「__2. MRTK Exampleパッケージに含まれる、サンプルシーンをビルドする__」
までの手順をご紹介したいと思います:spy_tone2:!

# __1. Mixed Reality Toolkit-Unity (以下、MRTK) の導入方法__

## What's MRTK !?
![image.png](https://qiita-image-store.s3.amazonaws.com/0/180432/6436aad2-7fbb-45a0-a230-d67e920e295e.png)

> Mixed Reality Toolkit-Unityは、Unity上でMixed Realityエクスペリエンスを構築するための基本的なコンポーネントや、共通のインタラクションや、UIコントロールを共有するオープンソースプロジェクトです。- [「Mixed Reality  Toolkit ( MRTK ) の有用なビルディングブロック」](https://medium.com/@dongyoonpark/mixed-reality-toolkit-mrtk-%E3%81%AE%E6%9C%89%E7%94%A8%E3%81%AA%E3%83%93%E3%83%AB%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF-4eb343d474cb)より抜粋

MRTKは、UnityのAssetsファイルとして配布されており、下記手順で非常に手軽に、
自分のプロジェクトに導入することができます。

早速、導入していきたいと思います。


## 導入環境
- Unity __2017.2.1f1__
- Visual Studio __2017 15.0__
- Mixed Reality Toolkit - Unity __2017.4.10__

## MRTK 導入手順

### __1. GitHub から、MRTKのパッケージファイルをダウンロード__

- [Mixed RealityToolkit-Unity ( Releases )](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases)


![image.png (43.0 kB)](https://img.esa.io/uploads/production/attachments/3505/2018/08/10/10862/b435d481-b8f6-4580-864a-5fb75cf63f23.png)

今回ダウンロードするのは、↓パッケージ2つ！

- [HoloToolkit-Unity-2017.4.10.unitypackage](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases/download/2017.4.1.0/HoloToolkit-Unity-2017.4.1.0.unitypackage)
- [HoloToolkit-Unity-Example-2017.4.10.unitypackage](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases/download/2017.4.1.0/HoloToolkit-Unity-Examples-2017.4.1.0.unitypackage)

## __2. アセットファイルをUnityにインポート__

1. Unityで、新規プロジェクトを作成
2. __[Assets]__ > __[Import Package]__ > __[Custom Package ...]__ より下記2つのパッケージをインポート。

- インポートするパッケージ
 - HoloToolkit-Unity-2017.4.10.unitypackage
 - HoloToolkit-Unity-Example-2017.4.10.unitypackage

![image.png (64.0 kB)](https://img.esa.io/uploads/production/attachments/3505/2018/08/10/10862/61acdd8d-ecac-42c3-9f2c-9b94848fbf12.png)

![image.png (37.7 kB)](https://img.esa.io/uploads/production/attachments/3505/2018/08/10/10862/335149b0-ad58-4287-b998-e9392094345c.png)

正常にインポートが終了すると、「Mixed Reality Toolkit」タブが追加されます。

![image.png (36.2 kB)](https://img.esa.io/uploads/production/attachments/3505/2018/08/10/10862/702df60e-6ea6-4933-90cd-af7063e2f073.png)

同様の手順で、「__HoloToolkit-Unity-Example-2017.4.10.unitypackage__」もインポートします。

## __3. Project Settingの変更__
HoloLens用にビルドするために、Project Settingの変更します。
一つずつ設定を変更することも可能なのですが、
今回は、MRTKの下記タブより設定したいと思います。
__[Mixed Reality Toolkit]__ > __[Configure]__ > __[Apply Mixed Reality Project Setting]__

![image.png (48.1 kB)](https://img.esa.io/uploads/production/attachments/3505/2018/08/10/10862/d1d2156f-7d23-4e4a-86f4-2c22b5986f97.png)

MRデバイス向けビルドをする際に、変更が必要な箇所を一発で変更してくれます。

![image.png (38.7 kB)](https://img.esa.io/uploads/production/attachments/3505/2018/08/10/10862/cd16f377-e368-4d0d-8f5e-9ab8031c3451.png)

「__Apply__」を押下すれば、OK！:point_up:
これで開発前の準備はすべて整いました。

# __2. MRTK Exampleパッケージに含まれる、サンプルシーンをビルドする__

今回は、BoundingBoxを試してみたいので、以下サンプルシーンを選択。
__[Assets]__ > __[HoloToolkit-Examle]__ > __[UX]__ > __[Scenes]__ > __[BoundingBoxGizmoExamle]__

![image.png](https://qiita-image-store.s3.amazonaws.com/0/180432/a7526a80-ece1-6e72-38d8-92a65b1dcd31.png)

シーンを開くと、下記のようなシーンビューになると思います。

![image.png](https://qiita-image-store.s3.amazonaws.com/0/180432/6e088467-6461-8302-260c-001442718581.png)

__[File]__ > __[Build Setting]__を開き、ビルドします。

![image.png](https://qiita-image-store.s3.amazonaws.com/0/180432/39221da9-8b23-6754-fe14-43de3c9014aa.png)

アウトプットされた「〇〇〇.slnファイル」を、Visual Studioで開き、HoloLensにデプロイします。

![image.png](https://qiita-image-store.s3.amazonaws.com/0/180432/85fd6627-d425-a0a0-bd27-2103acbfd77e.png)

__[Device]__ボタンを押下すると、ビルド&デプロイが実行されます。

# __3. アプリを起動してみた (※動画あり)__

<blockquote class="twitter-tweet" data-lang="ja"><p lang="ja" dir="ltr">MRTK Example<br>「BoundingBoxGizmoExample」を<br>動かしてみた！<a href="https://twitter.com/hashtag/HoloLens?src=hash&amp;ref_src=twsrc%5Etfw">#HoloLens</a> <a href="https://t.co/UyLUBeD6kD">pic.twitter.com/UyLUBeD6kD</a></p>&mdash; 堀尾風仁 / Futo Horio (@_Futo23_) <a href="https://twitter.com/_Futo23_/status/1028188203050627072?ref_src=twsrc%5Etfw">2018年8月11日</a></blockquote>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>





## Reference !

- [MixedRealityToolkit-Unity ( GitHub )](https://github.com/Microsoft/MixedRealityToolkit-Unity)
- [Mixed Reality  Toolkit ( MRTK ) の有用なビルディングブロック](https://medium.com/@dongyoonpark/mixed-reality-toolkit-mrtk-%E3%81%AE%E6%9C%89%E7%94%A8%E3%81%AA%E3%83%93%E3%83%AB%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF-4eb343d474cb)

# 最後に
Microsoft UX Designerの[Yoon (Dong Yoon Park)](https://medium.com/@dongyoonpark?source=post_header_lockup) 氏の記事がとても参考になりました。
日本語で解説していただき、ありがとうございます。( 一度ご本人にお会いしてみたいな :dark_sunglasses:！)