在 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 版本下选择:
    谷歌API的英特尔凌动x86的系统映像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中通过单击打开的AVD管理Tools > AVD Manager

  2. 点击Create Virtual Device ,在AVD管理器对话框的底部。

  3. 选择或创建您想要的手机的硬件配置文件,并选择Next

  4. 选择x86x86_64运行的API等级27或更高版本的系统映像,并选择Next

    • 虽然 API 级别 24 或更高版本支持物理 ARCore 设备,但 Android Emulator 支持需要 API 级别 27 或更高版本。

    • 仅支持基于 x86 的 Android Emulator 架构。其他架构如arm64-v8aarmeabi-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.28.0_x86_for_emulator.apk发布页面。

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

    启动所需的AVD,然后从你的系统文件夹(即,拖动下载的APK Downloads )到正在运行的仿真,或者使用安装adb虚拟设备运行时:

    adb install -r Google_Play_Services_for_AR_1.28.0_x86_for_emulator.apk

对您想要使用的任何其他 AVD 重复这些步骤过程。

控制虚拟场景

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

移动虚拟摄像机

长按Option (MacOS的)或Alt (Linux或Windows)访问摄像机的运动控制。使用以下控件移动相机:

平台行动该怎么办
苹果系统向左或向右移动按住Option键按A键或d
向下或向上移动按住Option键按QE
向前或向后移动按住Option键按WS
更改设备方向按住Option键鼠标移动
LinuxWindows向左或向右移动按住Alt +按A键或d
向下或向上移动按住Alt +按QE
向前或向后移动按住Alt +按WS
更改设备方向按住Alt +鼠标移动

释放OptionAlt在模拟器回交互模式。

使用Virtual Sensors的选项卡扩展的控制更精确的定位设备。

将增强图像添加到场景中

将图像载入仿真器的模拟环境测试增强图像

使用Camera的选项卡Extended controls添加或修改Scene images 。有两个图像位置,一个在墙上,一个在桌子上。

要查看场景中的这些图像位置,请启动模拟器,然后通过摄像机起始位置后面的门将摄像机移动到餐厅区域。

故障排除提示

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

  • 如果您的应用程序的Arcore无法打开相机时,它的推出,确保Camera Back设置为VirtualScene ,如所描述的上述配置步骤

  • 如果您的 ARCore 应用程序无法打开并显示错误消息“无法创建 AR 会话”,请检查应用程序日志。如果你找到一个java.lang.UnsatisfiedLinkError使用包含消息/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)你可能已经安装了谷歌播放服务AR的版本错误apk. 创建一个新的虚拟设备并安装 x86 版本。