Vuforia发动机和AR基金会

Vuforia Engine可以与AR Foundation一起在同一场景中使用,无论您开始使用哪个平台进行开发。利用这两个平台,通过Unity的Package Manager将其中一个添加到您的项目中,从而增强您的AR项目。

概述和前提条件

可以将Vuforia Engine目标添加到现有的AR Foundation项目中,同样,也可以将AR Foundation功能添加到已经使用Vuforia Engine的Unity项目中。AR Foundation支持允许您在Vuforia场景中使用垂直平面或环境探测器,或在AR Foundation场景中使用模型目标和区域目标。 

要求

  • 请参阅支持的版本在支持的Unity Editor版本上。
  • AR Foundation 5.0或更高版本。
  • ARKit和/或ARCore支持的设备。
  • Vuforia开发人员许可证密钥。

此跨平台集成不支持UWP平板电脑、HoloLens和Magic Leap设备。

支持所有Vuforia引擎功能,支持所有AR Foundation功能,但内容缩放除外。这两个平台都使用相同的坐标系,这意味着锚和平面检测可以与环境中的AR内容检测和定位互换。 

注:在同一场景中组合Vuforia Engine和AR Foundation确实会增加性能开销和延迟。虽然这在iOS设备上几乎看不到;在Android上,这将导致Vuforia目标的延迟更高,跟踪更不稳定。 

无论如何,我们建议仅在需要Vuforia Engine和AR Foundation的功能时才同时使用它们。为了获得最佳性能和最低延迟,请使用不带AR Foundation的Vuforia引擎。

添加Vuforia或AR基金会

当Vuforia引擎目标添加到现有的Unity场景时,如果AR Foundation已被使用,Vuforia将在运行时自动检测。如果场景已经包含ARFoundation游戏对象,则Vuforia AR相机游戏对象不需要添加到场景中。 

统一设置

确保您的Unity项目正确地针对您希望构建的平台。此外,根据所选平台包括平台提供商。

从空的统一场景设置

确保您的Unity项目正确地针对您希望构建的平台。此外,根据所选平台包括平台提供商。

  • 安装并启用平台特定的XR插件。
    • 转到窗口->包管理器并安装XR插件管理包。
    • 项目设置选择XR插件管理-><平台>并启用插件提供程序(即ARKit、ARCore)。

将Vuforia引擎添加到AR Foundation场景中。

  1. 使用包管理器将Vuforia Engine SDK 10.16或更高版本添加到项目中。首先,从下载并导入SDKVuforia的开发者门户。有关添加Vuforia引擎的更多信息,请参阅Unity的Vuforia引擎包托管.
  2. 在中添加许可证密钥Vuforia配置 .

注: The Vuforia行为组件自动添加到AR Foundation的AR相机游戏对象在运行时,只要Vuforia引擎目标添加到ARFoundation场景中。The 世界中心模式将自动设置为设备

将AR Foundation添加到Vuforia引擎场景

将AR Foundation添加到支持Vuforia的现有项目的过程类似。 

  1. 打开程序包管理器窗口中搜索列表统一登记处AR Foundation软件包。请参见Unity 2021 AR Foundation 5.0如果包管理器中没有出现版本5或更高版本。
  2. 点击然后按安装按钮。

构建AR场景

为了让Vuforia Engine和AR Foundation并肩工作,场景中需要来自这两个平台的组件。你也应该只使用一个AR相机游戏对象–即主摄像头来自ARFoundation。 

注:为了在ARFoundation场景中使用Vuforia引擎目标,构建时场景中至少需要存在一个Vuforia目标。不支持仅在运行时通过脚本添加目标。

以下步骤演示了如何结合Vuforia Engine Image Targets和ARFoundation的环境探测器构建示例场景:

  1. 首先用AR Foundation替换场景中的默认摄影机XR Origin游戏对象。 右键单击等级制度并选择XR->XR来源(移动AR).
    1. 这个主摄像头是的子级第个e(电子) XR来源 游戏对象
  2. 从同一菜单中添加AR会话游戏对象。
  3. 通过右键单击添加Vuforia目标层次结构并选择Vuforia引擎->将任何所需内容添加到Vuforia目标,例如,将球体作为子对象。

  4. 添加AR环境探测管理器组件到XR Origin游戏对象.

  5. 创建新材质并设置其金属色平滑度属性设置为1(一)。还应确保镜面反射高光反思已启用。
  6. 将材质指定给用作Vuforia目标增强的球体。这将显示环境探测器对目标增强的反射。

  7. 继续设置生成设置如我们的Unity入门将项目引导并构建到您的设备上进行测试。 

Vuforia依靠AR Foundation在同一场景中创建锚。因此AR锚定经理组件是必需的XR Origin游戏对象.

AR会话

AR基金会AR会话控制AR体验的生命周期,重置它将重置Vuforia依赖的数据,如锚位置。例如,当卸载场景并且Vuforia行为已被销毁。  

Vuforia地平面

为了将Vuforia Engine的接地平面(Plane Finder和Ground Plane Stage)功能与ARFoundation一起使用,需要将以下AR Foundation组件添加到XR Origin游戏对象.

  • AR Raycast经理
  • AR平面经理