PluginKit SDK Tutorials

List Setting up the build environment Selecting the device Declaring VR DeviceServices

Setting Up the Build Environment

• Make sure Android Studio is installed.
• Make sure to use Android API Level 23 or later.
• Download and import the VIVE Wave™ PluginKit (wvr_pluginkit.aar).
• Add the required libraries in build.gradle.

Selecting the Device

There may be a lot of HMDs and controllers installed on your device at the same time. You need to select the HMD and controller that will be used by the VIVE Wave™ Settings AP.

Declaring VR DeviceServices

1. Write AndroidManifest.xml

For every VR DeviceService you want to use in your VR App, you need to declare the VR DeviceService in the AndroidManifest.xml so that the VIVE Wave™ Server will know it exists.

<category android:name="com.htc.intent.category.VRDEV" />

Additionally, if the VR DeviceService is an HMD, you need to add this line:

<meta-data android:name="supportHmd" android:value="true" />

Or if the VR DeviceService is a controller, you need to add this line:

<meta-data android:name="supportController" android:value="true" />

2. Implement : VRDeviceService

3. Implement : VRDevice

   • isConnected

   • setupConfig

   • Proximity (HMD only)

     • ProximitySensorState

Pluginkit SDK Samples

Wave VR provides a sample DeviceService in SDK/samples/SimpleDevice. SimpleDevice includes the HMD, controller, and external tracker.

External device properties for HMD

The pluginkit can also acquire a set of specified device properties from the HMD device service. Please refer detail description in the following portion. Detail for HMD external device propeties