Testing a location on an Android-based VR headset

You can create a location in the ENGAGE SDK, and then test it on an Android-based VR headset. However, the location is restricted to your development device. Other users can't join you.

1. Build a location bundle for Android

  1. If you haven't installed the Android platform build support module for Android, complete the steps described in Installing a platform build module.

  2. Follow the steps described in Building a location bundle and select the Build for Android check box.

2. Copy the asset bundle to the headset

To load your location when you use a headset, you must first copy the asset bundle to the headset. The specific steps vary between devices. The general process is as follows:

  1. Turn on your VR headset.

  2. Connect the VR headset to your computer. For example, use a USB cable.

  3. On the VR headset, depending on the manufacturer, select to allow permission or transfer files.

  4. On your computer, the VR headset is added as an external drive. Browse to this drive, and then to Internal shared storage > Android > data > com.ivre.engage > files > ENGAGE.

  5. Create a new folder for your location. You can choose any name for the folder.

  6. Copy both the .engagebundle and .manifest files from the /AssetBundles/Android subfolder of your local SDK repository to the new folder on the headset.

Location asset bundle files copied to Oculus Quest 2 headset

3. Load the location in the ENGAGE app

  1. Open the ENGAGE app on the VR headset, and then log in.

  2. On the menu screen, select Start Session.

  3. On the Start Session page, in the search field, enter @local.

  4. In the Test Local Scene Bundle window, select Browse.

  5. In the Select Scene Bundle window, select App Storage, and then select ENGAGE.

  6. Browse to the folder that you created for your location.

  7. Select your location, and then select Open.

  8. In the Test Local Scene Bundle window, for the location that you want to test, select LOAD.

You can use the profiling tools in ENGAGE to analyse your location and identify any performance issues. For more information, see Profiling.

Last updated