为音频眼镜和显示眼镜创建虚拟设备

适用的 XR 设备

本指南可帮助您为以下类型的 XR 设备打造优质体验。

了解 XR 设备类型 →

音频和
显示眼镜

了解 XR 设备类型 →

Android XR 模拟器是 Android 模拟器的专用版本，专为 XR 应用开发者而设计。借助该工具，您可以在熟悉的 Android Studio 环境中测试和调试 XR 应用。

您需要先设置 Android XR 模拟器，然后才能在其中运行应用。 为无屏眼镜和带屏眼镜创建 Android 虚拟设备 (AVD)，以便在测试和调试应用时与 Android XR 模拟器搭配使用。无屏眼镜和带屏眼镜的模拟器充当单独的虚拟设备，您可以将其与运行手机 AVD 的模拟器实例配对。

请按照以下部分中的步骤设置这些虚拟设备所需的一切。

另请参阅

如果您是首次在 Android Studio 中使用模拟器，请参阅 Android 模拟器文档。

检查系统要求

在开始为无屏眼镜和有屏眼镜创建 Android 虚拟设备 (AVD) 之前，请先查看以下系统要求。

注意： Android XR 模拟器专为在 Android Studio 中开发 Android 应用而设计，不支持 Unity 或 OpenXR 应用。

• Android Studio：安装最新 Canary build，并配置 Studio 以进行 XR 开发。
• 系统：一台至少符合 Android 模拟器要求的计算机，但不支持 ChromeOS。请预留额外的磁盘可用空间，因为无屏眼镜和带屏眼镜 AVD 还需要手机 AVD 作为应用的主机设备。

为无屏眼镜或带屏眼镜创建 Android 虚拟设备

如需为无屏眼镜或显示眼镜创建 AVD，以便在测试和调试应用时使用，请按以下步骤操作：

1. 打开最新 Canary build 的 Android Studio，然后依次点击 Tools > 设备管理器 > Add a new device > 创建虚拟设备。

   

2. 在添加设备窗口的设备规格部分中，选择 XR。

3. 从列表中选择无屏眼镜或显示眼镜，然后点击下一步。

4. 在 Configure Virtual Device 标签页的 Select system image 部分中，从系统映像列表中选择与您的系统兼容的最新系统映像。

   

5. 点击 Finish，如果系统提示您下载所选的系统映像，请点击 Yes。

创建手机 AVD 作为主机设备

无屏眼镜和带屏眼镜 AVD 还需要手机 AVD 作为应用的主机设备。

注意： 每个无屏眼镜或有屏眼镜 AVD 都需要一个单独的手机 AVD 作为主机设备。单个手机 AVD 无法与多个音频或显示眼镜 AVD 配对。

首先，创建一个手机 AVD 作为眼镜的主机设备：

1. 在 Android Studio 中，返回设备管理器，然后依次点击 Add a new device > Create Virtual Device。
2. 在添加设备窗口的外形规格部分中，选择手机。
3. 选择任意手机设备（本示例使用 Pixel 9 Pro），然后点击下一步。

4. 从 API 下拉菜单中，选择 API 级别为 canary-20261007 的 API CANARY 预览版。

   

5. 在选择系统映像部分中，从系统映像列表中选择与您的系统兼容的最新系统映像：

   • 预发布 16 KB 页面大小 Google Play ARM 64 v8a 系统映像 (macOS)
   • 预发布 16 KB 页面大小 Google Play Intel x86_64 Atom 系统映像（Windows 和 Linux）

6. 点击 Finish，如果系统提示您下载所选的系统映像，请点击 Yes。

配对设备

最后，配对设备：

1. 在设备管理器中，找到无屏眼镜或显示眼镜 AVD，然后从溢出菜单中选择 Pair Glasses。

   

   注意： 如果您在使用配对助理配对设备时遇到问题，也可以尝试手动配对。

2. 从兼容设备列表中选择手机 AVD。

   

   配对助理会在模拟器中启动两个 AVD 并发起配对。

3. 在手机 AVD 上，接受权限请求以关联设备。

   

   配对助理完成配对。

   

注意： 首次完成配对后，每当您启动模拟器时，模拟器都会自动重新连接设备。如果模拟器无法重新连接设备，请参阅问题排查步骤。

后续步骤

为无屏眼镜和显示眼镜创建 AVD 后，您便可以使用模拟器在 AVD 上运行应用。

---

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