共用方式為


使用混合實境功能工具來安裝世界鎖定工具

MR 功能工具

混合實境功能工具可以是取得世界鎖定工具,以及其他適用於 Unity 的寶貴混合實境套件的極實用方式。

如需 MR 功能工具的詳細資訊,請參閱其 在線檔,但很容易使用。

混合實境功能工具螢幕快照

透過 MR 功能工具安裝 WLT

若要取得完整的 WLT 功能,只需從 MR 功能工具選取最新版本的「世界鎖定工具」即可。 然後繼續將 WLT 新增至場景,或 快速入門指南

如果取得範例(也需要 MRTK),則不需要先安裝相依性。 只要選取 [範例] 套件,也會安裝最少的一組必要相依性。 但請參閱 下面的內容

注意

Tl;DR 版本 - 如果從 MR 功能工具安裝,您必須安裝到路徑長度為 11 個字元或更少,包括磁碟驅動器的資料夾。 本文結尾會更詳細 地說明這一點。 所以 e:\stuff\T1 會運作,但 e:\stuff\T12 不會。

MR 功能工具中的範例(可寫入套件)

如上所述,MR 功能工具和 UPM 會將套件安裝為唯讀資源。 對於範例而言,這是不方便的,因為樣本的大部分值都提供可修改進行實驗的揮發性資產。

若要啟用此功能,MR 功能工具 (或 UPM) 所安裝的範例會遵循稍微不同的路徑。 安裝它們是兩個部分的程式。

第一個部分會繼續執行,就像安裝唯讀套件一樣。 不過,在該安裝之後,範例將不會出現在 [資產] 或 [套件] 中。

若要完成將範例匯入至您的專案:

  1. 開啟 Unity 封裝管理員

  2. 如果 封裝管理員 設定為 “Unity Registry”,請將它變更為 [在專案中]

    專案中的套件管理員

  3. 尋找您要完成安裝的範例。 我們在這裡的目標是「世界鎖定範例 v1.2.4」。

    匯入項目按鈕

  4. 按 [匯入至專案] 按鈕。

  5. 範例現在會出現在 Assets 中的 Samples 資料夾底下,如下所示。 他們可以重新配置,以符合您項目的組織。

    Unity 項目中顯示的範例

安裝方法之間的差異

決定要使用的安裝方法時,有一些微妙的考慮。

MR 功能工具 (UPM 套件)

MR 功能工具的主要驅動程式是套件相依性。 MR 功能工具中的套件可以指定需要安裝的其他套件,才能正常運作。 接著,功能工具可以取得並安裝,而不只是您所要求的套件,還可以取得並安裝其所有相依性。 在功能工具處理要求安裝之後,您不需要追蹤其他安裝。

透過 MR 功能工具(或 UPM)取得的資源與從 .unitypackage 檔案取得的資源之間最大的差異在於,前者是僅安裝寫入,而後者則與您自己的資源一樣卸除。

請注意,透過功能工具取得 WLT 時,凍結的世界引擎 DLL 會以相依性的形式傳入。 不需要透過 NuGet 手動安裝。

WLT 版本 (.unitypackage 檔案)

WLT 會發佈定期發行,這被視為非常穩定的快照集。 這些可在 [ 世界鎖定工具版本 ] 頁面上取得。

如上所述,將這些 .unitypackage 檔案匯入項目的結果與您在來源中複製的結果相同(請參閱下方)。 腳本和資產是可寫入的,而且可以重新排列以符合您的結構。

相依性鏈結非常簡單,但安裝用戶端(您)負責安裝相依性,以及您想要的套件。

簡單的相依性圖表是線性的。 在下列清單中,每個專案相依於其上方的每個專案,但不取決於其下方的專案:

  1. 凍結的世界引擎 DLL (從 NuGet,請參閱 安裝指示
  2. 世界鎖定核心引擎
  3. 世界鎖定工具
  4. 世界鎖定範例(也取決於 MRTK,但 MRTK 包含在 .unitypackage 中)

從 GitHub 程式代碼 (來源中複製)

另一個取得 WLT 的選項是直接從 GitHub 取得來源(透過 git 或作為 zipfile),並將其複製到您的專案中。 這相當於從上述 .unitypackages 安裝。

若要取得符合版本的來源,請尋找 適當的分支。 例如,版本 v1.2.4 的來源位於 分支 release/v1.2.4中。

關於安裝路徑長度限制

從混合實境功能工具安裝時

Windows 會 強制路徑長度上限為 260 個字元。 凍結的世界引擎套件有一些很長的內部路徑。 混合實境功能工具(或 Unity 的 UPM,視您想要指責的物件而定),會在中間新增一些很長的字串。

如果您在 Unity 控制台中看到錯誤,抱怨找不到路徑的一部分,您將知道您是否已通過MAX_PATH限制。

長路徑錯誤

同樣地,安裝路徑 e:\stuff\T1 將會運作,但 e:\stuff\T12 會太長。

具有諷刺意味的是,第一個達到限制的檔案甚至不會在 Windows 上使用,它適用於 iOS 組建(iOS 沒有MAX_PATH限制)。 WLT 會建置並正常執行,而不需要它。 不過,檔案的存在會干擾一些重要的 MRTK 腳本的執行,而且可能以其他微妙的方式破壞 Unity 的不穩定。

從 .unitypackage 檔案或 Github 安裝時

如果沒有 UPM/MRFeatureTool 將字元插入安裝路徑中,還有一些喘息的空間。 不過,凍結世界引擎內部路徑階層仍然相當深。 從 unitypackage 檔案或 github 安裝時,安裝資料夾長度應該大約為 100 個字元。

WLT 問題有更多調查和討論。