启用 ARCore

本页介绍如何在您的 Unity 项目中启用 ARCore 功能。 为此,您需要做的是:

导入 ARCore SDK for Unity

下载 ARCore SDK for Unity,并通过点击菜单 Assets > Import package > Custom Package 将其导入您的项目。

在 Unity 的 Project 窗口中,您应该能在 Assets/GoogleARCore/Examples/HelloAR/ 中同时看到 SDK 文件和 HelloAR 示例应用。

将您的应用配置为 AR 必备或 AR 可选

在您的应用中启用 ARCore 有两种方法:AR 必备AR 可选。 如果您在决定该选择哪一种方法上需要帮助,请参阅在应用商店中发布 AR 应用

AR 必备

AR 必备是指您的应用没有 AR 便无法使用。 应用商店确保只将 AR 必备应用提供给支持 ARCore 的设备。 当用户安装 AR 必备应用时,应用商店会自动安装 ARCore,然后再安装应用。

要将应用设置为 AR 必备,确保按下图所示勾选 Edit > Project Settings > ARCore > ARCore Required 菜单项。 该菜单项默认情况下处于勾选状态。

您的应用将自动执行运行时检查,以确保设备支持 ARCore 并已将其安装。 如果 ARCore 未安装(可能因为它被用户移除)或版本过旧,您的应用将提示用户安装或更新。 如果安装或更新失败(可能因为网络故障),Session.Status 将返回错误,您的应用应处理错误并退出。

AR 可选

AR 可选是指您的应用包括的一项或多项 AR 功能会在设备支持 ARCore 时启用。 但应用也可在不支持 ARCore 的设备上安装和运行。 当用户安装 AR 可选应用时,应用商店不会自动安装 ARCore

要将应用设置为 AR 可选,请取消选中 Edit > Project Settings > ARCore > ARCore Required 菜单项。

在您的应用中,您需要调用 Session.CheckApkAvailability() 以检查设备是否支持 ARCore,如果支持,则检查是否安装了 ARCore。 您的应用应处理下列三种情况:

  • ARCore 不受支持。 您的应用应隐藏 AR 相关功能。
  • ARCore 受支持,但未安装版本过旧。 您可以通过调用 Session.RequestApkInstallation() 来提示用户安装或更新。
  • ARCore 受支持并且已安装,您可以创建一个 ARCore Session 并开始使用 ARCore。

后续步骤

阅读示例应用和 ARCore for Unity API 参考中的代码。