Quest

## 1. 安装
### （1）准备工作
在 Meta Quest 上使用 LarkXR 4.0 客户端之前，请确认设备已正确激活，并且已开启 **开发者模式**。
### （2）安装
访问 [https://www.pingxingyun.com/devCenter.html#devDL](https://www.pingxingyun.com/devCenter.html#devDL) 下载 Quest APP 的 APK。
如需将 APK 侧载到设备，请参考安装指南：[https://home-oss.pingxingyun.com/exe/SideQuest.zip](https://home-oss.pingxingyun.com/exe/SideQuest.zip)。
## 2. 运行
### （1）启动应用
在 Quest 头显中，进入 **资料库 > 未知来源**，选择 **LarkXR 4.0 Meta-OpenXR** 启动应用。
### （2）配置服务器
启动应用后，如果尚未配置服务器地址，会弹出 **「Connect to Server Fail」** 提示。
点击 **「Setup Server Address」** 输入服务器 IP 地址。配置完成后，服务器上所有可用的 VR 内容都会显示在应用中。
### （3）进入应用
在列表中选择目标应用，按下手柄上的 **A 键** 即可启动。
运行云渲染应用时，手柄按键映射如下：
| 按键 | 功能 |
|---|---|
| A / X | Trackpad 按下 |
| Y / B | 菜单键 |
| Joystick | Trackpad 滑动 |
| Trigger | 扳机键 |
| Grip | 握持键 |
### （4）退出应用
要退出当前正在运行的应用：
1. 按下手柄上的 **菜单键**。
2. 在弹出对话框中选择 **「Quit」**，即可返回应用列表。
### （5）参数设置
启动应用后，点击 **「Settings」** 可配置手柄振动、显示偏好等基础选项。
点击 **「Advanced Settings」** 可配置以下参数：
#### 预设模式
- **Manual：** 分辨率缩放 0.9，码率 20 Mbps，标准 UDP，固定注视点渲染开启，H265 开启，10-bit 编码关闭，FEC 上报关闭。
- **Normal：** 分辨率缩放 1.0，码率 40 Mbps，增强 UDP，固定注视点渲染开启，H265 关闭，10-bit 编码关闭，FEC 上报关闭。
- **Extreme：** 分辨率缩放 1.0，码率 60 Mbps，增强 UDP，固定注视点渲染开启，H265 开启，10-bit 编码关闭，FEC 上报关闭。
#### 参数说明
- **Resolution：** 设置云渲染与视频编码所使用的分辨率。默认值为设备的原生显示分辨率。
- **Frame Rate：** 控制屏幕刷新频率。帧率越高，画面越流畅。
- **Bitrate：** 调整编码与传输码率。数值越高画质越好，但带宽占用也会增加。
- **Enable Haptics Feedback：** 设为 **No** 时，将抑制云端应用的振动反馈。
- **SkyBox：** 设置虚拟环境背景主题。
- **XR Space：**
  - **XrSpace Local：** 固定房间高度模式。
  - **XrSpace App：** 房间高度由系统配置决定。
- **Transport：**
  - **UDP：** 延迟低于 TCP；丢包时稳定性较差。码率按配置固定 —— 网络拥塞可能导致掉帧。
  - **Enhanced UDP：** 自适应码率与分辨率，并使用 H265 编码；在网络拥塞时表现更好。
  - **TCP：** 延迟更高但更稳定。仅建议在 UDP 不可用时使用。
- **Enable H265：** 开启后，视频流使用 H265 编码而非 H264。同等画质下 H265 压缩率更高，可降低带宽占用。
- **FPS：** 设置服务器渲染并发送视频的帧率。默认值因设备类型而异。云渲染过程中，超出渲染预算的帧会被丢弃，因此观察到的帧率可能波动。注意姿态数据与视频帧紧密耦合 —— 过期的姿态数据会被丢弃。正常运行时帧率波动是预期现象；若出现明显且持续的下降，则可能存在系统问题，需要排查。
- **Fixed Foveated Rendering：** 在视野中心保持全分辨率，同时降低周边分辨率，从而减少资源占用和延迟。
- **Report FEC Fail：** 开启后，会将前向纠错（FEC）失败上报给服务器，促使其提高传输带宽。在标准 UDP 设置下，一般应开启此项。
- **Enable 10-bit Encoding：** 启用 10-bit 色深编码，理论上可提升色彩质量，但会额外占用编码资源。