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 執行升級,詳見從舊版升級。