iOS 云锚点快速入门

ARCore Cloud Anchor API（简称 ARCore 云锚点服务）可为您的 iOS 应用提供云锚点功能， 使 iOS 和 Android 用户都能共享 AR 体验。

本指南将介绍如何执行以下操作：

  • 设置开发环境以使用云锚点
  • 在示例应用中尝试托管和解析锚点

前提条件

  • Xcode 版本 13.0 或更高版本
  • Cocoapods 1.4.0 或更高版本（如果使用 Cocoapods）
  • 运行 iOS 12.0 或更高版本且与 ARKit 兼容的 Apple 设备 （需要 iOS 12.0 或更高版本的部署目标）

使用云锚点

以下步骤使用 Cloud Anchors 示例应用向您展示了 用于配置和构建支持 ARCore 云锚点的应用的任务。

获取 Cloud Anchors 示例应用

  1. 从 GitHub 克隆或下载 ARCore SDK for iOS 获取示例应用代码。

  2. 打开终端或 Finder 窗口，并导航到您克隆的文件夹 或下载了 SDK。

  3. 您可以在以下位置找到示例应用代码：
    /arcore-ios-sdk-master/Examples/CloudAnchorExample。

    永久性云锚点示例应用代码是 位置：
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample。

会话设置

在设置 会话：

设置云锚点 ID 共享

Cloud Anchors 示例应用使用 Firebase 在下列二者之间共享云锚点 ID： 设备。您可以在自己的应用中使用不同的解决方案。

如需在示例应用中设置 Firebase 数据库，请执行以下操作：

  1. 按照 Firebase 说明将 Firebase 添加到您的应用。
  2. 下载添加过程中生成的 GoogleService-Info.plist 文件 Firebase 添加至您的应用。
  3. 为示例启用 Firebase 存储：
    • 转到 Firebase 控制台，然后选择您为其设置的项目 示例应用。
    • 选择 Database 面板。
    • 在 Realtime Database 选项上，点击 Get Started。
    • 系统随即会打开 Security rules for Realtime Database 菜单。
      • 如需运行该示例，请选择 Start in test mode。
      • 请注意，如果您正在使用 Firebase 开发您计划发布的应用， 您应使用限制性更强的安全规则。
  4. 在 Xcode 中，将 GoogleService-Info.plist 文件添加到应用的 Info.plist。

设置 ARCore API

要使用云锚点，您必须先设置 ARCore API，适用于您的应用。

运行 Pod 更新

CloudAnchorExample 应用程序随附Podfile预配置 您需要的 ARCore SDK 和 iOS 版本。如需安装这些依赖项，请执行以下操作：

  1. 打开终端窗口，然后从pod update Xcode 项目已存在。
    这将生成一个 .xcworkspace 文件，稍后您将使用该文件来构建和 运行应用所需的资源

请参阅将 ARCore SDK 添加到您的应用 详细了解如何在自己的应用中配置 Podfile。

  1. 在 Xcode 中打开项目的 .xcworkspace 文件。

    为避免构建错误，请确保从 .xcworkspace 构建 而不是 .xcodeproj 文件。

更改 app bundle ID

在 Xcode 中，更改应用的软件包 ID，以便与您的团队一起为应用签名。

构建并运行应用

  1. 连接您的设备并在 Xcode 中启动该应用。

  2. （可选）如果您正在构建和运行示例应用，请参阅以下内容 部分，详细了解如何使用该应用托管和解析云锚点。

试用示例应用

  1. 从 .xcworkspace 文件构建并运行示例应用以启动 。

  2. 如果系统提示，请向应用授予相机权限。ARKit 和 开始检测您的摄像头前方的平面。

  3. 点按 HOST 以进入托管模式。用于共享托管锚点的房间代码 系统就会生成并显示在屏幕上

  4. 点按某个平面，开始在该平面上托管云锚点。

    • 应用会在平面上放置一个 Andy Android 物体，并将一个锚点连接起来 。
    • 系统向 ARCore API 云端点发送一个主机请求。主持人 请求包含表示锚点相对于 视觉特征。
    • 托管后，锚点将获得一个用于解析云的 ID 锚点。

  5. 点按“RESOLVE”并输入房间代码即可之前访问 使用相同或不同的设备为此会议室托管的云锚点。

    • 将向 ARCore API 云端点发送一个解析请求。
    • 解析请求包含云锚点 ID。如果 ID 与 托管锚点和定位成功，则服务器返回 在本地坐标中对锚点进行转换。
    • 示例应用使用转换将锚点添加到您的场景中，然后 来渲染连接到它的虚拟对象。

将 ARCore SDK 添加到您的应用

在您自己的应用中，您需要更新Podfile以包含 ARCore SDK 和支持的 iOS 版本控制。具体操作步骤如下：

  1. 将以下 platform 和 pod 添加到您的 项目的 Podfile：

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
  1. 打开终端窗口，然后从所在的文件夹运行 pod update 您的 Xcode 项目已存在。
    这将生成一个 .xcworkspace 文件，用于构建和 运行应用所需的资源

永久性云锚点

如托管具有持久性的云锚点中所述， 您可以为云锚点提供最长 365 天的存留时间。适用于以下应用的示例代码： /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample中提供了使用永久性云锚点的教程， 来自 GitHub 的 ARCore SDK for iOS 目录下。

后续步骤