2025-03-17 NO.1 Quest3 开发环境配置教程

文章目录

准备条件
1 Quest3 激活
- 1.1 下载 Oculus 助手
- 1.2 打开 quest 热点
- 1.3 Quest3 连接 wifi
- 1.4 参考教程
2 登录 Oculus（*）
- 2.1 创建 Meta 账号（*）
- 2.2 Oculus 软件下载与配置（*）
3 创建项目
- 3.1 下载 Unity Hub
- 3.2 下载 Unity
- 3.3 创建 Unity 项目
4 项目配置
- 4.1 切换平台
- 4.2 安装 XR 环境
- 4.3 添加 Meta SDK
- 4.4 导入 Meta SDK
- 4.5 Meta 设置
附：导入 Meta XR All-in-One SDK 失败解决方案
- 方案 1：更改 manifest.json
- 方案 2：手动导入

准备条件

Quest3 头显一个。
一根 USB 3.0 数据线。
科学上网。

1 Quest3 激活

1.1 下载 Oculus 助手

网址：https://ochelper.xlemon.cn/home.html。

1.2 打开 quest 热点

下载 Oculus 助手后，双击 exe 文件打开。

过程中按照程序提示执行，包括：

电脑断开有线连接，连接 wifi，最好是手机热点（校园网不稳定）。
关闭电脑杀毒软件。
共享网络（按照助手提示操作即可）。

成功后显示如下：

1.3 Quest3 连接 wifi

进入 Quest3 设备，找到名为 quest 的 wifi，直接输入密码即可连接激活。

过程中需要购买 5.9r 的流量包，以免流量不够。

1.4 参考教程

quest3激活与领50美详细教程！送任选20美正版游戏!超简单oculus助手激活教程！包搞定！30美点券保底！_哔哩哔哩_bilibili。
quest3联网激活、领30美金券、领阿斯加德之怒2，一条龙一次性全搞定，小白直接上车，保姆级别手把手教学，耐心一步步跟着操作，没理由搞不定，干就完事了~~~_哔哩哔哩_bilibili。
【2024-5月更新】Meta Quest3激活+开发者小白教程，只要一台电脑，不需要特殊工具，快速简便_哔哩哔哩_bilibili。

2 登录 Oculus（*）

2.1 创建 Meta 账号（*）

（1）打开网址 https://auth.meta.com/，该网址需要连接外网。点击“用邮箱继续操作”。

（2）填入邮箱。这里邮箱必须使用国外邮箱，国内邮箱注册后登陆不上 Oculus 软件。可以淘宝上购买 Meta 账号进行操作。

（3）不查收邮件，而是改为“输入密码”，密码填写对应的邮箱密码即可。

（4）在双重验证步骤里下拉列表，选择“levs（身份验证应用）”。

（5）开启一个新的浏览器窗口，输入 https://2fa.fun/ 网址填入账号的代码以获取验证码（具体验证方式可能不同淘宝店所提供的略有不同，能登陆上即可）。

（6）返回界面，输入验证码登录即可。

（7）登录后显示的界面如下。

以上过程可在淘宝店的指导下完成，目的是能登录上 Meta 账号即可。

2.2 Oculus 软件下载与配置（*）

（1）打开官网下载链接：https://www.meta.com/zh-cn/help/quest/articles/headsets-and-accessories/oculus-rift-s/install-app-for-link/，点击“Oculus PC 应用设置”即可开始下载，正常安装即可。

（2）打开 Oculus 软件，选择“Log into a Meta account”。

（3）跳转到网页上，选择“以…的身份继续”。

（4）回到 Oculus 软件，需要耐心等待，或者多试几次。如果还未成功，参考该教程处理：https://blog.csdn.net/G0rgeoustray/article/details/111503152。

（5）登录完成后，使用 USB 数据线连接设备。

第一次用数据线连接会提示 Quest Link 数据线访问，允许即可。

（6）进入“Settings”页面，选择“通用”选项，打开 OpenXR Runtime 设置。

（7）选择“Beta 测试版”选项，勾选以下设置：

开发者 Runtime 功能。
Passthrough over Meta Quest Link。

（8）注意，之后运行项目的过程中 Oculus 软件需要一直后台开启。

3 创建项目

3.1 下载 Unity Hub

首先下载 Unity Hub，用于统一管理不同 Unity。下载完成后，使用 Unity Hub 安装 Unity 编辑器，然后用 Unity 编辑器创建 Unity 工程，进行项目的开发。

Unity Hub 下载链接： https://unity.com/download。

3.2 下载 Unity

Unity 版本分为国际版（如 2022.3.60f1）、国内特供版（版本号后缀带有 c，如 2022.3.54f1c1）、团结引擎（国内版 Unity 的另一个分支，适用于国服特色的应用，如微信小程序、车机、鸿蒙开发。Quest 开发一般不使用）。

国际版和国内特供版在使用上基本没有区别，但一些新的 Unity 版本和功能会率先在国际版推出。

开发 Quest 建议使用国际版，在 Meta XR SDK 的某些版本中，国内特供版的 Unity 在导入 SDK 的时候会报错。

国际版：https://unity.com/releases/editor/archive。（需要科学上网）
国内特供版：https://unity.cn/releases。

使用国内特供版的 Unity Hub 也能下载国际版 Unity 编辑器，因为导入 SDK 是在 Unity 编辑器当中进行的，所以 Unity Hub 可以是国际版，也可以是国内特供版，而 Unity 编辑器建议使用国际版，坑点可能会更少。这个链接需要科学上网（不能用香港节点），才能够正确跳转到国际版 Unity 的下载页面。

官方推荐下载 Unity6 版本，但由于目前（时间：2025.03.17）国内 Unity 限制 Unity6 版本的下载（经常作妖是这样的），因此需要进入国际版官网下载国际版。下图链接：https://developers.meta.com/horizon/documentation/unity/unity-development-overview/。