Legacy Documentation: Version 2018.2 (Go to current version)
Google VR hardware and software requirements
Supported APIs and SDKs
Other Versions

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:

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 SettingsA settings manager that lets 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 CardboardSee Google Cardboard
See in Glossary
to add it to the list.

Finding Cardboard-specific settings for iOS/Android (Edit > Project Settings > Player > XR Settings)
Finding Cardboard-specific settings for iOS/Android (Edit > Project Settings > Player > XR Settings)

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

Cardboard-specific settings in VR SDK list
Cardboard-specific settings in VR SDK list

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.

Finding the Daydream-specific settings for Android (Edit > Project Settings > Player > XR Settings)
Finding the Daydream-specific settings for Android (Edit > Project Settings > Player > XR Settings)

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

Daydream-specific settings in VR SDK list
Daydream-specific settings in VR SDK list

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 with editorial review

  • Google VR documentation updated for Unity XR API in 2017.3

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

对文档有任何疑问,请移步至开发者社区提问,我们将尽快为您解答