Player settings

This article describes the Player settings to pay attention to when packaging an application with the EasyAR Sense Unity Plugin in Unity.

Configuration notes for different platforms

When building in Unity, you need to check and confirm the following settings.

In the Unity menu File -> Build Settings-> Player Settings, click the Android icon to open the Android platform settings.

switchtoandroid

Usually the following options need to be set.

Package Name Set the Android app Package Name. Note that the Package Name must match the one entered when creating the License Key.
Minimum API Level The Minimum API level supported by EasyAR depends on the variant in use. When using the Full variant, Android API Level 24 or higher is required; when using other variants, EasyAR Sense requires Android API Level 21 or higher.

Tip

The Full variant is usually used for Mega Go on-device localization features and 5DoF camera features. When using the Mega cloud localization service, 5DoF camera support is also enabled by default.

The EasyAR Sense variant used by the target platform can be viewed in the Project Settings > EasyAR > Sense menu under Lib Variants.
Target Architecture If you need to use Google ARCore or compile for ARM64 for other reasons, you need to use IL2CPP and select ARM64 support. If ARM64 architecture support is not required, no configuration is needed.
Special configuration for video recording

If you want to use video recording, set Graphics API to OpenGLES3 or OpenGLES2, and uncheck Multithreaded Rendering. You also need to set Lib Variants > Android to VideoRecording in EasyAR settings.

In the Unity menu File -> Build Settings-> Player Settings, click iOS to open the iOS platform settings panel.

switchtoios

Usually the following options need to be set.

Bundle ID

Set the iOS app Bundle ID. Note that the Bundle ID must match the one entered when creating the License Key.
Target Architecture

In Player Settings, change architecture to ARM64; Universal cannot be used.
Usage Description configuration

Depending on whether permissions are enabled in EasyAR settings under Permissions, different Usage Descriptions must be configured.
- If Camera permission is enabled, you need to add Camera Usage Description, otherwise the build will fail.
- If Location permission is enabled, you need to add Location Usage Description, otherwise the build will fail.
Additional configuration for EIF recording (XCode project, when needed)

If you need to record EIF to the default directory and transfer it to a computer or other device through the iOS Files app, you need to add UIFileSharingEnabled to Info.plist and set its value to true.

The following are some common errors and solutions related to Player settings.

License Key exception

If there is an exception with the License Key (for example, the Package Name does not match), a message similar to is not a valid EasyAR Sense license key or it does not match package name will appear when packaging the application. If you choose to continue packaging at this point, the resulting app will not work properly. Please carefully check the window prompt and fix the problem before packaging again.
Disabling license checks during packaging

In some special cases, if you initialize manually using EasyAR APIs and do not use the License Key in the Setttings file, you can choose Continue and don't warn me again, or disable the EasyAR Sense License > Verify When Build option in EasyAR settings. This will turn off the packaging-time check.
Android device support for non-ARM architectures

EasyAR Sense does not directly support x86 and x86-64 Android systems, but device chips based on x86 architecture usually can run ARM programs compatibly. Therefore you need to disable the x86 architecture selection so that some x86 devices can work properly.