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

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

    androidAPILevel

  • 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 设备上可以正常使用。