upgrading to ULTRALEAP gemini v5.2+

To develop Ultraleap Gemini we rebuilt our tracking engine from the ground up, and made some changes to how things work. These changes enable very exciting new integration possibilities. But there are also breaking changes.

DO YOU NEED TO UPGRADE YOUR TOOLS?

If you have an application built with a previous version of our Hand Tracking Software and any of our developer tools for Unity, Unreal, or our LeapC API, then you will need to upgrade these tools so they work with Ultraleap Gemini. Upgrading involves just a few simple steps.

An application built with any prior version of the following will not be compatible with Ultraleap Gemini V5.2+ Hand Tracking Software:

• Ultraleap Hand Tracking Software (i.e. V5.0.0 preview, V4.x, V3.x SDK or V2.x)

• Ultraleap Unity Modules (i.e. V4.8.0 and below)

• Ultraleap Unreal Plugin (i.e. V3.7.11 and below)

• Ultraleap OpenXR Hand Tracking API Layer (i.e. V1.0.0-beta2 release and below)

The following applications will not be compatible with Ultraleap Gemini V5.2+ Hand Tracking Software:

• TouchFree V2.0 and below

Migrate to ultraleap Gemini V5.2+ Hand Tracking Software

We recommend uninstalling any previous versions of Ultraleap Hand Tracking Software manually, then installing V5.2+.

The V5.2+ software installation will not automatically remove a previous installation.

This means that you can potentially have more than one version installed. However, this will lead to conflict between the services when connecting to an Ultraleap camera.

Steps for migration from V4, V4.1, V5.0.0 preview, and an application that is using:

• The LeapC API

  • Install the SDK from the Gemini V5 Hand Tracking Software installer

  • Update to use the new LeapC libraries

  • The LeapC API is backwards-compatible with V4. This means you do not need to make changes to your code if you want to update your application to be compatible with V5.2. Simply integrate the new SDK library (specifically the LeapC.dll file) and re-compile your application. The SDK library is included in the software installer.

• Unity modules

  • Install the latest Unity Plugin (V5.0.0+)

  • Follow our migration guide, using OpenUPM or .unitypackage files

• Unreal modules

  • Install the latest Unreal Plugin (V4.0.3+)

  • Update to use the new Unreal plugin

• Ultraleap OpenXR Hand Tracking API Layer

  • Install the latest Ultraleap OpenXR Hand Tracking API Layer (V1.0.0+)

Steps for migration from V4, V4.1, V5.0.0 preview, and the following applications:

• TouchFree V2.0 and below

  • Uninstall/remove previous versions of TouchFree

  • Install TouchFree 2.1 to use it with Gemini V5.2

Visit our troubleshooting page for FAQs and more.