入門指南的這一部分將引導您創建、打包和部署第一個適用于 Meta Quest 的虛幻引擎應用程序。
?
?
安裝 Android Studio 和 Android NDK
您必須下載并安裝 Android Studio 和 Android NDK。這將為虛幻引擎提供運行所需的一些依賴項，例如 Apache Ant 和 Java 開發工具包 (JDK)。
要安裝 Android Studio 和 NDK，請按照虛幻引擎文檔中的“設置 Android SDK 和 NDK?”中的說明進行操作。
?
?
從源代碼構建或下載適用于 UE5 的 MetaXR 插件
ps：對于萌新直接通過虛幻啟動器，下載4.27.x版本的虛幻引擎即可，可省略該步驟直接跳到下面的“創建您的項目”。
您需要一個專為 Meta Quest 開發而定制的虛幻引擎版本。您有兩個選擇：
- 下載UE5的MetaXR插件并將其復制到Epic提供的虛幻引擎5中。
- 從 GitHub 獲取 UE5 或 UE4 的 Oculus-VR 分支，然后自行編譯虛幻引擎的定制版本。
選項 1：下載 MetaXR 插件并將其復制到虛幻引擎 5
要將 Epic 的 Meta Quest 支持添加到 UE5：
- 根據虛幻引擎5文檔中的“安裝虛幻引擎”下載并安裝UE5。
- 從虛幻引擎 5 集成下載頁面下載適用于 UE5 的 MetaXR 插件 .zip 文件。
- 將 .zip 文件內容提取到
ue5InstallationFolder\Engine\Plugins\Marketplace\MetaXR`。例如：C:\Program Files\Epic Games\UE_5.0\Engine\Plugins\Marketplace\MetaXR
選項2：獲取虛幻引擎的Oculus-VR Fork并從源代碼編譯
按照GitHub 上訪問虛幻引擎源代碼的說明獲?。?/span>
- 一個史詩帳戶
- 一個 GitHub 帳戶
- 訪問虛幻引擎源代碼存儲庫的授權
請忽略有關下載 Epic 虛幻引擎源代碼的說明，因為您將構建虛幻引擎源代碼的 Oculus-VR 分支。
- 從 GitHub 上虛幻引擎的 Oculus-VR分支下載源代碼，并將其解壓到您的開發計算機上的某個位置。為了避免構建時出現潛在錯誤，請注意文件路徑長度。
重要的
提取或克隆源代碼。請注意，超過Windows 最大路徑長度的路徑將導致構建失敗。如果這是一個問題，請不要映射到網絡共享。這將大大減慢構建過程。相反，為該目錄創建一個連接點。
- 啟動 Visual Studio 安裝程序，然后針對要使用的 Visual Studio 版本單擊“修改” 。
- 在“工作負載”選項卡下，單擊“使用 C++ 進行游戲開發”（如果未選中），然后單擊“修改”。
- 要完成該過程，請按照 Epic 關于從源代碼構建虛幻引擎 的說明進行操作。
根據您的機器，構建可能需要一段時間才能完成。
?
?
創建您的項目
在本節中，您將使用虛幻引擎創建一個項目：
- 在虛幻引擎啟動器中，按啟動按鈕打開虛幻項目瀏覽器。
- 從虛幻項目瀏覽器的“游戲”部分，選擇“空白”。
- 對于項目默認值，選擇：
- 藍圖
- 移動的
- 可擴展
- 無入門內容
在屏幕底部：
- 設置文件夾位置
- 設置項目名稱
您的屏幕應如下所示：
- 按“創建”按鈕創建項目并加載空白項目。
?
?
配置 Meta Quest 開發項目
官方視頻：為Oculus頭顯設備開發UE4項目
在本部分中，您將啟用 MetaXR 或 Oculus VR 插件并修改一些項目設置以與 Meta Quest 設備配合使用。
-
轉到“編輯”?>?“插件”，然后選擇“虛擬現實”部分。
-
啟用Meta XR插件（ UE4 上的Oculus VR）。在 UE5 上避免使用 Oculus VR（已棄用）。如果您沒有看到Meta XR，請下載Meta XR 插件。?
-
要在將任何虛幻引擎項目部署到頭盔后運行該項目，您必須至少保存一個虛幻引擎關卡。要保存當前關卡，請按工具欄中的“保存”圖標進行保存。為其命名，例如QuestQSMap。
-
選擇編輯 > 項目設置。然后，在“項目”下，選擇“地圖和模式”部分：
-
在Default Maps下，將Editor Startup Map和Game Default Map設置為您剛剛保存的關卡：
-
向下滾動并選擇引擎 > 輸入。找到移動部分：
-
對于“默認觸摸界面”，選擇“清除”，從而將該值設置為“無”：
結果應該是這樣的：
-
向下滾動到平臺部分，選擇Android。然后在右側向下滾動到APK 打包部分，如有必要，請單擊立即配置：
-
根據您的目標設備進行以下設置。
對于 Meta Quest 2 和 Meta Quest Pro：
- 最低 SDK 版本：29
- 目標 SDK 版本：29
- 在 KitKat 及以上設備上啟用全屏沉浸式，檢查 True
-
在構建中禁用支持 OpenGL ES3.2（官方虛幻引擎為OpenGL ES3.1），勾選支持Vulkan。
-
打開Advanced APKPackaging并單擊Oculus Mobile 設備包旁邊的+。從下拉列表中選擇Oculus Quest 2（如果有Quest1可多加一個Quest1）。注意：對于 Quest Pro 支持，請選擇插件，然后選擇MetaXR，并在移動下添加Quest Pro。您仍必須在上述步驟中選擇任務 2。
-
-
單擊Android SDK部分，并確保構建項目所需的 Android SDK 工具指向計算機上的正確文件夾，并且您已為每個設備設置了 API 級別。
-
滾動到“引擎”部分，選擇“渲染”，然后在“移動”和“移動 MSAA”下，確保選擇“?4x MSAA” 。
-
進一步滾動到渲染設置的VR部分，并確保移動 HDR已關閉。下圖顯示了一個示例。
-
在渲染的VR部分啟用Mobile Multi-view。
請注意，您可能需要重新啟動項目才能應用其中一些設置。
-
將您選擇的其他代碼添加到項目中。
請注意，本主題中描述的許多設置也在Oculus 性能窗口中提供。有關更多信息，請參閱Oculus 性能設置。
?
?
添加權利檢查
建議 Meta Quest Store 上發布的所有虛幻應用程序實施權利檢查，以驗證用戶的應用程序是否合法。有關如何實施權利檢查的信息，請參閱平臺解決方案指南中的《虛幻開發入門》 。
?
?
在頭盔上啟動您的應用程序
本節介紹如何啟動虛幻引擎項目以便可以在頭盔中查看它。
-
下載最新 Oculus ADB驅動程序，并安裝。
-
確保您的頭盔已通過 USB 電纜連接到開發 PC。
- 確保您已安裝并可以運行 Android 調試橋 (ADB)，并且您的 PC 可以使用 ADB 命令 adb devices 查看設備。有關更多信息，請參閱《移動 SDK 開發人員指南》中的?使用ADB與MetaQuest連接
- 在虛幻引擎編輯器中，單擊“啟動”圖標旁邊的 來打開“在設備上啟動的選項”：
- 從下拉列表中，選擇要部署到的設備。如果系統提示您保存項目，即使您最近保存過，也請務必執行此操作。這將確保最新內容駐留在您的頭盔上。
- 在虛幻引擎編輯器的下角，有一個進度條指示打包過程的狀態。如果這是您第一次打包項目，則可能需要幾分鐘，具體取決于項目的大小。
- 該過程完成后，您應該能夠啟動該項目并在頭盔中查看它。
?
?
插件設置
配置應用程序的不同方面，例如是否支持手部跟蹤、使用什么級別的 FFR，以及使用插件設置設置色彩空間。有關更多信息，請參閱插件設置。
?
?
應用程序分發
當您準備好分發應用程序時，需要使用 Android 分發密鑰庫才能提交到 Meta Quest 商店。
在構建最終發布包之前，請創建一個新的 Android 密鑰庫，如 Android 的應用程序簽名指南中的“手動簽署 APK”部分所述。生成分發密鑰庫后，在虛幻編輯器中，轉到Edit?>?Project Settings?>?Platforms?>?Android，向下滾動到Distribution Signing，然后輸入所需信息。
有關詳細信息，請參閱Mobile SDK 文檔的應用程序簽名部分。
注意：查看Distribute非常重要，其中涵蓋 Meta Quest Store 提交要求和指南。
?
?
打包您的應用程序
- Meta Quest：編譯和打包應用程序?本節提供有關運行和部署面向 Meta Quest 的 Unreal 應用程序的深入信息。