适用于 Android 的 Depth API 快速入门

  • 针对 Depth API 设置开发环境
  • 在示例应用中试用遮挡效果并直观呈现深度图

前提条件

打开示例项目

本快速入门使用 OpenGL,这是一种用于渲染 2D 和 3D 矢量图形的编程接口。在开始执行以下步骤之前,请先查看启用 ARCore

使用以下命令克隆代码库以获取示例项目:

git clone https://github.com/google-ar/arcore-android-sdk.git

在 Android Studio 中,打开 hello_ar_java 示例项目,该项目位于 arcore-android-sdk 目录下的 samples 子目录中。

运行示例

借助 Depth API 示例应用,您可以将虚拟 Android 小人置于环境中,并切换遮挡以查看不同之处。它还可以让您切换给定空间中的深度图可视化。

确保您的 Android 设备已连接到开发机器,然后在 Android Studio 中点击 Run

如果面向 AR 的 Google Play 服务缺失或已过时,您的设备可能会提示您安装或更新。点按 CONTINUE 即可从 Google Play 商店安装。

启用深度

首次运行应用并放置 Android 小人时,系统会显示一个对话框,提示您启用深度。它仅在应用首次运行时(对于第一个放置的 Android)显示。点按 Enable 即可添加遮挡效果。

切换遮挡和深度图的可视化

点按齿轮图标可切换遮挡和深度图的可视化效果。 选择 Enable depth 可启用遮挡效果。选择 Show depth map 可在设备屏幕上显示深度图的可视化效果。

例如,以下图片显示了一个虚拟 Android 小人在真实空间中,它旁边有一个后备箱。在第一张图片中,虚拟 Android 与后备箱的边缘不切实际地重叠。在第二张图片中,Android 被适当遮挡,在周围环境中看起来更真实。

下图显示了墙上挂有自行车的走廊的摄像头图像,以及为该摄像头图像创建的深度图的可视化效果。

后续步骤

开始在您自己的应用中使用 Depth API。如需了解详情,请参阅: