組件介紹
Addon 由數個 Framework 組件構成,這些組件只在建置 Avatar 時生效。一般安裝與使用不需要動到它們;想了解 Addon 如何運作,或要自行調整時,再查閱這一頁。
下圖是 Salt 安裝 Addon 後的 Face Tracking 階層,每個物件右側列出它帶有的 Framework 組件,點選即可跳到對應說明。
Avatars
Salt
Armature
Body
Kemono_Ear
Face Tracking修改前先備份
組件的設定已由 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 會:
- 掃描各 Playable Layer 的狀態與狀態機,找出 VRC Animator Tracking Control。
- 把其中眼部與嘴部的 Tracking/Animation 設定改為「要求」,原欄位改成 No Change;其他身體部位維持原樣。
- 在 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,請確認覆寫指向的組件與屬性仍然存在。
Hierarchy


All