====== VCI Attachable (VCISDK) ======
VCIがプレイヤーのアバターに装着できるようになるコンポーネントです。\\
VCIが装着された場合、ボーンとVCIの相対位置を維持するようになります。

装着箇所は[[unity:humanoid| Unity Humanoid Avatar]]のボーンマッピングに準拠しています。

===== コンポーネント画像 =====
{{:vci:sdk:attachable:description.jpg?direct&600|}}

===== VCI Attachable =====

^ プロパティー ^ 機能 ^ VCバージョン ^
| Attachable Human Body Bones | VCIの取り付け先となるボーンのリスト\\ 取付可能なボーンは [[unity:humanoid| Humanoid Avatar]] に準拠しています\\ | |
| Attachable Distance | 装着の判定を行う範囲。 長さは半径(m)で指定します。\\ （**0 を指定すると装着しないので注意**）  | |
| Scalable | チェックを入れると、装着範囲がSubItemの拡縮に連動します  | 1.9.3e以降 |
| Offset | 装着範囲の中心を指定します  | 1.9.3e以降 |

===== オブジェクト構成について =====

{{:vci:sdk:attachable:attachableobject.jpg?400|}}

  * VCIAttachableはSubItemと同じオブジェクトに張り付けてください。
  * VCIAttachableに加えてSubItem(Grabbable)＋[[vci:component:unity_collider|Collider]]＋[[vci:component:unity_rigidbody|Rigidbody]]が必要です。
  * 推奨設定（下記設定で空中に静止するオブジェクトになります）
  * Rigidbody … UseGravity:無効 Is Kinematic：有効
  * Collider … Is Trigger:有効

===== 仕様について =====

  * 取付可能なボーンのリストは [[unity:humanoid| Humanoid Avatar]] と対応しています。
  * 手を離したタイミングで「SubItemのtransform + Distance」に\\ 取り付け先のボーンが存在すれば装着できます。
  * 取付先をRightHandとLeftHandに設定した場合、\\ 持ち替えるような動作をする度にもう片方の手に装着されます。

===== SubItemの所有権の変化 =====

{{:vci:sdk:attachable:ownership.png?direct&600|}}

装着可能なVCIは他の人から装着された場合、\\
装着された側の人がつかまなくても装着された人に所有権が移ります。\\
装着できなかった場合は、通常通り手を離した人がSubItemの所有権を持っています。

===== ScalableとOffsetの挙動 =====

Offsetを立方体の右上に設定した場合の、VCIAttachableの挙動です。Scalableにチェックを入れた場合は、SubItemのサイズに連動して装着範囲が拡縮します。Offsetは常にSubItemのサイズに連動します。ScalableとOffsetが未設定の場合は、以前のバージョンと同じ挙動になります。

{{:vci:sdk:attachable:attachabe_offset_scalable_off.gif?400|}}

Scalable: Off

{{:vci:sdk:attachable:attachabe_offset_scalable_on.gif?400|}}

Scalable: On

===== 関連ページ =====

  * [[https://blog.virtualcast.jp/blog/2019/09/nazenani5/ | なぜなにバーチャルキャスト#05～装着アイテムで遊ぼう！]]