借助 Direct Preview，您可以使用来自 Android XR 设备的实时数据，直接在 Unreal Editor 中测试和迭代复杂的互动。 借助 Direct Preview，主机可以渲染和调试内容，将视觉视口直接流式传输到实体 Android XR 设备，并将受支持的 OpenXR 扩展实时流式传输回主机。
请按照本指南在 Unreal Engine 中为您的项目设置 Direct Preview。
前提条件
在开始之前，请确保您的开发环境满足以下要求：
- Unreal Engine 版本：Unreal Engine 5.6.x 或 5.8.x。
- 项目设置：完成 Unreal Engine 项目设置指南中的所有步骤。
- Android XR Engine Hub：完成 Android XR Engine Hub 指南入门部分中的所有步骤，以便安装和配置主机，从而使用 Direct Preview。
硬件：
- 使用运行 Windows 11 的宿主机。
- 使用支持 Vulkan 视频编码的现代显卡。
设置 Android XR 插件
使用所需的 Android XR 插件设置 Unreal Engine：
按照适用于 Unreal Engine 的 Android XR 扩展程序快速入门指南中的步骤操作。
之后，如果您创建新项目或打开未与 Direct Preview 搭配使用的项目，请再次按照这些步骤操作。
对于每个项目，请确保该项目具有指向供应商插件文件夹的符号链接。
配置项目设置
为 Direct Preview 串流配置项目设置：
- 依次前往 项目设置 > Platforms > Windows。
- 将 RHI 更改为 Vulkan。
- 依次前往修改 > 插件。
- 启用 AndroidXRStreaming 插件。
- 依次前往修改 > 项目设置 > 说明。
- 启用在 VR 中启动。
启用流式传输运行时
现在，项目已启用 AndroidXRStreaming 插件，请检查 Android XR 流式传输运行时是否存在：
- 依次前往 Project Settings（项目设置）> Plugins（插件）> AndroidXRStreaming。
点击 Enable AndroidXR Streaming。
重启虚幻引擎以应用这些更改。
配置流式传输客户端
使用不同的选项为您的项目配置流式传输客户端：
- 前往 Project Settings（项目设置）> Plugins（插件）。
在 AndroidXRStreamingClient 部分中，查看以下每个选项，并根据项目需求启用或停用这些选项：
- Auto Start Client On Preview：启用后，在编辑器中点击 Start VR Preview 时，会在任何有效的所选设备上启动预览客户端应用。
- Auto Stop Client On Preview：启用后，当编辑器中的 VR 预览停止时，预览客户端也会终止。
- 自动选择兼容设备：启用后，在搜索设备时，系统会自动选择连接到机器的第一台兼容设备。
- 显示错误对话框：启用后，会显示其他错误对话框（例如，如果您尝试在未选择客户端设备的情况下启动 VR 预览，系统会显示错误对话框）。停用此选项可隐藏这些对话框。
- 刷新：启用后，刷新按钮会搜索已连接的设备，并列出兼容的设备（通过 Android XR Engine Hub 中是否存在 Direct Preview 客户端应用来确定）。
开始直接预览
启动 Direct Preview，直接从 Unreal Engine 进行流式传输：
使用优质 USB-C 数据线将 Android XR 设备连接到主机。
如果您之前从未在此设备上使用过 Direct Preview，请先在 Android XR Engine Hub 中连接并配置该设备以使用 Direct Preview，然后再通过游戏引擎启动 Direct Preview。
在 Unreal 编辑器中，点击 Play level in VR（在 VR 中播放关卡）。启动 Direct Preview 时，请勿使用常用的 Play in Editor 选项。