【VRChatアバターギミック】AvatarPoseSystem Quest

AvatarPoseSystemQuest

アバターのポーズを固定して動かせるアバターギミック（Quest対応版）

身体と揺れ物（PhysBone）をそれぞれ固定可能です、身体は固定後ポーズの調整が可能です

### メニュー

- Option

- HideBody ...身体固定時に表示する仮の身体の表示/非表示を切り替えます。

- AllowGrab ...掴みの有効/無効を切り替えます。

- ShowHandle ...ハンドルの表示/非表示を切り替えます。

- AutoTarget ...ハンドルの対象自動選択を切り替えます。

- On/Off (Hold) 　 ...固定/解除を切り替えます。解除する際は1秒間ホールドしてください。（誤操作防止）

- Timer5s ...5秒後に固定するタイマーを起動します。

- Timer15s ...15秒後に固定するタイマーを起動します。

- Ex

- FixBody On/Off ...身体のみ固定/解除を切り替えます。

- FixBody Timer5s ...5秒後に身体のみ固定するタイマーを起動します。

- FixBody Timer15s ...15秒後に身体のみ固定するタイマーを起動します。

- FixPB On/Off ...PhysBoneのみ固定/解除を切り替えます。

- FixPB Timer5s ...5秒後にPhysBoneのみ固定するタイマーを起動します。

- FixPB Timer15s ...15秒後にPhysBoneのみ固定するタイマーを起動します。

- Target

- ※この下に身体の各部位にハンドルを移動するメニューがあります

### メニュー以外の操作

- 身体を固定中でハンドル表示時に身体の各部位に表示されるハンドルを持つと位置や角度を調整できます。調整した位置で固定する時はPhysBoneの固定の要領で可能です。

- ハンドルの対象自動選択が有効になっている場合に、手を近づけた部位に自動でハンドルが移動します。

- 身体を固定中で掴みが有効になっている場合に、身体の近くで手をFistにすると身体を持って動かすことができます。手を離すと身体はその場所に固定されます。※掴み有効時はハンドルは表示されず、ハンドルを持つことはできません。

## 準備事項

下記のものをあらかじめ適用してください

1. Modular Avatar

https://modular-avatar.nadena.dev/ja/

## 導入方法

1. アバターに、AvatarPoseSystemQuest prefabを配置します。

1. 必要に応じて、AvatarPoseSystemQuest コンポーネントに設定を行います。

- Unhandle Eyes : 目をハンドルで調整しない（他ギミックの視線制御を使用する場合はチェックしてください）

- Unfix Phys Bones : 固定したくないPhysBone/HeadChopを設定してください（設定した要素のみ対象）

- Unfix Phys Bones With Children : 固定したくないPhysBone/HeadChopを設定してください（設定した要素と子要素が対象）

- Unfix Objects : 固定したくないオブジェクトを設定してください（VirtualLensなどはこちら）

- Unfix Object Paths : 固定したくないオブジェクトのパスを設定してください(自動生成オブジェクト指定用)

- Set Paramaters On Fix : ポーズ固定時にパラメータを変更する設定

- Set Paramaters On Unfix : ポーズ固定解除時にパラメータを変更する設定

- Enable Trace : チェックするとトレース情報を作成します。バグ報告時にこの情報を添付していただけますと確認がスムーズになる可能性があります。

①固定したくないPhysBone/VRCHeadChopがある場合は、対象を 「Unfix Phys Bones」「Unfix Phys Bones With Children」に設定してください。

②固定したくないオブジェクトがある場合は、対象を 「Unfix Objects」に設定してください。

③固定したくないオブジェクト（ビルド時に追加されるオブジェクト）がある場合は、対象をのパスを 「Unfix Object Paths」に設定してください。

## 注意事項

- 本ギミックではPhysBoneの固定を行いますが、本ギミック以外で制御が行われているPhysBoneはうまく制御できないことがあります。

- 本ギミックはアバターの構造に影響を与えるため、他のギミックなどに影響を与える可能性があります。そのため同時に入れた他のギミックがうまく動かないなどの状況が発生する可能性があります。

※「Unfix Phys Bones」「Unfix Phys Bones With Children」「Unfix Objects」をうまく設定していただくことで回避できる場合がありますが、できないこともあります。

- AvatarPoseSystem 用の拡張機能は AvatarPoseSystemQuest では使用できません。

## エラーに関する問い合わせについて

- AvatarPoseSystemQuest の Enable Trace にチェックを入れてビルドを行うと、トレース情報を作成します。バグ報告時にこの情報を添付していただけますと確認がスムーズになる可能性があります

- 添付前にトレース情報ファイルを開いて送付して問題ない内容であるかをご確認下さい。

## よくあるご質問への回答

- Q:ハンドルがつかめない

- A:ハンドルはPhysBoneになっております。VRChatの設定でAvatar Interactionsの設定値をご確認いただき、PhysBoneが触れる状態になっているかご確認下さい。

また、Quest対応アバターではPhysBoneが8個を超える場合アップロード時に削除されてしまうため掴めなくなります。PhysBoneの数をご確認ください。

なお、AvatarPoseSystem Questでは2つのPhysBoneを使用します。

## 特記事項

- 今後VRChat及びVRCSDKなどのバージョンアップにより動作に問題が発生することがあります

- 本アイテムはPCVRモード、QuestVRモードでの使用を想定しております。

- 本アイテムはVRChat SDK - Avatars 3.10.0 以上をを想定しております。

## ライセンス

本アセットはZeroFactory共通利用規約で提供されます。許諾事項は以下のURLよりご確認ください。

https://zerofactory.booth.pm/items/6513512

## 更新履歴

- v1.0.0 リリース

- v1.0.1 以下の内容を修正

- 掴み操作がリモートで同期されない点を修正

- v2.0.0 以下の内容を修正

- ExtraBone拡張用の対応行いました

- Off時に1秒間メニューをホールドするように変更（誤操作防止）

- トレースログがクリアされていなかった点を修正

- v2.0.1 以下の内容を修正

- MA 1.17.0でアバターにMA Floor AdjusterとAPSがある場合に地面に埋まったようになってしまう点を修正

- ExtraBoneを設定していない場合にエラーになってしまう点を修正

- prefabの初期値でトレース情報出力がONになっていたためOFFに変更

- v2.0.2 以下の内容を修正

- MA Merge Armatureを使用した衣装などが追従しない点を修正