本文档将引导您了解如何在 Android Studio 中使用 Android XR 模拟器和布局检查器来构建 XR 应用。
Android Studio 包含以下适用于 XR 的新功能
- Android XR 模拟器
- 布局检查器中的 XR 支持
Android XR 模拟器
Android XR 模拟器提供虚拟化的 XR 设备,用于在 Android Studio 中测试和调试您的 XR 应用。它模拟 XR 设备,让您可以在 3D 空间环境中体验您的应用。这样,您在早期开发阶段无需物理硬件即可构建应用,从而简化工作流并加快迭代速度。
如果这是您首次在 Android Studio 中使用模拟器,请查看有关 Android 模拟器的一般文档。
启动 Android XR 模拟器
安装 Android XR 模拟器后,点击设备管理器中设备的运行按钮。
启用鼠标和键盘
目前,模拟器仅支持鼠标和键盘输入。使用模拟器时,请确保选中键盘和鼠标图标。
完成此操作后,您可以通过将鼠标移到模拟器窗口上来开始与虚拟空间中的各种元素进行交互。
在虚拟环境中查看和移动
Android XR 模拟器在虚拟 3D 环境中渲染应用元素。使用以下控件更改视图方向、平移、推拉、旋转和重置
![]() |
平移:点击并拖动鼠标,向上、向下和左右移动。这将允许从不同角度查看模拟器内容 |
![]() |
推拉:点击并拖动鼠标,使您与视野中的对象更近或更远 |
![]() |
旋转:点击并拖动鼠标,向该方向旋转视图 |
![]() |
重置:点击此按钮可将模拟器恢复为默认视图 |
您还可以使用以下键盘快捷键在虚拟环境中移动。在使用鼠标和键盘输入时,按住 Option 键 (macOS) 或 Alt 键 (Windows) 即可使用这些快捷键。
- W(或向上箭头键):在当前视图中向前移动。
- A(或向左箭头键):向左侧移。
- S:(或向下箭头键):向后移动。
- D(或向右箭头键):向右侧移。
- Q:垂直向下移动。
- E:垂直向上移动。
启用透视模式
使用以下菜单选项启用或停用模拟的透视环境。
启用后,透视模式将显示模拟的室内环境。使用此模式在混合现实中测试应用。
其他模拟器控件
![]() |
电源:模拟设备开机或关机 |
![]() ![]() |
音量:模拟音量控制 |
![]() |
屏幕截图:截取设备当前状态的屏幕截图 |
![]() ![]() ![]() |
Android 三按钮控制:模拟返回、主屏幕和概览按钮 |
问题排查
请查看版本说明,了解任何已知问题和解决方法。
如果您遇到不是已知问题的问题,请查看支持页面,了解获取帮助和报告问题的说明。
附上崩溃报告或 Bug 报告将有助于我们更好地理解问题。屏幕截图和录像也提供了所需的更多详细信息。本部分中的说明介绍了如何上传崩溃报告以及如何使用 adb 生成 Bug 报告。
将 Android Studio 布局检查器与 XR 应用结合使用
开始构建空间面板和轨道器后,您可以使用 Android Studio 布局检查器检查布局。如果您不熟悉布局检查器,请参阅我们的布局调试指南。
按照以下步骤将布局检查器与您的 Android XR 应用结合使用
- 在 Android Studio 中打开项目后,请确保已停用嵌入式布局检查器(取消选中该选项并重启 Android Studio)。
- 运行您的应用。
- 应用部署完成后,选择工具 > 布局检查器。
此布局检查器将在嵌入式窗口中打开。几秒钟后,左侧显示预览,右侧显示组件树。轨道器和面板作为独立对象显示在您的主要内容下方。
现在,您可以在模拟器中与您的应用进行交互。如果要检查任何组件,请在预览或组件树中点击它。
点击右侧角落的“属性”标签页,即可查看组件属性。
启用使用情况统计信息以帮助改进 Android Studio for XR
请考虑启用使用情况统计信息并发送反馈,以帮助我们改进这些工具。由于这是 Android Studio 的 Canary 版本,因此其中许多功能仍在开发中。
点击设置 > 外观与行为 > 系统设置 > 数据共享,并确保选中向 Google 发送使用情况统计信息。
OpenXR™ 和 OpenXR 徽标是 The Khronos Group Inc. 拥有的商标,并在中国、欧盟、日本和英国注册为商标。