使用受支持的 OpenXR 扩展构建

Android XR 支持 Open XR 1.1 规范和一系列第三方供应商扩展。使用这些扩展程序可让您在针对 XR 开发时获得熟悉的体验。其中一些功能需要Android 运行时权限。

Android XR 供应商扩展

扩展程序名称

说明

XR_ANDROID_avatar_eyes

允许应用获取用户眼睛的位置和方向，以便更逼真地呈现头像的眼睛姿势和状态。此扩展程序不应用于其他眼动追踪用途。对于互动，应使用 XR_EXT_eye_gaze_interaction。此扩展程序需要 android.permission.EYE_TRACKING。

XR_ANDROID_composition_layer_passthrough_mesh

允许应用通过额外的组合层将透视纹理投影到任意几何图形。此扩展程序需要 android.permission.SCENE_UNDERSTANDING。

XR_ANDROID_depth_texture

公开原始和平滑的深度，以便进行遮挡、点击测试和其他利用准确场景几何图形的特定任务（例如假冒面部检测）。根据当前的相机/眼睛姿势提供低分辨率深度纹理和场景置信度。此扩展程序需要 android.permission.SCENE_UNDERSTANDING。

XR_ANDROID_device_anchor_persistence

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

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。

XR_ANDROID_mouse_interaction

此扩展程序引入了一种新的互动配置文件，专为鼠标设备通过 OpenXR 操作系统输入而设计。允许为用户鼠标个人资料（包括鼠标设备和触控板设备）使用常用的操作姿势。此 API 旨在通过鼠标指针在 3D 空间中与对象互动。例如，使用虚拟激光指针瞄准墙上的虚拟按钮，就是适合“瞄准”姿势的互动。

XR_ANDROID_passthrough_camera_state

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

XR_ANDROID_performance_metrics

此扩展程序提供了用于枚举和查询当前 XR 设备、合成器和 XR 应用的各种性能指标计数器的 API。

XR_ANDROID_raycast

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

XR_ANDROID_trackables

借助此扩展程序，应用可以访问物理环境中的可跟踪对象（例如平面），并创建附加到可跟踪对象的锚点。此扩展程序需要 android.permission.SCENE_UNDERSTANDING。

XR_ANDROID_trackables_object

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

XR_ANDROID_unbounded_reference_space

提供无边界的参考空间，可用于随着时间的推移构建更好的场景理解。借助此参考空间，观看者可以自由地穿越复杂环境（通常距离起点数十米），同时始终优化观看者附近的坐标系稳定性。

其他受支持的扩展程序

还支持以下其他扩展。信息位于外部网站上。