This repository was archived by the owner on Nov 8, 2019. It is now read-only.
GVR SDK for Unity v0.5.0
Upgrade Instructions
- Due to extensive changes in the plugin contents, it is recommended to delete the
Cardboard
directory and (if you have no other Android plugins) thePlugins/Android
directory before importing the v0.5 SDK.
Fixes
- If native code distortion correction is not supported, fall back to using an Image Effect.
- If native code UI layer is not supported, fall back to rendering it in Unity.
Additions
- The iOS build platform is now supported.
- Added a new C++ native code implementation for head tracking and distortion correction.
- The Java-based native code implementation has been moved to the Legacy folder.
- Refactored Cardboard.cs into a front-end Unity API and a back-end VRDevice class.
- VRDevice implementations provided for Android, iOS, and Unity editor.
- Some Cardboard properties have been renamed (but the old names still work).
- Added a Tilt event for when the viewer is turned on its side.
- Added C# events to Cardboard for responding to Trigger and Tilt events.
- Added more phone and viewer profiles to the in-editor simulation menus.
Deletions
- The
Cardboard.SDK.BackButtonExitsApp
property. - The
Cardboard.SDK.IsInCardboard
property.
Known Issues
- (Fixed in v0.5.2) Multi-threaded rendering: Currently not supported.
- Incorrect screen rectangle on some phones: There are several functions in Android to query the phone's dpi, from which the size of the screen is derived. For every such function, there are some phone models that return an incorrect dpi value, which leads to an incorrect screen size estimate.
- (Fixed in Unity 5.1) Unity 5 rendering issues: As of Unity build 5.0.0f4, the following steps should be taken to fix or ameliorate any rendering issues, such as an all-black screen, flashing textures, or non-stereo views:
- Enable the Development Build option in the Build dialog. This seems to fix various rendering glitches, like flashing textures.
The root cause of the rendering glitches is under analysis, with
assistance from Unity. Note: If you are using any Image Effects, make sure thatStereoController
's Direct Render property is set to false. Check if that fixes the issue first.
- Enable the Development Build option in the Build dialog. This seems to fix various rendering glitches, like flashing textures.
Changelog
- The iOS build platform is now supported.
- Added a new C++ native code implementation for head tracking and distortion correction.
- The Java-based native code implementation has been moved to the Legacy folder.
- Refactored Cardboard.cs into a front-end Unity API and a back-end VRDevice class.
- VRDevice implementations provided for Android, iOS, and Unity editor.
- Some Cardboard properties have been renamed (but the old names still work).
- Added a Tilt event for when the viewer is turned on its side.
- Added C# events to Cardboard for responding to Trigger and Tilt events.
- Added more phone and viewer profiles to the in-editor simulation menus.
- If native code distortion correction is not supported, fall back to using an Image Effect.
- If native code UI layer is not supported, fall back to rendering it in Unity.