v5.2.0

5.2.0 (2024-07-31)

Bug Fixes

• Editor: Allow saving and loading deformation configuration via JSON (46bf685)
• Runtime: Correct bones job regenerates metadata with mask changes, fix hand wave (539cb0b)
• Runtime: Don't run correct bones job if weight is zero (b452051)
• Runtime: Fix CCDIK edge cases when the skeleton is scaled (ab0a8af)
• Runtime: Fix character's rest pose before humanoid asset is used (32895a6)
• Runtime: Fix correct hand assigning the wrong bone for the secondary IK target (1ab07df)
• Runtime: Fix external bone targets job when containing invalid bones (f56c881)
• Runtime: Fix incorrect bone mappings being set when spawning an inactive character (4acc069)
• Runtime: Fix locomotion animation playback direction for embodied character (5fa894c)
• Runtime: Fix OnDestroy job activity for ExternalBoneTargets (24cc82f)
• Runtime: Force character into t-pose when adding retargeting components to it (418c235)
• Runtime: Handle CCDIK cases where the bones aren't directly hierarchical (0cdafa8)
• Runtime: Optimize CCDIK performance by using poses (f0e2e54)
• Runtime: Remove retargeting layer in AddMainRetargetingComponent (801e8e7)
• Runtime: Skip DrivenTransform in proxy transform update if the DrivenTransform is null (be1bb3f)
• Samples: Retargeted uses correct bones with finger accuracy, jobs enabled (c29802c)
• Samples: Update ISDK sample to be more accurate (b4f897a)

Features

• Editor: Add functionality to update the current skeleton to the animator's avatar humanDescription (02cdf82)
• Editor: Add JSON read/write for RetargetingLayer and RetargetingProcessor (0350d55)
• Editor: Update one-click retargeting to take into account hand proportions for setting the finger position correction weight (ae76d7b)
• Editor: Update the one-click retargeting constraint setup (4189415)
• Runtime: Add arm length multiplier to full body deformation constraint (86c7028)
• Runtime: Add OVRControllersHands positions sync option for RetargetingProcessorCorrectHand (922e374)
• Runtime: Add public config functions LateMirroredObject (c6ba3c5)
• Runtime: Add public JSON loading API to retargeter classes (cd16f3a)
• Runtime: Add UpdateToAnimatorPose to AnimationUtilities (ca3dad3)
• Runtime: Add use secondary bone id option for the correct hand IK processor (a154d6d)
• Runtime: Allow jobs for retargeting processors (43a7be2)
• runtime: Allow specifying arm chain bones for arm IK (9108de5)
• Runtime: ARKitFace forces usage of proper mapping value (fa2ed7f)
• Runtime: Chain proxy target jobs (30c7c45)
• Runtime: Change HelperMenusBody access to public (9feca2c)
• Runtime: Combine blend and correct hand processors (d4dadf1)
• Runtime: Control positions and rotations on PlaybackAnimationConstraint (e42342a)
• Runtime: Custom playback of PlaybackAnimationJob (31b7fd2)
• Runtime: Disable updating RT constraint adjustments from editor (7a7dd55)
• Runtime: Improve shoulder roll to be more accurate in its function (b37a37f)
• Runtime: Move JSON functions to deformation constraint class (b9d5240)
• Runtime: Optimize FABRIK (ce3153f)
• Runtime: PlaybackAnimationConstraint can mask by individual bone (26fdec7)
• Runtime: RetargetingLayer supports jobs-base processors (d0776fc)
• Runtime: Update RetargetingProcessorCorrectHand sync with OVRControllersHands to also optionally sync rotations (a1c9b30)
• Runtime: Use a job to update proxies (e672abb)
• Runtime: Use jobs for external bone targets (d39e9de)

v5.1.0

5.1.0 (2024-05-17)

Bug Fixes

• Runtime: Allocate bone mappings in RetargetingLayer to prevent null ref when adding at runtime (7211879)
• Runtime: Allow fixing spine rotations in deformation's ApplyOriginalSpineOffsets (0963b46)
• Runtime: Check for null retargeting processor gizmos (d1d1f88)
• Runtime: Enforce proper rest pose when using animation rigging retargeting (92eadc3)
• Runtime: Properly align feet in hip pinning sample (21bdcbc)
• Runtime: Update the ISDK sample mug material to be compatible with URP (ec01def)
• Samples: Fix finger and shoulder accuracy with ISDK scene (cb791d6)
• Samples: Fix initial rotation issue with hip pinning (cf6bc80)
• Samples: Update Aura with constraints (521f246)

Features

• Editor: Recommend four bones for skinning in project setup tool (db7a615)
• Editor: Support auto mapping TongueOut for ARKitFace (bcb30a6)

v5.0.1

5.0.1 (2024-04-22)

Bug Fixes

• Editor: Update retargeting one-click for multiple upper body objects (f2c1dc2)
• Samples: Disable normals on animation clips that copy from other avatar (b2d497e)

v5.0.0

5.0.0 (2024-04-19)

Bug Fixes

• Editor: refresh bones on object change (5b9493b)
• Editor: refresh bones on scene change (c9d0398)
• Editor: Update spine adjustments calculation to affect only one axis (8bc9397)
• Runtime: Add explicit dependency to burst in the Movement package (34025a0)
• Runtime: Fix deformation's toes interpolation (5c0e126)
• Runtime: Fix edge case with AnimatorBoneVisualizer's TryGetBoneTransforms (336ea4f)
• Runtime: Fix warnings for unused retargeted bone mappings (c1ba908)
• Runtime: Optimize performance of retargeting (7beeb41)
• Runtime: RetargetingProcessorCorrectBones interpolates using adjustments, fix finger position weight usage (f51ea12), closes #1 #2
• Runtime: Use correct world-to-local transformation for start to end vector (f41a622)
• Samples: added chest to all bones listing (e957e08)
• Samples: added controllers forfitness to control UI (adf1582)
• Samples: Fix icon positioning of menu outline (c121fb9)
• Samples: hide skeleton lines when object disables (1d82ea1)
• Samples: renamed movement events (a273892)

Documentation

• Samples: Update README to new SDK version (ae7bc2e)

Features

• Editor: Update one-click retargeting with new parameters (a827e6f)
• Runtime: Add support for automated custom bone mappings in retargeting (df044c1)
• Runtime: Add the shoulder roll property for deformation (1e4dfa0)
• runtime: BodyTrackingForFitness sample (0bfa946)
• Runtime: Deformation allows straightening spine (5901e5a)
• Runtime: Finger position correction weight (d49cb39)
• Runtime: Optimize more, and clean up (7d530fa)
• Runtime: Original spine offsets should be proportional (90b248a)
• Runtime: Update retargeting blend hand processor for tracked head options (24778ba)
• Samples: Show hands or controllers with disembodied character (1ae5cdc)

BREAKING CHANGES

• Runtime: Updated bone mappings requires V63 SDK.

V63 SDK introduces the OVRHumanBodyBonesMappingsInterface, which can be used to create custom bone pair mappings for retargeting. This feature adds support for that capability, adding the ability to set the bone mappings based on which optional bones are present on the Unity humanoid.

The automatic mapping maps the HumanBodyBones.Chest bone to the OVRSkeleton.SpineMiddle bone, for a better result with the spine retargeting on most characters. However, if there is a missing UpperChest bone, the OVRSkeleton.SpineUpper bone will be mapped instead. These mappings can be modified in the inspector under Retargeted Bone Mappings.

• Samples: using v63 instead of v60

Updated references to the correct SDK version.
Updated instructions for adding a Camera Rig.
Added troubleshooting note about attempting to run scenes form the Packages folder (they may need to be copied to /Assets).

v4.4.0

4.4.0 (2024-03-13)

Bug Fixes

• Editor: Add FullBodyOVRSkeletonBoneVisualizerBoneTupleDrawer to display full body tuples (eb4e7cd)
• Editor: Fix one-click upper body retargeting setup (4e40556)
• Editor: Fix serialized legs weights display on new characters (294c70e)
• Runtime: Address foot target orientation for grounding (hip pinning) (0aabd0d)
• Runtime: Fix one-click setup for retargeted characters when the root isn't zero (868aa83)
• Runtime: Handle root motion edge case with 2022/2023 (7bf9a7f)
• Runtime: Improve auto adjustments axis calculation (5ed2139)
• Runtime: RetargetingHandProcessor uses absolute scale for hand world position (1d546d3)
• Runtime: Update auto adjustments for skeletons with a different rest pose right (30da68f)
• Runtime: Update bone visualizer to better reflect the bone mapping (6a88513)

Features

• Editor: Update auto adjustments calculation (24ad9d0)
• Runtime: Account for missing bones when calculating adjustments (5e8263d)
• Runtime: Add BlendHandConstraintProcessor (90e1dd3)
• Runtime: Add ExternalBoneTargets (0bc2fc0)
• Runtime: Add RetargetingAnimationRig (0739a30)
• Runtime: Add RetargetingHandDeformationProcessor (9bd4596)
• Runtime: Add upper body option to FullBodyDeformationConstraint (aa84fb9)
• runtime: Incorporate BlendHandConstraintProcessor (a78affd)
• Runtime: Incorporate ExternalBoneTargets (d72bb8f)
• Runtime: Integrate RetargetingAnimationRig (11a9c19)
• Runtime: Integrate RetargetingHandDeformationProcessor (3b05073)
• Runtime: Limit deformation's squash and stretch (2999663)
• Runtime: Update full body deformation arm weight behaviour (e586f7c)
• Runtime: Update upper body deformation for OVRCustomSkeleton (456c9ec)

v4.3.0

4.3.0 (2024-02-15)

Bug Fixes

• Runtime: RetargetingProcessorCorrectBones uses base class adjustments, update all adjustments in RtLayer (7fa22af)
• Runtime: Update AddComponentsRuntime with new adjustments (3fd5cd6)

Features

• Runtime: Add custom target hand position for correct hands and update one-click adjustments (46c642b)
• Runtime: Add FABRIK option for hand correction processor (0837ee4)
• Runtime: Add spine bone adjustments to deformation and automate adjustments (a38ed8f)
• Runtime: Automatic adjustments for retargeting and deformation on full body (5fec824)
• Runtime: Update feet placement for accurate head full body deformation (b8543cd)

v4.2.1

4.2.1 (2024-02-01)

Bug Fixes

• Runtime: Update tongue to use captured expression weights (d1fb642)

v4.2.0

4.2.0 (2024-02-01)

Bug Fixes

• Runtime: Check for invalid shoulders in FullBodyDeformationJob (6785b0c)
• Runtime: Check for null targetBone in CheckPossibleMetacarpal (50dc6fb)
• Runtime: Fix spawning positional problems in retargeting scene (70f0a7c)
• Runtime: Set initial shoulder stretch to be optional (3f55759)

Features

• Editor: Simplify full body deformation constraint parameters (79b3acb)
• Runtime: Add an option for using world hand position as the target (cc57dee)
• Runtime: Allow precomputation of adjustments (c3e8cde)
• Runtime: Put proxy bones under a parent transform (11733ed)
• Runtime: Update FullBodyDeformation with additional settings for shoulders and arms (576b0da)

v4.1.0

4.1.0 (2024-01-11)

Bug Fixes

• Editor: Update one-clicks for adding body tracking to disable apply root motion on animators (cb7b68c)
• Runtime: DeformationJob checks for animator avatar for bone queries (f91bb92)
• Runtime: Fix potential missing transform handle in CopyPoseJob (10dd1bc)

Features

• Runtime: Add shoulders adjustments when using the one-click for setting up body tracking (327ad57)
• Runtime: Check for humanoid, translation DoF for retargeting (591148f)
• Samples: Update Locomotion sample with character prefab (217a99a)

v4.0.1

4.0.1 (2023-12-21)

Bug Fixes

• Samples: Add OVRBody to high fidelity prefabs (3326a4f)