虚幻5 XR开发环境配置(quest3)

注意

请完成【虚幻5安装流程】

请完成【quest3激活流程】

说明

首先要有虚幻5引擎的开发环境，再来配置metaquest开发环境，quest3的系统是安卓系统，所以需要配置安卓开发环境，实际上并不太需要进行安卓开发，只是安装环境，后续就是在虚幻5配置XR的插件和相关参数。

1.java开发环境设置

**Java SE Development Kit 17.0.10 (**Windows x64 Compressed Archive)

https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html

解压"Java SE Development Kit 17.0.10"压缩包到D:\jdk17

按win键，搜索【环境变量】，打开【编辑系统环境变量】

会出现名叫系统属性的弹窗，点击环境变量

系统变量中创建，变量名：JAVA_HOME 变量值：D:\jdk17

找到【系统变量】下变量名为path的一行，点击编辑，弹出编辑环境变量，点击新增，输入%JAVA_HOME%\bin ，点击确定保存

2.Android环境设置

Android Studio Flamingo | 2022.2.1 Patch 1 May 1, 2023

https://developer.android.com/studio/archive （页面右上角语言选English 不然可能无法下载）

运行下载文件并安装

安装后第一次打开【Android Studio】并安装需要内容

重启【Android Studio】，在projects下点击【More Actions】

选择【SDK Manager】

在窗口下方给【Hide Obsolete Packages】打勾

在【SDK Platform】页面下勾选Android API 34, Android 12L (Sv2)

在【SDK Tools】页面展开【Android SDK Build-Tools 34】，勾选 34.0.0， 33.0.1

在【SDK Tools】页面展开【NDK（Side by side）】，勾选 25.1.8937393

在【SDK Tools】页面展开【Android SDK Command-line Tools】，勾选 Version 为11.0的

在【SDK Tools】页面展开【CMake】，勾选 Version 为3.10.2的

在【SDK Tools】页面勾选【Android Emulator】【Android Emulator hypervisor driver】【Android SDK Platform-Tools】

点击【Apply】然后选同意

完成后重启电脑

3.创建VR工程

启动虚幻5，在左侧选择【Games】

选择【Virtual Reality】 模板

取消勾选【Starter Content】

命名你的项目（使用英文名），本教程示例名称【vr-project】

点击【create】，等待创建成功

退出虚幻引擎

4.虚幻引擎SetupAndroid脚本

打开【虚幻5】安装文件夹

双击执行这个文件【……\UE_5.3\Engine\Extras\Android\SetupAndroid.bat】

5.虚幻引擎Meta XR插件

Unreal Engine 5 Integration (Meta XR Plugin v62)

https://developer.oculus.com/downloads/package/unreal-engine-5-integration/

Unreal Engine 5 Platform (Meta XR Platform v62)

https://developer.oculus.com/downloads/package/unreal-5-platform-sdk-plugin

找到你刚刚在虚幻5创建的工程文件夹，示例【…\vr-project】

在这个文件夹创建【Plugins】文件夹，示例【…\vr-project\Plugins】

将【UnrealMetaXRPlugin.62.0.zip】解压到【…\vr-project\Plugins】

此时【Plugins】文件夹中应该包含一个【MetaXR】文件夹

将【Unreal5PlatformSDKPlugin.60.0.zip】解压到【…\vr-project\Plugins】

此时【Plugins】文件夹中应该包含一个【MetaXRPlatform】文件夹

6.虚幻引擎Plugins设置

用虚幻引擎打开之前创建的【vr-project】工程

在主菜单点击【Edit】/【Plugins】

在左侧菜单找到【Installed】/【Virtual Reality】

勾选【Meta XR】

关闭【Plugins】窗口

7.虚幻引擎Project Settings设置

在虚幻引擎主菜单点击【Edit】/【Project Settings】

7.1虚幻引擎Platforms Android设置

在左侧菜单找到【Platforms】/【Android】

设置【Minimum SDK Version】为 【29】

设置【Target SDK Version】为 【32】

点击所有红色区域按钮，完成后会变绿

7.2虚幻引擎Platforms SDKConfig设置

在左侧菜单找到【Platforms】/【Android SDK】

设置【Location of Android SDK】为【 C:/Users/name/AppData/Local/Android/Sdk】

设置【Location of Android NDK】为【 C:/Users/name/AppData/Local/Android/Sdk/ndk/25.1.89373933】

设置【Location of Java】为【 C:/Users/name/AppData/Local/Android/Sdk/ndk/25.1.89373933】

设置【Location of Java】为【 D:/jdk17】（根据之前jdk解压位置）

设置【SDK API Level】为【 android-32】

设置【NDK API Level】为【 android-29】

7.3虚幻引擎Plugins Meta XR设置

在左侧菜单找到【Plugins】/【Meta XR】

在右侧页面【General】下，设置【XR API】为【Epic Native OpenXR with Oculus vendor extensions】

在右侧页面【General】下，设置【Color Space】为【 P3 (Recommended)】

在右侧页面【General】下，设置【Controller Pose Alignment】为【Grip】

关闭【Project Settings】窗口

在虚幻引擎主菜单点击【File】/【Save All】

7.4虚幻引擎 VR Preview功能设置

在虚幻引擎主菜单点击【Edit】/【Plugins】

在左侧菜单找到【Build-In】/【Virtual Reality】

禁用【OpenXR】，【OpenXREyeTracker】【OpenXRHandTracking】

重启虚幻引擎

打开电脑【oculus】应用并登录

使用quest3，点击左下角头像右边区域【快速设置】

使用【Quest Link】连接到电脑，随后会进入【Quest Link】控制区

在虚幻引擎菜单下面的【游戏模式】按钮中，点击更多（竖着的三个点）

选择【VR Preview】

随后会出现一个绿三角和一个眼镜的图标，点击它

随后即可在quest3中游玩当前游戏

7.5虚幻引擎Meta XR Simulator插件

Meta XR Simulator v62

https://developer.oculus.com/downloads/package/meta-xr-simulator/

将【Meta XR Simulator】解压到【C:\Users\name\Documents\Unreal Projects】，解压后应该有个【com.meta.xr.simulator-62.0.0.tgz】文件

将刚刚那个文件【com.meta.xr.simulator-62.0.0.tgz】也解压到【C:\Users\name\Documents\Unreal Projects】

将【com.meta.xr.simulator-62.0.0】文件夹内的【package】移动到【C:\Users\name\Documents\Unreal Projects\MetaSimulator-62\】

在虚幻引擎主菜单点击【Edit】/【Project Settings】

在左侧菜单找到【Plugins】/【Meta XR】

设置【Meta XR Simulator JSON file】为【 C:\Users\name\Documents\Unreal Projects\MetaSimulator-62\package\MetaXRSimulator\meta_openxr_simulator.json】

关闭【Project Settings】窗口

在虚幻引擎主菜单点击【File】/【Save All】

在菜单栏下点击【Meta XR Simulator】标签，给他勾上

这时候运行你的【vr-project】项目（点绿色三角），就会以模拟仿真方式运行，无需真实设备

8.虚幻引擎打包部署

8.1虚幻引擎打包部署配置

如果你已经使用了【VR Preview】我们需要重新启用OpenXR 插件:

在虚幻引擎主菜单点击【Edit】/【Plugins】

在左侧菜单找到【Build-In】/【Virtual Reality】

启用【OpenXR】，【OpenXREyeTracker】【OpenXRHandTracking】

重启虚幻引擎

在虚幻引擎主菜单点击【Edit】/【Project Settings】

在左侧菜单找到【Plugins】/【Meta XR】

在右侧页面【General】下，设置【XR API】为【Epic Native OpenXR with Oculus vendor extensions】

关闭【Project Settings】窗口

在虚幻引擎主菜单点击【File】/【Save All】

8.2打包和安装apk

在虚幻引擎主菜单点击【Platforms】

选择【Android】/【Package Project】

放到你想打包的位置

等待虚幻引擎打包，可以看见【OutputLog】日志输出

运行电脑上的【Meta Quest Developer Hub】 应用

在【Device Manager】下点击【Add Build】

选择你刚刚打包的apk安装

进入你的quest3，点击右下角九个点的图标【应用目录】

将右上角的【所有应用】改为【未知来源】，这时候就可以看见刚刚打包的游戏了

点击运行，体验一下吧