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。

在 需要批准的状态(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,请确认覆写指向的组件与属性仍然存在。