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.