rsanchezsaez / CardboardSDK-iOS

iOS port of Google's CardboardSDK (mobile VR toolkit)
Other
334 stars 104 forks source link

CardboardSDK-iOS

March 2016 update

Google has released an official iOS CardboardSDK. However, for now it's a closed source precompiled library.


iOS port of Google's CardboardSDK.

Treasure example fully running with magnetic trigger detection. Successfully tested on an iPhone 6 running iOS 8 and on a iPhone 5 running iOS 7.

It (mostly) has feature parity with Android's CardboardSDK v0.5.1.

Unity

There is a bundled sample Unity project compatible with Unity 5.0.0f4 (use other Unity versions at your own risk).

The Unity\Cardboard.UnityProject folder contains the sample project based on Google's CardboardSDK-Unity plugin.

Unity Instructions

There are two ways of running the Unity project on an iOS device:

a. Pre-built Unity Xcode project

You can use the bundled pre-built Unity Xcode project, but you need to regenerate libiPhone-lib.a, as it's too big to commit to GitHub.

This method is useful for updating the Xcode project after changing the Unity project or its Cardboard Unity scripts.

  1. Open the Unity project on Unity 5.0.0f4.
  2. Go to File -> Build Settings, choose iOS and click Build. Choose the already existing Unity\Cardboard.UnityProject\builds\iOS as the output folder and click on Append. Unity should then update your current project with the needed Unity library binary without overwriting the CardboardSDK native code.
  3. Open Unity\Cardboard.UnityProject\builds\iOS\Unity-iPhone.xcodeproj on Xcode and run on an iOS device (tested on Xcode 6.2).
b. Build your own Unity Xcode project

You can disregard the Unity\Cardboard.UnityProject\builds\iOS\ folder and build your own project from scratch.

This method is useful if you want to rebuild the Unity Xcode project after updating Unity to a newer version (newer Unity versions won't let you append to an already built Xcode project).

  1. Open the Unity project on Unity 5.0.0f4 or later.
  2. Go to File -> Build Settings, choose iOS, click Build and save it to any folder of your choosing.
  3. Open the built project on Xcode.
  4. Add the CardboardSDK source files to the Classes group: right click on Classes and choose Add files to "Unity-iPhone". Do not copy the CardboardSDK source, just link them at their original location by unchecking Copy items if needed.
  5. Add the GLKit framework: go to the Unity-iPhone target -> Build Phases -> Link Binary With Libraries and add the GLKit.framework.
  6. Go to Project -> Build Settings and set: C++ Language Dialect to GNU++11.

Unity Issues

General Todo

Discusion

Overlay Views

The CBStereoGLViewclass allows any UIView to be rendered to OpenGL. You can subclass it for your app overlay (lens distortion correction is correctly applied to it). See the TextOverlayView subclass on the Treasure example.

Avoid updating the texture on every frame as it's an expensive operation (performing UIView animations is not a good idea).

Headtracker

The HeadTracker can either use:

In general using HEAD_TRACKER_MODE_CORE_MOTION_EKF is recommended.

In HeadTracker.mm, you can set #define HEAD_TRACKER_MODE to either HEAD_TRACKER_MODE_EKF, HEAD_TRACKER_MODE_CORE_MOTION, or HEAD_TRACKER_MODE_CORE_MOTION_EKF.

General Issues

License & Contributors

CardboardSDK-iOS, as the original CardboardSDK, is available under the Apache license. See the LICENSE file for more info.

See AUTHORS.md for some of the project contributors.