This page describes how to enable ARCore functionality in your Unreal Engine projects. To do this, you need to:
- Configure your app to be AR Required or AR Optional
- Make sure your app complies with ARCore's User Privacy Requirements
Using Google Play Services for AR to enable ARCore functionality
ARCore SDKs make AR features available on ARCore supported devices that have Google Play Services for AR installed. Users can install and update Google Play Services for AR from the Google Play Store.
There are two ways to enable ARCore in your app: AR Required and AR Optional. If you need help deciding which one to choose, see Publish AR Apps in the Google Play Store.
AR Required means that your app is not usable without AR and makes your app available only on devices that support ARCore.
To make an app AR Required, check the ARCore Required App box in GoogleARCore plugin settings. This setting is located in the menu Edit > Project Settings > Plugins > GoogleARCore.
Your app will automatically perform runtime checks to ensure that the device
supports ARCore and that Google Play Services for AR is installed. If Google
Play Services for AR is not installed (possibly because it was removed by the
user) or the version is too old, your app will prompt the user to install or
update it. If the install or update fails (possibly due to network failure) the
Get ARCore Session Status Blueprint node will return
Error, and your app
should handle the error and quit.
AR Optional means your app can be installed and run on devices that don't support ARCore, but includes AR features that are enabled when running on supported devices. When users install an AR Optional app, the Google Play Store does not automatically install Google Play Services for AR.
To make an app AR Optional, uncheck the ARCore Required App box in GoogleARCore plugin settings.
In your app, use the
Check ARCore Availability Blueprint node to check whether
the device supports ARCore and, if so, whether Google Play Services for AR is
Your app should handle these conditions:
|Device does not support ARCore.||Hides AR-related functionality.|
|Device supports ARCore, but Google Play Services is either not installed or out of date.||Prompts the user to install or update by using
|Device supports ARCore and Google Play Services for AR is installed and up to date.||Starts the service.|
User Privacy Requirements
Make sure your app complies with ARCore's User privacy requirements.
Read the code in the sample app and ARCore for Unreal API reference.