Skip to content

組件介紹 ​

Addon 由數個 Framework 組件構成,這些組件只在建置 Avatar 時生效。一般安裝與使用不需要動到它們;想了解 Addon 如何運作,或要自行調整時,再查閱這一頁。

下圖是 Salt 安裝 Addon 後的 Face Tracking 階層,每個物件右側列出它帶有的 Framework 組件,點選即可跳到對應說明。

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 調整好。直接修改 Prefab 內的值,升級時可能會被新版內容取代;想長期保留的調整,請記下修改的項目與數值。

Face Tracking Settings ​

調整 Addon 效果的主要入口。 使用隨附 Prefab 時,展開 Avatar 底下的 Face Tracking,選取 Face Tracking Settings 物件,就能在 Inspector 調整這款 Addon 提供的眼部、嘴部與 Reset 選項。

想調整的效果Inspector 中的設定
眼部追蹤的強度眼部權重(Eye Weight)。開啟預覽可比較不同權重下的眼型。
張嘴時下顎張開的幅度下顎強度(Jaw Strength)。
閉眼等動作發生時,保留多少原本的臉型對應 Reset 群組的滑桿。例如自訂眼型在閉眼時穿模,可預覽閉眼姿勢,再調整該群組。可用的群組依 Addon 而定。

VRC Face Tracking Installer ​

把 VRChat 原生臉部追蹤的設定寫入 VRC Avatar Descriptor。 這個組件放在 Addon Prefab 上,記錄三類內容:

  • 參與追蹤的網格
  • 要啟用的功能,例如視線、眼皮與語音口型
  • 要加入 Descriptor 的 Blendshape Set 與 Parameter Behavior

建置 Avatar 時,Framework 會把這些內容合併進 Descriptor。

不是 Installer 視窗

這個組件只在建置時運作。要把 Addon 安裝到 Avatar 上,請從 Unity 上方選單開啟 TriturboFT › Face Tracking Installer 視窗。

Face Tracking Blend Set ​

為 Descriptor 加入一組 Face Tracking Blendshape Set。 VRC Face Tracking Installer 也能提供 Set;若某個子 Prefab 只需要自己的一組追蹤形狀(例如眼皮),就在該 Prefab 上用這個組件定義:

  • Set 的名稱
  • 追蹤輸入與 Blendshape 的對應
  • 預設權重

想讓 Set 的權重隨條件改變,勾選 控制權重(Control Weight)並設定 狀態(States)。若同時填入 權重輸出參數(Weight Output Parameter),狀態改變權重時,同一個值也會寫入該 Float 參數,供其他動畫讀取。

Face Tracking Toggle ​

依條件切換權重,並自動產生對應的 Animator 控制。 在 狀態(States)清單中,每個狀態包含條件和一個 0 到 1 的權重;執行時套用清單中第一個條件成立的狀態。

這個權重可以送往兩種地方:

控制對象設定方式沒有狀態成立時
Blendshape Set選取 Set,進入狀態時套用其權重。也可填入權重輸出參數,把同一個值寫入 Float 參數。使用 Set 自己的預設權重。
讀取 Float 參數的 Blend Tree 或其他組件不選 Set,在 混合參數(Blend Parameter)填入要寫入的 Float 參數。寫入 Toggle 的預設權重(Default Weight)。

例如,某個 Blend Tree 用一個 Float 控制耳朵跟隨表情的幅度:只填混合參數、把預設權重設為 1,再加一個以手動模式為條件、權重為 0 的狀態。切到手動模式時,Blend Tree 讀到 0,耳朵便不再跟隨表情。

Tracking State Router ​

統一決定眼部與嘴部要用追蹤還是動畫。 原本 Avatar 中各個 Layer 都可能用 VRC Animator Tracking Control 切換這兩個部位,Router 把這些切換集中到一處處理。建置時,Router 會:

  1. 掃描各 Playable Layer 的狀態與狀態機,找出 VRC Animator Tracking Control。
  2. 把其中眼部與嘴部的 Tracking/Animation 設定改為「要求」,原欄位改成 No Change;其他身體部位維持原樣。
  3. 在 FX Controller 加入 Tracking State Router Layer,根據收到的要求,決定眼、嘴各自使用 Tracking 或 Animation。

在 需要核准的 Layer(Require Approval On)選擇要檢查哪些 Playable Layer,再為眼部與嘴部分別設定 允許動畫條件(Allow Animation Conditions)。選取的 Layer 提出 Animation 要求時,Router 會檢查對應部位的條件;其他 Layer 的要求可直接生效。

每個部位也可指定 追蹤輸出參數(Tracking Output Parameter),讓其他組件讀取 Router 的判定結果:1 代表 Tracking,0 代表 Animation。

隨附 Prefab 的設定範例

隨附的 Face Tracking Settings Prefab 用整數參數 FT/ExpressionMode 記錄選單中的表情模式,並將 需要核准的 Layer 設為 FX。這個參數名稱與各模式的數值都由 Prefab 定義。自行配置 Router 時,可以在允許動畫條件中選用自己的 Animator 參數。

在這個 Prefab 裡,FX 動畫想接管眼部時,只要眼部追蹤已關閉,或 FT/ExpressionMode 等於 2(Expression Priority),Router 就會核准。嘴部使用同樣的規則,但檢查的是嘴部追蹤開關。直接來自 Gesture 層的要求則可直接生效。

參考:VRChat SDK 的 Animator Tracking Control 說明

Face Tracking Merge Motion ​

把 Animation Clip 或 Blend Tree 加入 Avatar 的 Playable Layer。 Unity 將兩者統稱為 Motion。Clip 內的物件路徑可以從 Avatar 根物件起算,也可以以指定的根物件計算相對路徑,讓同一份動畫用在不同位置的 Prefab 上。

啟用 Motion 變體(Motion Variants)後,可以依條件改播其他版本。多個變體同時成立時,清單中較前面的優先;都不成立時播放原本的 Motion。

變體模式條件成立時
Override Motion沿用原本的 Motion,只替換其中的 Clip,或改變 Blend Tree 讀取的輸入。例如原本以 TongueX 控制左右方向,手動模式下可改讀另一個 Float 參數,或指定常數 0,讓方向固定在中央。
New Motion改播另一個 Animation Clip 或 Blend Tree。例如用另外製作的手動控制 Blend Tree,取代整個追蹤用的 Blend Tree。

Face Tracking Forward Parameters ​

把 SDK 的追蹤輸入轉成 Animator 可讀取的 Float。 每條規則指定三件事:輸入的 Tracking Key、計算方式,以及輸出參數名稱。建置時會產生 SDK 的 Forward to Animator 參數行為。

例如,選取 EyeClosedLeft 與 EyeClosedRight,計算方式選 Max,輸出的 Float 就是左右眼閉合程度中較大的值。其他計算方式還有 Min、Add、Multiply 與自訂算式。

Blend Tree 可以讀取輸出的 Float,讓動畫隨所選 Tracking Key 的值變化。要控制什麼取決於動畫的內容,例如帶動耳朵,或調整 Face Tracking Blendshape 的權重。

多個組件要求相同的計算時,會共用同一個輸出。不同的計算使用同名參數時,Framework 會依作用範圍區分名稱;同一作用範圍內互相矛盾的規則則會回報錯誤。若階層外的動畫也刻意要讀取同名參數,請勾選 允許階層外同名(Allow External Name Sharing)。

Component Property Overrides ​

在建置時替換其他組件的屬性值。 每筆覆寫記錄目標組件、序列化屬性路徑與替換值,只套用到建置用的 Avatar 複本,不會修改場景中的物件。

例如 Installer 會在 Face Tracking Meshes 上記錄網格覆寫,讓目標 Skinned Mesh Renderer 在建置時改用含追蹤 Blendshape 的網格。若更換過 Renderer 或更新過 Prefab,請確認覆寫指向的組件與屬性仍然存在。