Pico Neo3

## 安装
1. 使用 USB 数据线将 VR 头显连接到电脑，并打开 SideQuest 软件。如果出现请求开启调试权限的提示，请选择「允许」。连接成功后，状态如下图所示：
   ![](https://docs.pingxingyun.com/media/202503/84737a994b46467380af610873b061a87127.png)
2. 点击右上角的箭头图标，选择 APK 文件所在目录，然后继续安装。
   ![](https://docs.pingxingyun.com/media/202503/f109cddb4eab437cafdcd8cc272d17b74304.png)
3. 安装完成后，会看到如下提示：
   ![](https://docs.pingxingyun.com/media/202503/e809c182e021436588d413f6764b8caa9720.png)
## 运行
### 启动应用
在 Pico Neo3 中，进入 **资料库**，找到 **LarkXR 4.0 Pico OpenXR** 并启动应用。下图为应用打开后的界面。
![](https://docs.pingxingyun.com/media/202503/a2ad1047575540059d1cd13f4d862f262767.png)
LarkXR 4.0 服务器上应已上传 VR 应用。
### 设置服务器地址
进入应用后，点击 **Setup Server Address** 设置服务器地址，如下图所示：
![](https://docs.pingxingyun.com/media/202503/5a2193dc8a554c8da01d5b7c71f030814789.png)
设置 IP 后，服务器上的所有 VR 内容都会显示出来。
![](https://docs.pingxingyun.com/media/202503/361bcf3252d4468b89c8965f98d9b8387755.png)
### 进入应用
选择应用并按下 **A** 键进入。
运行云端应用时，手柄按键映射如下：
| 手柄输入 | 映射为 |
|---|---|
| A / X | Trackpad 按下 |
| Y / B | 菜单键 |
| Joystick | Trackpad 滑动 |
| Trigger、Grip | 各自对应的按键 |
进入应用后的初始界面为加载页：
![](https://docs.pingxingyun.com/media/202503/6a411ec262aa4675b19b4656791b9c076784.png)
进入成功后即可正常使用应用：
![](https://docs.pingxingyun.com/media/202503/592514dac1444c648eed828362d037cd2260.png)
### 退出应用
要呼出退出界面，按住右手扳机并短按 **B**，或按住左手扳机并短按 **Y**。然后选择 **Exit** 返回应用列表。
![](https://docs.pingxingyun.com/media/202503/75b9e2a0776c4102a5c8f8fc48204a997757.png)
### 参数设置
打开应用后，点击 **Settings** 可快速配置是否开启手柄振动、分辨率、码率等选项。
![](https://docs.pingxingyun.com/media/202503/ce34d52aaccc40ed8689b14b61e969d14617.png)
点击 **Advanced Settings**，如下图所示，可设置传输类型、是否使用 H265 协议、FEC 上报、帧率、固定注视点渲染以及 10-bit 编码。
![](https://docs.pingxingyun.com/media/202503/9361a119d67d4503b29be607ac0e39866324.png)
## 画质预设
| 预设 | 分辨率缩放 | 码率 | 传输方式 | 固定注视点渲染 | H265 | 10-bit 编码 | FEC 上报 |
|---|---|---|---|---|---|---|---|
| Manual | 0.9 | 20M | 常规 UDP | 开启 | 开启 | 关闭 | 关闭 |
| Normal | 1 | 40M | 增强 UDP | 开启 | 关闭 | 关闭 | 关闭 |
| Extreme | 1 | 60M | 增强 UDP | 开启 | 关闭 | 关闭 | 关闭 |
## 设置项说明
**Resolution** — 云渲染与视频编码实际使用的分辨率。默认等于头显分辨率，缩放系数为 1。拖动滑块会将宽高乘以该系数。降低分辨率可减少云渲染资源占用和传输压力，但也会影响最终画质。
**Frame Rate** — 屏幕刷新频率；刷新越快，画面越流畅。超过头显自身帧率没有实际意义，降低帧率则会减少流畅度并增加延迟。
**Coderate Setting** — 调整编码与传输所用的码率。码率越高画质越好，但需要更多网络带宽。为流畅、清晰地使用云 VR，请确保使用 5G Wi-Fi 或 5G 网络。
**Enable haptics feedback** — 选择「No」时，将忽略云端应用的振动反馈。
**SkyBox** — 天空盒主题。
**XrSpace** — `XrSpace Local`（固定房间高度）或 `XrSpace App`（房间高度随系统设置）。
**Transport** — 选择传输协议：
- **UDP** — 延迟低于 TCP，但稳定性较差；丢包可能导致马赛克等花屏。码率较高时可能丢包，建议控制在约 40M 以内。
- **TCP** — 稳定且不丢包，但会增加延迟。提高码率不会导致丢包。
- **KCP** — 兼具 UDP 与 TCP 的特点，弱网下丢包更少、带宽占用更高。传输码率按设定值发送，可能导致网络拥塞；拥塞时只能手动下调码率。局域网环境下一般能满足需求且不易拥塞。公网传输效果取决于服务器网络节点和实际链路，出现问题的可能性更高。
> 当前版本在公网传输时，如果效果较差、画面卡顿，请选择 UDP，避免使用 KCP，降低码率和分辨率，并使用 H265。
**Enable H265** — 决定视频是否使用 H265 编码；默认为 H264。H265 压缩率更高，同等画质下更省带宽，但编解码资源占用更大。目前 H264 兼容性更广。当服务器性能充足且编解码延迟较低时，开启 H265 可降低带宽占用。
**FPS** — 服务器渲染并发送视频的帧率。默认值因头显而异。由于设备性能和具体环境不同，更高的 FPS 并不总是效果更好。实际传输与编码过程中不会严格遵守设定帧率，可能会丢帧，并优先保证低延迟 —— 渲染过慢的帧会被丢弃，因此观察到的帧率会波动。姿态输入与视频帧紧密关联，过期的姿态数据没有意义。云渲染会尽量按设定帧率执行，但波动属于正常现象。只有在某个流程中帧率极低，才属于需要排查的异常。
**Fixed foveated rendering** — 在视野中心保持分辨率，同时降低边缘分辨率，从而减少资源占用和延迟。
**Report fec fail** — 当 FEC（前向纠错）失败时向服务器上报，促使服务器提高传输通道带宽。在常规 UDP 设置下，应开启 FEC 上报。
**Enable 10bit encode** — 启用 10-bit 色彩编码，理论上可提供更好的色彩质量，但会占用更多编码资源。