VKC Attribute Clickable UI

VKCAttributeClickableUIコンポーネントは、ワールド内のオブジェクトが「クリックできる」状態を強調するためのガイドUIを設定するためのコンポーネントです。

VKC Attribute Click Guide (旧：HEOClickGuide)について

本コンポーネントはVKC Attribute Click Guide (旧：HEOClickGuide)の一般化を意図したコンポーネントです。
今後のアップデートでVKC Attribute Click Guideは徐々に廃止される予定であるため、基本的には本コンポーネントをお使いください。

基本設定

Single Image

名称 (英語)	名称 (日本語)	初期値	機能
Look At Camera	カメラに正面を向ける	true	カメラ方向に対して常に正面を向くようになります
Alpha Blending	透過表示	true	半透明やカットアウトを使用できます
Double Side	両面表示	true	両面表示するか否かを切り替えます
Foreground Rendering	最前面に描画	true	最前面に描画するか否かを切り替えます
Follow Nodes	ノードに追従	true	ノードが動的な場合UIも動かせるか否かを切り替えます
Auto Hide	時間経過で非表示	true	エリアに侵入後、時間経過で非表示にするか否かを切り替えます
Time for Hiding(s)	非表示になるまでの時間(秒)	5.0	エリアに侵入後、何秒表示させるかを設定できます
Single Image/Animation	シングルイメージ/アニメーション	Single Image	表示する画像を静的なpng画像にするか、コマ送りのアニメーション画像を設定するかを決められます
Image(.png)	画像（.png）	.guideframe	Guideframeの画像を設定できます
Position	位置	[0.0, 0.0, 0.0]	同じGameObject内のTransformコンポーネントのPosition値からの相対位置を設定できます
Rotation	回転	[0.0, 0.0, 0.0]	同じGameObject内のTransformコンポーネントのRotation値からの相対回転を設定できます
Scale	スケール	[1.0, 1.0, 1.0]	スケール値を設定できます

Animation

名称 (英語)	名称 (日本語)	初期値	機能
Animation Speed	アニメーションスピード	1.0	コマ送りするスピードを決められます。1の場合、1秒ごとにフレームが切り替わります。
Frames For Animation	コマ送りアニメーション	-	コマ送りする複数のアニメーションを設定できます。一番上から、コマ送りの画像が設定できます。
Image(.png)	画像（.png）	.guideframe	Guideframeの画像を設定できます
Position	位置	[0.0, 0.0, 0.0]	同じGameObject内のTransformコンポーネントのPosition値からの相対位置を設定できます
Rotation	回転	[0.0, 0.0, 0.0]	同じGameObject内のTransformコンポーネントのRotation値からの相対回転を設定できます
Scale	スケール	[1.0, 1.0, 1.0]	スケール値を設定できます

使い方

1. 空のゲームオブジェクトにVKC Attribute Clickable UIコンポーネントをアタッチします。
   このとき、VKC Node Collider、BoxCollider、VKC Item Area Colliderが必ずアタッチされます。

   

2. BoxColliderの範囲内にプレイヤーが侵入した際、クリックが可能である旨がUIによって示されます。
   この時オブジェクトをクリック可能とさせたい距離に応じてBoxColliderのスケールを変更しておきます。

   

3. クリックの対象であるオブジェクトをVKC Item Area Collider OnEnter / OnExitにて指定し、クリック可能と不可能を切り替えることができます。
   ここでは一例として、SphereオブジェクトをEnable / DisableClickableNodeアクションを使用してクリック可能と不可能を切り替えます。

   

4. ワールドをビルドして見た目を確認します。
   プレイヤーがBox Colliderに侵入した際にオブジェクトがクリック可能となったガイドUIが表示され、同時に該当のオブジェクトがクリック可能となります。
   Single Imageモードの時、設定された画像を「Time for Hiding(s)」にて設定された秒数分表示します。
   プレイヤーがBox Collider内にいる際に常にガイドUIを表示させたい場合は「Auto Hide」を無効にします。

   

5. UIを強調したい場合はAnimationモードを使うと有効です。
   ここでは一例として、1コマごとに1.0 → 1.2 → 1.5 → 1.2 → 1.0とスケールが伸縮するアニメーションを設定し、コマ送りのスピードを5.0に設定します。
   また、アニメーション表示が途切れないように「Auto Hide」を無効にします。

   

6. ワールドをビルドすると、以下のようにガイドUIが拡大・縮小して表示されます。

   

複雑なアニメーションの実装について

Animationモードではコマ送りによるアニメーションの設定を主な用途として想定しています。
より複雑なアニメーション・演出を再生したい場合は、一例としてオブジェクトをアニメーションさせる / VKC Item Objectにアニメーションを付与する方法を参考にアニメーションを設定し、VKC Item ObjectとVKC Item Area Colliderの連携の実装が考えられます。