Animator Parameters

アバターの Playable Layers で Animator Parameters を使用することで、アバターの Animator ステートを制御したり、影響を与えたりすることができます。

• 一部のパラメータは VRChat に組み込まれており、どの Playable Layer でも使用可能です。
• カスタムパラメータを独自に作成することもできます。これには Expression Parameters asset を作成する必要があります。

ビルトインパラメータ

アバターの Playable Layers に追加することで、VRChat のビルトインアバターパラメータにアクセスできます。

これらのパラメータを追加すると、VRChat 内の状況に応じて値が自動的に更新されます。例えば、VelocityMagnitude パラメータを追加すると、プレイヤーの現在の速度に基づいてその値が更新されます。

すべてのビルトインパラメータは読み取り専用です。これらを Expressions Menu や OSC で変更することはできません。

以下のリストには、VRChat のすべてのビルトインパラメータ、その説明、型、および 同期タイプ が記載されています。

アバターのスケール（拡大縮小）パラメータ

Playable Layer は、以下のパラメータを使用して、プレイヤーの現在の アバタースケール に反応させることができます。

パラメータの型

Expression Parameters アセット では、以下の型のパラメータを定義できます。

同期される各パラメータは、一定量のパラメータメモリを消費します。VRChat では最大 256 ビットのカスタムパラメータを同期できます。また、VRChat はアバターの Expression Parameters の合計（同期・非同期を含む）を 8192 個までと制限しています。組み込みパラメータ はこの制限に含まれません。

GestureLeft および GestureRight の値

GestureLeft および GestureRight は、以下の値をそれぞれ使用します。

Viseme（口形）の値

Oculus の Viseme インデックス を上から順に使用しており、sil は 0 となります。参考として以下を参照してください：

AFK State

AFK状態は、以下の状況でトリガーされます。

• ユーザーがヘッドセットを外し、HMDの近接センサーによってヘッドセットを装着していないと判定された場合。
• システムメニューが開いている場合。これは使用しているプラットフォームがシステムメニュー表示時にどのようにデータを配信するかによって異なります。例えば、Oculus DashはAFKとして登録されませんが、SteamVRのメニューはAFKとして登録されます。これは意図的な動作ではなく、副次的な影響によるものです。
• ユーザーがEndキーを押して、AFK状態を切り替えた場合。

TrackingType Parameter

TrackingType は、いくつかの情報を示しています。

値が3、4、または6で、かつ VRMode が1の場合、アバターの着用者が有効にして現在トラッキングしているポイントの数を示します。この値は変化する可能性があります！ 6点トラッキング中のユーザーが、追加の3つのトラッキングポイントを外した場合、値は6から3に変わります。Animatorを設計する際は、この点を考慮してください。

値が0、1、または2で、かつ VRMode が1の場合、アバターがまだ初期化中であることを示します。この値の組み合わせに基づいて分岐するようにAnimatorを設計すべきではありません。その代わりに、3、4、または6といった「有効な」値になるのを待つようにしてください。

カスタムパラメータ

アバターの Playable Layers に独自のパラメータを追加できます。 Expression Parameters アセットを作成することで、VRChat 内でのパラメータ制御が可能になります。例えば、Expressions Menu を設定して、VRChat 内でユーザーがアバターをカスタマイズできるようにすることが可能です。

Expression Parameters アセット

Expression Parameters アセットには、Playable Layers が使用できるカスタムパラメータのリストが含まれています。各パラメータには名前、型、デフォルト値があります。また、パラメータを他のプレイヤーと同期するかどうかを選択することもでき、これにより Animator やカスタムパラメータによって生じた変化を他のプレイヤーにも見せることができます。

カスタムパラメータの制御方法

アバターの Playable Layers と Expression Parameters アセットでカスタムパラメータを設定した後、以下の3つの方法でパラメータを制御できます。

• Expressions Menu を設定する。これにより、VRChat 内で衣装の切り替えやカスタムアニメーションの再生といったパラメータ制御を簡単に行えるようになります。Expressions Menu は、カスタムパラメータを制御する最も簡単で一般的な方法です。
• Playable Layer 内の各ステートにステートビヘイビアの Avatar Parameter Driver をアタッチする。これにより、Expression Parameters アセットで定義したパラメータを自動的に設定、加算、あるいはランダム化できます。
• OSC 用にアバターを設定する。これにより、ユーザーや外部ツールからパラメータを制御できるようになります。例えば、VRCFaceTracking は、顔や目のトラッキング機器を使用してアバターの表情パラメータを制御します。

デフォルトの AV3 エイリアシング

独自のコントローラーを作成したくない場合のために、テンプレートの AV3 VRChat コントローラーで使用される「デフォルト」がいくつか用意されています。これらは、名前を重複させない限り、エイリアシング（別名参照）によって独自のパラメータと衝突することはありません。

特に、デフォルトの Action レイヤーと FX レイヤーはエイリアシングを使用しています。これらのレイヤーに含まれる Expression を使用することを心配する必要はありません。

Action は VRCEmote というエイリアスされたパラメータを使用します。これは 1 から 16 の範囲を持つ Int 型です。

FX は VRCFaceBlendH (-1, 1) および VRCFaceBlendV (-1, 1) というエイリアスされた Float パラメータを使用します。独自のメニューでこれらを利用したい場合は試してみてください。デフォルトの FX レイヤーを使用するには、Body という名前の Skinned Mesh があり、その中に mood_happy、mood_sad、mood_surprised、そして mood_angry というブレンドシェイプが含まれている必要があります。

要するに、カスタム Playable Layers を持たない Avatar3 アバターとしてアップロードした場合でも、上記の名前のブレンドシェイプが含まれていれば、組み込みのエモートをいくつか使用できるということです。

また、eyes_closed ブレンドシェイプがあれば、デフォルトの Die エモートを使用したり、AFK になった際に目を閉じさせることができます。

クロスプラットフォームのパラメータ同期

Quest 版と PC 版の両方がアップロードされているアバターを使用する場合、パラメータは名前ではなく、パラメータリスト内の位置とパラメータの型によって同期されます。あるパラメータを PC と Quest 間で同期させるには、パラメータリスト内で同じ位置にあり、同じパラメータ型である必要があります。

このため、どちらのバージョンがすべてのパラメータを使用していなくても、アバターの PC 版と Quest 版には常に同じ Expression Parameters アセットを使用するようにしてください。

不一致なパラメータ型の変換

Animator で パラメータ型 を選択する際は、使用しようとしている 組み込みパラメータ や カスタムパラメータ と同じ型を選択することをお勧めします。例えば、VRChat の組み込みパラメータ AFK を Animator 内で使用する場合は、bool 型を選択する必要があります。

ただし、パラメーターには一致しない型を選択することも可能です。VRChatは、パラメーターの値をアニメーターで使用されている型へ変換しようと試みます。例えば、AFK パラメーターに float 型を選択した場合、VRChatは自動的に AFK を true や false ではなく、1.0 または 0.0 に設定します。これにより、アニメーターの Blend Tree 内で AFK パラメーターを使用することも可能になります。

以下の表は、一致しないパラメーターを変換した際にどのように変化するかを示しています。

Trigger 型パラメーター

現時点では、アニメーションコントローラーで Trigger 型のパラメーターを使用することはお勧めしません。これらの値は、アバターのバージョン間（アバターを表示しているリモートクライアントや、鏡越しにアバターを表示している際などの特殊な状況を含む）で同期がずれる可能性があります。アバターの状態を表現する場合は、Int、Float、または Bool 型のパラメーターを使用してください。

同期タイプ

VRChatでは、組み込みパラメータのほとんどがインスタンス内の他のプレイヤーと同期されます。また、独自のカスタムパラメータに対しても同期を有効にできます。

同期タイプは、VRChatが各パラメータをどのように同期するかを決定するものです。パラメータは以下のいずれかの同期タイプを使用します。

• Speech
  • Viseme（口形）にのみ使用されます。
  • 音声入力に応じてOculus Lipsyncの出力パラメータを駆動します。
  • ローカルで更新され、直接的な同期は行われません（音声によって駆動されるため）。
• Playable
  • 長時間実行されるアニメーション状態を同期するための、比較的低速な同期モードです。
  • パラメータの変化に応じて0.1〜1秒ごとに（1秒間に1〜10回）更新されますが、高速な同期が必要な用途には適していません。
• IK
  • 頻繁に変化する値を同期するための、より高速な同期モードです。
  • 0.1秒ごとに継続的に（1秒間に10回）更新され、リモートユーザー側では値が float されます。
  • パラメータによっては、アバターのローカルで計算されたIK状態に基づいて計算されることもあります。
• None
  • このパラメータは他のプレイヤーと同期されません。
  • 例えば、IsLocal はローカルプレイヤーのアバターでは常に true となり、他のプレイヤーのアバターでは false となります。

カスタムパラメータの同期を有効にした場合、VRChatは通常 Playable 同期タイプを使用します。ただし、パペットコントロールでパラメータを制御する場合、VRChatは同期タイプを Playable から IK に切り替え、更新頻度と補間処理を向上させます。パペットコントロールを閉じると、同期タイプは Playable に戻ります。

最終更新: 2025年12月19日