自作のHoloLensアプリの使い方どう説明します？

HoloLensはジェスチャが入力のメインになります。ジェスチャの種類は多くはないですが初めてのアプリケーションでは操作方法に戸惑う場合が多いと思います。
MRDesignLabs_Unity_LunarModulesは両手ジェスチャー入力でかつTapHoldでの操作が基本になります。そして、操作が複雑（慣れが必要なのですが）です。おそらく説明がないと操作を理解できません。このため、チュートリアルのための機能が付いています。今回はLunarModuleのチュートリアルの機能だけを抜き出し利用できるようするともにサンプルコードで使い方の説明を行いたいと思います。

LunaModuleをデプロイして遊びたい方はこちらを参考にしてください。

環境などなど

開発環境

Windows 10 Pro
Unity 5.6.1f1
Visual Studio 2015 Community Edition Update 3

ソースコード

LunarModuleのチュートリアル

Lunar Moduleではこういう形で機体の操作をチュートリアルで説明しています。手の色が青い状態なのですが、これはそれぞれの手がHoloLensのセンサ内で検出されている状態です。センサー外の場合は赤色になります。

この手の表現を行うためのPrefabがHandoCoachとして提供されています。

HandCoachの説明

HandCoachはPrefabで構成されています。Hierarchyに登録しプロパティを設定することで、設定したジェスチャー操作がアニメーションで表示されます。
1つのHandCoachで片手or両手どちらも対応可能です。また、チュートリアルとして複数の操作を組み合わせる場合、手順分HandCoachを作る必要はありません。実際には１つだけ用意しておき、プログラム側からプロパティを変更することで複数操作のチュートリアルを実現します。

プロパティが多いコンポーネントですのでカテゴリ毎に設定を整理したいと思います。

Material settings

HandCoachの外観についての設定をするプロパティ群です。

プロパティ名	説明	選択値など
HandMaterial	ジェスチャーに使用するマテリアルを設定します。	HandCoachMaterial
Highlight Color	手が表示され強調表示されているときの色を設定します。	-
Normal Color	手が表示され、強調表示されていないときの色を設定します。	-
Tracked Color	センサーが手を検出中であるときの色を設定します。	-
Tracking lost Color	センサーが手の検出を喪失している時の色を設定します。	-
Color(Highlight)	Highlight Colorで設定した色をマテリアルのどこに反映させるかを設定します。	_InnerColor(手全体) _RimColor(輪郭)
Color(Tracking)	Tracked Color及びTracking lost colorで設定した色をマテリアルのどこに反映させるかを設定します。	_InnerColor(手全体) _RimColor(輪郭)
Use float property for transparency	ジェスチャーの浮き上がらせ方をfloat数値系のプロパティで行うか、Color系のプロパティで行うかを選択します。trueの場合はFloat値での変更になります。Color系は透過度を変更します。	-
Range(Transparency)	ジェスチャーの浮かび上がり方に関する設定値。透過度を変更して表示するか、輪郭の光具合で表現するかを選択する。	_Alpha(色の透過度) _RimPower(輪郭の光具合)
Color(Transparency)	ジェスチャーの浮かび上がり方に関する設定値。どの色に対して変更を掛けるかを設定します。	_InnerColor(手全体) _RimColor(輪郭)
hands to Highlight	ジェスチャーの手にハイライト色を適用するか設定します。	None Left Right

Tracking settings

センサーの検出に対するジェスチャーオブジェクトの設定を行います。

プロパティ名	説明	選択値など
CheckTracking	trueの場合、センサーが手を検出/未検出に応じて透過色を自動的に設定します。	None Left Right Both
Auto-ghost hands when tracking lost	センサーで手が未検出の場合、表示されている手の透過度を変更するかどうか設定します。	true/false
Ghosting	手が未検出の場合、透明度を変更する手を設定します。	None Left Right Both
Tracking	変更不可。センサーにより検出されている手を取得します。	None Left Right Both

Gesture settings

ジェスチャーの挙動に対する設定を行います。

プロパティ名	説明	選択値など
Hands to show	ジェスチャー表示する手を設定します。	None Left Right Both
Auto Lower On Invisible	不可視時に自動的に手のジェスチャーを下げるように設定します。	true/false
RightGesture	右手で表現するジェスチャーを設定します。	None Tap TapHold TapHoldRelease Bloom Ready
LeftGesture	左手で表現するジェスチャーを設定します。	None Tap TapHold TapHoldRelease Bloom Ready
RightMovement	右手のジェスチャー操作の表現を設定します。	Static：一度だけ設定に応じたジェスチャーの動きを再現します。 PingPong:設定応じたジェスチャーの動きを繰返し(初期状態→最終状態→初期状態→...)実施します。 Directional:設定応じたジェスチャーの動きを繰返し実施します（初期状態→最終状態1セットで繰り返す）
LeftMovement	左手のジェスチャー操作の表現を設定します。	Static：一度だけ設定に応じたジェスチャーの動きを再現します。 PingPong:設定応じたジェスチャーの動きを繰返し(初期状態→最終状態→初期状態→...)実施します。 Directional:設定応じたジェスチャーの動きを繰返し実施します（初期状態→最終状態1セットで繰り返す）

Right hand direction & Left hand direction

ジェスチャー操作の中にポジションの移動が含まれる場合は以下のパラメータをチェックし移動に対するアニメーションを有効にします。

プロパティ名	説明	選択値など
None	動きなし	-
Left	左にポジションを移動するジェスチャー	-
Right	右にポジションを移動するジェスチャー	-
Front	前方にポジションを移動するジェスチャー	-
Back	手前方向にポジションを変更するジェスチャー	-
Up	上にポジションを移動するジェスチャー	-
Down	下にポジションを移動するジェスチャー	-

使い方

使い方自体は非常に簡単で、HierarchyパネルにProjectパネルから「HandCoach.prefab」をドラッグ&ドロップします。チュートリアルとしていろいろなジェスチャーの説明をする場合でもジェスチャー操作をプログラム側から変更できるのでオブジェクトとしては１つあれば問題ありません。
配置後チュートリアルとして設定したいジェスチャーをプロパティで設定すれば画面に手の動きがアニメーションで表示されます。
例えば、今回のサンプル用に追加したHandCoachのいくつかのパターンではこのような動きになります。

Lunar Moduleに実装されているHandCoachの調査と拡張。元はセンサーのトラッキング時に青になる。これを正しい操作状態のときに青くなるようにしてみる。使い方はわかってきたので整理しよう。 #MRDesignLabs pic.twitter.com/mGPyP5laOi
— takabrz (@takabrz1) 2017年8月16日

実際の操作方法としてジェスチャーの動きを伝えることができるためヘルプ用のシーンなどでこれを使う形になります。

自分のアプリに導入する場合

このHandCoarchについてはLunar Module付属の機能のためHolotoolKit-Unity,MRDesignLabsに加えてMRDesignLabs_LunarModuleも必要になります。実際にチュートリアル用にHandCoachを使う場合はLunar Moduleのgithubから必要なものだけを抜き出す形で使うことになります。

抽出するファイル群

必要な構成は以下の通りです。

HoloToolkitフォルダ全て
MRDesignLabsフォルダ全て
MRDesignLabs_LunarModule以下
- \Animation以下
  - HandCoachAnimator.controller
  - HandLeftHandedness.anim
  - HandMoveBack.anim
  - HandMoveDown.anim
  - HandMoveForward.anim
  - HandMoveLeft.anim
  - HandMoveRight.anim
  - HandMoveUp.anim
  - HandRightHandedness.anim
- \Editor以下
  - HandCoachInspector.cs
- \Materials以下
  - Shaders\HandCoachShader.shader
  - HandCoachMaterial.mat
- \Meshes以下
  - \Materials\coachBody_Mat.mat
  - HandCoach.fbx
- \Prefabs以下
  - HandCoach.prefab *\Scripts以下
  - HandCoach.cs
- \Textures以下
  - HandCoachTexture.psd
  - HandPresent.psd
  - HandPressed.psd

サンプルコードと拡張

上記の方法でHandCoach部分だけ抽出したサンプルを作成しました。
HandCoachの機能でTracking Settingsという設定項目があります。この設定を利用するとHoloLensのセンサーが手を検出している場合に、ジェスチャーオブジェクトの色をトラッキング中の色に変更することができます。これによりセンサーに認識されているかを判別することができます。

使い方を理解するために、この機能を少し拡張し「正しいジェスチャー状態の場合にトラッキング中の色に変更する」機能を追加したいと思います。どのような動作になるかは先の動画を見ていただくとわかると思います。まずセンサーが手を検出している状態ではReadyジェスチャーが青くなります。その後Tap動作を行うとTap操作に対応するジェスチャーが青くなります。また、TapAndHold状態で手のポジションを変更するとすると移動した向きにあったジェスチャーが青くなります。この機能については前回説明したLocalHandInputの機能も利用しています。

DirectionTrackableHandCoachHelper

https://github.com/TakahiroMiyaura/MRHandCoachSamplesにHandCoach拡張用にDirectionTrackableHandCoachHelperコンポーネントを追加しました。このコンポーネントはHnadCoachコンポーネントを必須にしています。ですのでHierarchyパネルに追加したHandCoach.prefabにこのコンポーネントを追加する形で利用します。
プロパティは以下の通りです。

プロパティ名	説明	選択値など
Target Right Gesture	検出したい右手のジェスチャー	None Tap TapHold TapHoldRelease Bloom Ready
Target Right Direction	TapAndHold中の右手の移動方向	None Left Right Front Back Up > Down
Target Left Gesture	検出したい左手のジェスチャー	None Tap TapHold TapHoldRelease Bloom Ready
Target Left Direction	TapAndHold中の左手の移動方向	None Left Right Front Back Up > Down
Tap Threshold	ジェスチャーの内、Tap、TapAndHold→Releaseを区別するための閾値。TapはジェスチャーとしてTapAndHold+ReleaseになるためHoldの時間次第でTapなのか、TapAndHold+Releaseなのかを区別します。	0.1
RHand	右手設定済みのLocalHandInput	-
LHand	左手設定済みのLocalHandInput	-

最後に

基本的には機能を提供するMRToolkit-Unityに比べると実験要素の強いMRDesignLabsですが、便利な機能が豊富です。
皆で使えば、MRToolkit-Unity側にも追加されたりすると思うので、たまにはMRDesignLabsも楽しんでください。

HoloLensではじめるMRDesignLabs - HandCoachを使いこなす