Finch Logo

Documentation

GVR Unity SDK with Dash support

You develop applications by Unity for Google Daydream and Daydream-ready smartphones (for example Google Pixel)? You are looking for way to port your apllications to other VR-ready smartphones without functionality loosing?

You can do it with the help of GVR Unity SDK with Dash support absolutely painless

More customers You are granted more customers for your games by replacing few files in your Unity project.

Same functionality No lose functionality. Controller rotations, laser 3D-pointer, buttons and positions - your game doesn't lose anything. Touchpad is replaced by stick with button under it as same as under Google Daydream's touchpad.

Two versions of Unity projects are not necessary You can switch between controllers to build project by changing one option in Player Settings.

What is GVR Unity SDK?

Google VR Unity SDK enables Daydream and Cardboard app development in Unity.

You can download GVR Unity SDK here or clone here. Make sure that GVR Unity SDK version and Dash support patch version match.

How to port?

  1. Download GVR Unity SDK v1.10 Finch Dash support patch.unitypackage.
  2. Make backup of your Unity project.
  3. Open the Unity project in up-to-date version of Unity Daydream Technical Preview or Unity 5.6.0 or higher.
  4. Import Migration Package.unitypackage into your Unity project. Don't uncheck any checkboxes - Unity will replace some files.
  5. Done. Now your project supports both Google Daydream and Finch Dash.

How to build for Google Cardboard SDK with Finch Dash controller?

To build Unity project for Google Cardboard SDK with Finch Dash controller you need up-to-date version of Unity Daydream Technical Preview or Unity 5.6.0 or higher.

  1. In menu "File → Build Settings" (Ctrl + Shift + B) switch platform to Android (for confirmation press button "Switch Platform"). Build settings

  2. In menu "Edit → Project Settings → Player" set following values:

    2.1. Checkbox "Virtual Reality Supported" must be checked, set "Cardboard" as Virtual Reality SDK.

    2.2. Minimum API Level higher or equal than 21 (Android 5.0 ‘Lollipop’).

    2.3. Set “FINCH_DASH” in "Scripting Define Symbols".

    2.4. Also set “FINCH_DASH_TRIGGER” in "Scripting Define Symbols" to use Dash trigger as touchpad tap (to list use semicolon).

Player Settings - Dash.png

How to build for Samsung GearVR with Finch Dash controller?

To build Unity project for Samsung GearVR with Finch Dash controller you need Unity 5.6.0 or higher. If your project is configured for Google Cardboard SDK with Finch Dash controller (see "How to build for Google Cardboard SDK with Finch Dash controller?") you need make following changes:

  1. In folder "Assets/Plugins/Android/assets" put osig-file, bound with target Samsung smartphone. Osig-file creating process is written below. Note: it is neccessary to genereate another osig-file for another Samsung-smartphone.
  2. In menu "Edit → Project Settings → Player" set following values:

    2.1. Checkbox "Virtual Reality Supported" must be checked, set "Oculus" as Virtual Reality SDK.

    2.2. Minimum API Level higher or equal than 21 (Android 5.0 ‘Lollipop’).

    2.3. Set “FINCH_DASH” in "Scripting Define Symbols".

    2.4. Also set “FINCH_DASH_TRIGGER” in "Scripting Define Symbols" to use Dash trigger as touchpad tap (to list use semicolon).

PlayerSettings - Dash

How to create osig-file for Samsung smartphone?

  1. Connect your smartphone with Windows PC by USB.
  2. Open Android SDK folder on your Windows PC, find "adb.exe" in "platform-tools" folder.
  3. Open the "adb.exe devices" by Windows Command Prompt.
  4. Copy DeviceID to clipboard.
  5. Enter to web-page: https://dashboard.oculus.com/tools/osig-generator/.
  6. Paste DeviceID and press "Download file".

How to build for Google Daydream with Google Daydream controller?

To build Unity project for Google Daydream controller you need Unity 5.6.0 or higher. If your project is configured for Google Cardboard SDK with Finch Dash controller (see "How to build for Google Cardboard SDK with Finch Dash controller?") you need make following changes:

  1. In folder "Assets/Plugins/Android/assets" put osig-file, bound with target Samsung smartphone. Osig-file creating process is written below. Note: it is neccessary to genereate another osig-file for another Samsung-smartphone.
  2. In menu "Edit → Project Settings → Player" set following values: 2.1. Checkbox "Virtual Reality Supported" must be checked, set "Daydream" as Virtual Reality SDK. 2.2. Minimum API Level higher or equal than 24 (Android 7.0 ‘Nougat’). 2.3. Make sure that neither “FINCH_DASH” nor “FINCH_DASH_TRIGGER” options are set in "Scripting Define Symbols".

PlayerSettings

About Finch Dash

You can read more about Finch Dash controller on web-site https://finch-vr.com/dash.

GVR Unity SDK with Dash support