How to get started with Oculus Quest and Unity on macOS

Get the right Unity version

There’s lots of versions of Unity and just grabbing the latest isn’t going to get you very far. The various moving parts involved all rely on each other being at certain specific versions.

Modules

When installing the Unity version(s) ensure that you have the following included:

Create a new project

Using Unity Hub go to “Projects” and click “NEW”, if you have installed multiple versions of Unity you can use the down arrow next to “NEW” to select the version we added in the previous step (2019.1.4f1).

Oculus Integration

The “Asset Store”

Project Settings

We need to set out project to build for Virtual Reality and more specifically, in the case of the Quest, we need to set it to build for Oculus VR on Android.

Add an Oculus API key

Remember those new menu items for Oculus we got earlier? Go to “Oculus” > “Platform” > “Edit Settings”

Build Settings

Though we’ve configured the player for the Quest (by setting some android preferences and telling it to use the Oculus SDK) we haven’t actually told Unity to build for Android.

Hook up the Quest

Before actually connecting your headset to the computer you need to put your Quest in to developer mode (as you might with any Android device you were trying to run code on).

Developer Mode

Hopefully the user account you’re logged in to on the Quest is the same as the one you added a development app to earlier. This then allows the Oculus app on your mobile phone to toggle Developer Mode on the headset.

Connecting

Connect the Quest to your computer using a USB cable.

Running on the device

By default the open scene we have in Unity is pretty empty and boring and not set up for the Oculus.

Problems?

Hopefully everything ran fine.

Further Reading and Acknowledgements

This article is very much reusing and combining content from other sources and wouldn’t be possible without them.

Hire me

You can find me here and on LinkedIn.

Freelance iOS Objective C/Swift Developer. SWmobile meetup co-organiser.