Quest

## 1. Installation

### (1) Preparation

Before using the LarkXR client on Meta Quest, ensure that the device has been properly activated and that **Developer Mode** is enabled.

### (2) Installation

Visit [https://paraverse.cc/larkxr-resource/](https://paraverse.cc/larkxr-resource/) to download the Quest APP APK.

To sideload the APK onto your device, refer to the installation guide at [https://home-oss.pingxingyun.com/exe/SideQuest.zip](https://home-oss.pingxingyun.com/exe/SideQuest.zip).

## 2. Running

### (1) Launching the App

On the Quest headset, navigate to **Library > Unknown Sources** and select **LarkXR Meta-OpenXR** to launch the application.

### (2) Server Configuration

Upon launching the app, if the server address has not been configured, a **"Connect to Server Fail"** prompt will appear.

Tap **"Setup Server Address"** to enter the server IP address. Once configured, all available VR content on the server will be displayed in the app.

### (3) Entering an Application

Select the desired app from the list and press the **A button** on the controller to launch it.

When running cloud-rendered applications, the controller button mappings are as follows:

| Button | Function |
|---|---|
| A / X | Trackpad press |
| Y / B | Menu button |
| Joystick | Trackpad swipe |
| Trigger | Trigger button |
| Grip | Grip button |

### (4) Exiting an Application

To exit an application that is currently running:

1. Press the **menu button** on the controller.
2. Select **"Quit"** from the pop-up dialog to return to the app list.

### (5) Parameter Settings

After launching the app, tap **"Settings"** to configure basic options such as controller vibration and display preferences.

Tap **"Advanced Settings"** to configure the following parameters:

**Preset Modes:**

- **Manual:** Resolution scaling 0.9, bitrate 20 Mbps, standard UDP, fixed foveated rendering enabled, H265 enabled, 10-bit encoding disabled, FEC reporting disabled.
- **Normal:** Resolution scaling 1.0, bitrate 40 Mbps, enhanced UDP, fixed foveated rendering enabled, H265 disabled, 10-bit encoding disabled, FEC reporting disabled.
- **Extreme:** Resolution scaling 1.0, bitrate 60 Mbps, enhanced UDP, fixed foveated rendering enabled, H265 enabled, 10-bit encoding disabled, FEC reporting disabled.

**Parameter Descriptions:**

- **Resolution:** Sets the resolution used for cloud rendering and video encoding. The default value is the native display resolution of the device.
- **Frame Rate:** Controls the screen refresh frequency. A higher frame rate produces smoother visuals.
- **Bitrate:** Adjusts the encoding and transmission bitrate. Higher values improve visual quality but increase bandwidth consumption.
- **Enable Haptics Feedback:** When set to **No**, vibration feedback from cloud applications is suppressed.
- **SkyBox:** Sets the theme for the virtual environment background.
- **XR Space:**
  - **XrSpace Local:** Fixed room height mode.
  - **XrSpace App:** Room height determined by system configuration.
- **Transport:**
  - **UDP:** Lower latency than TCP; less stable under packet loss. The bitrate is fixed as configured — network congestion may cause frame drops.
  - **Enhanced UDP:** Adaptive bitrate and resolution with H265 encoding; better performance in congested network conditions.
  - **TCP:** Higher latency but more stable. Recommended only for scenarios where UDP is unavailable.
- **Enable H265:** When enabled, the video stream uses H265 encoding instead of H264. H265 offers superior compression at equivalent quality, reducing bandwidth usage.
- **FPS:** Sets the frame rate at which the server renders and transmits video. Default values vary by device type. During cloud rendering, frames that exceed the rendering budget are discarded, which may cause observed frame rate fluctuations. Note that pose data and video frames are tightly coupled — stale pose data is discarded. Frame rate fluctuations during normal operation are expected; significant and sustained drops may indicate a system issue requiring investigation.
- **Fixed Foveated Rendering:** Maintains full resolution at the center of the field of view while reducing resolution at the periphery, lowering resource consumption and latency.
- **Report FEC Fail:** When enabled, reports Forward Error Correction (FEC) failures to the server, prompting it to increase transmission bandwidth. This option should generally be enabled under standard UDP settings.
- **Enable 10-bit Encoding:** Enables 10-bit color depth encoding, theoretically improving color quality at the cost of additional encoding resources.