Setup

Last updated: 3 months ago • 2 versions | Visibility: Public

Setup

Install packages

Via Git URL

1. Open Package Manager in Unity Editor (Window > Package Manager)

2. Click on the "+" button at the upper left and select "Add package from Git URL..."

3. Enter following path

• Lynx Core: https://github.com/Lynx-MR/UnitySDK.git?path=/Packages/Core

Via OpenUPM

Under Project Settings > Package Manager, add a new registry

•     Name: Lynx
•     URL: https://package.openupm.com
•     Scope(s): com.lynx

Then, click on the "save" button

Now, you can import Lynx sources from the Package Manager

1. Open Window > Package Manager
2. Select "My registries"
3. Install Core and Modules (the project will restart if OpenXR was not previously installed)

Configure

Project configuration

a. One-click configuration

To build an application for the Lynx-R1, use the "Lynx" menu to automatically configure the project for you.

Lynx > Settings > Configure project settings

A popup indicating the changes on your project should appear. You can "Validate" the changes.

(1 error log could appear for TextMeshPro without consequences)

b. Manual configuration

To be able to build applications for the Lynx-R1, we recommend to use the following settings:

• Switch to Android platform
• Target ARM64 architecture (the headset is based on the Qualcomm XR2 SoC)
• Enable multithreading rendering
• Set Landscape left presentation
• Target OpenGLES Graphics API (Vulkan is supported but not perfectly stable for now)
• Set target Android API 10
• Under OpenXR Section
  • Select OpenXR in XR Plugin Management (currently not set with the automated configuration)
  • Enable Lynx-R1
     

If you want to use the hand tracking, you'll have to add the following settings under OpenXR section:

• Select Hand Interaction Profile
• Enable Hand Tracking Subsystem
• Enable Meta Hand Tracking Aim

Warning: enabling OpenXR from code is currently unstable on this version. Please enable it on Project Settings > XR Plugin Management > enable OpenXR (Android tab).

Scene setup

As Lynx is based on OpenXR and XRI, you can use already existing assets and samples for XR.

If you want to start a new scene from scratch, you can follow these steps:

1. Create a new scene
2. Remove the Main Camera
3. Add XR Origin

By building and installing the apk, you should now be able to navigate in your scene.

For further information, please check these pages:

• Features - Learn to manage AR and VR on the Lynx-R1
• UI - Basic 2D elements to quickly develop interfaces
• Samples - Take a look at the sample scenes presenting Lynx features