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

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

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

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

直接预览 OpenXR 支持

借助直接预览功能,您可以在引擎的视口内立即测试以下流式扩展程序,延迟时间很短:

功能或能力 OpenXR 扩展字符串

设备锚点持久性

XR_ANDROID_device_anchor_persistence

Raycast

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 对应的 Set,将引擎调用从宿主机重定向到设备流。

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

在游戏引擎中配置并启动直接预览

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

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

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