What's new in version 6.0

New features

Bounding boxes

  • Added an API for provider plug-ins to implement the detection and tracking of 3D bounding boxes. Refer to Bounding box detection for more information.

Persistent anchors

Image Stabilization

  • Added support for Image Stabilization, which helps stabilize shaky video from the camera. Refer to AR Camera Manager component for more information.

XR Simulation occlusion

  • Added support for occlusion to XR Simulation, allowing you to test occlusion without deploying to device.

XR Simulation light estimation

Build AssetBundles window

  • Added an editor window in Assets > AR Foundation > Build AssetBundles that you can use to build AssetBundles containing XRReferenceImageLibrary objects.

Asynchronous anchor creation

Multiple classifications for planes

Added

Generic trackablesChanged event

  • Added a generic ARTrackableManager.trackablesChanged event to replace all previous trackables-changed events (ARPlaneManager.planesChanged, etc). This simplifies the code needed to work across all managers.
    • This new event can be used in the Inspector.
    • This new event also fixes an issue where destroying an ARAnchor or AREnvironmentProbe component would not result in a respective anchorsChanged or environmentProbesChanged event invocation.
  • Added a generic ARTrackablesChangedEventArgs to replace all previous trackables-changed event arguments structs.

Platform-specific error codes and success codes

  • Added XRResultStatus, a new way for AR Foundation to provide status information for completed operations. Provider plug-ins can add extension methods to this type to give users access to platform-specific error codes and success codes.

More consistent image tracking in XR Simulation

  • Added SimulatedTrackedImage.imageAssetGuid API to make it possible for XR Simulation to identify images even if Keep Texture at Runtime is disabled in the reference image library.

Support for concave plane boundary meshes

Render graph

  • Added support for the Universal Render Pipeline Render Graph introduced in URP 17.

Other API design improvements

Changed

Minimum Unity Editor version

  • Upgraded minimum Unity Editor version from 2021.2 to 6000.0. Refer to the official Unity 6 New Naming Convention announcement for more information.

XR Simulation image tracking workflow

  • Changed the SimulatedTrackedImage component to render a textured mesh of its image, allowing you to see the image in the Scene view and Game view without requiring additional GameObjects.
  • Removed now-unnecessary Quad GameObjects from the DefaultSimulationEnvironment.
  • Changed XR Simulation navigation controls to be bound to configurable Input Actions instead of hard-coded to WASD keys. You can configure these Input Actions in the XR Simulation Preferences window.

ARAnchor life cycle

  • Changed the life cycle behavior of ARAnchor in the event that adding the anchor to the XRAnchorSubsystem failed. Instead of retrying the add operation every frame, the ARAnchor component now disables itself after the first failed attempt.

Other API design improvements

  • Changed ARTrackable to now implement the ITrackable interface, enabling generic API designs when dealing with trackables.
  • Changed Promise<T>.OnKeepWaiting() to virtual instead of abstract.
  • Changed XRPlaneSubsystem.Provider.requestedPlaneDetectionMode from virtual to abstract, as ARPlaneManager requires a concrete implementation.
  • Changed SubsystemLifecycleManager.GetActiveSubsystemInstance() from protected to protected static, as it does not use any instance members of SubsystemLifecycleManager.
  • Changed the behavior of SimulationSessionSubsystem.sessionId to now return a non-empty, unique value when the subsystem is running. You can access the session id using XRSessionSubsystem.sessionId.
  • Changed SimulationPlaneSubsystem to respect the currently set PlaneDetectionMode, detecting updates only from planes that match the current mode.
  • Changed the behavior of ARMeshManager to recalculate normals on a mesh if normals were requested and the provider did not calculate them.

Deprecated

All deprecated APIs are replaced by new API additions.

Removed

  • Removed the following APIs which were previously deprecated. Refer to the recommended upgrade guidance if your code used any of these APIs.
Removed API Upgrade recommendation
ARAnchorManager.AddAnchor Add an anchor using AddComponent<ARAnchor> or ARAnchorManager.TryAddAnchorAsync
ARAnchorManager.RemoveAnchor Call Destroy() on the ARAnchor component to remove it.
ARCameraManager.focusMode Use autoFocusEnabled or autoFocusRequested instead.
ARCamerManager.lightEstimationMode Use currentLightEstimation or requestedLightEstimation instead.
ARCamerManager.TryGetLatestImage Use TryAcquireLatestCpuImage instead.
AREnvironmentProbeManager.automaticPlacement Use automaticPlacementRequested or automaticPlacementEnabledinstead.
AREnvironmentProbeManager.environmentTextureHDR Use environmentTextureHDRRequested or environmentTextureHDREnabled instead.
AREnvironmentProbeManager.AddEnvironmentProbe Add an environment probe using AddComponent<AREnvironmentProbe>.
AREnvironmentProbeManager.RemoveEnvironmentProbe Call AREnvironmentProbe.Destroy() to remove it.
ARFaceManager.maximumFaceCount Use requestedMaximumFaceCount or currentMaximumFaceCount instead.
ARHumanBodyManager.humanBodyPose2DEstimationEnabled Use pose2DEnabled or pose2DRequested instead.
ARHumanBodyManager.humanBodyPose3DEstimationEnabled Use pose3DEnabled or pose3DRequested instead.
ARHumanBodyManager.humanBodyPose3DScaleEstimationEnabled Use pose3DScaleEstimationRequested or pose3DScaleEstimationRequested instead.
AROcclusionManager.humanSegmentationStencilMode Use requestedSegmentationStencilMode or currentSegmentationStencilMode instead.
AROcclusionManager.humanSegmentationDepthMode Use requestedSegmentationDepthMode or currentSegmentationDepthMode instead.
ARPlaneManager.detectionMode Use requestedDetectionMode or currentDetectionMode instead.
ARSession.matchFrameRate Use matchFrameRateRequested or matchFrameRateEnabled instead.
ARTrackableManager.sessionOrigin Use origin instead.
ARTrackedImageManager.maxNumberOfMovingImages Use requestedMaxNumberOfMovingImages or currentMaxNumberOfMovingImages instead.
MutableRuntimeReferenceImageLibrary.ScheduleAddImageJob Use ScheduleAddImageWithValidationJob instead.
XRAnchorSubsystemDescriptor.Cinfo.subsystemImplementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRCameraSubsystem.TryGetLatestImage Use TryAcquireLatestCpuImage instead.
XRCameraSubsystemCinfo.implementationType Use providerType and, optionally, subsystemTypeOverride instead.
XREnvironmentProbeSubsystemCinfo.implmentationType Use providerType and, optionally, subsystemTypeOverride instead.
FaceSubsystemParams.subsystemImplementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRHumanBodySubsystemCinfo.implementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRImageTrackingSubsystem.Cinfo.subsystemImplementationType Use providerType and, optionally, subsystemTypeOverride instead.
XROcclusionSubsystemCinfo.implementationType Use providerType and, optionally, subsystemTypeOverride instead.
XROcclusionSubsystemCinfo.supportsHumanSegmentationStencilImage Use humanSegmentationStencilImageSupportedDelegate instead.
XROcclusionSubsystemCinfo.supportsHumanSegmentationDepthImage Use humanSegmentationDepthImageSupportedDelegate instead.
XROcclusionSubsystemCinfo.queryForSupportsEnvironmentDepthImage Use environmentDepthImageSupportedDelegate instead.
XROcclusionSubsystemCinfo.queryForSupportsEnvironmentDepthConfidenceImage Use environmentDepthConfidenceImageSupportedDelegate instead.
XRPlaneSubsystemDescriptor.Cinfo.subsystemImplementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRPointCloudSubsystemDescriptor.Cinfo.implementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRRaycastSubsystemDescriptor.Cinfo.subsystemImplementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRReferenceObjectLibrary.indexOf Use IndexOf instead.
XRSessionSubsystem.subsystemImplementationType Use providerType and, optionally, subsystemTypeOverride instead.
XRSubsystem Use UnityEngine.SubsystemsImplementation.SubsystemWithProvider instead.
  • Removed the image file /Editor/Icons/ARVR@4x.png as it was unused.
  • Removed the Description attribute from values of several enums, as the attribute was unused:
    • XRCameraFrameProperties
    • AREnvironmentProbePlacementType
    • CameraFocusMode
    • LightEstimationMode
    • EnvironmentDepthMode
    • HumanSegmentationDepthMode
    • HumanSegmentationStencilMode
    • OcclusionPreferenceMode

For a full list of changes in this version including backwards-compatible bugfixes, refer to the package changelog.