Quest（推荐）

### 安装步骤：

（1）准备工作：

在使用 Oculus Quest 前，请确保已激活并开启开发者模式。

（2）安装：

- 访问https://www.pingxingyun.com/devCenter.html 下载 Quest APP 的 apk 文件。

- 参考安装教程：https://home-oss.pingxingyun.com/exe/SideQuest.zip 安装下载的 Quest apk。

#####2、运行
**（1）在 Oculus Quest 中，导航至资源库，然后选择未知来源应用，在列表中找到【LarkXR Meta-OpenXR】并启动。以下是打开应用的示例截图：**
![](https://docs.pingxingyun.com/media/202503/553dfcc8c7704ac388712cf338f15c3a3912.png)

**（2）LarkXR服务器应该预先上传好VR应用。**
首次打开应用程序时，需设置服务器地址。请点击右上角的“设置服务器地址”，进入如下所示界面，在相应字段填写服务器的IP地址和端口号。
![](https://docs.pingxingyun.com/media/202503/75daf6c0cbe34577b5d74fd5fa9a3fce5363.png)
设置完IP地址后，请点击“返回”按钮，即可进入应用一览界面，如下图所示：
![](https://docs.pingxingyun.com/media/202503/7925317cbed844dba39bb15254af1b471926.png)

**（3）进入应用**
要选择一个应用，请使用手柄上的摄像头对准该应用，然后按下右手柄的A键或左手柄的X键即可进入该应用。
![](https://docs.pingxingyun.com/media/202503/9ff52fb5db7c4131a1de3d2fc9153bb86239.png)
进入应用时，初始画面为loading画面，如下图所示：
![](https://docs.pingxingyun.com/media/202503/4020d8d0d99e4078b99185e6daeb90102350.png)
成功进入应用后，您可以正常使用应用，如下图所示：
![](https://docs.pingxingyun.com/media/202503/4012da5d60584e36b0c1717ce787c1bc9601.png)

**(4）退出应用**
**三维列表退出使用中的应用：**
1.要调出退出界面，请按住右手的扳机键并短按 B 键，或者按住左手的扳机键并短按 Y 键。然后选择“退出”按钮，即可返回应用列表。
![](https://docs.pingxingyun.com/media/202503/dc288bb8b3104f689e0c3d2a8e8e0bd12752.png)![]
![](https://docs.pingxingyun.com/media/202503/2fa563dd87404179bf17f038a0814d997378.png)

**(5) 参数设置**
三维列表参数设置：**
打开应用后，点击“设置”，可以快速配置，设置是否开启手柄震动，设置分辨率，设置码率：
![](https://docs.pingxingyun.com/media/202503/6d401905110440d7b7733fa6564b85b53555.png)
点击高级设置，如下图所示：可以设置传输类型，是否使用H265协议，是否开启FEC报告，帧率，是否开启固定注视点渲染，是否开启10Bit编码。
![](https://docs.pingxingyun.com/media/202503/16c27bc6c1e945aca29e2cbf63d061085063.png)

**名词解释：**
- **流畅**：具体配置为：分辨率缩放0.9，码率20M，普通UDP,启用固定视点渲染，启动H265编码，关闭10bit编码，开启FEC报告。
- **标准**：具体配置为：分辨率缩放1，率码率40M，增强UDP,启用固定视点渲染，关闭H265编码，关闭10bit编码，不开启FEC报告。
- **超清**：具体配置为：分辨率缩放1，率码率60M，增强UDP,启用固定视点渲染，关闭H265编码，关闭10bit编码，不开启FEC报告。
- **分辨率**：该项目设置云端渲染和视频编码实际使用的分辨率。默认等于头戴设备本身的分辨率。缩放倍数为 1。通过拖拽滑块修改缩放倍数，设置完的分辨率将宽和高都乘以该倍数。调小分辨率有助于降低云端渲染资源消耗和传输压力。同时也会影响最终画面的清晰度。
- 帧率就是画面刷新的频率，刷新的越快越流畅，但是超过眼镜本身的帧率是没啥意义的，减小帧率除了会减少流畅感还会增加延时。
- **码率**：通过滑块设置编码传输所使用的码率。码率越高实际视频质量越好，但需要更高的网络带宽。请根据实际情况
选择。要流畅清晰的使用云 VR，请保证使用 5G wifi 或 5G 网络。
- **是否开启手柄震动**：选择否将忽略云端应用的震动反馈。
- **传输类型云渲染视频流的传输通道类型**：UDP: 使用 UDP 进行传输，相较 TCP 有延时低但不稳定的特点，可能会有丢包导致的马赛克等现象。当码率比较高的时候可能会导致丢包，推荐不超过 40M 左右。TCP: 使用 TCP 进行传输，传输稳定不会丢包，但会增加延时。提高码率不会导致丢包的现象。增强 UDP：结合 UDP 和 TCP 的特点，稳定丢包少，但在网络条件差的情况下会更多带宽。目前版本没有调速 UDP。传输码率按照设定的值，可能导致网络拥塞，当拥塞时只能手动调节码率。在局域网条件下基本能满足需要不会拥塞。公网传输的情况下要看具体情况，服务器的网络节点和实际链路具体情况未知，出现问题的可能性较大。目前版本公网传输如果效果不好卡住推荐选 UDP，不要选增强 UDP，并降低码率和分辨率，使用 H265。
- **是否使用 H265 协议**：视频是否使用 H265 编码，默认使用 H264。H265 相较于 H264 有更高的压缩率，同样的画质可以节约带宽，
但是会消耗更多编解码资源。H264 普及和兼容性目前比 H265 要好。当服务器性能够用编解码延时不大的情况下可以启用 H265 以达到减少带宽的目的。
- **FPS**：服务器渲染和传输视频的帧率。默认项根据不同的眼镜设置为不同的值。由于头戴设备的性能和具体环境的差异，并不是 FPS 越高效果越好。并且实际视频传输和编解码过程中并不会完全按照该帧率执行，会有丢帧，具体原则是延时优先，太慢的帧来不及渲染会被丢弃，具体表现为监控数据中的帧率的波动。同时姿态输和视频帧是高度绑定的整体，过时的姿态数据也没有实际意义。设置的该帧率整个云渲染将努力按照该帧率执行，但有波动是正常的现象。除非出现某一过程帧率极低的情况，这种是异常现象要排查。
- **固定视点渲染**：
开启固定视点渲染将保持视野中心分辨率，降低边缘分辨率，起到降低资源消耗减少延时的作用。
- **开启 fec 报告**：
当fec（前向纠错）失败时上报给服务器，服务器增加传输通道的带宽，通常在普通UDP的设置下需开启前向纠错报告。
- **开启10bit编码**：
开启10bit颜色编码，理论上色彩更好占用编码资源更多