Table of Contents

Standalone support

This article explains which are the settings you have to apply to your project to be able to build for the different standalone platforms.

Unity's target platform needs to be set to Android:

  • Go to File -> Build Profiles.
  • Select Android platform in the list and click on Switch Platform (you'll need to install the Android module in case it's not already installed).

VR device support is based on OpenXR, via Unity's OpenXR plugin. Meta support is built in and for other platforms (HTC and PICO) their corresponding plugins must be installed. OpenXR features and interaction profiles for different Standalone VR platforms are mutually exclusive and they only should have the corresponding OpenXR Feature Groups activated. If you want to build the same project for more that one platform (for example Meta and HTC), you would have to change these settings every time you build.

Note

Hand Tracking Subsystem must be activated too in case you want to use hand tracking in your application.

Adding support to a project developed before VIROO 3.0

To add support for standalone, follow these steps:

  1. Open the VIROO Main scene (if you started from the template, it's located at Assets -> Scenes -> VIROO Main).
  2. Make sure the VirooStandalone prefab is present in the hierarchy; if it isn't, add it.". You can find it at Packages/Viroo/Runtime/Viroo.Unity/Standalone/Bootstrap/Prefabs/VirooStandalone.prefab.
  3. Save the scene.

Meta

VIROO Studio is already configured for Meta standalone devices. These are the settings needed to build for Meta:

  1. Select the plug-in provider.

    • Go to Edit -> Project Settings -> XR Plug-in Management and select the Android tab.
    • Select OpenXR in Plug-in Providers. There should be the only plug-in provider selected.

  2. Set up the Meta Quest Support feature group.

    • Go to Edit -> Project Settings -> OpenXR and select the Android tab.
    • Verify that the Meta Quest Support feature is checked in OpenXR Feature Groups; if not, check it.
    • In case you aren't building for Vulkan, in the settings editor of the OpenXR Feature Groups make sure that the Optimize Buffer Discards option is unselected.

    meta-settings.png

  3. Select the interaction profiles.

    • Go to Edit -> Project Settings -> OpenXR, and select the Android tab.
    • In the Enabled Interaction Profiles section, add only the following profiles: Oculus Touch Controller Profile, Meta Quest Touch Pro Controller Profile and Meta Quest Touch Plus Controller Profile.
    • Delete any other interaction profiles.

    meta-profiles.png

PICO

These are the basic steps to configure your project for PICO standalone devices. For more information please refer to PICO documentation.

Install PICO Unity OpenXR SDK following these steps:

  1. Download PICO Unity OpenXR SDK.

  2. Unzip the content of the file that has been downloaded.

  3. Open the Package Manager (Window -> Package Manager), in Add section (the section with a + icon), select the Add package from disk option.

    pico-download.png

  4. Select the package.json file that's in the extracted folder.

Configure your project:

  1. Select the plug-in provider.

    • Go to Edit -> Project Settings -> XR Plug-in Management and select the Android tab.
    • Select OpenXR and PICO XR feature group in Plug-in Providers. This should be the only plug-in provider selected under OpenXR section.

    pico-plugin.png

  2. Select the interaction profiles.

    • Go to Edit -> Project Settings -> OpenXR and select the Android tab.
    • Add PICO4 Touch Controller Profile and PICO Neo3 Touch Controller Profile.
    • Delete any other interaction profiles.

    pico-profiles.png

  3. Further Player Settings

    • Go to Edit -> Project Settings -> Player -> Other Settings.
    • In Rendering section make sure that the Auto Graphics API is unselected and that the selected Graphics API is OpenGLES3.

    openGLES3.png

    • In Identification select Android 10 as the Minimum API Level.

    android10.png

    • In Configuration select ARM64 as the target architecture.

    arm64.png

HTC

These are the basic steps to configure your project for HTC standalone devices. For more information please refer to HTC documentation.

Install VIVE OpenXR following these steps:

  1. Download the Vive OpenXR Installer unity package and save it.

  2. Import the file to the Unity Project (Assets -> Import Package -> Custom Package...).

  3. Install the package.

    • You will find a menu called VIVE on the Unity UI.
    • Select VIVE -> OpenXR Installer -> Install or Update latest version.

    htc-install.png

Configure your project:

  1. Select the plug-in provider.

    • Go to Edit -> Project Settings -> XR Plug-in Management and select the Android tab.
    • Select OpenXR and VIVE XR Support feature group in Plug-in Providers. This should be the only plug-in provider selected under OpenXR section.

    htc-plugin.png

  2. Select the interaction profiles

    • Go to Edit -> Project Settings -> OpenXR and select the Android tab.
    • Add VIVE Focus 3 Controller Interaction and Oculus Touch Controller Profile.
    • Delete any other interaction profiles.

    htc-profiles.png

  3. Further Player Settings.

    • Go to Edit -> Project Settings -> Player -> Other Settings.
    • In Rendering section make sure that the Auto Graphics API is unselected and that the selected Graphics API is OpenGLES3.

    openGLES3.png

    • If your target device is a Focus 3, go to Identification and select Android 9 as the Minimum API Level.
    • In Edit -> Project Settings -> Player-> Resolution and Presentation, Default Orientation needs to be set to Landscape Left.

    htc-orientation.png