Loading the simulation onto a VR headset - POINT-VR/POINT-VR-Chapter-1 GitHub Wiki

How to Test the APK Builds

Setting Up Your Testing Environment for Sideloading Android APKs

  1. On your PC, Download the Advanced Installer of SideQuest: https://sidequestvr.com/download
  2. The official SideQuest site has detailed instructions if you get stuck installing SideQuest and connecting it to your Quest headset.
  3. Users might need to download Oculus drivers: https://developer.oculus.com/downloads/package/oculus-go-adb-drivers/

Sideloading the APK onto the Headset

  1. Connect the headset (switched on) to your PC with the USB C cable. Headset should already be in developer mode.
  2. Open SideQuest
  3. Authorize the transfer of files inside the headset.
  4. In the top-right corner, select "Install APK file from folder on computer"
  5. Select the test APK to sideload (We keep all our APKs in the Builds folder)
  6. In the headset, navigate to your apps
  7. Change from All apps to Unknown Source (Meta updates their UI design so the images below might not be an accurate visual of the current app folder.)
  1. Run the now installed app on the headset

Borrowing an Oculus Quest from the IDEA Lab

  1. Headsets from the IDEA Lab must be pre-booked with the following link: https://uiuc.libcal.com/equipment?lid=5488
  2. Physically pick it up from the IDEA Lab at this location and between these hours: https://www.library.illinois.edu/enx/idea-lab/
  3. Since the last person to use it probably didn't charge it, you should do so before attempting to use it
  4. Factory reset it by holding the volume down and power buttons: https://www.youtube.com/watch?v=MRRDQxQ51NM
  5. Perform the first-time setup with the headset and pair it with the software you chose in Step 4 of the environment setup above
  6. Within that software, go to the settings and enable developer mode for the paired device
  7. After rebooting, you can sideload the APK onto the headset with the next set of instructions below
  8. When you are done with the headset, reset it and return it to the IDEA Lab during normal hours
  9. If you forgot to reset it before turning it in, you can remove it from your Oculus account here: https://secure.oculus.com/my/devices/

[Experimental] How to test Unity project with Oculus Quest 2 and Virtual Display

For those who have already purchased Virtual Display and wanted to test a project wirelessly.
This only works for Windows.
Refer to this thread for more information: https://forum.unity.com/threads/unity-editor-and-virtual-desktop.881449/#post-6422274

1.) Install SteamVR (if you have not)
2.) Also install SideQuest and Virtual Display on your PC
3.) Locate your Virtual Desktop folder (it should look similar to this: C:\Program Files\Virtual Desktop Streamer\VirtualDesktop.Streamer.exe)
4.) Locate your Unity Editor folder (it should look similar to this: C:\Program Files\Unity\Hub\Editor\2019.4.20f1\Editor\Unity.exe)
5.) Locate your POINT-VR Project folder. (it should look similar to this: C:\Users\POINT-VR-Chapter-1)
WARNING: It is VERY important that your project folder location does not contain any whitespace. Otherwise it would not work. If your location happens to have whitespace in it (such as C:\Users\Your Name\POINT-VR-Chapter-1), I suggest moving POINT-VR-Chapter-1 folder to C:\Users.
6.) Open Command Prompt and type in your command with the following syntax: "Virtual Dekstop Streamer Exe Path" "Unity Editor executable path" -projectpath "Unity project path -useHub -hubIPC -cloudEnvironment production"
So your command should look something like this:

"C:\Program Files\Virtual Desktop Streamer\VirtualDesktop.Streamer.exe" "C:\Program Files\Unity\Hub\Editor\2019.4.20f1\Editor\Unity.exe" -projectpath "C:\Users\POINT-VR-Chapter-1 -useHub -hubIPC -cloudEnvironment production"

It should open the Unity project directly. If it opens the Unity Hub, then you did something wrong.
7.) Open Virtual Desktop in your Quest 2 and launch SteamVR.
8.) Hit play in your Unity project and begin testing.

Using the Oculus Link

We currently do not have instructions on how to set up the Quest Link cable or Air Link to test the project in Unity. However, for developers who are using Oculus link to run the simulation in a headset from the Unity Editor, the following additional steps need to be taken:

  1. Go to File -> Build Settings. Switch the platform to Android if it is not already the current platform.

  2. From Build Settings, navigate to Player Settings (bottom-left button). Ensure you are on the Android tab.

  3. Scroll down to Other Settings -> Scripting Define Symbols, delete IS_NOT_USING_OCULUS_LINK and save.

[!WARNING] This change to the settings (Settings.json) should NOT be committed.