Android XR Unity Extensions v1.0.0

Author: LevanaChen

Assets/Banner.png.meta

@@ -8,10 +8,68 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this package adheres to
 [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [1.0.0] - 2025-05-07
+
+### Editor version and package compatibility
+
+  * This version of the package requires minimal Unity Editor version `6000.1.0b12`. You can install the official **Unity 6.1** (e.g. `6000.1.0f1` or newer) from the Unity Hub.
+  * Package dependencies updated in this version:
+    * OpenXR Plugin (`com.unity.xr.openxr`) 1.14.2
+    * AR Foundation (`com.unity.xr.arfoundation`) 6.1.0
+  * Verified compatible packages:
+    * Unity OpenXR Android XR (`com.unity.xr.androidxr-openxr`) 1.0.0-pre.2
+    * Composition Layer (`com.unity.xr.compositionlayers`) 2.0.0
+
+### Known issues
+  * **Vulkan Subsampling** now causes rendering issues in multiple samples, including **ImageTracking**, **HandMesh**, **SceneMeshing**, and **XRController**.
+    * It's confirmed as a regression issue from **OpenXR Plugin** package, expect to be fixed by future releases.
+    * **Workaround**: To disable it, under the setting menu of **Android XR (Extensions) Session Management**, unselect **Subsampling (Vulkan)**.
+
+### Added
+  * Marker Tracking and QR Code Tracking:
+    * New OpenXR Feature `XRMarkerTrackingFeature` which provides marker tracking via `ARTrackedImageManager`. Including APIs:
+      * Extension method `ARTrackedImage.IsMarker()` to check if the image instance is a marker.
+      * Extension method `ARTrackedImage.TryGetMarkerData(out XRMarkerDictionary, out int)` to get marker data from a marker instance.
+      * New ScriptableObject `XRMarkerDatabase`, a container of `XRMarkerDatabaseEntry`, used to manage marker references in an `XRReferenceImageLibrary`.
+    * New OpenXR Feature `XRQrCodeTrackingFeature` which provides QR Code tracking via `ARTrackedImageManager`. Including APIs:
+      * Extension method `ARTrackedImage.IsQrCode()` to check if the image instance is a QR Code.
+      * Extension method `ARTrackedImage.TryGetQrCodeData(out string)` to get the QR code data from a QR Code instance.
+    * New implementation of `XRImageTrackingSubsystem`. To use it with AR Foundation's `ARTrackedImageManager`, create an `XRReferenceImageLibrary` with a QR Code reference named **QrCode** and/or updates marker references from `XRMarkerDatabase`.
+    * New sample **ImageTracking** which demonstrates the usage of QR Code tracking and marker tracking.
+  * Added experimental features support which use OpenXR extensions `XR_ANDROIDX_*`. **Noted**:
+    * Applications can then access `ANDROIDX` extensions at runtime but **cannot be published in Google Play Store**.
+    * Experimental features can take several iterations towards formal releases which **may include breaking changes, deprecation, and removal**.
+  * Body Tracking **(Experimental*)**:
+    * New Experimental OpenXR Feature `XRBodyTrackingFeature` which provides body tracking via `ARHumanBodyManager`.
+    * New sample **BodyTracking** which demonstrates the usage of body tracking.
+  * System State **(Experimental*)**:
+    * New Experimental OpenXR Feature `XRSystemStateFeature` which provides system state via `TryGetSystemState(out systemState)`.
+    * Added system state API usage to **BlendMode** sample.
+  * Scene Meshing **(Experimental*)**:
+    * New Experimental OpenXR Feature `XRSceneMeshingFeature` which provides scene mesh data via `XRMeshSubsystem`.
+    * Added new sample **SceneMeshing** which demonstrates the usage of scene meshing API.
+
+### Changed
+  * **Subsampling (Vulkan)** is now disabled by default in **Android XR (Extensions) Session Management**.
+  * Face Tracking:
+    * Updated `XRFaceParameterIndices` with new enum values for tongue blendshapes.
+    * Updated `XRFaceState` with new property `ConfidenceRegions`, indexed by new enum `XRFaceConfidenceRegion`.
+
+### Deprecated
+  * N/A
+
+### Removed
+  * Removed `XRTrackableFeature`, `XRAnchorFeature`, and **Trackables** sample. Please use `ARPlaneFeature` and `ARAnchorFeature` from **Unity OpenXR Android XR** instead.
+  * Removed `XRDisplayRefreshRateFeature` and **DisplayRefreshRate** sample. Please use `DisplayUtilitiesFeature` from **Unity OpenXR Android XR** instead.
+
+### Fixed
+  * Fixed typo in `XRHandMeshFeature` which referred to depth texture permission rather than hand tracking permission.
+  * Fixed bug in `XRHandMeshFeature` which started a subsystem in the `OnSubsystemStop()` callback.
+
 ## [0.9.1] - 2025-04-03
 
 ### Added
-  * New Sample **XRController** which syncs and displays Samsung Controller
+  * New Sample **XRController** which syncs and displays Samsung Controller.
 
 ### Changed
   * N/A
@@ -38,7 +96,7 @@ supports the following features:
 -   Tracked Objects via Object Tracking Subsystem Provider
 -   Hand Meshes via Mesh Subsystem Provider.
 -   Passthrough Composition Layer via OpenXR Composition Layer Provider
--   Face Tracking via MonoBehavior `XRFaceTrackingManager`
+-   Face Tracking via MonoBehaviour `XRFaceTrackingManager`
 -   Unbounded Reference Space
 -   Display Refresh Rate
 -   Environment Blend Mode

Assets/iconBG.png.meta

@@ -10,7 +10,9 @@
         "GUID:e7613e527d035461da6942ba7283ee2d",
         "Unity.XR.CoreUtils.Editor",
         "Unity.XR.CompositionLayers",
-        "Unity.XR.CompositionLayers.Editor"
+        "Unity.XR.CompositionLayers.Editor",
+        "Unity.XR.ARSubsystems",
+        "Unity.XR.ARSubsystems.Editor"
     ],
     "includePlatforms": [
         "Editor"
@@ -22,41 +24,11 @@
     "autoReferenced": true,
     "defineConstraints": [],
     "versionDefines": [
-        {
-            "name": "Unity",
-            "expression": "6000.0.4",
-            "define": "UNITY_6000_0_4_OR_NEWER"
-        },
-        {
-            "name": "Unity",
-            "expression": "6000.0.23",
-            "define": "UNITY_6000_0_23_OR_NEWER"
-        },
-        {
-            "name": "com.unity.xr.openxr",
-            "expression": "1.8.2",
-            "define": "UNITY_OPENXR_1_8_2_OR_NEWER"
-        },
-        {
-            "name": "com.unity.xr.management",
-            "expression": "4.4.0",
-            "define": "XR_MGMT_4_4_0_OR_NEWER"
-        },
         {
             "name": "com.unity.xr.androidxr-openxr",
-            "expression": "0.1",
+            "expression": "0.5.0",
             "define": "UNITY_OPEN_XR_ANDROID_XR"
         },
-        {
-            "name": "com.unity.xr.androidxr-openxr",
-            "expression": "0.2",
-            "define": "UNITY_OPEN_XR_ANDROID_XR_0_2_0"
-        },
-        {
-            "name": "com.unity.xr.androidxr-openxr",
-            "expression": "0.3.9",
-            "define": "UNITY_OPEN_XR_ANDROID_XR_0_4_0"
-        },
         {
             "name": "com.unity.xr.hands",
             "expression": "0.1",

Assets/iconFG.png.meta

@@ -20,16 +20,13 @@
 namespace Google.XR.Extensions.Editor.Internal
 {
     using System.Linq;
+    using Unity.XR.Management.AndroidManifest.Editor;
     using UnityEditor;
     using UnityEditor.XR.Management;
     using UnityEditor.XR.OpenXR.Features;
     using UnityEngine.XR.OpenXR;
     using UnityEngine.XR.OpenXR.Features;
 
-#if XR_MGMT_4_4_0_OR_NEWER
-    using Unity.XR.Management.AndroidManifest.Editor;
-#endif
-
     internal static class AndroidXRBuildUtils
     {
         // UnityEditor.XR.OpenXR.Features.Android.AndroidFeatureSet is an internal class,
@@ -48,15 +45,13 @@ public static TOpenXRFeature GetActiveFeature<TOpenXRFeature>()
             return OpenXRSettings.ActiveBuildTargetInstance.GetFeature<TOpenXRFeature>();
         }
 
-#if XR_MGMT_4_4_0_OR_NEWER
         public static string PrintManifestElement(ManifestElement manifestElement)
         {
-            return string.Format("Path: {0}{1}",
-                string.Join("/", manifestElement.ElementPath),
-                string.Join("", manifestElement.Attributes.Select(
-                    pair => string.Format("\n  Attribute: {0}={1}", pair.Key, pair.Value))));
+            string element = string.Join("/", manifestElement.ElementPath);
+            string attributes = string.Join(string.Empty, manifestElement.Attributes.Select(
+                pair => string.Format("\n  Attribute: {0}={1}", pair.Key, pair.Value)));
+            return string.Format("Path: {0}{1}", element, attributes);
         }
-#endif
 
         internal static bool IsAnyAndroidXRFeatureEnabled()
         {

CHANGELOG.md

@@ -28,14 +28,17 @@ namespace Google.XR.Extensions.Editor.Internal
         FeatureIds = new string[] {
             XRSessionFeature.FeatureId,
             XREnvironmentBlendModeFeature.FeatureId,
-            XRTrackableFeature.FeatureId,
-            XRAnchorFeature.FeatureId,
             XRObjectTrackingFeature.FeatureId,
+            XRMarkerTrackingFeature.FeatureId,
+            XRQrCodeTrackingFeature.FeatureId,
             XRFaceTrackingFeature.FeatureId,
             XRPassthroughFeature.FeatureId,
             XRHandMeshFeature.FeatureId,
             XRFoveationFeature.FeatureId,
             XRUnboundedRefSpaceFeature.FeatureId,
+            XRBodyTrackingFeature.FeatureId,
+            XRSceneMeshingFeature.FeatureId,
+            XRSystemStateFeature.FeatureId,
         },
         // Features enabled and disabled along with selecting and deselecting the feature set
         // from Editor.
@@ -45,13 +48,12 @@ namespace Google.XR.Extensions.Editor.Internal
         // Features enabled along with selecting the feature set from Editor,
         // desired to include all XR_ANDROID_* features provided by this package.
         DefaultFeatureIds = new string[] {
-            XRTrackableFeature.FeatureId,
-            XRAnchorFeature.FeatureId,
             XRObjectTrackingFeature.FeatureId,
+            XRMarkerTrackingFeature.FeatureId,
+            XRQrCodeTrackingFeature.FeatureId,
             XRFaceTrackingFeature.FeatureId,
             XRPassthroughFeature.FeatureId,
             XRHandMeshFeature.FeatureId,
-
         },
         UiName = "Android XR (Extensions)",
         Description = "Feature group that provides Android XR experience and " +
@@ -68,14 +70,18 @@ internal class AndroidXRFeatureSet
         /// </summary>
         internal static readonly string[] _sessionManagementDependentIds = new string[]
         {
-            XRAnchorFeature.FeatureId,
             XREnvironmentBlendModeFeature.FeatureId,
             XRFaceTrackingFeature.FeatureId,
             XRFoveationFeature.FeatureId,
+            XRHandMeshFeature.FeatureId,
             XRObjectTrackingFeature.FeatureId,
+            XRMarkerTrackingFeature.FeatureId,
+            XRQrCodeTrackingFeature.FeatureId,
             XRPassthroughFeature.FeatureId,
-            XRTrackableFeature.FeatureId,
             XRUnboundedRefSpaceFeature.FeatureId,
+            XRBodyTrackingFeature.FeatureId,
+            XRSceneMeshingFeature.FeatureId,
+            XRSystemStateFeature.FeatureId,
         };
     }
 }

Editor/Google.XR.Extensions.Editor.asmdef

@@ -39,19 +39,11 @@ static void AddAndroidXRProjectValidationRules()
                         "Android XR reuiqres resizable windows to render pop-ups correctly " +
                         "in immersive view, such as system permission requests.",
                     IsRuleEnabled = AndroidXRBuildUtils.IsAnyAndroidXRFeatureEnabled,
-#if UNITY_6000_0_4_OR_NEWER
                     CheckPredicate = () => PlayerSettings.Android.resizeableActivity,
                     FixItMessage =
                         "Go to <b>Project Settings > Player Settings</b>, " +
                         "selet <b>Android</b> tab, then enable <b>Resizable Activity</b>.",
                     FixIt = () => PlayerSettings.Android.resizeableActivity = true,
-#else
-                    CheckPredicate = () => PlayerSettings.Android.resizableWindow,
-                    FixItMessage =
-                        "Go to <b>Project Settings > Player Settings</b>, " +
-                        "selet <b>Android</b> tab, then enable <b>Resizable Window</b>.",
-                    FixIt = () => PlayerSettings.Android.resizableWindow = true,
-#endif
                     FixItAutomatic = true,
                     Error = true,
                 },