# AvatarPoseSystem アバターのポーズを固定して動かせるアバターギミック 身体と揺れ物（PhysBone）をそれぞれ固定可能です、身体は固定後ポーズの調整が可能です 固定したアバターをカメラで撮影できます。VirtualLens2やVRCLens出の撮影も可能です ### メニュー - Option - HideBody 　 ...身体固定時に表示する仮の身体の表示/非表示を切り替えます。 - AllowGrab 　　　　 　...掴みの有効/無効を切り替えます。 - ShowHandle 　　　 　 　...ハンドルの表示/非表示を切り替えます。 - LockHandle 　 ...ハンドルのロックを切り替えます。ロック中はハンドルを持てなくなります。 - On/Off (Hold 1 sec) 　 ...固定/解除を切り替えます。解除する際は1秒間長押し（ホールド）してください。（※誤操作防止のため、解除時のみ1秒間のホールドが必要です） - Timer5s 　...5秒後に固定するタイマーを起動します。 - Timer15s 　...15秒後に固定するタイマーを起動します。 - LipSync ...身体固定中もリップシンク（口の動き）を継続するかどうかを切り替えます。OFFの場合は固定中のみリップシンクが停止します。 - Ex - FixBody On/Off 　...身体のみ固定/解除を切り替えます。 - FixBody Timer5s 　...5秒後に身体のみ固定するタイマーを起動します。 - FixBody Timer15s 　...15秒後に身体のみ固定するタイマーを起動します。 - FixPB On/Off 　　...PhysBoneのみ固定/解除を切り替えます。 - FixPB Timer5s 　 　...5秒後にPhysBoneのみ固定するタイマーを起動します。 - FixPB Timer15s 　 　...15秒後にPhysBoneのみ固定するタイマーを起動します。 ### メニュー以外の操作 - 身体を固定中に身体の各部位を持つと位置や角度を調整できます。調整した位置で固定する時はPhysBoneの固定の要領で可能です。 ※持てる部分はハンドルを表示すると見ることができます。 - 身体を固定中で掴みが有効になっている場合に、身体の近くで手をFistにすると身体を持って動かすことができます。手を離すと身体はその場所に固定されます。 - 身体を固定中に、手のそばにある赤いハンドルを引っ張ると手のサイズを大きくできます。ハンドルを持ちやすくするためにご使用ください。 - 身体を固定中に、背中付近にある赤いハンドルを引っ張ると身体の位置を移動できます。 ## 準備事項 下記のものをあらかじめ適用してください 1. Modular Avatar https://modular-avatar.nadena.dev/ja/ 2. lilToon https://lilxyzw.booth.pm/items/3087170 ※v5.0.0より、従来のタイマー演出で使用していた「円形ゲージシェーダー」の事前導入は不要になりました（本アセット同梱のテクスチャにて動作します）。 ## 導入方法 1. アバターに、AvatarPoseSystem prefabを配置します。 2. 必要に応じて、AvatarPoseSystemコンポーネントに設定を行います。 - Unhandle Eyes : 目をハンドルで調整しない（他ギミックの視線制御を使用する場合はチェックしてください） - Unfix Phys Bones : 固定したくないPhysBone/HeadChopを設定してください（設定した要素のみ対象） - Unfix Phys Bones With Children : 固定したくないPhysBone/HeadChopを設定してください（設定した要素と子要素が対象） - Unfix Objects : 固定したくないオブジェクトを設定してください（VirtualLensなどはこちら） - Unfix Object Paths : 固定したくないオブジェクトのパスを設定してください(自動生成オブジェクト指定用) - Handle Size : ハンドルのサイズ - 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」に設定してください。 ※VirtualLens2やVRCLensを使用して写真を撮りたい場合はこちらに設定が必要です。詳細は後述します。 ### 導入補足 - VirtualLens2を使用したい場合 「Unfix Objects」に"VirtualLens2" オブジェクトを設定してください。 「Unfix Object Paths」に"_VirtualLens_Root"を設定してください。 また、VirtualLens2側の設定で、Marker Objectで「Auto」になっている物がある場合は「Auto」を押してオブジェクトの生成を行ってください。(これを行わない場合、ドローン等の操作ができなくなります) - VRCLensを使用したい場合 「Unfix Objects」に"VRCLens"、"PickupA"、"PickupB"、"PickupC" オブジェクトを設定してください。 ※"PickupA"、"PickupB"、"PickupC"はVRCLensによりアバターの頭と両手ボーンの下に作成されています。 - PC-1を使用したい場合 「Unfix Objects」に"Hand Proxy" オブジェクトを設定してください。 - ポーズ固定時にEmoteCollectorのポーズを解除したい場合 「Set Paramaters On Fix」に Paramater Name=EC/AllReset, Value=1 を設定してください。 「Set Paramaters On Unfix」に Paramater Name=EC/AllReset, Value=0 を設定してください。 - ポーズ固定時にAvatarPoseLibraryのポーズを解除したい場合 「Set Paramaters On Fix」に Paramater Name=AnimPoseReset_, Is Prefix=☑, Value=1 を設定してください。 ### 導入補足2 - キメラアバターの場合 キメラアバター（アバターの頭部に別のアバターなどの頭部を付けたもの）にAvatarPoseSystemを適用する場合は、身体の方の元々の目のボーンと同じ階層、同じ名前ですげ変えた頭の目のボーンがある状態に調整ください。 ## 注意事項 - 本ギミックではPhysBoneの固定を行いますが、本ギミック以外で制御が行われているPhysBoneはうまく制御できないことがあります。 ※例えば、マヌカの尻尾はAFKアニメーション内に制御が行われているため固定時にまっすぐになってしまいます。これを回避するにはAFKアニメーションから尻尾の制御を削除する必要があります。 - 本ギミックはアバターの構造に影響を与えるため、他のギミックなどに影響を与える可能性があります。そのため同時に入れた他のギミックがうまく動かないなどの状況が発生する可能性があります。 ※「Unfix Phys Bones」「Unfix Phys Bones With Children」「Unfix Objects」をうまく設定していただくことで回避できる場合がありますが、できないこともあります。 - 本ギミックは本ギミック以外の身体の部位を掴んだり動かすようなギミックとは併用できません ## エラーに関する問い合わせについて - AvatarPoseSystem の Enable Trace にチェックを入れてビルドを行うと、トレース情報を作成します。バグ報告時にこの情報を添付していただけますと確認がスムーズになる可能性があります - 添付前にトレース情報ファイルを開いて送付して問題ない内容であるかをご確認下さい。 ## よくあるご質問への回答 - Q: 固定が解除できない - A: 誤操作による意図しない解除を防ぐため、固定の解除時は「On/Off (Hold 1 sec)」メニューを1秒間長押し（ホールド）する必要があります。タップではなく1秒間押し続けてください。 - Q: ハンドルがつかめない - A: ハンドルはPhysBoneになっております。VRChatの設定でAvatar Interactionsの設定値をご確認いただき、PhysBoneが触れる状態になっているかご確認下さい。 ## 特記事項 - 今後VRChat及びVRCSDKなどのバージョンアップにより動作に問題が発生することがあります - 本アイテムはPCVRモードでの使用を想定しております。 - 本アイテムはVRChat SDK - Avatars 3.7.0 以上を想定しております。 ## ライセンス 本アセットはZeroFactory共通利用規約で提供されます。許諾事項は以下のURLよりご確認ください。 https://zerofactory.booth.pm/items/6513512 ## SPECIAL THANKS 〇 アイデア提供、テスト - sao* ( https://x.com/sao_0u0 )