Skip to content

License requirement

The functionality described requires a Feature style license with the SDK feature enabled, if you do not have such a license, please contact support at support@manus-meta.com.

SDK Integrated

The SDK can be used in two ways: integrated and remote. This article delves into what the integrated mode is, how and when to use it.

Introduction

The integrated mode of the MANUS SDK is a mode where no MANUS Core connection is required to connect the MANUS glove devices. The SDK will directly communicate with the glove devices. The SDK API is identical to the remote mode.

When to use

The integrated mode is useful in the following scenarios:

Linux only

MANUS Core does not work on Linux and still requires a separate machine to have its gloves connected to. In this case, the integrated mode is the only way to connect the gloves to the Linux machine.

Deep integration

When the application wants to have full control over the glove devices, and wants to handle glove calibration, pairing/un-pairing, tracking data, etc. themselves.

How to use

To enable integrated mode, the SDK initialization call should be made with the second parameter set to false. This will initialize the SDK in integrated mode. The SDK examples give users the choice to select between integrated and remote mode on startup.

const SDKReturnCode t_InitializeResult = CoreSdk_Initialize(SessionType::SessionType_CoreSDK, false);

On Windows platforms this is all that is needed to use the SDK in integrated mode. On Linux platforms, it's important to make sure the required packages are installed. Please refer to the installation instructions for more information.

Glove calibration

It's highly advised to integrate the glove calibration process into your application to achieve the most accurate data quality. The SDK provides the necessary functions to calibrate the gloves. More information on how to integrate glove calibration using the SDK can be found within the SDKClient example.

Limitations

The integrated mode does not have the full feature set that can be found in MANUS Core.

License requirement

The integrated mode requires a Feature style license with the SDK feature enabled. This new style of licenses is introduced in MANUS Core 2.4.0. If you do not have such a license and would like to aquire one, please contact support at at support@manus-meta.com.

Lack of Dashboard

Integrated mode does not communicate outwards, so there is no way to configure the gloves through the MANUS Core Dashboard or use any other of the features that are available in the Dashboard.

Such as:

  • Glove calibration
  • Pairing / Unpairing
  • Recorder
  • Exporter
  • Firmware updating
  • Networked devices

No built-in tracking system integrations

MANUS Core has support for various tracking systems, such as SteamVR, ART, Vicon. These integrations are not available in integrated mode. Tracking data can be sent to the SDK manually. More information on how to do this can be found here.

One glove pair maximum

Currently integrated mode only supports one glove pair. If multiple glove pairs are needed, remote mode with MANUS Core is required.