Microsoft Mixed Reality Toolkit v2.8.2

Mixed Reality Toolkit 2.8.2 is now available for download via GitHub and the Mixed Reality Feature Tool. This update provides key fixes for applications targeting Microsoft or Oculus devices, as well as performance improvements. For complete details, please see the release notes.

Download

• [Recommended] Mixed Reality Feature Tool
  When using Unity 2019.4 or newer, MRTK is available using the Mixed Reality Feature Tool. For more information, please see Welcome to the Mixed Reality Feature Tool.

• Import asset (.unitypackage) files
  When using Unity versions older than 2019.4, please scroll down to Assets and download to a known location (typically, this is the Downloads folder on Windows 10):

  • Microsoft.MixedReality.Toolkit.Unity.Foundation.2.8.2.unitypackage
  • [Required if upgrading, optional otherwise] Microsoft.MixedReality.Toolkit.Unity.Tools.2.8.2.unitypackage
  • [Optional] Microsoft.MixedReality.Toolkit.Unity.Examples.2.8.2.unitypackage
  • [Optional] Microsoft.MixedReality.Toolkit.Unity.Extensions.2.8.2.unitypackage
  • [Optional] Microsoft.MixedReality.Toolkit.Unity.TestUtilities.2.8.2.unitypackage

Once downloaded, you can set the target platform and import the desired packages using these instructions.

Getting started

To help get started using MRTK v2.8.2, please see the Welcome page, which covers software requirements and the initial steps required to use MRTK.

Release notes

Please see Release Notes for information on new features, known issues and changes.

What's Changed

• [2.8.1] Fix null ref in WindowsMixedRealityXRSDKArticulatedHand by @keveleigh in #10622
• Fix cursors spawning at the root on initial source detection by @keveleigh in #10623
• 2.8.1 cherry-picks from main by @keveleigh in #10624
• Fix a reference issue in ClippingPrimitive by @MaxWang-MS in #10627
• Fixed issue where Controller Visuals weren't initialized before OnSourceDetected by @RogPodge in #10625
• Fixing bug due to missing flag ifdefs by @RogPodge in #10628
• Bounding box of SkinnedMeshRenderer support added by @lvonasek in #10611
• Update caches systems references to be actual caches and not an additional 0(n) lookup by @SimonDarksideJ in #10606
• Add demand due to current image issue (port of #10642) by @keveleigh in #10648
• [2.8.1] perf pass by @keveleigh in #10643
• Update CameraFOVChecker.cs to fix .NET build in Unity 2018 by @keveleigh in #10654
• Update the links to our docs and API ref page by @MaxWang-MS in #10670
• Add support for "select" voice command with OpenXR by @MaxWang-MS in #10661

New Contributors

• @lvonasek made their first contribution in #10611

Full Changelog: v2.8.0...v2.8.1

HoloLens 2 and ARM64

There is a known compiler issue that impacts applications built for Microsoft HoloLens 2 using ARM64. This issue is fixed by updating Visual Studio 2019 to version 16.8 or later. If you are unable to update Visual Studio 2019, please import the Tools package to apply a workaround.

• [Mixed Reality Feature Tool] com.microsoft.mixedreality.toolkit.tools
• [.unitypackage] Microsoft.MixedReality.Toolkit.Tools.2.8.2.unitypackage

Upgrading

Please review the Upgrade Guide for guidance on how to upgrade existing projects.

Note that the Tools package is now required when upgrading to a newer version of MRTK. It includes the migration tool, which automates the updating of projects assets to account for some changes in MRTK.