Player configuration

This article introduces the Player configuration options that need attention when packaging applications using EasyAR Sense Unity Plugin in Unity.

Different platform configuration instructions

When packaging in Unity, the following configurations need to be checked and confirmed.

Navigate through Unity menu File -> Build Settings-> Player Settings, click the Android icon to bring up the settings for the Android platform.

switchtoandroid

Typically, the following options need to be set.

Package Name Set the Package Name of the Android application, note that the Package Name must match the one filled in when creating the License Key.
API Level The API level supported by EasyAR depends on the version used. 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.
Target Architecture If Google ARCore is to be used, or ARM64 support is required for other reasons, IL2CPP compilation must be used and ARM64 support selected. Configuration is not required when ARM64 architecture support is not needed.
Special configuration for video recording function

To use the video recording function, set Graphics API to OpenGLES3 or OpenGLES2, and uncheck Multithreaded Rendering. Additionally, set Lib Variants > Android to VideoRecording in EasyAR configuration.

Navigate through Unity menu File -> Build Settings-> Player Settings, click iOS to bring up the settings panel for the iOS platform.

switchtoios

Typically, the following options need to be set.

Bundle ID

Set the Bundle ID of the iOS application, note that the Bundle ID must match the one filled in when creating the License Key.
Target Architecture

Change architecture to ARM64 in Player Settings, Universal cannot be used.
Usage Description configuration

Depending on the activation in Permissions in EasyAR configuration, different Usage Descriptions need to be configured.
- If the Camera permission is enabled, Camera Usage Description must be added, otherwise the build will fail.
- If the Location permission is enabled, Location Usage Description must be added, otherwise the build will fail.
Additional configuration needed for EIF recording (XCode project, when required)

If EIF needs to be recorded to the default directory and shared to a computer or other devices via the iOS Files app, add UIFileSharingEnabled to Info.plist and set its value to true.

Below are some common errors and solutions related to Player configuration.

Error reporting for abnormal License Key

If the License Key is abnormal (e.g., Package Name mismatch), an error 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, the packaged application will not function properly. Please carefully check and fix the issue according to the window prompts before continuing with the packaging.
Disabling license verification during packaging

In special cases, if you use EasyAR's interface for manual initialization and do not use the License Key in the Settings file, you can select Continue and don't warn me again, or disable the EasyAR Sense License > Verify When Build option in EasyAR configuration. This will turn off the verification during packaging.
Support for non-ARM architecture Android devices

EasyAR Sense does not directly support x86 and x86-64 architecture Android systems. However, x86 architecture device chips are generally compatible with ARM programs. Therefore, it is necessary to configure the deselection of the x86 architecture, allowing normal usage on some x86 devices.