组件介绍
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。
在 需要批准的状态(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 记录菜单中的表情模式,并将 需要批准的状态 设为 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