Merge pull request #1508 from ultraleap/bug/UNITY-1246-DeviceTransform_Leap2_windows

include and use LeapC API for device transform available

Author: MattGrayUL

Packages/Tracking Preview/package.json

@@ -1,12 +1,12 @@
 {
   "name": "com.ultraleap.tracking.preview",
-  "version": "6.12.0",
+  "version": "6.12.1",
   "description": "Ultraleap Tracking Preview",
   "displayName": "Ultraleap Tracking Preview",
   "unity": "2021.3",
   "license": "Apache-2.0",
   "dependencies": {
-    "com.ultraleap.tracking": "6.12.0",
+    "com.ultraleap.tracking": "6.12.1",
     "com.unity.inputsystem": "1.5.0"
   },
   "keywords": [
@@ -23,8 +23,8 @@
   },
   "samples": [
     {
-      "displayName": "Examples",
-      "description": "A collection of examples for the Preview package",
+      "displayName": "Preview Examples",
+      "description": "A collection of examples for the Ultraleap Tracking Preview package",
       "path": "Examples~"
     }
   ]

Packages/Tracking/CHANGELOG.md

@@ -6,6 +6,46 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 [docs-website]: https://docs.ultraleap.com/unity-api/ "Ultraleap Docs"
 
+## [6.12.1] - 28/09/23
+
+### Tracking Client versions
+- Windows 	v5.16.0
+- MacOS 	v5.16.0
+- Android 	v5.16.0
+
+### Fixed
+- (leapXRServiceProvider) Hands offset incorrectly on Windows when using Leap 2
+
+### Known issues 
+- Use of the LeapCSharp Config class is unavailable with v5.X tracking service
+- Repeatedly opening scenes can cause memory use increase
+- Currently the Ultraleap Hand Tracking feature for OpenXR requires the New and Legacy input systems to be enabled, to simultaneously use OpenXR and the Ultraleap Unity Plugin's features.
+- The OpenXR Leap Provider does not currently support the `Confidence` hand property (and will return fixed values)
+- After using Ultraleap OpenXR in Unity Editor, the tracking mode of device 0 will be set to HMD until the Unity Editor session ends. This can stop the testing of non-XR scenes until the Unity Editor is re-opened
+- Running both the Ultraleap XRHands Subsystem and another XRHands Subsystem at the same time causes unstable results. Only enable one at a time.
+
+
+## [6.12.0] - 12/09/23
+
+### Added
+- (MRTK Support) Added an MRTK3 subsystem for using Leap tracking directly (non-OpenXR)
+
+### Changed
+- (XRHands) XRHands subsystem will now use existing LeapXRServiceProviders found in the scene before considering generating new ones
+
+### Fixed
+- (XRHands) XRHands double-translates tracking data causing XRI InputActions to be wrongly positioned when the XROrigin is moved
+
+### Known issues 
+- Use of the LeapCSharp Config class is unavailable with v5.X tracking service
+- Repeatedly opening scenes can cause memory use increase
+- Currently the Ultraleap Hand Tracking feature for OpenXR requires the New and Legacy input systems to be enabled, to simultaneously use OpenXR and the Ultraleap Unity Plugin's features.
+- The OpenXR Leap Provider does not currently support the `Confidence` hand property (and will return fixed values)
+- After using Ultraleap OpenXR in Unity Editor, the tracking mode of device 0 will be set to HMD until the Unity Editor session ends. This can stop the testing of non-XR scenes until the Unity Editor is re-opened
+- The OpenXR Leap Provider palm can be in unexpected position when using pre-1.4.3 OpenXR Layer. A workaround is to ensure you use 1.4.3 or newer - installed by the 5.12.0 or newer Tracking Service Installer
+- Running both the Ultraleap XRHands Subsystem and another XRHands Subsystem at the same time causes unstable results. Only enable one at a time.
+
+
 ## [6.12.0] - 12/09/23
 
 ### Added

Packages/Tracking/Core/Runtime/Plugins/Android/libs/libLeapC.so

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:17beab110ca59c2571da19d0defa40e2f150424623f756e983530e7c3f79b7a7
-size 6553848
+oid sha256:2c69374a1861ee2804d7a466419e73963f0f2836667ff484ab9d973578c765f0
+size 7320552

Packages/Tracking/Core/Runtime/Plugins/LeapCSharp/Device.cs

@@ -263,6 +263,15 @@ public Pose DevicePose
                     return devicePose;
                 }
 
+                bool deviceTransformAvailable = LeapC.GetDeviceTransformAvailable(Handle);
+
+                if (!deviceTransformAvailable)
+                {
+                    devicePose = Pose.identity;
+                    poseSet = true;
+                    return Pose.identity;
+                }
+
                 float[] data = new float[16];
                 eLeapRS result = LeapC.GetDeviceTransform(Handle, data);
 

Packages/Tracking/Core/Runtime/Plugins/LeapCSharp/LeapC.cs

@@ -1052,6 +1052,9 @@ public static eLeapRS GetDeviceCount(IntPtr hConnection, out UInt32 deviceCount)
         [DllImport("LeapC", EntryPoint = "LeapGetDeviceInfo", CharSet = CharSet.Ansi)]
         public static extern eLeapRS GetDeviceInfo(IntPtr hDevice, ref LEAP_DEVICE_INFO info);
 
+        [DllImport("LeapC", EntryPoint = "LeapDeviceTransformAvailable")]
+        public static extern bool GetDeviceTransformAvailable(IntPtr hDevice);
+
         [DllImport("LeapC", EntryPoint = "LeapGetDeviceTransform")]
         public static extern eLeapRS GetDeviceTransform(IntPtr hDevice, [MarshalAs(UnmanagedType.LPArray, SizeConst = 16)] float[] transform);
 

Packages/Tracking/Core/Runtime/Plugins/MacOS/libLeapC.dylib

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4da6b779439167c951080f1e2720544f091c2c1de9a448b9e1e831fd6c4cc6aa
-size 11808032
+oid sha256:fd734f979881e750792b988a6e263117baf013282e97ac07ee5f3fdda8e8fff2
+size 12090352

Packages/Tracking/Core/Runtime/Plugins/x86_64/LeapC.dll

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d7b2d7ac37f5a4ec6d931ff3e688b0fcc4b7c8016f40cf0beca64704b6eb3985
-size 11108144
+oid sha256:3e2c363d9f8ae2cad0fc7af3182b5bc5641d832e455b5c522ca76f98eb9f942a
+size 13313328

Packages/Tracking/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.ultraleap.tracking",
-  "version": "6.12.0",
+  "version": "6.12.1",
   "description": "Ultraleap's Unity Plugin enables the data produced by Ultraleap tracking hardware to be used by developers inside their Unity projects. It includes various utilities and prefabs that make it as easy as possible to design and use hand tracking in XR projects",
   "displayName": "Ultraleap Tracking",
   "unity": "2021.3",
@@ -21,8 +21,8 @@
   },
   "samples": [
     {
-      "displayName": "Examples",
-      "description": "",
+      "displayName": "Interaction Examples",
+      "description": "A collection of XR and non-XR interaction examples for the Ultraleap Tracking package",
       "path": "Examples~"
     }
   ]