- An Android device that supports Cardboard, Daydream, Gear VR or ARCore
- A compatible headset for Daydream or Gear VR
Download and install Android Studio for your operating system.
If you plan on using the AR features, ensure that you are installing Android Studio version 3.0 or higher with Android SDK Platform version 7.0 (API level 24) or higher.
Building AR/ARCore With Android Studio
- Enable Developer Mode on your Android device
- Enable USB Debugging within the Developer Menu
- Connect your device to your computer via USB. When a pop-up appears asking to "Allow USB Debugging?", select "OK".
Follow the instructions here to install the ARCore Service onto your device. For this version of Viro, we require the ARCore 1.10.0
Download and unzip the Hello World projects here.
Ensure your device has the latest Cardboard, Google VR Services and/or Daydream applications installed from the Play Store. Your device may not support all 3 applications, but update all of those your device does support.
If you're trying to use build for GearVR, follow the instructions here to generate an OSIG file for your device. Once you have the OSIG file, place the file in your project's
- Open the project for the platform you're interested in. We provide one sample project for AR, one for VR (which supports both OVR and GVR), and one for ViroViewScene (used for making 3D applications without AR and VR).
- If you're asked about enabling Instant Run, select 'Don't remind me again for this project'
- Once the project initializes, run a Gradle sync
- Open the AndroidManifest.xml and place your Viro API key where it says "API_KEY_HERE".
- Run the application!
Choosing your VR Platform
If you're using the VR Hello World project, you can select between OVR and GVR by opening the Build Variants pane on the left.