Permissions

Some XR features require system permissions on the Android XR runtime. Refer to the following table for a list of OpenXR features and the permissions they require. Each feature is documented with a code example you can use to request the relevant permission. If a feature requires the 'coarse' version of a permission (i.e., android.permission.SCENE_UNDERSTANDING_COARSE) the 'fine' version of that permission is also sufficient (i.e., android.permission.SCENE_UNDERSTANDING_FINE).

Feature	Permission
Plane detection	android.permission.SCENE_UNDERSTANDING_COARSE
Hand tracking	android.permission.HAND_TRACKING
Face tracking	android.permission.EYE_TRACKING_COARSE
Gaze interaction profile	android.permission.EYE_TRACKING_FINE

Request multiple permissions simultaneously

If your app needs to request multiple permissions at once, you should use Permission.RequestUserPermissions.

Use the following example code to request multiple permissions at once:

const string k_SceneUnderstandingCoarsePermission = "android.permission.SCENE_UNDERSTANDING_COARSE";
const string k_HandTrackingPermission = "android.permission.HAND_TRACKING";
const string k_EyeTrckingCoarsePermission = "android.permission.EYE_TRACKING_COARSE";
const string k_EyeTrackingFinePermission = "android.permission.EYE_TRACKING_FINE";

[SerializeField]
ARPlaneManager m_ARPlaneManager;

[SerializeField]
ARFaceManager m_ARFaceManager;

#if UNITY_ANDROID
void Start()
{
    var permissions = new List<string>();

    // add permissions that have not been granted by the user
    if (!Permission.HasUserAuthorizedPermission(k_SceneUnderstandingCoarsePermission))
    {
        permissions.Add(k_SceneUnderstandingCoarsePermission);
    }
    else
    {
        // enable the AR Plane Manager component if permission is already granted
        m_ARPlaneManager.enabled = true;
    }

    if (!Permission.HasUserAuthorizedPermission(k_HandTrackingPermission))
    {
        permissions.Add(k_HandTrackingPermission);
    }

    if (!Permission.HasUserAuthorizedPermission(k_EyeTrackingFinePermission))
    {
        permissions.Add(k_EyeTrackingFinePermission);
    }
    else
    {
        // enable the AR Face Manager component if permission is already granted
        m_ARFaceManager.enabled = true;
    }

    if (!Permission.HasUserAuthorizedPermission(k_EyeTrckingCoarsePermission))
    {
        permissions.Add(k_EyeTrckingCoarsePermission);
    }

    // setup callbacks to be called depending on whether permission is granted
    var callbacks = new PermissionCallbacks();
    callbacks.PermissionDenied += OnPermissionDenied;
    callbacks.PermissionGranted += OnPermissionGranted;

    Permission.RequestUserPermissions(permissions.ToArray(), callbacks);
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}

void OnPermissionGranted(string permission)
{
    // enable the corresponding AR Manager component after required permission is granted
    if (permission == k_SceneUnderstandingCoarsePermission)
    {
        m_ARPlaneManager.enabled = true;
    }
    else if (permission == k_EyeTrckingCoarsePermission)
    {
        m_ARFaceManager.enabled = true;
    }
}
#endif // UNITY_ANDROID

Refer to Request runtime permissions for more information on Android permissions in Unity.

Permissions

Request multiple permissions simultaneously

Additional resources