Skip to content

安装与升级指南 ​

从 Booth 下载 Addon、导入 Unity,再交给 Face Tracking Installer 应用到 Avatar 上。

使用旧版 Addon?

如果 Installer 提示使用旧版安装工具,请参阅旧版 Addon 文档。想把旧版升级到 2.x,请看从旧版升级。

开始之前 ​

  • Avatar 版本兼容:Booth 商品页列有支持的 Avatar 型号与版本,购买前请先核对。
  • 项目能正常上传:准备可上传 VRChat Avatar 的 Unity 项目,并已导入 Avatar 本体。
  • 保持网络连接:导入时会下载所需包,请等 Unity 导入与编译完成再继续。

商品页还没列出新版 Avatar?

兼容性列表中的版本皆已经过确认,但改装、其他包或项目设置仍可能影响效果。若原始 Avatar 推出了新版本,欢迎通过联系与支持告知 Avatar 名称与版本,以及目前的 Addon 版本。

安装 Addon ​

  1. 从 Booth 购买并下载

    在 Triturbo 的 Booth 商店找到对应 Avatar 的 Face Tracking Addon 并购买。购买后,到 Booth 的已购买商品页面下载 Addon 的 ZIP 档,并解压缩取出其中的 .unitypackage。下载清单中有多个文件时,请下载最新版本。

  2. 导入 Unity

    把 .unitypackage 拖进 Unity 的 Project 窗口,或从 Assets › Import Package › Custom Package 导入。包安装窗口会列出所需的依赖包,依提示安装,并等待下载与编译完成。

  3. 把 Avatar 放进场景

    将要安装的 Avatar 放进场景,并离开 Play Mode 与 Prefab Mode。

  4. 打开 Face Tracking Installer

    从 Unity 上方菜单打开 TriturboFT › Face Tracking Installer。

    Face Tracking - Avatars - Windows, Mac, Linux - Unity 2022.3.22f1 <DX11>
  5. 指定要安装的 Avatar

    在 Hierarchy 找到带有 VRC Avatar Descriptor 的 Avatar 根对象,拖到 Installer 的投放区;也可以直接点击投放区下方的 Avatar 名称。

    Hierarchy
    All
    Avatars
    Salt
    Airi
    Lime
  6. 确认安装内容

    Installer 会自动识别对应的 Addon,并列出即将应用的内容。按下安装前,请核对以下几处:

    1. 附加组件 应显示你导入的 Addon 名称。识别结果不符时,可按「更改…」手动切换。
    2. 网格补丁 左边是 Avatar 的 FBX 版本,右边是将应用的补丁版本。
    3. 变更 即将加入 Avatar 的 Prefab 与网格补丁。
    4. 表情参数 安装后的参数用量,需在 256 比特以内。
    5. 在副本上操作 想保留原始 Avatar 时勾选,Installer 会先复制一份再安装。
  7. 按下「安装」并上传

    出现「安装完成」后,确认 Avatar 无误并保存场景,即可通过 VRChat SDK 上传。使用副本时,请确认上传的是安装完成的那一个。

更新 Addon ​

Addon 推出新版本(例如 2.0 → 2.1)时,从 Booth 下载新版并导入同一个项目即可,已安装的 Avatar 会直接使用更新后的内容,不需要重新安装。

导入后,可以打开 Installer 并拖入 Avatar 确认状态:主按钮显示 已安装 就代表完成;若网格补丁区显示「补丁更新可用」,请依提示更新网格。确认后重新上传 Avatar。

从旧版(1.x)升级到 2.x ​

旧版 Addon 使用各自的菜单(例如 TriturboFT › <Avatar 名称> FT)安装,2.x 起统一改用 Face Tracking Installer。已安装旧版的 Avatar,需要用 Installer 升级一次:

  1. 备份项目与场景。
  2. 导入同一款 Addon 的 2.x 包。
  3. 打开 Installer,拖入已安装旧版的 Avatar。
  4. 核对变更内容后按下 升级。

Installer 检测到旧版的安装内容时,主按钮会变成 升级,变更清单会同时列出要移除与要安装的项目:

  1. 变更 − 移除 是旧版的 Prefab,+ 安装 是要换上的 2.x 内容与网格补丁。若曾自行修改旧版的对象或设置,请特别留意被移除的项目。
  2. 表情参数 旧版 Prefab 释放的用量会先扣除(虚线区段),再计入 2.x 的用量。
  3. 在副本上操作 建议勾选,保留原始 Avatar 方便比对。

出现「升级完成」后,检查新的 Avatar,保存场景并重新上传。

建议保留 Face Tracking Prefab

建议保留 Avatar 底下由 Installer 安装的 Face Tracking Prefab,并避免对这些 Prefab 运行 Unpack Prefab。保留 Prefab 链接有助于 Installer 在升级时识别已安装的内容。

Installer 按钮状态 ​

按钮意义与处理方式
安装尚未安装。依变更清单安装所需内容。
升级检测到旧版的安装内容。检查清单后运行。
已安装目前内容已是最新,不需要操作;仍可查看网格补丁状态。
需要检查有需要先解决的问题,请阅读窗口中的提示。
打开旧版 Installer这款 Addon 尚未支持新版 Installer,请依提示使用旧版安装工具。

常见问题 ​

找不到 Face Tracking Installer

请确认包下载与 Unity 编译皆已完成,并检查 Console 是否有编译错误。Installer 位于 Unity 上方菜单的 TriturboFT › Face Tracking Installer。

Avatar 拖不进投放区

请从 Hierarchy 拖曳带有 VRC Avatar Descriptor 的 Avatar 根对象,并确认已离开 Play Mode 与 Prefab Mode。

导入新版后,Avatar 看起来没有更新

导入新版包后,需要重新上传 Avatar,VRChat 内的 Avatar 才会更新。若是从旧版(1.x)升级到 2.x,还需要先用 Installer 运行升级,详见从旧版升级。