Guide to migrate a GVR project to Cardboard.

AI-generated Key Takeaways

• This guide explains how to migrate Unity projects from the deprecated Google VR (GVR) to the Cardboard XR Plugin.

• The migration process involves exporting the GVR project's scene, creating a new project in a compatible Unity version, importing the scene, and then importing the Cardboard SDK.

• Specific adjustments to scene settings, such as adding scripts and components, are needed for the project to function correctly with the Cardboard plugin.

• The final step is to configure and build the project according to the Cardboard Quickstart guide.

This guide shows you how to migrate Unity projects from the deprecated Google VR (GVR) to use the Cardboard XR Plugin.

Note: To demonstrate the migration, you'll use HelloVR, a demo game provided by the Google VR SDK for Unity, to directly visualize the changes and adaptations needed. Configurations for other application scenes may vary based on their specific requirements and functionalities.

Set up your development environment

Software Requirements:

• Unity 2021.3.32f1 or later supported by the Cardboard XR Plugin.
  • Make sure to include Android and iOS Build Support during installation.

Open your GVR project and export the scene without the GVR package.

Follow these steps to open your existing GVR project and export the scene.

1. Open your Unity project using GVR.

2. In Unity, go to Assets > Export package to export the current project.

   

3. Unselect all folders containing scripts to avoid compiling errors when importing the project on a newer version of Unity, as it does not support GVR.

   

Create a new project on a newer version of Unity and import your project.

1. Open a newer version of Unity supported by Cardboard XR Plugin (Unity 2021.3.32f1 or later) and create a new 3D project.

2. Import the GVR project.

   

Import the Cardboard SDK.

1. Import the Cardboard SDK following the Quickstart for Google Cardboard for Unity.

Adjust the scene settings to be supported by Cardboard.

Note: The following steps are necessary specifically for the HelloVR sample to function as intended. This section might differ when configuring other applications.

1. Add the ObjectController script to all interactive objects in the scene.

   1. On the Hierarchy panel navigate to Treasure and select the Icosahedron shape

      

   2. On the Inspector panel on the left, in the Script component, select the ObjectController script.

      

   3. Repeat the process on all three shapes.

2. Drag the script CardboardReticlePointer.cs to Player > Main Camera > GVRReticlePointer.

   The script is located at Packages/com.google.xr.cardboard/Runtime/CardboardReticlePointer.cs.

   

3. Drag the script CardboardStartup.cs to the CubeRoom.

   The script is located at Assets/Samples/Google Cardboard XR Plugin for Unity/<version>/ Hello Cardboard/Scripts/CardboardStartup.cs.

   

4. Select Player > Main Camera and, in the Inspector panel, add the component Tracked Pose Driver.

   

Configure and build your project.

1. Follow the configuration guide provided in the Quickstart for Google Cardboard for Unity for your respective device.