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
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 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 make sure that the device supports ARCore and has it installed. If ARCore 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. If the install or update fails, possibly due to network failure, then 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 Play Store does not automatically install ARCore.
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 ARCore is supported on the device, and if supported, whether ARCore is installed. Your app should handle the following three cases:
- If ARCore is not supported, your app should hide AR related functionality.
- If ARCore is supported, but either not installed or too old, you can prompt the user to install or update with the
Install ARCore ServiceBlueprint.
- If ARCore is supported and installed, you can start ARCore.
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.