Google VR quick start guide

This section helps you get started with developing Google VR applications using Unity. Many of the instructions for developing Google VR content are available on the Google VR Developer website.

Use the following guides to install Unity and the Google VR SDK:

1. See Downloading and installing Unity to help install the Unity Editor.

   i ) When targeting Android, make sure you install Unity Android Support through the Unity Installer.

   ii ) When targeting iOS, make sure you install Unity iOS support through the Unity Installer and that you have a macOS machine to compile and deploy to your device.

2. Follow the instructions on the Google developer site for VR for your targeted platform(s).

Official Google VR guides

Google provides starter guides for developing Google VR applications with Unity for both Android and iOSApple’s mobile operating system. More info
See in Glossary. Links to specific guides are given below:

• Getting started with Google VR SDK for Unity for Android.

• Getting started with Google VR SDK for Unity for iOS.

Unity Platform configuration settings

This section provides a step-by-step guide for configuring your Unity Project to build Google VR applications.

Follow the steps in the next sections to ensure your Unity project can successfully build for your target Google VR devices.

Targeting Cardboard (Android and iOS)

Unity provides a number of platform-specific build options for building applications to Cardboard-supported devices.

To access these settings, open the Player SettingsSettings that let you set various player-specific options for the final game built by Unity. More info
See in Glossary in the Unity Editor (menu: Edit > Project SettingsA broad collection of settings which allow you to configure how Physics, Audio, Networking, Graphics, Input and many other areas of your Project behave. More info
See in Glossary > Player) and click either the iPhone or Android icon, depending on which device you want to build to. Navigate to XR Settings and make sure Virtual Reality Supported is checked. Next, navigate to the Virtual Reality SDKs list and click the plus (+) button. Select CardboardAbbreviation of Google Cardboard
See in Glossary to add it to the list.

When you have added Cardboard to the Virtual Reality SDKs list, click the foldout arrow next to it to view additional Cardboard settings.

The table below provides a list of properties available in the Cardboard settings, along with a description of their functionality.

PropertyA generic term for the editable fields, buttons, checkboxes, or menus that comprise a component. An editable property is also referred to as a field. More info See in Glossary	Description
Depth Format	Use this drop-down to set the Z buffer depth. Unity uses this to sort the visible data and determine what is actually rendered to the screen.
Enable Transition View	The transition view is the view that Google VR provides to inform the user that they must put their device in a Cardboard-compatible viewer. You can enable it to provide users some time to insert their device into a viewer. By default, this is disabled.

The minimum platform requirement for Cardboard is Android 5.0 (Lollipop) (SDK API level 21).

To ensure Unity uses the correct APKThe Android Package format output by Unity. An APK is automatically deployed to your device when you select File > Build & Run. More info
See in Glossary, and only runs on devices upgraded to the latest version of Android, you need to change the Minimum API Level.

To do this, go to the Player Settings and navigate to Other Settings. Under Identification, use the Minimum API Level drop-down to set it to the latest API in the list.

Set the Target API Level to API level 21 or higher for Cardboard only. If you are targeting Daydream then this needs to be 24 or higher. By default, this property uses the highest level you have installed. For more information about API levels for Android, see documentation on Android PlayerSettings.

You are now ready to create your Unity content for Cardboard. Follow the same workflow you would for normal Android or iOS development (see documentation on Android development or iOS development for more information). Make sure you build and run your game on a Cardboard-capable device (menu: File > Build & Run).

Targeting Daydream (Android only)

Unity provides a number of platform-specific build options for building applications to Daydream-supported devices.

To access these settings, open the Player Settings (menu: Edit > Project Settings > Player) and navigate to the Android section (click the Android icon marked in the figure below). Navigate to XR Settings and make sure the Virtual Reality Supported checkbox is ticked. Next, navigate to the Virtual Reality SDKs list and click the plus (+) button. Select Daydream to add it to the list.

When you add Daydream to the Virtual Reality SDKs List, click the foldout arrow next to it to view additional Daydream settings.

The table below provides a list of properties available in the Daydream settings, along with a description of their functionality.

Property	Description
Depth Format	Use this drop-down to set the Z buffer depth. This is used for sorting the visible data and determining what is actually rendered to the screen.
Foreground Icon	Set the foreground icon for presentation in the Google VR Play store.
Background Icon	Set the background icon for presentation in the Google VR Play store.
Use Sustained Performance Mode	Enable Sustained Performance Mode for longer XRAn umbrella term encompassing Virtual Reality (VR), Augmented Reality (AR) and Mixed Reality (MR) applications. Devices supporting these forms of interactive applications can be referred to as XR devices. More info See in Glossary experiences. This reduces performance to improve battery life.
Enable Video Surface	Enable Asynchronous Video Reprojection. For more information, see the documentation about Asynchronous Video Reprojection for more information.
Enable Protected Memory	Enables memory protection for DRM protected content when using Asynchronous Video Reprojection. This option only appears if Enable Video Surface has been selected. For more information, see Asynchronous Video Reprojection.
Positional Head Tracking	Allows you to specify the minimum level of head tracking you need support for. For more information, see VRDaydream.SupportedHeadTracking.

The minimum platform requirement for targeting Daydream only is Android 7.0 (Nougat) (SDK API level 24). If you are targeting Cardboard as well as Daydream, then the minimum supported API level is 21.

To ensure Unity uses the correct APK, and only runs on devices upgraded to the latest version of Android, you need to change the Minimum API Level.

To do this in the Player Settings, navigate to Other Settings. Under Identification, use the Minimum API Level drop-down to set it to the latest API in the list.

Set Target API Level should be set to API level 24 if you are Daydream. By default, this property uses the highest level you have installed. For more information about API levels for Android, see documentation on Android PlayerSettings.

You are now ready to create your Unity content for Daydream. Follow the same workflow you would for normal Android development (see documentation on Android development for more information). Make sure you build and run your game on a Daydream-capable device (menu: File > Build & Run).

---

• 2018–03–27 Page published

• Google VR documentation updated for Unity XR API in 2017.3

• Positional head tracking added to Daydream-specific settings in 2017.3