Jump to content

[Tutorial] Getting started with development on Vive platforms


Recommended Posts

You can quickly get started with Android based VIVE platforms. By integrating with our Wave sdk, you can support all mobile Android (AIO) devices and we will be showing step by-step instructions on how to quickly get development rolling.

1) Install a LTS version of unity
Download and install unity hub https://unity3d.com/get-unity/download .

a) After installing, switch to the "installs" tab of the unity editor


b) Click the "Install Editor" button

c) When installing, make sure to install the modules windows, android, "Android build support", "Android SDK&NDK tools", "OpenJDK", which are needed to create builds for the platforms that vive runs on.

2) Create a new project using the "VR template"


a) Select "New project"

Select the "VR Template", hitting the "Download template" first if that button shows up, like it does below

b) Create the project, give it a "Project name" and path that you can find again later. 
Here, I'll be calling my Project "Hello VR" 🙂
Then click the "Create project" button

3) Connect your project to the VIVE ecosystem!
a) Open the Package manager, by selecting "Window->Package Manager"

b) Select the gear icon, here circled in red
c) Fill in a new entry for VIVE in the "Package Manager Settings" and hit save
Name: Vive
URL: https://npm-registry.vive.com/
Scope(s): com.htc.upm

d) Switch back to the package manger tab and select the new entry "My Registries"

e) Install the "Vive Wave XR Plugin" by selecting "Vive Wave XR Plugin" entry, and selecting the "Install" button in the lower right of the panel

4) Enable the wave xr plugin

a) open "Project Settings" tab, select "XR Plug-In Management" , then select the android tab underneath the text "XR Plug-in Management"



5) Set up the Android Manifest to finish configuration

a) Select the menu option "Project settings->Wave XR" and open the "PlayerSettings Configure Dialog"


b) A new popup window should be showing. Click "Accept all" to set up your project correctly for the app


c) Wait until you see the confirmation dialog 


5) Set up the Android Manifest for your project. This configures the app and is a critical step to ensuring that the program works as expected

a) Download the file linked here

b) Copy the file to a new directory in your project "Plugins/Android", so that the file lives in your project at the path "Plugins/Android/AndroidManifest.xml"
In your "Project tab" it should appear like the image below

c) Enable a custom android manifest in your "Player Settings" tab, under android.
The player settings tab can be found by selecting "build settings" then selecting the "Player settings" button and the "Publishing Settings" sub tab (there are a lot of settings, so you may need to scroll down)




6) Add the sample scene to your project. 

a) Open the "Build" window, by selecting "File->Build Settings"


b) In the project view, find the "Sample Scene" and drag it on to the "Scenes in build" section of the "Build Settings" Window, so that it shows up like this:

7) Run the app!

a)  In the headset, go to settings->Advanced and enable "USB Debugging" and "Install Unknown apps"

b) Connect your focus3 to the pc running unity with a usb cable, accept permissions if a dialog comes up


c) Inside of unity's build window, select "Build and run" to build the app and show it in your device!

name the build

Wait for build

😎 Enjoy the developing for VR!

If you want to compare what you have against a finished version of the tutorial, the project is also available here:

And if you just want to compare your build against an official one, this is a copy of the apk, which can be installed using adb ( https://techcult.com/install-apk-using-adb-commands/ )


  • Like 1
Link to comment
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
  • Create New...