在 Android XR Engine Hub 中设置直接预览

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

直接预览功能是 Android XR Engine Hub 中的一项功能,可让您使用 Android XR 设备中的实时数据,直接在 游戏引擎的编辑器中测试和迭代复杂互动。这样可以完全绕过 XR 开发中通常耗时的构建和部署周期。

借助直接预览功能,宿主机无需在每次更改时都导出完整的 APK,而是渲染和调试内容,将视觉视口直接流式传输到实体 Android XR 设备,并实时将受支持的 OpenXR 扩展流式传输回宿主机。

直接预览 OpenXR 支持

借助直接预览功能,您可以在引擎的视口内进行即时低延迟测试,以测试以下流式传输的扩展:

功能或能力 OpenXR 扩展字符串

设备锚点持久性

XR_ANDROID_device_anchor_persistence

光线投射

XR_ANDROID_raycast

可跟踪对象(平面/深度)

XR_ANDROID_trackables

对象跟踪

XR_ANDROID_trackables_object

场景网格化

XR_ANDROID_scene_meshing

面部跟踪

XR_ANDROID_face_tracking

眼动跟踪

XR_ANDROID_eye_tracking

直通相机状态

XR_ANDROID_passthrough_camera_state

手部互动

XR_EXT_hand_interaction

在 Android Engine Hub 中开始使用直接预览功能

按照以下部分中的步骤启用直接预览功能,配置实体 Android XR 设备,并在游戏引擎中启用和启动低延迟直接预览功能:

下载并安装 Android XR Engine Hub

首先,下载并安装最新版本的 Android XR Engine Hub。

连接和配置 Android XR 设备

接下来,连接和配置 Android XR 设备以进行直接预览:

  1. 关闭所有正在运行的游戏引擎编辑器。
  2. 打开 Android XR Engine Hub

    Android XR Engine Hub 中的“设备管理器”界面

  3. 使用优质 USB-C 数据线将 Android XR 设备连接到宿主机。

  4. 从界面顶部的设备下拉菜单中,选择已连接的 Android XR 设备。

    选择要与直接预览功能搭配使用的设备

  5. 检查流客户端是否已初始化:

    1. 点击 Install Stream Client (安装流客户端),将必要的守护程序部署到头戴式设备。
    2. 针对 Active OpenXR Runtime (活跃的 OpenXR 运行时)点击 Set (设置),将引擎调用从宿主机重定向到设备流。

    在 Android XR Engine Hub 中启用直接预览

在游戏引擎中配置和启动直接预览功能

最后,在游戏引擎中配置和启动直接预览功能:

  1. 完成游戏引擎的首次设置和配置步骤:

  2. 每次要启动直接预览功能时,请按照游戏引擎的“启动直接预览”部分中的步骤操作: