使用受支持的 OpenXR 扩展构建

Android XR 通过 OpenXR 1.1 规范和一长串第三方供应商扩展程序支持 OpenXR。在开发 XR 应用时,使用这些扩展程序可为您提供熟悉的体验。其中一些功能需要 Android 运行时权限。如果您想直接基于 OpenXR API 进行构建,可以在此代码库中找到所需的头文件。

Android XR 供应商扩展

扩展程序名称

说明

XR_ANDROID_composition_layer_passthrough_mesh

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

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_COARSEandroid.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_mouse_interaction

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

XR_ANDROID_passthrough_camera_state

为透视摄像头提供启用、初始化或停用状态。

XR_ANDROID_performance_metrics

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

XR_ANDROID_raycast

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

XR_ANDROID_scene_meshing

允许应用实时获取现实世界环境的语义 3D 网格。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_FINE

XR_ANDROID_trackables

此扩展程序允许应用访问实体环境中的可追踪对象(例如飞机),并创建附加到可追踪对象的锚点。此扩展程序需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_trackables_object

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

XR_ANDROID_unbounded_reference_space

提供可用于随着时间的推移构建更好的场景理解的无界限参考空间。此参考空间可让观看者在复杂环境中自由移动,通常会移动到距离起始位置数米远的地方,同时始终优化观看者附近的坐标系稳定性。

其他受支持的扩展服务

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


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