Please Select Your Location
Australia
Österreich
België
Canada
Canada - Français
中国
Česká republika
Denmark
Deutschland
France
HongKong
Iceland
Ireland
Italia
日本
Korea
Latvija
Lietuva
Lëtzebuerg
Malta
المملكة العربية السعودية (Arabic)
Nederland
New Zealand
Norge
Polska
Portugal
Russia
Saudi Arabia
Southeast Asia
España
Suisse
Suomi
Sverige
台灣
Ukraine
United Kingdom
United States
Please Select Your Location
België
Česká republika
Denmark
Iceland
Ireland
Italia
Latvija
Lietuva
Lëtzebuerg
Malta
Nederland
Norge
Polska
Portugal
España
Suisse
Suomi
Sverige

Getting Started with OpenXR for Mobile

⚠ NOTICE

This legacy plugin is no longer being updated and maintained, please develop mobile content with OpenXR 2-in-1 Unity / Unreal package .


What will you learn?

You will learn how to setup a project using the VIVE OpenXR Plugin to create immersive content that runs on Android devices such as VIVE Focus 3 .

Note:
In this tutorial we will use Unity 2021.3.9f1 and Vive Focus 3.
Prerequisite: Unity Versions 2020.3.15f2, 2020.3.30f1 and 2021.3.3f1 are verified and recommended.

What is VIVE OpenXR Plugin?

OpenXR enables XR portability across hardware VR devices to help developers prioritize content creation over porting.


Setup Project

Download the Vive Wave OpenXR Plugin here. Link



Project Settings

  1. In File-> Build Settings, the target platform needs to be set to Android. Click on Switch Platform.

GettingStartedTutorialImage1

  1. In Edit-> Project Settings-> Player-> Resolution and Presentation-> Orientation, Default Orientation needs to be set to Landscape Left.

GettingStartedTutorialImage1

  1. In Edit-> Project Settings-> Player-> Other Settings-> Graphics APIs, choose OpenGLES and remove Vulkan .
※ To shorten the build time of the Unity project , we recommend you choose only one Graphis API .
※ If you do not see the session for choosing Graphics APIs, please make sure the Auto Graphics API is unselected . (For more information of what Auto Graphis API does, please see here. )


GettingStartedTutorialImage1

  1. In Edit-> Project Settings-> XR Plug-in Management enable OpenXR and VIVE Focus 3 Support feature group


GettingStartedTutorialImage1

  1. After enabling VIVE Focus 3 Support feature group, you may see a pop-up for OpenXR Project Validation with multiple issues displayed. Select Fix All .

GettingStartedTutorialImage1



Create a test scene

Right-Click in the Hierarchy window and choose XR-> Convert Main Camera to XR Rig.

GettingStartedTutorialImage1

GettingStartedTutorialImage1


Optional: Adding Controllers

Follow Unity's Configuring an XR Rig with the XR Interaction Toolkit. Link


USB Debugging

Enable USB Debugging in the headset. Now the project can be built and run on Focus3. For issues building and running the project, refer to Unity's Publising to Android tutorial. Link

GettingStartedTutorialImage1