适用于 iOS 的 Google ARCore SDK

版权所有 (c) 2018 Google LLC。保留所有权利。

此 SDK 提供对所有 ARCore 跨平台功能的访问,例如云锚点。

请注意,我们不接受拉取请求。

快速入门

有关云锚点,请参阅适用于 iOS 的云锚点快速入门。有关增强现实面孔,请参阅适用于 iOS 的增强现实面孔快速入门。有关地理空间信息,请参阅适用于 iOS 的地理空间信息快速入门

API 参考

请参阅ARCore iOS API 参考

示例

可以在https://github.com/google-ar/arcore-ios-sdk/tree/master/Examples下载示例应用。请务必遵循 README 文件中的任何说明。

发行说明

SDK 发行说明可在发行页面上找到。

安装

ARCore 需要 >= 11.0 的部署目标。此外,您必须使用至少版本 15.0 的 iOS SDK 进行构建。 ARCore 二进制文件不再包含 bitcode,bitcode 已在 Xcode 14 中弃用,因此如果您使用 Xcode 13 进行构建,则必须为您的项目禁用 bitcode。可以使用 CocoaPods 或 Swift Package Manager 安装 SDK;有关详细信息,请参见下文。

使用 Swift Package Manager

从 1.36.0 版本开始,ARCore 正式支持通过 Swift Package Manager 进行安装

  1. 转到 File > Add Packages 并输入包 URL:https://github.com/google-ar/arcore-ios-sdk
  2. Dependency Rule 设置为 Up to Next Minor Version,然后选择 ARCore 的最新版本。
  3. 选择要包含的所需 ARCore 库。也可以通过 Build Phases > Link Binary With Libraries 稍后添加库。
  4. 将标志 -ObjC 添加到 Other Linker Flags。建议将 Other Linker Flags 设置为 $(inherited) -ObjC
  5. 确保 Enable ModulesLink Frameworks Automatically 构建设置设置为 Yes,因为 ARCore 依赖于自动链接。
  6. 确保 Enable Bitcode 设置为 No,因为 ARCore 二进制文件不包含 bitcode。

其他步骤

在开始使用 ARCore 云锚点 API 或 ARCore 地理空间 API 之前,您需要在 Google Developer Console 中创建一个项目,并启用 ARCore API

用户隐私要求

请参阅用户隐私要求

附加条款

您必须披露 ARCore 的使用情况,以及它如何收集和处理数据。这可以通过显示指向站点“当您使用我们合作伙伴的网站或应用时,Google 如何使用数据”的醒目链接来完成(位于 www.google.com/policies/privacy/partners/,或 Google 可能不时提供的任何其他 URL)。

许可协议和服务条款

使用 ARCore SDK for iOS 即表示您接受 Google 的 ARCore 附加服务条款,网址为 https://developers.google.com/ar/develop/terms

弃用政策

使用 ARCore SDK 1.12.0 或更高版本 构建的应用受云锚点 API 弃用政策的约束。

由于 SDK 使用了较旧的、已弃用的 ARCore 云锚点服务,因此使用 ARCore SDK 1.11.0 或更低版本 构建的应用将从 2020 年 12 月起无法托管或解析云锚点。