了解 XR 的权限

适用的 XR 设备

本指南可帮助您为以下类型的 XR 设备打造优质体验。

了解 XR 设备类型 →

扩展现实头戴设备

有线扩展现实眼镜

了解 XR 设备类型 →

与移动设备和其他设备规格上的应用一样，XR 应用提供的某些功能需要您的应用在应用的 AndroidManifest 文件中声明权限。对于危险权限，您的应用可能需要请求运行时权限。如需了解更深入的信息，请参阅 Android 中的权限和权限最佳实践。

XR 应用可以使用以下权限。本部分中的所有权限都被视为危险权限，因此您必须在应用清单中声明这些权限，并在运行时请求这些权限。

android.permission.EYE_TRACKING_COARSE

表示用户的眼部姿势、状态和方向，例如用于头像。当需要低精度眼动追踪数据时，请使用此权限。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_ANDROID_eye_tracking
• xrGetCoarseTrackingEyesInfoANDROID

Unity 功能

• Android XR：AR Face

android.permission.EYE_TRACKING_FINE

眼动注视，用于选择、输入、互动和眼动追踪注视点渲染。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_EXT_eye_gaze_interaction
• xrGetFineTrackingEyesInfoANDROID
• XR_META_foveation_eye_tracked
• XR_VARJO_foveated_rendering

Unity 功能

• 眼动追踪互动

android.permission.FACE_TRACKING

跟踪和渲染面部表情。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_ANDROID_face_tracking
• XR_ANDROID_face_tracking_data_source

Unity 功能

• XRFaceTrackingFeature

android.permission.RECORD_AUDIO

录制音频输入，例如用于音频驱动的面部追踪数据源。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_ANDROID_face_tracking_data_source

Unity 功能

不适用

android.permission.HAND_TRACKING

跟踪手部关节姿势以及角速度和线速度；使用用户手部的网格表示。

注意： 检测捏合、戳、瞄准和抓握等基本手势不需要此权限。

Jetpack XR SDK

• 手部状态和关节姿势

OpenXR 扩展

• XR_ANDROID_hand_mesh
• XR_EXT_hand_tracking
• XR_FB_hand_tracking_aim
• XR_FB_hand_tracking_mesh

Unity 功能

• XR Hands
• XRHandMeshFeature

android.permission.BODY_TRACKING

追踪身体关节姿势和骨骼比例。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_ANDROID_body_tracking

Unity 功能

• XRBodyTrackingFeature

android.permission.SCENE_UNDERSTANDING_COARSE

光线估测；将透视投影到网格表面；对环境中的可跟踪对象执行光线投射；平面、图像、标记、二维码、网格和对象跟踪；持久和共享锚点。

Jetpack XR SDK

• PanelEntity
• 平面跟踪
• 点击测试
• 锚点持久性

OpenXR 扩展

• XR_ANDROID_anchor_sharing_export
• XR_ANDROID_composition_layer_passthrough_mesh
• XR_ANDROID_device_anchor_persistence
• XR_ANDROID_light_estimation
• XR_ANDROID_raycast
• XR_ANDROID_spatial_anchor_space
• XR_ANDROID_spatial_component_subsumed_by
• XR_ANDROID_spatial_discovery_bounds
• XR_ANDROID_spatial_entity_bound_anchor
• XR_ANDROID_spatial_object_tracking
• XR_ANDROID_trackables
• XR_ANDROID_trackables_image
• XR_ANDROID_trackables_marker
• XR_ANDROID_trackables_object
• XR_ANDROID_trackables_qr_code
• XR_EXT_spatial_anchor
• XR_EXT_spatial_image_tracking
• XR_EXT_spatial_marker_tracking
• XR_EXT_spatial_mesh_tracking
• XR_EXT_spatial_object_tracking
• XR_EXT_spatial_persistence
• XR_EXT_spatial_persistence_operations
• XR_EXT_spatial_plane_tracking

Unity 功能

• XRAnchorFeature
• XRLightEstimationFeature
• XRPassthroughFeature
• XRTrackableFeature
• XRObjectTrackingFeature

android.permission.SCENE_UNDERSTANDING_FINE

深度纹理；场景网格化；立方体贴图光线估测；深度光线投射和空间注释。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_ANDROID_depth_texture
• XR_ANDROID_light_estimation_cubemap
• XR_ANDROID_scene_meshing
• XR_ANDROID_spatial_annotation_tracking
• XR_ANDROID_spatial_discovery_raycast

Unity 功能

• XRDepthTextureFeature

android.permission.ACCESS_FINE_LOCATION

用于地理空间跟踪和锚点的精确地球相对位置和方向。

Jetpack XR SDK

不适用

OpenXR 扩展

• XR_ANDROID_geospatial
• XR_ANDROID_geospatial_anchor

Unity 功能

不适用