MRTK v2.4 Release Notes ( 日本語訳 )

# Overview
先日、MRTK ( Mixed Reality Toolkit - Unity ) v2.4 がリリースされたので、以下 Release Notes の内容を日本語に翻訳してみました。機械翻訳ではなく、自力で翻訳 ( + 所感  )しているのでフィードバック等あればお気軽にコメントいただければと思います。Unity 2019.3 を使用して開発を進める場合は、ビルド時の設定で詰まる可能性が高いので、__「Known issues in MRTK v2.4」__ を一度確認されることをお勧めします。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/e7c25255-99f7-37eb-c6d2-e6863d51c74b.png" width="600">
> __「microsoft/MixedRealityToolkit-Unity」より引用__

- [MRTK v2.4 Release Notes](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/ReleaseNotes.html)

# Agenda

- Support devices & platforms
- Software Requirements
- What's new in MRTK v2.4
- Breaking changes in MRTK v2.4
- Known issues in MRTK v2.4

# Support devices & platforms

MRTK v2.3 からの大きな変更点は、以下の2点になります。

__1. 「Ultraleap Hand Tracking をサポート」__
__2. 「Mobile AR から ( Experimental ) が外れた」__ 

※ ( Experimental ) は、現在実装途中であり、時間の経過と共に変更が加わる可能性のある新たな機能を開発者がいち早く検証できるよう提供されている実験的な取り組みです。

- Microsoft HoloLens 2
- Microsoft HoloLens ( 1st gen )
- Windows Immersive headsets
- OpenVR
- ( Experimental ) Unity 2019.3 XR Platform
- Mobile AR  ( Unity AR Foundation 使用 )
  - Android
  - iOS
- Ultraleap  Hand Tracking

# Software Requirements
ほとんど変更点はないですが、MRTK v2.3 では __「NuGet から MRTK をインポートする際、Unity 2018.4 LTS のみサポート」__ となっていた箇所が、MRTK v2.4 Relase Note では表記が削除され、Unity 2019 でもサポートされたようです。( 未検証 )

- __Visual Studio ( 2017 or 2019 ) Community Edition or Higher__
- __Windows 10 SDK 18362 or later ( Visual Studio Installer インストール分  )__
- __Unity 2018.4 LTS or 2019 ( ※ 2019.3 を推奨 )__ 

※ Nuget ( .NET Framework パッケージマネージャー ) より MRTK をインストールする場合

- [Nuget for Unity 2.0.0 or newwer](https://github.com/GlitchEnzo/NuGetForUnity/releases/latest)

Nuget を使って、MRTK をインポートする方法は以下のドキュメントをご覧ください。

- [Mixed Reality Toolkit NuGet package](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/MRTKNuGetPackage.html)

※ Nuget パッケージを使用した既存プロジェクトのマイグレーション ( MRTK アップデート ) は現時点でサポートされていません。新規プロジェクトで MRTK をインポートする際にのみ使用できます。基本的には、GitHub Release ページから .Unitypackage ファイルをダウンロード&インポートする方法が良いかと思います。

# What's new in MRTK v2.4
## Ultraleap Hand Tracking Support
新しく追加された Leap Motion Data Provider を使えば、VRアプリケーションで手の関節を認識したハンドトラッキングや、Unity Editor 上でのラピッドプロトタイピングを実現することができます。このデータプロバイダーは、Leap Motion Controller をマウントしたヘッドセット、もしくはデスク上に表向きに置かれた状態で設定することができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/4091f11c-c1b6-b98f-9daa-2831998f597a.png" width="600">
> __Release Notes 「Ultraleap Hand Tracking Support」より引用__

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">We teased it last week at <a href="https://twitter.com/hashtag/MRDevDays?src=hash&amp;ref_src=twsrc%5Etfw">#MRDevDays</a>, but the moment is actually here! MRTK 2.4 is released. MRTK 2.4 now supports <a href="https://twitter.com/ultraleap?ref_src=twsrc%5Etfw">@Ultraleap</a> hand tracking! We can’t wait to see what you develop with this update.<br><br>Check the release notes for the other features - <a href="https://t.co/CITIZembqL">https://t.co/CITIZembqL</a> <a href="https://t.co/rH9rb9HqCx">pic.twitter.com/rH9rb9HqCx</a></p>&mdash; Mixed Reality DevRel Team (@MxdRealityDev) <a href="https://twitter.com/MxdRealityDev/status/1265757092440231937?ref_src=twsrc%5Etfw">May 27, 2020</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

## Migration window
MRTK にマイグレーションツールが追加されました。このツールを活用すれば、MRTK内の Deprecate ( 廃止 ) されたコンポーネントを新しいバージョンに置き換えることができます。既存のプロジェクトを古いMRTKを使って開発していた場合、このツールを使って既存コード + MRTKの新しいバージョンにプロジェクトを移行させることができます。

Migration Window は、__[ Mixed Reality Toolkit ] > [ Utilities ] > [ Migration Window ]__ から追加することができます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/c29ebec6-1b6d-af25-5ec0-1fa392641579.png" width="600">

後ほど、ご紹介する「ButtonConfigHelper」や「ObjectManipulation」などを既存プロジェクトに簡単に適用することができます。

> <img width="600" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/3a4d2d40-119e-45e1-94ea-bf2ab109242f.png">
> __Release Notes 「Migration Window」より引用__

詳細は、「[Migration Window](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/Tools/MigrationWindow.html)」 ページをご覧ください。

## MRTK folder layout change

MRTK v2.4 からフォルダのディレクトリ構造に変更が加わりました。この変更により全てのMRTKコードが単一の __「MRTK」__ フォルダ配下に格納され、ファイルパスの長さが短縮されました。

| 変更前フォルダ | 変更後フォルダ |
| --- | --- |
| MixedRealityToolkit | MRTK\Core  |
| MixedRealityToolkit.Examples | MRTK\Examples |
| MixedRealityToolkit.Extensions | MRTK\Extensions |
| MixedRealityToolkit.Providers | MRTK\Providers |
| MixedRealityToolkit.SDK | MRTK\SDK |
| MixedRealityToolkit.Servies | MRTK\Services |
| MixedRealityToolkit.Tests | MRTK\Tests |
| MixedRealityToolkit.Tools | MRTK\Tools |

※ 個別カスタマイズをしたプロファイル ( クローン, 新規作成 ) が格納されるフォルダ <font color="red">__「MixedRealityToolkit.Generated」__</font>  は、
この変更に含まれておらず、そのまま残っています。
( 下図 : 変更後のディレクトリパス )

<img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/43ef6d77-03e1-4bc7-a36b-dd1bf01dc6cf.png">

## MRTK Toolbox
MRTK Toolbox は、Unity Editor Window の便利ツールです。この機能を使えば、__MRTK UX Prefab Component ( あらかじめ用意されたUXコンポーネント ) の「検索」と 「シーンへの追加」を簡単に行うことができる__ ようになります。検索バーを使用すれば、表示されるアイテムをフィルタリングすることが可能です。Toolbox Window は、すぐに使える MRTK Prefab を生成し、シーンに追加するために設計されています。 

アイコンをクリックすると、ヒエラルキーに対象Prefabが追加されます。また、アイコンの下にある「Documentation」ボタンを押すと、それぞれのドキュメントページへ飛ぶことができます。

<img width="500" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/2b024d3d-34c4-434e-8b38-7110a17d7784.png">

以下のように7カテゴリ、45種類の Prefab が用意されています。

| カテゴリ名 | 概要 | 画像 |
| --- | --- | --- |
| __Buttons__  | 様々なカタチのボタン<br/> ( 19種類 ) | <img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/251833f5-8b82-4063-9533-2f550d7458bc.png"> |
| __Button Collections__ | 複数のボタンを並べたもの<br/> ( 6種類 ) | <img width="300" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/3683e6b0-6b01-45a0-9887-7704dbf8a0f6.png"> |
| __Near Menus__ | 様々な近距離メニュー<br/> ( 6種類 ) | <img width="300" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/9ac4057a-3988-43e8-a2f5-328505497627.png"> |
| __Miscellaneous__ | 雑多なプレハブ群<br/>( 3種類 ) | <img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/b02549ae-69da-41db-be1b-092ae72dc3b7.png">  |
| __Tooltips__ | 注釈などに使える補足説明用UI<br/>( 3種類 ) | <img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/9a30356f-2df2-4c64-b633-cb558d789ed4.png"> |
| __Progress indicators__ | 進行状態を表すインジケータ―<br/>( 4種類 )| <img width="300" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/57b36c94-9f5e-4d63-85a9-fce83f882c34.png"> |
| __Unity UI__<br/> ( Requires Canvas  ) | Unity Canvas 上で使えるボタン<br/> ( 4種類 )  | <img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/3dab685e-c010-489b-8687-80a67b7b03af.png"> |

Toolbox は、__[ Mixed Reality Toolkit ] > [ Toolbox ]__ から追加することができます。

<img width="500" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/30/10862/c7b4f733-75ac-4a0e-9b93-e3ab86b87dab.png">

<blockquote class="twitter-tweet"><p lang="ja" dir="ltr">MRTK v2.4 新機能<br>Toolbox ( Unity Editor )<br><br>MRTKに含まれている Prefab を<br>ビジュアルを確認しながら追加可能！<br><br>ボタン、ツールチップ、Unity UI etc..<br>ジャンル分けもされてて見やすい。<br> <a href="https://twitter.com/hashtag/MRTK?src=hash&amp;ref_src=twsrc%5Etfw">#MRTK</a> <a href="https://twitter.com/hashtag/MixedReality?src=hash&amp;ref_src=twsrc%5Etfw">#MixedReality</a><a href="https://twitter.com/hashtag/Unity?src=hash&amp;ref_src=twsrc%5Etfw">#Unity</a> <a href="https://twitter.com/hashtag/MixedRealityToolkit?src=hash&amp;ref_src=twsrc%5Etfw">#MixedRealityToolkit</a> <a href="https://t.co/ER7lyiAt8i">pic.twitter.com/ER7lyiAt8i</a></p>&mdash; Futo Horio (@Futo_Horio) <a href="https://twitter.com/Futo_Horio/status/1266372953182101511?ref_src=twsrc%5Etfw">May 29, 2020</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>


## Tap to Place
``Tap to Place`` は遠くのオブジェクトにインタラクション追加するUXコンポーネントです。このコンポーネント ( Script ) を使用すれば、ゲームオブジェクトをサーフェイス ( 壁や床 ) などに簡単に配置することができます。頭の動きとタップ操作 ( Hand Ray ) で、オブジェクトの配置を変更することができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/8b8bfc20-5d10-3310-b760-62ef673f2cb3.gif" width="600">
> __Release Notes 「Tap to Place」より引用__

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/186c7840-2048-64e6-60b8-158b5acfa915.png" width="300">


__サンプルシーン : MRTK/Examples/Demos/Solvers/Scenes/TapToPlaceExample.unity__

## Button Config Helper added to Pressable Button
``Button Config Helper`` は名前の通り、MRTK の Pressable Button のアイコンや、ボタン名などを一括で管理するためのヘルパーです。MRTK v2.3 までは、それぞれのゲームオブジェクトで設定していた内容が、MRTK v2.4 Button Config Helper を使用すれば、親オブジェクトのヘルパー内で簡単に設定を変更することができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/9ca3854a-30bc-1d41-b6f2-52eca0debbba.gif" width="600">
> __Release Notes 「Button Config Helper added to Pressable Button」 より引用__

__サンプルシーン : MRTK/Examples/Demos/UX/PressableButton/Scenes/PressableButtonExample.unity__

## New HoloLens 2-style Toggle Buttons - Checkbox, Switch, Radio
MRTK UX Component に新しい Toggle ボタンが追加されました。

- __チェックボックス__ ( Checkbox )
- __スイッチ__ ( Switch )
- __ラジオ__ ( Radio )

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/9f5e192e-65ff-5dd4-b0d5-cca9fad58517.gif" width="300"> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/a4d5a264-14e2-8543-9c57-af313781186a.gif" width="300">
> __Release Notes 「New HoloLens 2-style Toggle Buttons」より引用__

| ボタン名 | プレハブ名 |
| --- | --- |
| チェックボックス | __HoloLens 2 Checkbox Button 32×96mm__ |
| スイッチ | __HoloLens 2 Switch Button 32×96mm__ |
| ラジオ | __HoloLens 2 Radio Button 32×96mm__ |

## Hand Menu Improvements
ハンドメニューはこれまでも多くのアプリケーションに採用されてきましたが、大きな問題がありました。それはオブジェクトの操作中、または他のコンテンツを操作している際に誤ってハンドメニューがアクティベーションされるという問題です。誤ったアクティベーションを防ぐために、HandConstraintPalmUp.cs にゲイズ ( Eye-Gaze, Head-Gaze )が当っている時にだけアクティベーションを行う「Gaze Activation」オプションが追加されました。このオプションにチェックすることで、ゲイズが当っている場合のみハンドメニューを有効化し、それ以外は動作させないという挙動を実現し、誤操作を減らすことができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/eb26b232-015d-1d6d-4adc-18ebe15b9a33.gif" width="600">
> __Release Notes 「Hand Menu Improvements」 より引用__

__サンプルシーン : MRTK/Examples/Experimental/HandMenuLayout/Scenes/HandMenuLayoutExamples.unity__

<img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/06/02/10862/edeb5308-536c-4a26-a9b2-154028c5c104.png"> <img width="300"  src="https://img.esa.io/uploads/production/attachments/3505/2020/06/02/10862/68de2823-44fb-4250-99ef-babdfeabe440.png">

[ ``Use Gaze Activation`` ] は、HandConstraitPalmUp コンポーネントの下部にチェックボックスがあります。

## Hand Menu Example update
Hand Menu Example がアップデートされました。
具体的には、以下2つの大きな操作メニューが追加されています。


| メニュー名 | 概要 | gif 動画 |
| --- | --- | --- |
| 大きな操作メニュー (1) | つまみを引いて離した移動&固定してくれる | <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/d8b87be5-6c50-1594-946f-4a5f5072040d.gif" width="1200"> |
| 大きな操作メニュー (2) | 手を下げた場所で自動位置固定をしてくれる | <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/770c30ee-7c00-735c-bc95-9c925d3dab0c.gif" width="600"> |

<font color="red">__※ これらのメニューは、Examples/Demos 配下に追加されており、現時点で Toolbox からは検索ができないので注意してください。__</font>

| メニュー | プレハブ場所 (パス) |
| --- | --- |
| 大きな操作メニュー (1) | MRTK/Examples/Demos<br/>/HandTracking/Prefabs<br/>/HandMenu_Large_AutoWorldLock_On_HandDrop.prefab |
| 大きな操作メニュー (2) | MRTK/Examples/Demos<br/>/HandTracking/Prefabs<br/>/HandMenu_Large_WorldLock_On_GrabAndPull.prefab |

> __Relese Notes 「Hand Menu Example update」 より引用__



## Dialog <font color="red">( Experimental )</font>
HoloToolkit から Dialog UI が移植されました。機能のアップデートは無いですが、HoloLens 2 向けにデザイン ( HoloLens 2 shell-style design ) が刷新されています。

><img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/98d3555c-d81f-83dc-9c26-f6a8f40783b4.png" width="600">
> __Release Notes 「Dialog」 より引用__

__サンプルシーン : MRTK/Examples/Experimental/Dialog/DialogExample.unity__

## Dock <font color="red">( Experimental )</font>
オブジェクトを所定の位置に近づけると、小さくなり Dock に収納することができる UX コンポーネントです。この機能を応用すれば、パレット、棚、ナビゲーションバーなどを作成することができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/645bef0a-9605-862a-cba3-87f6e9928c31.gif" width="600">
> __Release Notes 「Dock ( Experimental ) 」 より引用__

実際、HL2でサンプルシーンを動作させてみた様子は以下動画をご覧ください。

<blockquote class="twitter-tweet"><p lang="ja" dir="ltr">MRTK v2.4<br>Dock (Experimental)<br>早速試してみた！<br><br>所定の位置にオブジェクトを<br>近づけると小さくなって収納される。<br><br>パレット、ナビゲーションバー etc..<br>実装時に参考になるUXコンポーネント<br>想像より大きかったw<a href="https://twitter.com/hashtag/MRTK?src=hash&amp;ref_src=twsrc%5Etfw">#MRTK</a> <a href="https://twitter.com/hashtag/HoloLens2?src=hash&amp;ref_src=twsrc%5Etfw">#HoloLens2</a><a href="https://twitter.com/hashtag/MixedReality?src=hash&amp;ref_src=twsrc%5Etfw">#MixedReality</a> <a href="https://t.co/JrUOCXZYBx">pic.twitter.com/JrUOCXZYBx</a></p>&mdash; Futo Horio (@Futo_Horio) <a href="https://twitter.com/Futo_Horio/status/1266347449565605888?ref_src=twsrc%5Etfw">May 29, 2020</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

__サンプルシーン : MRTK/Examples/Experimental/Dock/DockExample.unity__

## Unity Profile makers
新しいバージョンの MRTK ( v2.4 ) では、入力システムとデータプロバイダーに Unity Profile マーカーが追加されました。これらのマーカーでは、アプリケーションの最適化に役立つ、MRTK入力システム内部の処理時間の詳細情報を提供してくれます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/9a121405-48da-910f-09ba-2a192311e805.png" width="600">
> __Release Notes 「Unity Profile makers」 より引用__

## WindowsApiChecker : isMethodAvailable(), IsPropertyAvailable(), and IsTypeAvailable()
WindowsApiChecker に、3つの新たなメソッドが追加されました。
これらのメソッドは、Windows 10 の機能サポートのチェックを可能にします。
( 結果は、UniversalApiContractV#_IsAvailable プロパティよりも優先的に使用されます。 )

- __IsMethodAvailable__
- __IsPropertyAvailable__
- __IsTypeAvailable__


## Helpers to get text input fields working with MixedRealityKeyBoard for UnityUI, TextMeshPro <font color="red">( Experimental )</font>

``UI_KeyboardInputField``、``TMP_KeyboardInputField`` の2つのヘルパークラスが追加されました。このヘルパークラスを使えば、フィールドがクリック時に、 HoloLens 2 および Windows Mixed Reality キーボードが表示され、Unity UI 内の入力フィールドに任意の文字を追加することができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/4c5899df-dfee-8ebf-97bb-6886854ff799.png" width="400">
> __Release Notes 「Helpers to get text input fields ..」 より引用__

詳細情報は、「[Mixed Reality Keyboard Helpers](https://microsoft.github.io/MixedRealityToolkit-Unity/Assets/MRTK/SDK/Experimental/MixedRealityKeyboard/README_MixedRealityKeyboard.html)」をご覧ください。

## Grid Object Collection Alignment Options
Grid Object Collection にグリッド内の用さを中央に配置するか、左/右軸に合わせて配置するかを選択できる機能が追加されました。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/3b9d580e-639f-cd0f-4a0a-2e02f7648a67.gif" width="400">
> __Release Notes 「Grid Object Collection Alignment Options」 より引用__

## Grid Object Collection Anchor Changes
Grid Object Collection の動作に変更が加わりました。オブジェクトの中心軸に沿ってアンカーを配置することで、Unity のレイアウトグループの動作により一致します。従来の Grid Object Collection の動作は、``AnchorAlogAxis`` フィールドで切り替えることができます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/ba24f5c4-1630-96e7-c2b1-bd57dc4687c5.gif" width="400">
> __Release Notes 「Grid Object Collection Anchor Changes」 より引用__

## Adjusted input simulation camera control
Unity Editor 上での入力シミュレーションにおけるカメラ操作スピードは「よりスムーズな体験」を提供するため、遅くなりました。この結果フレームレートから解放され、カメラのコントロール操作を有効化するボタンは「Ctrl」から「Shift」へ変更となりました。

## Hands-free GGV input simulation
Unity Editor 上で、手をシミュレーションせずに!? 検証することができるようになりました。従来だと、まず手をシミュレートしてからオブジェクトを操作しないといけませんでしたが、左クリックだけで操作ができるようになりました。これは地味ですが、非常に便利ですね。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/a625ff96-34cc-73cf-5004-d25ee32346a9.gif" width="600">
> __Release Notes 「Hands-free GGV input simulation」 より引用__

## Button Config Helper
Button Config Helper は、MRTKボタンのカスタマイズを容易にする編集機能です。
以下の操作を非常に簡単に行えるようになりました。

- __ボタンラベルの変更__ 
- __ボタンクリックイベントリスナーの追加__  
( ボタンがクリックされた時のイベント処理設定 )
- __ボタンアイコンの変更__

<img width="500"  src="https://img.esa.io/uploads/production/attachments/3505/2020/05/31/10862/80c7315d-eaff-4fd9-a971-b999f75ac4a0.png">

## Audio Spatializer Selection in MRTK configuration dialog
Audio Spatializer が MRTK Configuration dialog から指定できるようになりました。
Microsoft Spatializer のような新しい Spatializer をインストールすると、簡単に設定が変更できるように MRTK Project Configuration ウィザードが再表示されます。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/4a496375-1355-0385-b015-dfbf783f2039.png" width="600">
> __Release Notes 「Audio Spatializer Selection in MRTK configuration dialog」 より引用__

[Spatial sound in Unity](https://docs.microsoft.com/en-us/windows/mixed-reality/spatial-sound-in-unity)


## Object manipulator graduated to SDK
ObjectManipulator は、実験的な機能ではなく、SDKに移行しました。この機能は、廃止された ManipulationHandler クラス ( 以前のバージョン ) を置き換えることができます。ObjectManipulation には、ManipulationHandler クラスより柔軟に対応できる新しい制御システムがあり、物理世界に対して正しいフィードバックを返すことができます。完全な機能リストと設定方法については、「[Object manipulator](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/README_ObjectManipulator.html)」のドキュメントに記載があるので、そちらをご覧ください。

> <img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/180432/b6eb858c-59f2-f580-4865-304db138e162.png" width="600">
> __Release Notes 「Object manipulator graduated to SDK」 より引用__

__さきほどご紹介した「Migration Window」を使用することによって、「ManipulationHandler」から「ObjectManipulator」にアップグレードすることができます。__

## Bounds control improvements
MRTK v2.4 では、これまでのバージョンよりも境界面制御のテスト範囲を拡大し、ユーザーが抱える大きな問題点の1つに対処しました。境界のコントロールでは、設定を変更してもビジュアルを再作成しなくなりました。また、実行時のプロパティ変更もサポートするようになりました。

# Breaking changes MRTK v2.4
前回バージョンの MRTK v2.3 から MRTK v2.4 となり、大きな変更が加わった箇所は、以下の2点です。

## Eye Gaze API
IMixedRealityEyeGazeProvider インタフェースを実装した GazeProvider クラスのプロパティ名 __「UseEyeTracking」__ に変更がありました。

|  変更前 | <font color="black">__変更後__</font> |
| --- | --- |
| GazeProvider.UseEyeTracking | __GazeProvider.IsEyeTrackingEnabled__ |

## Eye gaze setup
新しい MRTK バージョンでは、Eye Gaze を有効化する手順に変更がありました。

「IsEyeTrackingEnabled」チェックボックスは、入力ポインター ( Input Pointer ) プロファイルの視線設定で見つけることができます。このチェックボックスにチェックを入れることで、デフォルトの Head Gaze ではなく、Eye Gaze が有効になります。

<img width="500" src="https://img.esa.io/uploads/production/attachments/3505/2020/05/31/10862/5353c5ee-aedb-461e-a2a8-0fd8247594ff.png">


この変更の詳細とアイトラッキングの詳細な設定手順は、「[Getting started with eye tracking in MRTK](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/EyeTracking/EyeTracking_BasicSetup.html)」をご覧ください。

# Known issues in MRTK v2.4
MRTK v2.4 には、以下、既知の問題が報告されているので内容把握と回避策を頭に入れておくと開発時に役立つと思います。

## MRTK Configurator dialog does not show 'Enable MSBuild for Unity' in Unity 2019.3

Unity 2019.3 で MSBuild を有効にすると、パッケージの読み込みが無限にループするという現象が発生します。回避策は、NuGet for Unity を使って、「Microsoft.Windows.DotNetWinRT」パッケージをインポートすることです。

## Duplicate Assembly Version and Multiple Precompiled Assemblies Unity 2018.4
Unity 2018.4 で、ターゲットプラットフォームを「PC, Mac & Linux Standalone」から「Universal Windows Platform」に切り替え、再度「PC, Mac & Linux Standalone」に戻されると、コンソールに次にエラーが表示される場合があります。

```console
PrecompiledAssemblyException: Multiple precompiled assemblies with the same name Microsoft.Windows.MixedReality.DotNetWinRT.dll included for the current platform. Only one assembly with the same name is allowed per platform. Assembly paths
```

```console
Assets\MRTK\Examples\Demos\HandTracking\Scenes\Utilities\InspectorFields\AssemblyInfo.cs(6,12): error CS0579: Duplicate 'AssemblyVersion' attribute
```

これらのエラーは、MSbuild For Unity による削除プロセス内の問題に起因しています。この問題を解決するには、「PC, Mac & Standalone」を選択した状態で、アセットのルートにある依存フォルダを削除し、Unityを再起動します。

この問題の詳細情報は、「Erros when switching from UWP to Standalone (  [#7948](https://github.com/microsoft/MixedRealityToolkit-Unity/issues/7948)  ) 」をご確認ください。

## Applications appearing as a 2D slate on Unity 2019.3
Unity 2019.3 を使用する場合、標準 SDK ( legacy ) または、プラグイン ( XR Management ) で XR サポートが有効化されていません。この結果、アプリケーションが2D平面で動作する状態になります。この問題を解決する方法は、「[Building and Deploying MRTK article](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/BuildAndDeploy.html#unity-20193-and-hololens)」に詳細が記載されています。

## Unity 2019.3 : ARM build architecture
Unity 2019.3 には、Visual Studio 2019 でビルドをする際、ターゲットプラットフォームを「ARM」設定するとエラーを引き起こす問題が報告されています。推奨される回避策は、「ARM64」に設定を変更し、ビルドを実行することです。もし、その選択が取れない場合は、Unity Editor 上で、__「Graphics Jobs」__ を無効化してください。__[Edit] > [Project Settings] > [Player] > [Other Settings]__ から設定することができます。さらに情報が必要な場合は、「[Building and Deploying](https://microsoft.github.io/MixedRealityToolkit-Unity/Documentation/BuildAndDeploy.html#unity-20193-and-hololens)」をご覧ください。

## Runtime profile swapping
MRTK は、実行時のプロファイル交換を完全にサポートしていません。
今後のリリースに向け、この機能について現在調査を進めている最中である。
詳しい情報が欲しい場合は、以下の GitHub Issues をご確認ください。

- Changin ActiveProfile at runtime does not work ( [#4289](https://github.com/microsoft/MixedRealityToolkit-Unity/issues/4289) )
- Runtime Profile Swapping - Input System ( [#5465](https://github.com/microsoft/MixedRealityToolkit-Unity/issues/5465) )
- Runtime Profile Swapping - Non Input System ( [#5466](https://github.com/microsoft/MixedRealityToolkit-Unity/issues/5466) )

## Unity 2018 : .NET Backend and AR Foundation
Unity 2018 で .NET スクリプティングバックエンドを使用して、UWP ( Universal Windows Platform  ) 向けのビルドを実行した際、Unity AR Foundation パッケージ由来のエラーが発生する問題があります。

この問題の回避するには、次のいずれかの手順を実行する必要があります。

- __スクリプティングバックエンドを .NET から IL2CPP に切り替える__
- __Build Settings ウィンドウで、"Unity C# Projects" のチェックを外す__