Setup

Last updated: 10 months ago • 4 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 paths

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

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)

Ultraleap packages

To use the handtracking module, you will need to install Ultraleap Packages.

You can to use automatic installation (requires Git installed)

Alternatively, you can add Ultraleap in registry using OpenUPM as the previous procedure with;

• Name: Ultraleap
• URL: https://package.openupm.com
• Scope(s): com.ultraleap

Then, install com.ultraleap.tracking package.

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
• Select OpenXR in XR Plugin Management (currently unstable)
• Select Khronos controller
• Enable Lynx-R1 service

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

• Enable Ultraleap service
• Enabble Unity Handtracking subsystem

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
• Handtracking - Integrate hand interactions in your project
• Samples - Take a look at the sample scenes presenting Lynx features