Skip to content

コンポーネント ​

Addon の各コンポーネントはアバターのビルド時に処理されます。このページでは、構成を確認したり自分で調整したりする場合の設定を紹介します。通常の導入は Installer で行えます。

以下は Salt に導入した後の Hierarchy です。各オブジェクトの右側にあるコンポーネント名から説明に移動できます。

Hierarchy
All
Avatars
Salt
Armature
Body
Kemono_Ear
Face Tracking
Mouth TrackingMerge MotionBlend Set
Mouth Ear MotionForward Parameters
Face Tracking MeshesComponent Property Overrides
Modular Avatar の Menu Installer、Parameters などは省略しています。

編集前にバックアップを

Addon のプレハブを直接編集すると、アップグレードで設定が置き換わる場合があります。引き継ぎたい項目と値は記録しておきましょう。

Face Tracking Settings ​

同梱プレハブでは、アバター内の Face Tracking を展開して Face Tracking Settings を選ぶと、Inspector で目、口、Reset の設定を調整できます。

調整したい動きInspector の設定
目の動きの強さEye Weight。プレビューで目の形を比較できます。
あごが下がる量Jaw Strength。
表情を作ったときに残す顔のカスタム形状対応する Reset グループを調整します。閉眼時の突き抜けなら、目を閉じてプレビューします。グループは Addon によって異なります。

VRC Face Tracking Installer ​

VRChat ネイティブの顔トラッキング設定を VRC Avatar Descriptor に追加します。 Addon プレハブで次の内容を指定します。

  • トラッキングに使うメッシュ
  • 視線、まぶた、リップシンクなどの有効にする機能
  • 追加する Blendshape Set と Parameter Behavior

ビルド時に Framework がこれらを Descriptor に統合します。

Installer を開くには

このコンポーネントはビルド時に動作します。Addon の導入には Unity の TriturboFT › Face Tracking Installer を開いてください。

Face Tracking Blend Set ​

Descriptor に顔トラッキング用の Blendshape Set を 1 組追加します。 VRC Face Tracking Installer でも Set を登録できます。まぶたなど、子プレハブで個別に管理したい場合はこのコンポーネントで次を定義します。

  • Set 名
  • トラッキング入力と Blendshape の対応
  • 初期ウェイト

条件でウェイトを変えるには 制御ウェイト を有効にして ステート を設定します。ウェイト出力パラメーター も指定すると、同じ値を他のアニメーションから Float として読み取れます。

Face Tracking Toggle ​

条件に応じてウェイトを切り替える Animator 制御を生成します。 各ステートに条件と 0〜1 のウェイトを設定します。リストの上から最初に条件を満たすステートが適用されます。

ウェイトの出力先は次のとおりです。

対象設定条件に合うステートがない場合
Blendshape SetSet を選びます。ステートのウェイトが適用され、ウェイト出力パラメーターを指定すると同じ値を Float にも書き込みます。Set の初期ウェイトを使用。
Float を読む Blend Tree や他のコンポーネントSet を空にして ブレンドパラメータ に出力先の Float を指定。Toggle の デフォルトウェイト を出力。

たとえば Float で耳が表情に追従する量を変える Blend Tree なら、Blend Parameter だけを指定し、初期値を 1、手動モードのステートを 0 にします。手動モードでは耳が表情に追従しなくなります。

Tracking State Router ​

目と口をトラッキングとアニメーションのどちらが制御するかをまとめて管理します。 複数レイヤーの VRC Animator Tracking Control から届く指示を扱うため、ビルド時に次の処理を行います。

  1. 各 Playable Layer のステートとステートマシンから VRC Animator Tracking Control を探します。
  2. 目と口の Tracking/Animation 指定を要求に変換し、元のフィールドを No Change にします。他の部位の設定は維持されます。
  3. FX に Tracking State Router レイヤーを追加し、届いた要求から目と口の状態を個別に決定します。

承認が必要な状態 で承認の対象レイヤーを選び、目と口それぞれに アニメーション許可条件 を設定します。対象レイヤーからの Animation 要求はその部位の条件を満たすと通り、他のレイヤーの要求はそのまま通ります。

各部位の トラッキング出力パラメーター で、判定結果を他のコンポーネントに渡せます。Tracking は 1、Animation は 0 です。

同梱プレハブの設定例

同梱の Face Tracking Settings プレハブはメニューの表情モードを整数 FT/ExpressionMode に記録し、承認対象を FX に設定しています。パラメーター名とモードごとの値はプレハブ側の定義です。独自に Router を設定するときは任意の Animator パラメーターを条件に使えます。

この設定では、目のトラッキングがオフ、または FT/ExpressionMode が 2(Expression Priority)のときに FX のアニメーションが目を制御できます。口も自身のスイッチで同様に判定されます。Gesture から直接届く要求はそのまま通ります。

VRChat SDK の Animator Tracking Control

Face Tracking Merge Motion ​

Animation Clip または Blend Tree を Playable Layer に追加します。Unity では両方を Motion と呼びます。Clip のパスはアバターのルート、または指定したルートを基準にできるため、別の場所のプレハブにも同じアニメーションを使えます。

Motion バリアントを有効化 を有効にすると条件に応じて切り替えられます。上から最初に一致したバリアントが優先され、一致しなければ元の Motion が再生されます。

モード条件成立時
Override Motion元の Motion の Clip や Blend Tree の入力を置き換えます。例:手動モードで TongueX を別の Float や定数 0 に変え、左右の動きを手動にする、または中央に固定する。
New Motion手動制御用のツリーなど、別の Clip や Blend Tree を再生します。

Face Tracking Forward Parameters ​

SDK のトラッキング入力を Animator が読める Float に変換します。入力の Tracking Key、計算方法、出力名を指定すると、ビルド時に Forward to Animator の Parameter Behavior が生成されます。

たとえば EyeClosedLeft と EyeClosedRight に Max を指定すると、左右の閉じ具合の大きい方を出力します。Min、Add、Multiply、カスタム式も使えます。

Blend Tree がこの Float を読むと、選んだ Tracking Key に応じてアニメーションが動きます。耳を動かす、顔の Blendshape のウェイトを変えるなど、対象はアニメーションの内容で決まります。

同じ計算は出力を共有します。計算が異なり名前だけが同じ場合はスコープごとに解決され、同じスコープ内の矛盾はエラーになります。階層外からも同名パラメーターを読みたい場合は 階層外の同名を許可 を有効にします。

Component Property Overrides ​

ビルド用のアバター複製上でプロパティを置き換えます。項目ごとに対象コンポーネント、シリアライズされたプロパティのパス、置き換え後の値を指定します。シーン上の値は維持されます。

たとえば Installer は Face Tracking Meshes にメッシュの上書きを記録し、ビルド時に対象の Skinned Mesh Renderer に追跡用 Blendshape を含むメッシュを適用します。Renderer の交換やプレハブ更新後は対象とプロパティが存在するか確認してください。