Android 快速入门

以 Android 为 ARCore Unity 应用目标平台入门指南。

本指南向您介绍如何设置您的开发环境和试用 ARCore 示例应用。

要求

您将需要:

硬件

软件

获得 ARCore SDK for Unity

  1. 下载 ARCore SDK for Unity 1.5.0 或更高版本
    下载的 SDK 文件名为 arcore-unity-sdk-v1.5.0.unitypackage

新建一个项目并导入 SDK

  1. 打开 Unity 并新建一个 3D 项目。

  2. 选择 Assets > Import Package > Custom Package

  3. 选择您上面下载的 arcore-unity-sdk-v1.5.0.unitypackage Unity 软件包。

  4. Importing Package 对话框中,确保已选择所有软件包选项,并点击 Import

  5. 出现提示时接受任何 API 升级

打开示例场景

  1. 在 Unity Project 窗口中,您可以在以下位置找到 HelloAR 示例:
    Assets > GoogleARCore > Examples > HelloAR > Scenes

配置构建设置

  1. 转到 File > Build Settings 以打开 Build Settings 窗口。
  2. 选择 Android 并点击 Switch Platform
  3. Build Settings 窗口中,点击 Player Settings
  4. Inspector 窗口中,配置下列播放器设置:
    设置
    Player Settings > Other Settings > Package Name 创建一个 Java 软件包名称格式的唯一应用 ID。
    例如,使用 com.example.helloAR
    Player Settings > Other Settings > Minimum API Level Android 7.0 或更高版本
    Player Settings > Other Settings > Target API Level Android 7.0 或更高版本
    Player Settings > XR Settings > ARCore Supported 启用

构建并运行示例应用

  1. 在您的手机上启用开发者选项和 USB 调试

  2. 将您的手机连接至开发计算机。

  3. 在 Unity Build Settings 窗口中,点击 Build and Run
    Unity 将您的项目构建成 Android APK、将其安装在您的手机上并启动它。

  4. 来回移动您的手机,直至 ARCore 开始检测和显示平面。

  5. 点按某个平面以在其上放置 Andy Android 对象。

  6. (可选步骤)使用 Android Logcat 查看日志消息,或使用 Android 设备监视器更全面地分析设备。

后续步骤

  • HelloAR 示例应用之旅中单步调试 HelloAR 代码。
  • 了解如何在您的应用中启用 ARCore
  • 使用增强图像来构建能对用户环境中的海报或徽标等 2D 图像作出响应的应用。
  • 让您的应用以 Android 或 iOS 为目标平台,并利用云锚点来打造 Android 和 iOS 用户可共享的 AR 体验。