使用受支持的 OpenXR 扩展构建

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
了解 XR 设备类型 →
扩展现实头戴设备
有线扩展现实眼镜
了解 XR 设备类型 →

Android XR 通过 OpenXR 1.1 规范 和大量第三方供应商扩展程序支持 OpenXR。使用这些扩展程序可让您在为 XR 开发时获得熟悉的体验。其中一些功能 需要 Android 运行时权限。如果您希望直接基于 OpenXR API 进行构建，可以在jetpack-xr-natives 代码库中找到所需的头文件。

Android XR 供应商扩展程序

扩展程序名称

说明

XR_ANDROID_depth_texture

公开原始深度和平滑深度，用于遮挡、命中测试和其他使用准确场景几何图形的特定任务，例如伪造人脸检测。提供来自当前相机/眼睛姿势的低分辨率深度纹理和场景置信度。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_FINE。

XR_ANDROID_device_anchor_persistence

允许应用在当前设备上跨应用和设备会话保留、检索和取消保留锚点。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_COARSE。

XR_ANDROID_eye_tracking

允许应用获取用户眼睛的位置和方向，旨在使化身的眼睛姿势和状态呈现更逼真。请勿将此扩展程序用于其他眼动追踪用途。对于互动，XR_EXT_eye_gaze_interaction 应改用。此扩展程序需要 android.permission.EYE_TRACKING_COARSE 或 android.permission.EYE_TRACKING_FINE。

XR_ANDROID_face_tracking

允许应用获取混合形状的权重，并在 XR 体验中呈现面部表情。此扩展程序需要 android.permission.FACE_TRACKING。

XR_ANDROID_hand_mesh

启用以动态手部网格表示的手部跟踪输入。此扩展程序旨在为用户手部的个性化表示形式的网格提供顶点和索引缓冲区。如需追踪手部关节，应使用 XR_EXT_hand_tracking；如需进行互动，应使用 XR_EXT_hand_interaction。此扩展程序需要 android.permission.HAND_TRACKING。

XR_ANDROID_light_estimation

估算用户当前环境的环境光照（包括 球面谐波）。此扩展程序允许应用请求表示头戴式设备周围真实世界环境光照的数据。在渲染虚拟对象时，可以使用此信息在与放置场景相同的条件下照亮虚拟对象。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_COARSE。

XR_ANDROID_passthrough_camera_state

为透视相机提供启用、初始化或停用状态。

XR_ANDROID_raycast

此扩展程序允许应用针对环境中的可跟踪对象执行光线投射。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_COARSE。

XR_ANDROID_trackables

此扩展程序允许应用访问物理环境中的可跟踪对象（例如平面），并创建附着其上的锚点。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_COARSE。

XR_ANDROID_trackables_object

支持在场景中跟踪实体对象（例如键盘和鼠标）。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_COARSE。

其他受支持的扩展程序

此外，还支持以下扩展程序。相关信息位于外部网站上。

OpenXR™ 和 OpenXR 徽标是 The Khronos Group Inc. 的商标，已在中国、欧盟、日本和英国注册为商标。