Android 版快速入门

要开始在 Android 设备上使用 ARCore，您可以运行 ARCore 中包含的 hello_ar_kotlin 或 hello_ar_java 示例应用 SDK。这些示例应用使用 OpenGL， 用于渲染 2D 和 3D 矢量图形的编程接口。应用显示 并允许用户点按平面来放置 3D 模型。

设置您的开发环境

打开示例项目

  1. 在 Android Studio 中，克隆 ARCore SDK GitHub 代码库。

    为此，您可以采用多种方法：

    • 对于已建立的 Android Studio 安装：

      • 从 Git 菜单中选择 Clone。
      • 在Version control中 下拉菜单中，选择 Git 作为版本控制系统。

      • 在 URL 字段中，输入以下指向 ARCore GitHub 的网址 代码库：

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

    • 您还可以打开一个 Terminal 并发出 git clone 命令，如下所示： 如下：

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

  2. 按如下方式打开某个示例项目（您必须明确打开一个 以便构建和运行该虚拟机）。

    • 从 File 菜单中选择 Open。
    • 在 arcore-android-sdk/samples 文件夹中，选择 hello_ar_kotlin 或 hello_ar_java 文件夹中，然后点击 Open。

准备设备或模拟器

您可以在受支持的设备上运行 AR 应用，或者 在 Android Emulator 中。您必须更新“面向 AR 的 Google Play 服务” 在模拟器上执行相应操作。请参阅 在 Android 模拟器中运行 AR 应用 了解详情 信息。

运行示例

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

Android Studio 将您的项目构建成可调试的 APK，安装该 APK，然后 然后在您的设备上运行应用如需了解详情，请参阅 构建和运行应用。

系统可能会提示您安装或更新面向 AR 的 Google Play 服务 文件缺失或过期。选择CONTINUE进行安装 Google Play 商店，或按照说明手动更新该应用 更新“面向 AR 的 Google Play 服务”。

借助 hello_ar_java 应用，您可以将三维 ARCore 典当放在 检测到的 AR 平面表面它通过 Android GL SurfaceView 实现， 用于渲染相机预览和基本 AR 对象（例如平面） 和锚点您可以在以下位置找到 hello_ar_java 的示例渲染框架： com/google/ar/core/examples/java/common/samplerender。

使用即时展示位置

借助 Instant Placement API，用户无需等待 ARCore 检测表面几何形状，便可将 AR 对象放置在屏幕上。随着用户在环境中进一步移动，对象放置位置也会实时优化。

点按屏幕以放置物体。请务必继续移动设备 看到全息对象显示在屏幕上，以便 ARCore 可以 获取有关周围环境的足够数据，以便准确锚定虚拟环境， 对象。

ARCore 检测到表面几何形状并在 该对象的放置区域，该对象的姿态会自动更新 以确保准确性。

即时展示位置

在图 1 中，Instant Placement 已停用，并且未定义 Surface 几何图形。 放在台球桌右侧的地板上（四个小蓝点）的物品 它们的姿势都不确定。

在图 2 中，“即时展示位置”从齿轮图标下的菜单中启用。

在图 3 中，在启用即时展示位置的情况下，在场景中放置了一个新对象。 它以灰度模式显示，而不是彩色，以表示它未被 已经校正为准确的姿势。

在图 4 中，当 表面几何图形（由可跟踪的网格线描述）进行检测。

使用深度

启用 Depth 后，ARCore 会考虑场景中物体的几何形状和位置，并计算 放置在场景中的相对于场景中其他对象的对象。它允许 放置的对象被场景中的物体遮挡， 。

即时展示位置

在图 1 中，“深度”处于停用状态。台球桌下方有一个对象。

在图 2 中，当设备在台球桌周围移动时，物体会出现 无论场景中的物体如何都跟随设备

在图 3 中，启用了深度。

在图 4 中，对象现在显示为被台球表遮挡成了设备 在场景中四处移动

后续步骤