歡迎使用 Mixed Reality 工具組子系統精靈。 此工具可用來透過自定義 Unity XR 子系統擴充 MRTK3 的功能。 本文件說明子系統精靈、其 UI,以及如何將您的自定義功能新增至 MRTK3。
注意事項
一般而言,建議使用子系統來實作平臺或提供者抽象概念。
若要使用子系統精靈,您必須先使用 Mixed Reality 功能工具匯入 MRTK3 工具套件。
快速入門
若要開始建立新的子系統,請從 MRTK3>[公用程式] 選單中選Subsystem Wizard取專案。
一旦啟動,子系統精靈會要求您提供一些資訊;亦即您的組織名稱、子系統的基底名稱,以及子系統是否需要設定數據。
組織名稱
根據預設,子系統精靈會讀取 Unity Player 設定,並確保組織名稱符合專案的公司名稱。 這個值可以覆寫為任何有效的 C# 識別碼。
基類名稱
所有子系統都會使用基類產生。 目前的架構需要此結構,並可讓您輕鬆地實作子系統的平臺或提供者特定版本。 建議使用子系統的名稱 (例如:「ScentSubsystem」) 作為基類名稱。
新增子系統組態
如果您的子系統是可設定的,請選 Add subsystem configuration 取方塊。
產生的名稱
精靈會自動建立特定項目的名稱。 這些名稱可以在精靈完成後,使用您最愛的文本編輯器來覆寫。
準備產生
略過檔案產生子系統類別
雖然通常不建議略過一或多個子系統檔案的產生,但在某些情況下,它可能會很有用 (例如:您想要重新產生單一檔案) 。
注意事項
子系統精靈不會覆寫現有的檔案。 若要重新產生檔案,必須先刪除檔案。
Skip使用所需檔案 () 旁的 選項,指示精靈隱藏產生。
完成子系統
完成後,子系統精靈會列出完成子系統實作所需的步驟集。 列出的步驟集可能會根據精靈設定而有所不同。
新增您的程序代碼
產生的程式代碼包含應在何處新增必要 (和選擇性) 程式代碼的指示。 這些指標的格式為以 TODO 一字開頭的批註,並包含要加入之程式代碼的描述。 例如:
// TODO: Apply the configuration to the provider.
啟用子系統
子系統準備就緒后,您可以造訪 編輯>項目設定>MRTK3,在 MRTK3 設定檔中加以啟用。