AR Foundation 配置

备注

AR Foundation不是必需的。如果你需要启用EasyAR的AR Foundation支持，或使用AR Foundation的其它功能，需要安装配置AR Foundation。

EasyAR 支持的 AR Foundation 版本

EasyAR Sense Unity Plugin 支持 AR Foundation 5 或更新版本。仅支持 Unity.XR.CoreUtils.XROrigin ，不支持 ARSessionOrigin。

注意

AR Foundation的支持是通过EasyAR Sense的自定义相机实现的。在自定义相机或头显上使用试用产品（个人版license、试用版XR license或试用版Mega服务等）时，EasyAR Sense每次启动后会在固定的有限时间内停止响应。使用付费版本的EasyAR Sense和付费的EasyAR Mega服务没有这个限制。

安装AR Foundation 及ARCore/ARKit插件

参考 AR Foundation 文档 来安装 AR Foundation。需要安装 AR Foundation 、 Google ARCore XR Plugin 以及 Apple ARKit XR Plugin。

../_images/image_g7_1.png

注意

确保安装的 Google ARCore XR Plugin 和 Apple ARKit XR Plugin 版本与 AR Foundation 版本完全一致。版本不匹配可能会导致运行时错误或功能异常。

../_images/image_g7_2.png

配置 XR Plug-in Management

请遵循 AR Foundation 介绍 中的 Project Setup > Install AR Foundation 来进行配置。注意选择你所使用的AR Foundation的版本来阅读。

一般来说，使用AR Foundation之前，需要先在 Unity 中启用 XR Plug-in Management 以支持 AR Foundation：

  1. 在 Project Settings > XR Plug-in Management 中选择当前平台，勾选 Initialize XR On Startup ，

../_images/image_g7_3.png

如果你需要自由控制初始化的时机，你需要保证在EasyAR ARSession的 Assemble 之前调用 AR Foundation的初始化。

  1. 在 Project Settings > XR Plug-in Management 中选择当前平台，在 Plug-in Providers中勾选当前平台的插件。

    • 对于 Android 平台，选择 Google ARCore 。

    • 对于 iOS 平台，选择 Apple ARKit 。

../_images/image_g7_4.png ../_images/image_g7_5.png

  1. 建议在 Project Settings > XR Plug-in Management > Google ARCore `` 中将 ``Requirement 设置为 Optional ， Depth 设置为 Optional ，以确保打包后应用可以在不支持ARCore的手机上运行。

../_images/image_g7_6.png

配置 URP

如果你在使用URP，你需要进行针对性的配置。使用其他渲染管线的用户可以跳过这一步。

请遵循 AR Foundation 介绍 中的 Project Setup > Universal Render Pipeline 来进行配置。注意选择你所使用的AR Foundation的版本来阅读。

请参考Unity官方文档正确配置URP并添加 ARBackgroundRendererFeature ，这里不详细描述。

../_images/image_g7_8.png

另外，你仍需按照类似方法，参考 Universal Render Pipeline (URP) 配置 来配置EasyAR的 EasyARCameraImageRendererFeature ，以确保EasyAR的渲染和AR Foundation的渲染都能正常工作。