Unreal 增强图像开发者指南

先决条件

  • 本指南假定您已安装并配置 Unreal Engine 4.19 以及 GoogleARCore 插件 1.2+。 否则,请参阅 Unreal 快速入门中的安装和设置步骤。

构建并运行示例

下载 arcore-unreal-sdk 以获得增强图像示例项目。

如需了解有关构建并运行示例项目的说明,请参阅 Unreal 快速入门

使用增强图像

  1. 要使用增强图像功能,请在 Unreal 内容浏览器中创建一个 GoogleARCoreConfig 数据 asset。

  2. 创建一个 GoogleARCoreAugmentedImageDatabase 数据 asset。

  3. 打开您在上一步中创建的 GoogleARCoreAugmentedImageDatabase asset,并将您希望 ARCore 检测并追踪的任何图像添加到 AugmentedImages 条目中。

    1. 系统将要求您提供纹理,并且您还可以选择性地提供名称和图像在实境中的预估宽度(米)。 请注意,如果您不知道或无法确定宽度,可以在宽度字段中输入 0.0。 ARCore 将在检测到图像时尝试预估其大小,但用户可能必须进行一些平行运动,以使 ARCore 能检测到图像。

  4. 在您完成增强图像数据库的配置后,打开您的 GoogleARCoreConfig asset,并选择您在 AugmentedImageDatabase 中刚创建的数据库 asset。 请注意,如果您在该会话中不做任何选择,将在您的 ARCore 会话中停用增强图像功能。

  5. 在 BluePrint 或 C++ 中使用 GoogleARCoreConfig 启动您的 ARSession。 您的 AR 应用应全都设置为检测增强图像。

在您的项目中,您可以在 Unreal 的增强现实模块中使用 BluePrint 或 C++ 函数来获取所有追踪的几何形状并尝试投射到 GoogleARCoreAugmentedImage type。 当 ARCore 检测到图像时,您将能获得该 GoogleARCoreAugmentedImage type 的实例。 然后您就可以利用 Blueprint 或 C++ 函数来查询其名称、索引、转换和范围。 详情请参阅示例项目增强图像图中的关卡蓝图。