This guide shows you how to set up Google VR development with Unity and build a demo Cardboard app for iOS.
Set up your development environment
You'll need an iPhone 5 or higher, running iOS 8.0 or higher.
You'll need a Cardboard viewer.
- Recommended version: LTS release 2017.4 or newer
- Minimum version: 5.6
Make sure that the iOS Build Support component is selected during installation.
- Make sure your environment is configured for iOS development.
Refer to Unity's guide for Getting started with iOS development.
Download the Google VR SDK for Unity
Download the latest
GoogleVRForUnity_*.unitypackagefrom the releases page.
The SDK includes the following demo scenes for Cardboard:
Scene Description GvrDemo Simple VR game in which you find and select a cube VideoDemo Shows various ways to use stereo or 360° video through playback or remote streaming
Create a new Unity project and import the Google VR Unity package
Open Unity and create a new 3D project.
Select Assets > Import Package > Custom Package.
GoogleVRForUnity_*.unitypackagefile that you downloaded.
In the Importing Package dialog, click Import.
Accept any API upgrades, if prompted.
Configure build settings and player settings
Select File > Build Settings.
Select iOS and click Switch Platform.
In the Build Settings window, click Player Settings.
Configure the following player settings:
Setting Value Player Settings > Other Settings > Virtual Reality Supported Enabled Player Settings > Other Settings > SDKs Click + and select Cardboard Player Settings > Other Settings > Target minimum iOS version 8.0 or higher Player Settings > Other Settings > Bundle Identifier Follow reverse the DNS format suggested by Apple
Preview the demo scene in Unity
In the Unity Project window, go to Assets > Google VR > Demos > Scenes. Open the GVRDemo scene.
Press the Play button. In the Game view you should see a rendered demo scene.
Note that although the scene here is monoscopic, the rendering on your phone will be stereo.
Interact with the scene using simulation controls:
Type Simulated action What to do Head movement Turn your head Hold Alt + move mouse Tilt your view Hold Control + move mouse Cardboard input Button press Click anywhere in the Game view
Build and run the demo scene on your device
Connect your phone to your computer using a USB cable.
Select File > Build and Run.
Unity builds your project and opens the generated Xcode workspace.
Put the phone in your viewer and try out the demo.