Vuforia Engine leverages Google's ARCore on devices that support it. Take advantage of ARCore for Ground Plane and Device Tracking (including Extended Tracking) features by enabling ARCore in your project.
Set ARCore as a required, optional, or don’t use depending on the set of devices that you wish to target.
Include ARCore
In Unity, the Android Settings are available in the Vuforia Configuration under the Device Tracker component. The ARCore library is included by default but can be disabled by clearing the checkbox. The included library version is stated on right side. The ARCore Requirement can be set to:
- DON’T USE – Vuforia Engine will not use the library but fall back on its own Ground Plane and Device Tracking technology.
- OPTIONAL – Vuforia Engine will use the library wherever available on supported devices.
- REQUIRED – Vuforia Engine will only run on devices that support the ARCore library.
When included, the Gradle build will automatically include the version of the ARCore library as specified on the Vuforia Supported Versions page. To use a custom version of ARCore, make sure the Include ARCore library option is unchecked.
NOTE: If the Device Tracker's Tracking Mode is set to POSITIONAL in the configuration, the ARCore setting is automatically set to OPTIONAL, but can be changed after that.
Android Build Support
When developing apps with Vuforia Engine and ARCore, you should make sure that your Build Settings are set correctly as 32-bit apps are not supported on 64-bit operated devices and the more recent ARCore libraries. Building the app to an unsupported architecture might result in a black screen.
Set the following Player Settings to build to 64-bit.
- Set the Scripting Backend to IL2CPP.
- Enable the ARM64 and disable the ARMv7 architecture.
NOTE: If 32-bit support is required, you should manually add the ARCore library.
Manually Include ARCore
It is also possible to change the ARCore library version used in the project:
- In the Vuforia Configuration, uncheck the Include ARCore library option.
- In the Project, create the directory: Assets/Plugins/Android.
- Copy the arcore_client.aar file with the intended version to that directory. The aar file can be downloaded from google-ar/arcore-unity-extensions. For older versions, please see here.
NOTE: Please see the current recommended ARCore version on our Supported Versions page.