HoloLens で作業してるとスケールが小さいせいなのか、「もう少し寄りたい（ズームしたい）けどこれ以上スクロール回すと突き抜けてしまう...！！」みたいなことがよくあります。
そんなときに使える操作方法を教えてもらったので残しておきます。
MRTK の Build Window の Deploy Options タブで、[Install AppX]を実行しても PowerShell のウィンドウが一瞬出るだけで何も起きない。（インストールできない）
[Uninstall AppX]を実行しても同じ結果。
既にインストールされてたり、過去に何度も実行できてたはずなのに、[Install AppX]と[Uninstall AppX]しか有効になっっていないのも特徴のひとつ。
HoloLens を再起動する。OSのバージョンに依存している可能性あり。
Mixed Reality Toolkit Documentation の UX Building Blocks の章の Button から要点と補足をまとめたページです。
ドキュメントは2.4をベースに書かれている。
詳細はこちら。
microsoft.github.io
非公式日本語はこちら。 hololabinc.github.io
基本的な使い方は以下の通り。
MRTK Canvas に変換する
[NearInteractionTouchableUnityUI]コンポーネントを追加
Scale を 0.001 に
Unity UI 向けのボタンを追加する
基本的な使い方は以下の通り。
テキストとアイコンを変更する（2.4であればButtonConfigHelper）
Interactable スクリプト（2.4であればButtonConfigHelper）で
General の Speech Command で音声コマンドを選び、ラベルを修正する
音声コマンドはMixedRealityToolkitのプロファイルで登録されているものから選ぶことになる
音声コマンドを無効化するには、音声コマンドを[No Selection]にして、ラベルを無効化すればいけそう？（未確認）
PressableButtonHoloLens2 ボタンに登録されているコンポーネント。
各スクリプトの関連はYoonさんのセッション動画のスライドが分かりやすかった。 *1
OnClick に関しては PhysicalPressEventRouter で発火のタイミングを選択できる。
Interactable の Receivers には Press や Touch も選べるので、詳細を変更しようとしない限りは直接 PressableButtonHoloLens2 を触らなくても良さそう。
Near Interaction、Far Interaction の両方の動きをサポートするには Interactable の OnClick を使う必要がある。
Toggle では、Interactable の General に項目が追加される。Receviers では Toggle を選べる。
こちらもセッション動画のスライド。
2.4なら ButtonConfigHelper から編集できる。
アイコンは[Icon Set]というアイコンをグループ化したセットで管理するようだ。
Examples パッケージには以下のセットが含まれている。
2.3ならこのあたりで直接編集する。
C:/Windows/Fonts/holomdl2.ttf をUnityにインポートする。Explorer上だとこんな表示。
初回作成時は、[Select Font Asset]は空のままで良さそう。
Character Sequence (Hex) の値。
E700-E702,E706,E70D-E70E,E710-E714,E718,E71A,E71D-E71E,E720,E722,E728,E72A-E72E,E736,E738,E73F,E74A-E74B,E74D,E74F-E752,E760-E761,E765,E767-E769,E76B-E76C,E770,E772,E774,E777,E779-E77B,E782-E783,E785-E786,E799,E7A9-E7AB,E7AF-E7B1,E7B4,E7C8,E7E8-E7E9,E7FC,E80F,E821,E83F,E850-E859,E872-E874,E894-E895,E8A7,E8B2,E8B7,E8B9,E8D5,E8EC,E8FB,E909,E91B,E92C,E942,E95B,E992-E995,E9E9-E9EA,EA37,EA40,EA4A,EA55,EA96,EB51-EB52,EB65,EB9D-EBB5,EBCB-EBCC,EBCF-EBD3,EC03,EC19,EC3F,EC7A,EC8E-EC98,ECA2,ECD8-ECDA,ECE0,ECE7-ECEB,ED17,EE93,EFA9,F114-F120,F132,F181,F183-F186
ちょっと古いがこの辺の記事を見ると理解が進む。
Generateが完了したら任意の場所に保存。187個もあるらしい。
Projectウィンドウでメニューから[Create > Mixed Reality Toolkit > Icon Set]で新しいアセットを作成する。
[Char Icon Font] に作成した Font Asset を突っ込むと読み込まれる。
Available Icons でクリックすると下の Selected Icons に追加される。逆に Selected Icons でクリックすると消える。
Selected Icons に追加されているアイコンが ButtonConfigHelper で選択できるようになる。
Name をつけるとスクリプト上からアイコンを識別できる。
Icon Set を変更して任意のアイコンを選択する。
Mixed Reality Toolkit Documentation の UX Building Blocks の章の Button から要点と補足をまとめたページです。
ドキュメントは2.4をベースに書かれている。
詳細はこちら。
microsoft.github.io
非公式日本語はこちら。 hololabinc.github.io
ToolBoxから参照したり追加したりできるのでそちらを使う。
Buttons
Button Collections
Microsoft.MixedReality.Toolkit.Unity.Examples パッケージに以下のボタンが梱包されている。 画像はリスト順に左からの順になっている。
なお、PressableRoundButtonはパッケージをインポートするとToolBoxにも追加される。
2.3はToolBoxがないので2.4の画面キャプチャを参考にすると良い。
なお、以下のボタンは2.4から追加されたので2.3には含まれない。
Microsoft.MixedReality.Toolkit.Unity.Examples パッケージに以下のボタンが梱包されている。 画像はリスト順に右からの順になっている。
新規プロジェクト作成時に行うミニマムなお決まりの手順、設定など。
[Universal Windows Platform] を選択して[Switch Platform]をクリック
MRTK のパッケージを Project ペインにドラッグ＆ドロップして Import
インポート後に表示される「MRTK Project Configurator」ウィンドウは、[Enable MSBuild for Unity] をオフにして Apply
「Build Settings」 画面やメニューから「Project Settings」 画面の[Player]タブを開く
メニューから TextMeshPro Essential Resources を Import
任意の Scene で HoloLens 用の設定を適用（Scene のセーブを忘れずに）
任意の Scene をビルドに追加
Unity 2019.3.xを使用している場合は、Visual StudioでビルドアーキテクチャとしてARMではなくARM64を選択してください。Unity 2019.3.xのデフォルトのUnity設定では、UnityのバグによりARMを選択した場合、UnityアプリはHoloLensにデプロイされません。これはUnityのイシュートラッカーで追跡することができます。
ARMアーキテクチャが必要な場合は、Edit > Project Settings（編集）、Player（プロジェクト設定）、Other Settings（その他の設定）メニューでGraphics Jobs（グラフィックジョブ）を無効にしてください。グラフィックジョブを無効にすると、Unity 2019.3.xのARMビルドアーキテクチャを使用してアプリをデプロイすることができますが、ARM64を推奨します。
Mixed Reality Toolkit Documentation の UX Building Blocks の章の Near Menu から要点と補足をまとめたページです。
ドキュメントは2.4をベースに書かれている。
詳細はこちら。
2.4 では、Microsoft.MixedReality.Toolkit.Unity.Foundation パッケージに以下の prefab が梱包されている。
2.3 では、Microsoft.MixedReality.Toolkit.Unity.Examples パッケージに以下の prefab が梱包されている。
2.3でもUI構成は2.4と同じように見える。以下は2.3の画面。
2.3も2.4も同じように編集可能。
ドキュメントには書かれていないが、パネルサイズを変更した場合 Pin ボタンの位置も調整が必要になる。
メニューの prefab を Unpack した場合も注意が必要。
Pin ボタンが prefab のままだとクリックイベントが元のメニューの prefab を参照しているので、Pin ボタンをクリックしてもユーザーに追従してくれない。
親の [FollowMeToggle.ToggleFollowMeBehaviour] を設定しなおす。
Pin ボタンの修正は 2.5.3 は必要なさそうだった。
