Android NDK 快速入门

设置您的开发环境

  • 安装 Android Studio 3.1 版或更高版本,以及 Android SDK Platform 7.0 版(API 级别 24) 或更高版本。

  • 安装 Android Native,让 Android Studio 为原生开发做好准备 开发套件 (NDK) 和 CMake 以及 SDK 管理器。如需了解详情,请参阅 NDK 使用入门

  • 您需要获得 ARCore SDK for Android。您可以选择以下任一解决办法:

    • 下载 ARCore SDK for Android 并 提取。

      也可以

    • 使用以下命令克隆代码库:

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

准备设备或模拟器

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

打开示例项目

在 Android Studio 中,打开 <ARCore SDK Folder>/samples/hello_ar_c 中的 hello_ar_c 示例项目。

示例项目在某些软件版本上具有构建依赖项,例如 作为 Gradle 和 Android SDK。如果未安装所需的依赖项 Android Studio 会请求您允许下载这些程序,并将其安装到您的 虚拟机。

运行示例

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

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

当您移动设备时,该应用会自动检测平坦的表面,并绘制一个 菱形网格。点按网格可以在一个三维 ARCore 小兵上 。

使用即时展示位置

借助 Instant Placement API,用户可以将 AR 对象放置在屏幕上 而无需等待 ARCore 检测表面几何形状。对象放置 随着用户在环境中进一步移动而实时优化。一次 ARCore 在放置 AR 物体的区域内检测到正确的姿势, 对象会自动更新为精确的姿势。

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

即时展示位置

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

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

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

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

使用深度

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

即时展示位置

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

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

在图 3 中,启用了深度。

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

后续步骤