Android XR Unity Extensions v0.9.1

Author: jkleinert

Assets/Banner.png.meta

@@ -8,6 +8,23 @@ 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).
 
+## [0.9.1] - 2025-04-03
+
+### Added
+  * New Sample **XRController** which syncs and displays Samsung Controller
+
+### Changed
+  * N/A
+
+### Deprecated
+  * N/A
+
+### Removed
+  * N/A
+
+### Fixed
+  * Updated Android XR permissions.
+
 ## [0.9.0] - 2024-12-12
 
 This is the first release of **Android XR Extensions for Unity

Assets/iconBG.png.meta

@@ -89,6 +89,19 @@ internal class XRSessionFeatureBuildHooks : OpenXRFeatureBuildHooks
                         { "value", "ACTIVITY_START_MODE_UNMANAGED_FULL_SPACE" }
                     }
             };
+        private static readonly ManifestElement _libopenxrso =
+            new ManifestElement()
+            {
+                ElementPath = new List<string>
+                    {
+                        "manifest", "application", "uses-native-library"
+                    },
+                Attributes = new Dictionary<string, string>
+                    {
+                        { "name", "libopenxr.google.so" },
+                        { "required", "false" }
+                    }
+            };
 #endif // XR_MGMT_4_4_0_OR_NEWER
 
         /// <inheritdoc/>
@@ -172,20 +185,28 @@ public override ManifestRequirement ProvideManifestRequirement()
                 Debug.Log(stringBuilder);
             }
 
-            if (CheckSceneUnderstandingPermission())
+            if (CheckSceneUnderstandingCoarsePermission())
             {
                 requiredManifest.Add(
-                    GetAndroidXRPermissionElement(AndroidXRPermission.SceneUnderstanding));
+                    GetAndroidXRPermissionElement(AndroidXRPermission.SceneUnderstandingCoarse));
                 Debug.LogFormat("Inject permission manifest: {0}",
-                    AndroidXRPermission.SceneUnderstanding.ToPermissionString());
+                    AndroidXRPermission.SceneUnderstandingCoarse.ToPermissionString());
             }
 
-            if (CheckEyeTrackingPermission())
+            if (CheckSceneUnderstandingFinePermission())
             {
                 requiredManifest.Add(
-                    GetAndroidXRPermissionElement(AndroidXRPermission.EyeTracking));
+                    GetAndroidXRPermissionElement(AndroidXRPermission.SceneUnderstandingFine));
                 Debug.LogFormat("Inject permission manifest: {0}",
-                    AndroidXRPermission.EyeTracking.ToPermissionString());
+                    AndroidXRPermission.SceneUnderstandingFine.ToPermissionString());
+            }
+
+            if (CheckEyeTrackingCoarsePermission())
+            {
+                requiredManifest.Add(
+                    GetAndroidXRPermissionElement(AndroidXRPermission.EyeTrackingCoarse));
+                Debug.LogFormat("Inject permission manifest: {0}",
+                    AndroidXRPermission.EyeTrackingCoarse.ToPermissionString());
             }
 
             if (CheckEyeTrackingFinePermission())
@@ -204,6 +225,9 @@ public override ManifestRequirement ProvideManifestRequirement()
                     AndroidXRPermission.HandTracking.ToPermissionString());
             }
 
+            requiredManifest.Add(_libopenxrso);
+            Debug.LogFormat("Inject native library manifest: libopenxr.google.so");
+
             List<ManifestElement> emptyElement = new List<ManifestElement>();
             return new ManifestRequirement
             {
@@ -230,7 +254,7 @@ private static ManifestElement GetAndroidXRPermissionElement(AndroidXRPermission
             };
         }
 
-        private bool CheckSceneUnderstandingPermission()
+        private bool CheckSceneUnderstandingCoarsePermission()
         {
             XRTrackableFeature trackableFeature =
                 AndroidXRBuildUtils.GetActiveFeature<XRTrackableFeature>();
@@ -265,7 +289,13 @@ private bool CheckSceneUnderstandingPermission()
                 (anchorFeature != null && anchorFeature.enabled);
         }
 
-        private bool CheckEyeTrackingPermission()
+        private bool CheckSceneUnderstandingFinePermission()
+        {
+            /// Add check for scene understanding when implemented.
+            return false;
+        }
+
+        private bool CheckEyeTrackingCoarsePermission()
         {
             FoveatedRenderingFeature foveatedRendering =
                 AndroidXRBuildUtils.GetActiveFeature<FoveatedRenderingFeature>();

Assets/iconFG.png.meta

@@ -27,23 +27,29 @@ namespace Google.XR.Extensions
     public enum AndroidXRPermission
     {
         /// <summary>
-        /// Permission to enable scene understanding features that relies on motion tracking,
+        /// Permission to enable coarse scene understanding features that relies on motion tracking,
         /// ToF sensor, and the VST RGB-left cameras.
         /// </summary>
-        SceneUnderstanding,
+        SceneUnderstandingCoarse,
+
+        /// <summary>
+        /// Permission to enable fine scene understanding features that relies on motion tracking,
+        /// such as depth texture and scene meshing.
+        /// </summary>
+        SceneUnderstandingFine,
 
         /// <summary>
         /// Permission to enable hand tracking.
         /// </summary>
         HandTracking,
 
         /// <summary>
-        /// Permission to enable eye tracking.
+        /// Permission to enable coarse eye tracking.
         /// </summary>
-        EyeTracking,
+        EyeTrackingCoarse,
 
         /// <summary>
-        /// Permission to enable eye gaze interaction.
+        /// Permission to enable eye gaze interaction and fine eye tracking.
         /// </summary>
         EyeTrackingFine,
 
@@ -68,12 +74,14 @@ public static string ToPermissionString(this AndroidXRPermission permission)
         {
             switch (permission)
             {
-                case AndroidXRPermission.SceneUnderstanding:
-                    return "android.permission.SCENE_UNDERSTANDING";
+                case AndroidXRPermission.SceneUnderstandingCoarse:
+                    return "android.permission.SCENE_UNDERSTANDING_COARSE";
+                case AndroidXRPermission.SceneUnderstandingFine:
+                    return "android.permission.SCENE_UNDERSTANDING_FINE";
                 case AndroidXRPermission.HandTracking:
                     return "android.permission.HAND_TRACKING";
-                case AndroidXRPermission.EyeTracking:
-                    return "android.permission.EYE_TRACKING";
+                case AndroidXRPermission.EyeTrackingCoarse:
+                    return "android.permission.EYE_TRACKING_COARSE";
                 case AndroidXRPermission.EyeTrackingFine:
                     return "android.permission.EYE_TRACKING_FINE";
                 case AndroidXRPermission.FaceTracking:

CHANGELOG.md

@@ -94,7 +94,7 @@ public class XRAnchorFeature : OpenXRFeature
         /// Runtime permission required to enable scene understanding.
         /// </summary>
         public static readonly AndroidXRPermission RequiredPermission =
-            AndroidXRPermission.SceneUnderstanding;
+            AndroidXRPermission.SceneUnderstandingCoarse;
 
         internal static bool? _extensionEnabled = null;
 

Editor/Internal/XRSessionFeatureBuildHooks.cs

@@ -80,7 +80,7 @@ public class XRObjectTrackingFeature : OpenXRFeature
         /// Runtime permission required to enable scene understanding.
         /// </summary>
         public static readonly AndroidXRPermission RequiredPermission =
-            AndroidXRPermission.SceneUnderstanding;
+            AndroidXRPermission.SceneUnderstandingCoarse;
 
         internal static bool? _extensionEnabled = null;
 

Runtime/AndroidXRPermissionExtensions.cs

@@ -79,7 +79,7 @@ public class XRTrackableFeature : OpenXRFeature
         /// Runtime permission required to enable scene understanding.
         /// </summary>
         public static readonly AndroidXRPermission RequiredPermission =
-            AndroidXRPermission.SceneUnderstanding;
+            AndroidXRPermission.SceneUnderstandingCoarse;
 
         internal static bool? _extensionEnabled = null;