Setup

Note

This section assumes you know the hardware requirements and features of the Vive Hand Tracking SDK. Please read Vive Hand Tracking SDK Overview section before this section.

Vive Hand Tracking SDK provides C/C++ API in a zip file, including headers, linker libs (Windows) and dynamic libraries. The header file is shared across all platforms, binaries are included in separate folder for each platform/architecture.

Based on different platform, process of setup may be different. Please refer to the sections below to setup each platform you use.

Windows

Note

SteamVR disables camera by default. This means a fresh installed SteamVR cannot use Vive Hand Tracking SDK without manual setup. See Camera Setup for how to setup SteamVR and check camera availability before using Vive Hand Tracking SDK.

Binaries are located at libs/Windows32/aristo_interface.dll and libs/Windows64/aristo_interface.dll, linker libs are located in the same folder.

  • The library requires cosmos_camera.dll (in the same folder) at runtime, please make sure to include it when distributing your final build.
  • The library requires Microsoft Visual C++ Runtime 2015 Update 3.
  • Hand detection is paused when HMD is took off. Please put on your HMD before using hand tracking.
  • 64-bit binary is preferred over 32-bit binary due to performance reasons.
  • Follow the steps in Camera Setup with SteamVR (Vive, Vive Pro or Valve Index) or Vive Console (Vive Cosmos) before start application.

WaveVR (Vive Focus)

Binaries are located at libs/Android/armeabi-v7a/libaristo_interface.so and libs/Android/arm64-v8a/libaristo_interface.so.

  • 32-bit library requires wvr_client.aar from WaveVR version 2.1.8 to 3.2.0. It should already exist in your app if you are targeting WaveVR.
  • 64-bit library requires wvr_client.aar from WaveVR version 3.1.1 to 3.2.0. It should already exist in your app if you are targeting WaveVR 64-bit.
  • You should declare camera permission in your AndroidManifest.xml. Camera permission should be granted before starting detection.
  • Both ARMv7 and ARMv8 binaries are provided in Vive Hand Tracking SDK. You should use ARMv8 version if possible, since it runs faster.
    • WaveVR 3.1.1 or later is required for ARMv8 support.

Note

Vive Focus 3 and WaveVR version 4.0 or later are not supported by Java plugin. See WaveVR Compatibility for details.

Google ARCore

Binaries are located at libs/Android/armeabi-v7a/libaristo_interface.so and libs/Android/arm64-v8a/libaristo_interface.so.

  • The native library is tested on Pixel.
  • Make sure your device support arcore. Follow ARCore supported devices to check whether your device is in supported device list or not.
  • Google Play Services for AR is necessary for running ARCore apps on your device. The latest version of Google Play Services for AR can be downloaded from Google Play Store or other application markets.
  • You should declare camera permission in your AndroidManifest.xml. Camera permission should be granted before starting detection.
  • Both ARMv7 and ARMv8 binaries are provided in Vive Hand Tracking SDK. You should use ARMv8 version if possible, since it runs faster.
  • The app must be in auto rotation orientation.

Android Phones

Binaries are located at libs/Android/armeabi-v7a/libaristo_interface.so and libs/Android/arm64-v8a/libaristo_interface.so.

  • The native library is tested on Pixel.
  • You should declare camera permission in your AndroidManifest.xml. Camera permission should be granted before starting detection.
  • Both ARMv7 and ARMv8 binaries are provided in Vive Hand Tracking SDK. You should use ARMv8 version if possible, since it runs faster.
  • The app must be in landscape left orientation.