使用Mixed Reality功能工具來安裝世界鎖定工具

  • 發行項

MR 功能工具

Mixed Reality功能工具是取得世界鎖定工具，以及其他適用于 Unity 的重要Mixed Reality套件非常有用的方式。

如需 MR 功能工具的詳細資訊，請參閱其 線上檔，但非常容易使用。

Mixed Reality功能工具螢幕擷取畫面

透過 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」，請將它變更為 「In Project」

    專案中的套件管理員

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

    匯入專案按鈕

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

  5. 範例現在會出現在 Assets 的 Samples 資料夾底下，如下所示。 他們可以重新置放以符合您專案的組織。

    Unity 專案中顯示的範例

安裝方法之間的差異

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

MR 功能工具 (UPM 套件)

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

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

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

WLT (.unitypackage 檔案)

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

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

相依性鏈結非常簡單，但安裝用戶端的責任 (您) 安裝相依性和您想要的套件。

簡單相依性圖形是線性的。 在下列清單中，每個專案相依于其上方的每個專案，但其下方沒有專案：

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

從 GitHub 程式碼 (複製來源)

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

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

關於安裝路徑長度限制

從 Mixed Reality 功能工具安裝時

Windows 會強制路徑 長度上限為 260 個字元。 Frozen World Engine 套件有一些很長的內部路徑。 Mixed Reality功能工具 (或 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 問題有更多調查和討論。