Sanctuary

EECS 441 Project Team JEANJA - Unity

How to collaborate with Git and Unity

Project setup URL

File and Folder Structure

• Starter App - Contains frontend and Unity Environment Code
  • Assets

    • GoogleVR - Google VR SDK

    • Objects - objects used in VR Environments

      • Nature
      • Nature2
      • Survival_Objects
      • Treasurechest
      • FireplaceTest

    • Scenes - main base environment

  • ProjectSettings - asset files needed for Starter App
• sanctuary_backend - backend Django REST API for data collection
  • django_project - admin, apps, models, tests, and views
  • sanctuary_backend - settings, urls, wsgi
• sanctuary_android - Android application for sanctuary (instructions for setup coming soon)
  • app - app activities
    • build.gradle (app) - dependencies
  • build.gradle (module) - dependencies
• gvr-android-sdk-1.160.0 - GVR Android SDK
  • assets - some assets for use in app
  • libraries - SDKs for audio, base, commonwidget, controller, panowidget, videowidget

Backend Build Instructions

Access the Digital Ocean droplet by ssh root@68.183.103.97. Ask Nathan for the password.

1. Install Python 3 and Django
2. Navigate to sanctuary/sanctuary_backend
3. python manage.py runserver

VR Build Instructions

Required (iOS):
    (1) iPhone 5 or higher
    (2) iOS 8.0 or higher
Required (Android):
    (1) Daydream compatible phone
    (2) Min Android SDK of 19

Step 1: Install Unity

1. Recommended version: LTS release 2017.4 or newer here:
2. Minimum version: 5.6
   • Make sure iOS Build Support is selected during installation.

Step 2: Configure your environment for iOS/Android development

1. Refer to Unity's guide for Getting started with iOS development
2. Refer to Google's guide for Getting started with Android development

Step 3: Download the Google VR SDK for Unity

1. Download the latest GoogleVRForUnity_*.unitypackage

Step 4: Create a new Unity project and import the Google VR Unity package

1. Open Unity and create a new 3D project
2. Select Assets > Import Package > Custom Package
3. Select the GoogleVRForUnity_*.unitypackage file that was downloaded
4. In the Importing Package dialog, click Import
   • Accept any API upgrades if prompted

Step 5: Configure build settings and player settings

1. Select File > Build Settings
2. Select iOS and click Switch Platform
3. In the Build Settings window, click Player Settings
4. Configure the following player settings:
   • 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

Step 6: Preview the demo scene in Unity

1. In the Unity Project window, go to Assets > Google VR > Demos > Scenes. Open the HelloVR scene.
2. Press the Play button. In the Game view you should see a rendered demo scene.
   • Note: although the scene here is monoscopic, the rendering on your phone will be stereo.
3. Interact with the scene using simulation controls

Step 7: Build and run the demo scene on your device

1. Connect your phoe to your computer using a USB cable
2. Select File > Build and Run
   • Unity builds your project and opens the generated Xcode workspace.
   • Note: If you use Build Settings… > Build to build your project, be sure to open the generated *.xcworkspace workspace file in Xcode, not the included *.xcodeproj project file. Opening the project file will result in build errors.