Unity for iOS 云锚点快速入门

使用云锚点可以打造 Android 和 iOS 用户能够共享的 AR 体验。

先决条件

  • 本指南假定您已下载 ARCore SDK for Unity 并将其导入以 iOS 为目标的 Unity 项目中。

    否则,请参阅 iOS 快速入门中的安装和配置说明。

  • 如果您对锚点的使用不熟悉,请参阅使用锚点,查看介绍。

要求

请参阅 iOS 快速入门中的要求

使用云锚点

针对使用云锚点设置您的开发环境并试用示例应用。

关于云锚点 ID 共享

CloudAnchors 示例应用使用 Unity 的网络功能在同一个网络上的设备之间共享云锚点 ID。

您可以在自己的应用中使用不同的解决方案。

添加 API 密钥

要在您的应用中使用 ARCore Cloud Anchor API,您需要一个 API 密钥。

  1. 获取一个 API 密钥。 如果您对 API 密钥的使用不熟悉,请参阅 Google Cloud Platform Console 帮助中心中的设置 API 密钥

  2. 为您的 Google Cloud Platform 项目启用 ARCore Cloud Anchor API

  3. 将您的 API 密钥添加到项目中:

    • 在 Unity 中,转到 Edit > Project Settings > ARCore
    • 将您的 API 密钥添加到 Cloud Services API Key 字段中。

打开示例场景

CloudAnchors 示例包含在 ARCore SDK for Unity 中。

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

配置构建和平台设置

  1. 将示例场景添加到您的构建中:

    • 转到 File > Build Settings 并点击 Add open scene
    • 选择 CloudAnchors。 停用构建中的任何其他场景。
  2. 按照 iOS 快速入门配置构建和平台设置的步骤操作。

试用示例应用

启用应用。

  1. 转到您的 Xcode 输出文件夹,并在 Xcode 中打开 Unity-iPhone.xcworkspace 文件。
    为了避免构建错误,请不要从包含的 Unity-iPhone.xcodeproj 项目文件构建或启动。

  2. 在 Xcode 中,选择左侧面板中的 Unity-iPhone 项目,连接您的手机,然后启动应用。

托管和解析云锚点

  1. 示例应用将在您的手机上启动,并开始检测您的摄像头前方的平面。

  2. 点按某个平面,在上面锚定一个 Andy Android 物体。

  3. 点按 HOST 按钮,托管锚点。

    将向 Google 云锚点服务发送一个托管请求。 托管请求包含表示锚点相对于附近可视特征的位置的数据。成功的托管请求将在此处创建一个云锚点,并为其分配一个云锚点 ID。

    在托管请求成功后,应用将显示一个房间代码。 您可以在同一个设备或其他设备上使用这个代码访问此房间之前托管的云锚点。

  4. 点按 RESOLVE 并输入之前返回的房间代码,访问此房间的托管云锚点。

    将向 Google 云锚点服务发送一个解析请求,如果成功,将返回房间中当前托管的云锚点。 示例应用使用返回的云锚点的转换来渲染连接到这些锚点的 Andy Android 物体。

后续步骤