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.4] - 2025-03-31

Changed

  • Recompiled the native plug-in with support for 16 KB page sizes on Android 15 or newer.

Fixed

  • Fixed and issue where enabling both the Meta Quest: AR Session and Meta Quest: Display Utilities OpenXR features would cause the app to unexpectedly quit.

[1.0.3] - 2025-03-05

Added

  • Added support for running scenes in the editor via Quest Link.

Changed

  • Changed the Meta Quest: Camera (Passthrough) feature to no longer enable the XR_FB_composition_layer_alpha_blend OpenXR extension. This is a backwards-compatible change with no effect on your code.

Fixed

  • Fixed the Meta Quest: Display Utilities feature so that it works correctly even when Meta Quest: Session is disabled. (MOXRB-70)
  • Fixed the MetaOpenXRAnchorSubsystem so that it correctly registers its subsystemTypeOverride, allowing you to typecast instances of XRAnchorSubsystem to MetaOpenXRAnchorSubsystem.

[1.0.2] - 2024-10-10

Changed

  • 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

  • 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.

[1.0.1] - 2023-11-02

Changed

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

Fixed

  • 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.

[1.0.0] - 2023-09-30

Added

  • 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.

Changed

  • 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

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

[0.2.1] - 2023-09-14

Added

  • 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.

Changed

  • 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

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

[0.1.2] - 2023-06-28

Fixed

  • 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.

[0.1.1] - 2023-06-12

Added

Changed

  • 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

  • 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.

[0.1.0] - 2023-04-04

  • This is the first release of Meta OpenXR Plugin <com.unity.xr.meta-openxr>.