Tutorials

This section provides several tutorials to help you learn how to use the VIVE Wave™ SDK to develop VR applications to run on Android devices.

The VIVE Wave™ runtime is constructed using a 3-way client-server-pluginkit architecture.

  • Client is the interface that accesses the runtime and builds the content scene and logic.
  • Server is the runtime core that routes the tracking data of VR accessories to the client and manages the common properties, resources, and settings of the VR system.
  • Pluginkit is the device driver of the VR accessory that sends tracking data and user interaction data to the runtime.

In one Android device, multiple client applications can connect to the same server that has multiple VR device drivers plugged-in. Upgraded servers and plugins are backward compatible with previously published client applications. This backwards compatibility makes it easier to maintain the server and extend VR accessories.

When developing an application, you can use the activity type: com.htc.vr.sdk.VRActivity. The design of your application will determine the activity type. The client activity will start the server in the background for your application, and generate an OpenGL context for your content to draw.

To access the life cycle of VRActivity, your project needs to import VIVE Wave™ repository with wvr_client. Add this in your build.gradle:

apply from: "$projectDir/build_sdk.gradle"

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.0'
        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.3.50'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven {
            // assign your wavevr local respository
            url "your_SDK_local_path/repo"
        }
    }
}

Note

  • After Download Wave SDK, repository with wvr_client located at your_SDK_local_path/repo.

Also add the dependency with the build.gradle module:

dependencies {
    compile 'com.htc.vr:wvr_client:+'
}

Note

  • If using VIVE Wave SDK version older than 3.2.0, you need wvr_client.aar to compile your project.
  • After Download Wave SDK, wvr_client.aar located at your_SDK_local_path/libs. See below:
apply from: "$projectDir/build_sdk.gradle"

repositories {
    flatDir{
        dirs 'libs'
    }
}
dependencies {
    compile 'com.htc.vr.aar:wvr_client.aar'
}

After preparing your build environment, check out the advanced tutorials below.

Advanced Tutorials

VRActivity with Native Code Creating an application using JNI.
Developing with the SDK More information regarding the SDK API.
Render Runtime Tutorials Shows how to use usage of render runtime.
Distortion Correction Theory Explans the distortion theory.
PermissionManager Shows how to use PermissionManager.
IMEManager Shows how to use IMEManager.
Developing with the SDK Overlay Shows how to use WVR Overlay.
Stopping Content from Appearing in Screenshots Shows how to protect your content.
Pose Prediction Shows how to enable pose rotation/position over different devices.
How to support 64-bit VR APP Shows how to configure your VR app to support 64-bit.
64 bit Support Limitation Gives information about the limitations of 64bit support.
Debug your application Shows how to debug your application.
Fade current Activity Shows how to fade a current Activity when starting a new Activity.
WaveVR AdaptiveQuality tutorial Introduces the WaveVR adaptiveQuality.
Cast Support Limitation Shows how to support Cast