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 in SteamVR for how to setup SteamVR and check camera availability before using Vive Hand Tracking SDK.

Binary is located at libs/Windows64/aristo_interface.dll, linker lib is located in the same folder.

  • The library requires ViveVR_api.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.
  • Make sure to test camera frame rate in SteamVR settings before start application.

WaveVR (Vive Focus)

Binary is located at libs/WaveVR/armeabi-v7a/libaristo_interface.so and libs/WaveVR/arm64-v8a/libaristo_interface.so.

  • 32-bit library requires wvr_client.aar from WaveVR 2.1.8 or newer. It should already exist in your app if you are targeting WaveVR.
  • 64-bit library requires wvr_client.aar from WaveVR 3.1.1 or newer. 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.

Android Phones

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

  • The android library works for non-VR, Cardboard and Daydream.
  • 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.