为图片添加维度

平台专用指南

借助 ARCore 中的增强图像 API，您可以构建 AR 应用，以检测和增强用户环境中的 2D 图像（例如海报或产品包装）。

您需要提供一组参考图片。ARCore 使用计算机视觉算法从每张图片的灰度信息中提取特征，并将这些特征的表示法存储在一个或多个增强图像数据库中。

在运行时，ARCore 会在用户环境中的平坦表面上搜索这些功能。这样一来，ARCore 就能检测现实世界中的这些图像，并估计它们的位置、方向和大小（如果未提供此类图像）。

功能

ARCore 最多可以同时跟踪 20 张图像。ARCore 不会同时检测或跟踪同一图像的多个实例。

每个增强型图片数据库最多可存储 1,000 张参考图片的信息。数据库数量不受限制，但任何时候都只能有一个数据库处于活动状态。

您可以在运行时将图片添加到增强图像数据库，每个数据库最多可添加 1,000 张图片。您可以使用网络连接下载之前创建的数据库。

添加图片时，您可以提供要检测的图片的实际尺寸。这样做可以提高图片检测性能。

ARCore 可以响应和跟踪以下类型的图像：

ARCore 开始跟踪图片后，它会在每一帧中提供图片位置和方向的估算值。随着 ARCore 收集的数据增多，这些估算会持续优化。

一旦检测到图像，ARCore 就会继续“跟踪”图像的位置和方向，即使图像因用户移动设备而暂时离开摄像头视图也是如此。在这种情况下，ARCore 会假定图像的位置和方向是静态的，并且图像本身不会在环境中移动。

所有跟踪都**在设备上**完成。无需连接到互联网即可检测和跟踪图片。

图片必须：

启用增强图像功能可能会增加 ARCore 的 CPU 利用率，具体取决于已启用的 ARCore 功能。在 AR 体验不需要时，不妨考虑停用所有未使用的功能。这将为您的应用提供额外的 CPU 周期，并提升热性能和电池续航时间。

如需了解详情，请参阅性能注意事项。

使用 Android 版 arcoreimg 工具生成图片数据库文件。此工具仅适用于 Android 和 Android NDK 开发。它内置于 Unity SDK 和 ARCore Unreal 插件中。
数据库会存储从参考图像的灰度数据中提取的特征的压缩表示。每个图片条目占用大约 6 KB。
运行时，将一个图像添加到数据库需要大约 30 毫秒。
- 在工作线程上添加图片，以免阻塞界面线程。
- 或者，如果可能，使用 ARCore SDK 中包含的 arcoreimg 工具在编译时添加图片。
如果您知道图片的预期物理大小，请进行指定。此信息可以提升检测和跟踪性能，尤其是对于较大的物理图像（超过 75 厘米）。
避免在数据库中保留许多未使用的图片，因为这会导致 CPU 利用率增加，从而对系统性能产生一定的影响。

如果您的图片绝不会从初始位置移动（例如，贴在墙上的海报），您可以在图片上附加锚点以提高跟踪稳定性。
物理图像必须占据摄像头图像的至少 25%，才能进行初始检测。您可以提示用户将物理图像放在他们的摄像头取景范围内。
在图像的跟踪状态变为“完全跟踪”之前，请勿使用图像的姿态和大小估算。在 ARCore 初次检测到图像时，如果未指定预期的物理大小，图像的跟踪状态将暂停。这意味着，ARCore 已识别出图像，但未收集到足够的数据来估算图像在 3D 空间中的位置。