在 Android 模拟器中运行 AR 应用

使用 Android 模拟器 用于在没有实体设备的情况下测试 AR 场景。借助 Android 模拟器 您用一台模拟设备在虚拟环境中运行 ARCore 应用 控制。

设置您的开发环境

软件要求：

获取适用于 ARCore 的 Android Studio 和 SDK 工具

  1. 安装 Android Studio 3.1 或更高版本。

  2. 在 Android Studio 中，前往 Preferences > Appearance and Behavior > System Settings > Android SDK。

  3. 选择 SDK Platforms 标签页，然后选中 Show Package Details。

    在相应 Android 版本下，选择：
    Google API Intel x86 Atom System Image API 级别 27 或更高版本。

  4. 选择 SDK Tools 标签页，然后添加 Android Emulator 27.2.9 或更高版本。

  5. 点击 OK 即可安装所选的软件包和工具。

  6. 再次点击 OK 以确认更改。

  7. Accept 是组件安装程序的许可协议。

  8. 点击 Finish。

创建支持 AR 的虚拟设备

有关详情，请参阅 Android Studio 说明中创建 虚拟设备。

创建新的 Android 虚拟设备 (AVD)

  1. 在 Android Studio 中，点击 Tools > Device Manager 打开设备管理器。

  2. 点击设备管理器面板顶部的 Create Device。

  3. 选择或创建所需的 Phone 硬件配置文件，然后选择 Next。

  4. 选择运行 API 级别 27 或更高版本的 x86 或 x86_64 系统映像 ，然后选择 Next。

    • 虽然 API 级别 24 或更高级别支持实体 ARCore 设备， 若要支持 Android 模拟器，需要使用 API 级别 27 或更高级别。

    • 仅支持基于 x86 的 Android 模拟器架构。其他 arm64-v8a、armeabi-v7 等架构目前 支持。

  5. 验证您的虚拟设备是否已正确配置：

    • 点击 Show Advanced Settings。

    • 确保将 Camera Back 设置为 VirtualScene。

  6. 点击 Finish 以创建 AVD。

运行应用

在模拟器中支持 AR 的虚拟设备上测试 ARCore 应用。待办事项 您可以按照 Android Studio 说明 在 Android 模拟器中运行应用。

更新“面向 AR 的 Google Play 服务”

模拟器上“面向 AR 的 Google Play 服务”的版本可能不符合 日期。请按照以下说明进行更新：

  1. 从 GitHub 下载最新的 Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk 版本页面。

  2. 将下载的 APK 安装到您要使用的每个 AVD 中：

    启动所需的 AVD，然后将下载的 APK 从系统文件夹拖出 （即Downloads）添加到正在运行的 模拟器，也可以在虚拟设备运行时使用 adb 进行安装： 

    adb install -r Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk

针对您要使用的任何其他 AVD 重复执行上述步骤。

控制虚拟场景

当您的应用连接到 ARCore 时，您会看到一个叠加层，其中描述了如何控制 相机和模拟器窗口下方的状态栏。

移动虚拟摄像头

按住 Shift 即可访问摄像头移动控件。 您可以使用以下控件来移动镜头：

操作 您需要采取的措施
向左或向右移动 在按住 Shift 的同时按 A 或 D
向下或向上移动 在按住 Shift 的同时按 Q 或 E
向前移动或向后移动 在按住 Shift 的同时按 W 或 S
更改设备屏幕方向 按住 Shift 并移动鼠标

释放 Shift 以返回到模拟器中的交互模式。

使用 Extended controls 中的 Virtual Sensors 标签页 以便进行更精确的设备定位。

向场景添加增强图像

将图像加载到模拟器的模拟环境中，以测试增强图像。

使用 Extended controls 中的 Camera 标签页添加或修改 Scene images。 有两个图片位置，一个在墙上，另一个在桌子上。

要在场景中查看这些图像位置，请启动模拟器，然后移动 摄像头拍摄到用餐区域 排名。

问题排查提示

  • 如果您的 ARCore 应用启动，并且您看到“此设备不支持 AR”消息， 请查看系统映像的修订版本请确保您使用的是 API 级别 27 修订版本 4 或更高版本。

  • 如果您的 ARCore 应用在启动时无法打开摄像头，请确保 Camera Back 设置为 VirtualScene， （如上文的配置步骤中所述）。

  • 如果您的 ARCore 应用无法打开，并显示“Failed to create AR”（未能创建 AR）错误消息 会话"查看应用日志。如果您发现java.lang.UnsatisfiedLinkError 如果显示包含“/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)”的消息，则表明您可能安装了 面向 AR 的 Google Play 服务 APK。创建新的虚拟设备并安装 x86 版本。