重要事項
Mixed Reality 功能工具目前僅支援 Unity。 如果你是在 Unreal 開發,請參考 工具安裝 文件。
Mixed Reality 功能工具是一種開發者發現、更新並加入 Mixed Reality 功能套件到 Unity 專案的新方式。 你可以依名稱或類別搜尋套件,查看它們的相依關係,甚至在匯入前查看專案清單檔案的擬議變更。 如果你以前沒用過清單檔案,那它就是一個包含你專案所有套件的 JSON 檔案。 一旦你驗證了想要的套件,Mixed Reality Feature 工具會將它們下載到你選擇的專案中。
系統需求
在你能執行 Mixed Reality 功能工具之前,你需要:
- 一台運行 Windows 10 或 11 且有活躍網路連線的電腦
注意事項
若電腦由組織管理的網路,請確保允許存取以下網址: https://aka.ms/https://feeds.dev.azure.com/https://learn.microsoft.com/https://pkgs.dev.azure.com/https://mixedrealitycloud.pkgs.visualstudio.com/ (僅限特殊搶先體驗者)
下載
在你設定好環境之後:
- 從 Microsoft 下載中心下載最新版本的 Mixed Reality 功能工具。
- 下載完成後,解壓檔案並儲存到桌面。
- 建立一個可執行檔的捷徑,方便更快存取。
注意事項
如果你是 Unity 套件管理器的新手,請遵循我們的 UPM 說明。
本版本的變更
版本 1.0.2209.0-預覽包含以下改進:
- 在發現功能檢視中新增了「顯示預覽功能」選項
- 更新至 .NET 6
- 將應用程式和 .NET 6 執行環境整合成單一執行檔,方便分發
- 修正了一個問題,就是在不需要時跳出降級現有套件版本的提示
1. 開始
從執行檔啟動 Mixed Reality 功能工具,該檔案會在首次啟動時顯示起始頁:
從開始頁,你可以:
- 使用齒輪圖示按鈕設定工具
- 請使用 問號 按鈕啟動預設網頁瀏覽器並顯示我們的文件
- 選擇 「開始 」以開始探索功能套件
2. 選擇您的 Unity 專案
為了確保所有發現的功能都能在你的專案 Unity 版本中得到支援,第一步是用專案路徑欄位) 右側的省略號按鈕 (,將 Mixed Reality 功能工具指向你的專案。
注意事項
瀏覽 Unity 專案資料夾時顯示的對話框中,檔名是 '_'。 必須有一個檔名的值,才能讓該資料夾被選取。
找到專案資料夾後,點擊「開啟」按鈕返回 Mixed Reality 功能工具。
重要事項
Mixed Reality 功能工具會進行驗證,以確保該檔案已被導向 Unity 專案資料夾。 該資料夾必須包含 Assets, Packages 以及 Project Settings 資料夾。
一旦專案被選定,你就可以
-
還原功能:如果專案清單中尚未出現的功能工具已發佈套件,請下載至 Packages/MixedReality 。 這個功能在概念上與之相似
nuget restore。 通常只有當你有專案 (中) 從倉庫複製來的 Feature Tool 套件時,才需要執行這個操作,該套件設定成忽略 tarball 檔案。 如果你不需要新套件,還原後可以關閉功能工具。
和/或
- 探索功能:請前往下一頁選擇你想加入專案的套件。
3. 發現並取得功能套件
特徵會依類別分組,方便查找。 例如,Mixed Reality Toolkit 分類中有多項功能供你選擇:
注意事項
如果你將在專案中使用 MRTK3 公開預覽版,必須啟用 Show preview releases 如下紅色方框所示的設定。
當Mixed Reality功能工具辨識到先前匯入的功能 () 時,會顯示每個功能旁邊的通知訊息。
選擇完成後,選擇 「取得功能 」以從目錄下載所有必需套件。 欲了解更多資訊,請參閱 發現與獲取功能。
4. 匯入功能套件
取得之後,會呈現完整的套件組合,以及一份必要的相依清單。 如果你需要更改任何功能或套件選擇,現在是:
我們強烈建議使用 「驗證 」按鈕,以確保 Unity 專案能成功匯入所選功能。 驗證後,你會看到一個跳出的對話框,裡面有成功訊息或已識別的問題清單。
選擇 匯入 繼續。
注意事項
點擊 匯入 按鈕後,如果仍有問題,會顯示一個簡單的訊息。 建議點選「否」,並使用 「驗證 」按鈕查看並解決問題。
欲了解更多資訊,請參閱 匯入功能。
5. 審查與核准專案變更
最後一步是審查並核准清單及專案檔案的擬議變更:
- 對清單的擬議變更顯示於左側
- 要加入專案的檔案列於右側
- 比較按鈕可並排檢視目前清單與擬議變更
欲了解更多資訊,請參閱審查與核准專案修改。
6. 專案更新
當提案變更獲得批准後,你的目標 Unity 專案會更新,參考所選的 Mixed Reality 功能。
Unity 專案的 Packages 資料夾現在有一個 MixedReality 子資料夾,裡面有功能套件檔案 (s) ,manifest 也會包含相應的參考 (s) 。
回到 Unity,等待新選定的功能載入,然後開始建構吧!