Table of Contents

Player 配置

本文介绍在 Unity 中使用 EasyAR Sense Unity Plugin 打包应用时需要注意的 Player 配置选项。

不同平台配置说明

在 Unity 打包时，需要检查并确认下列配置。

依次在 Unity 菜单 File -> Build Settings-> Player Settings，点击安卓图标，调出 Android平台 相应的设置。

switchtoandroid

通常情况下需要设置以下选项。

  • Package Name 设置 Android 应用的 Package Name, 注意 Package Name 要与创建 License Key 时填写的必须一致。

    androidPackageName

  • Minimum API Level EasyAR 支持的 Minimum API level 与使用的版本有关， 使用 Full 变种时，需要 Android API Level 24 或以上; 使用其他变种时，EasyAR Sense 需要 Android API Level 21 或以上。

    androidAPILevel

    提示

    Full 变种通常会在 Mega Go 端侧定位功能以及 5DoF camera 功能中使用，使用 Mega 云定位服务时默认也会启用 5Dof camera 支持。

    目标平台使用的 EasyAR Sense 变种可以在 Unity 菜单 Project Settings > EasyAR > Sense 中的 Lib Variants 选项中查看。

  • Target Architecture 如果需要使用 Google ARCore ，或其它情况需要编译支持 ARM64 ，需要使用 IL2CPP 编译并选择 ARM64 支持。在不需要支持 ARM64 架构的情况下无需配置。

    androidarm64

  • 视频录制功能的特殊配置

    如果要使用视频录制功能，需设置 Graphics API 为 OpenGLES3 或 OpenGLES2，并去掉 Multithreaded Rendering 的勾选。另外还需要在 EasyAR 配置 中将 Lib Variants > Android 设为 VideoRecording 。

    androidvideorecord

常见问题

下面是与Player 配置相关的一些常见错误和解决方案。

  • License Key 异常的报错

    如果 License Key 异常（比如 Package Name 不匹配），在打包应用时将会类似 is not a valid EasyAR Sense license key or it does not match package name 。这时如果选择继续打包，打包出的应用将无法正常使用，请根据窗口提示仔细检查并修复问题后再继续打包。

  • 关闭打包时的许可证检查

    在一些特殊情况，如果你使用 EasyAR 的接口手动初始化，不使用 Setttings 文件中的 License Key，你可以选择 Continue and don't warn me again ，或者关闭 EasyAR 配置 中的 EasyAR Sense License > Verify When Build 选项，这将关闭打包时的检查。

  • 非 ARM 架构的 Android 设备支持

    EasyAR Sense 不直接支持 x86 及 x86-64 架构的 Android 系统，但是一般x86架构的设备芯片可以兼容 ARM 程序，因此需要配置取消选择 x86 架构，这样在一些 x86 设备上可以正常使用。