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
Google Play Services for AR
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
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 and ARCore device profile
data are installed and up to date. If Google Play Services for AR is not
installed (possibly because it was removed by the user) or the version is too
old, or ARCore device profile data is not up to date, your app will prompt the
user to install or update them. 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
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
installed.
Your app should handle these conditions:
Condition | Action |
---|---|
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
the Install ARCore Service Blueprint. |
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.
Next steps
Read the code in the sample app and ARCore for Unreal API reference.