Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[1.0.2] - 2024-10-10

Changed the AR Foundation dependency version from 5.1.0-pre.6 to 5.1.0.
Changed the behavior of MetaOpenXRSessionSubsystem.sessionId to now return a non-empty, unique Guid value per Meta OpenXR session. You can access the session id using XRSessionSubsystem.sessionId.

Fixed an issue where the subsystem descriptor for MetaOpenXRPlaneSubsystem incorrectly stated that horizontal plane detection, vertical plane detection, and classification were unsupported. These features have all been supported since the 1.0 release, and the subsystem descriptor now returns the correct values.
Fixed a very rare issue where plane detection could possibly fail to update planes due to an unhandled error.
Fixed an issue where trackable poses would fail to update when the OpenXR runtime returned valid but untracked data.
Fixed an issue with BoundedPlane.nativePtr and XRAnchor.nativePtr so they now return a pointer to a struct with a version number and a pointer to the XrSpace handle of their respective trackable type. Refer to Plane native pointer and Anchor native pointer for more information.

Updated documentation to reflect changes to the Room Setup process including it being renamed to Space Setup and relocated to Settings > Physical Space

Fixed an issue where Meta's OpenXR runtime would log a warning every frame for each ARPlane in the scene regarding the use of an older version of their OpenXR API for semantic labels.
Fixed documentation links for Meta-OpenXR features in Project Settings > XR Plug-in Management > OpenXR.

Added new extension methods for the XRDisplaySubsystem to support getting the supported display refresh rates and requesting a display refresh rate. Refer to Meta Quest Display Utilities for more information.
Added documentation for recommended settings when using Universal Render Pipeline.

Renamed the AR features in the Meta Quest OpenXR feature group for brevity and consistency.
Changed the ARPlaneFeature implementation to request the Android permission com.oculus.permission.USE_SCENE on Start on OpenXR runtime versions 1.0.31 and newer, as required by the OpenXR specification.
Changed the Unity.XR.MetaOpenXR runtime assembly to only be included on Android and Editor platforms. This was always intended, but previously the assembly had been included on all platforms.

Fixed an issue where the ARAnchorFeature enabled more OpenXR extensions than were necessary for the XRAnchorSubsystem to function correctly.

Added com.oculus.permission.USE_SCENE permission to the manifest which will show a permission dialog to get user consent if scene data such as planes is requested.
Added support for XRSessionSubsystem's trackingState and notTrackingReason.
Added support for Scene capture.
Added validation rules. Go to Project Settings > XR Plug-in Management > Validation Rules to check if your project settings match the validation rules.

Split AR Foundation: Meta Feature into separate OpenXR Features, one for each AR Foundation subsystem. Go to Project Settings > XR Plug-in Management > OpenXR to enable or disable these features.
Changed minimum Unity version to 2022.3
Updated linked OpenXR version to 1.0.28 from 1.0.25.
Changed the package name from Meta OpenXR Feature to Unity OpenXR: Meta.
Changed blending factors for blending Unity content over passthrough from [source alpha, 1 - source alpha] to [1, 1 - source alpha] to support rendering additive materials.

Fixed Session availability API to properly check that an OpenXR session instance exists.

Fixed math operations for comparing structs with single-precision values.
Fixed an issue where it was possible to incorrectly remove or update planes before they were added in some uncommon situations. This resulted in an InvalidOperationException in AR Foundation that is now no longer thrown.

Added support for getting plane boundary vertices via XRPlaneSubsystem.GetBoundary.
Added support for getting plane alignment via ARPlane.alignment as well as planeAlignmentThreshold. Refer to Plane alignment for more information.
Added support for plane classification.
Added support for planes to be updated and removed.
Added a custom Editor for ARCameraManager to clarify that its serialized properties have no effect on Meta Passthrough.
Added a custom Editor for ARCameraBackground to clarify that it has no effect on Meta Quest devices.
Added support for requestedDetectionMode to filter horizontal and vertical planes.

Changed the trackableId property of planes to be backed by OpenXR's uuid field, instead of a monotonically increasing counter.
Changed the display name of the AR Foundation Meta Quest feature.
Grouped the Meta Quest OpenXR features in an OpenXR feature group.
Passthrough layer is now composited behind AR content rather than alpha blended in front of it. This fixes an issue where AR opaques always appeared semi-transparent.

Fixed an issue where the trackingState property of planes could be incorrectly reported in some rare cases.
Fixed an issue where the center of a plane in plane space was incorrectly reported as a value other than (0, 0).
Fixed an issue where ARPlanes were not removed if the Redo Walls action or the Clear Room Set Up action was performed through the Meta Quest menu.