EasyAR Sense Unity Plugin 样例使用说明

准备工作

准备Unity环境

了解 EasyAR Sense Unity Plugin 支持的系统和Unity 版本,并从Unity官方获取并安装Unity 安装包。

如果你是初次使用,建议你使用Unity官方的长期支持版本。

  • Unity 2019.4
  • Unity 2018.4
  • Unity 2017.4

准备样例内容包

从官网下载页获取EasyAR Sense Unity Plugin的样例内容包。如果要使用样例,需要下载名字中含有 Sample 的发布包。

获取许可证授权

使用EasyAR Sense之前需要先在官网注册并获取许可证授权 。

配置编辑器工程

创建空Unity工程

创建工程时,Template 选择 3D。EasyAR当前默认不支持Universal Render Pipeline等其他 Scriptable Render Pipeline 。

EasyAR Sense Unity Plugin 样例使用说明
EasyAR Sense Unity Plugin 样例使用说明
导入插件Sample内容包

将下载好的内容包解压,找到样例的Unity Package(.unitypackage)。双击内容包或者托拽到Unity编辑器的Assets目录下。

EasyAR Sense Unity Plugin 样例使用说明
EasyAR Sense Unity Plugin 样例使用说明
填写许可证

从Unity菜单中选择<EasyAR -> Change License Key>并在Inspector面板中输入准备工作中创建的License Key。

EasyAR Sense Unity Plugin 样例使用说明
EasyAR Sense Unity Plugin 样例使用说明
服务配置

部分sample需要使用EasyAR服务,需要配置服务器信息

  • ImageTracking_CloudRecognition

  • SpatialMap_SparseSpatialMap

  • MapLocalizing_Sparse

如果不使用这些sample可以跳过此步骤。

添加场景

将Unity工程中的所有场景添加到build settings中。如果内容包中包含启动器,需将启动器的场景(AllSamplesLauncher)移动到所有场景中的第一个。

EasyAR Sense Unity Plugin 样例使用说明
在编辑器中运行

样例的场景位于Assets/Samples/Scenes,打开AllSamplesLauncher场景可以运行所有sample,或者也可以选择打开某个独立的sample场景并运行。

EasyAR Sense Unity Plugin 样例使用说明
如果电脑上连接着摄像头,经过上面的配置之后,就可以直接在Unity编辑器中运行EasyAR Sense Unity Plugin的样例了。
EasyAR Sense Unity Plugin 样例使用说明
需要注意的是,并不是所有功能都可以在编辑器中运行,部分功能只能在Android或iOS设备上运行。无法在编辑器中使用的sample在运行时会有消息提示和错误log输出。

EasyAR Sense Unity Plugin 样例使用说明

在Android设备上运行

根据 Android 工程配置 配置工程,然后点击Build Settings的Build按钮或通过其它方式编译项目并在手机上安装,运行时需允许相应权限。

EasyAR Sense Unity Plugin 样例使用说明

在iOS设备上运行

根据 iOS 工程配置 配置工程,然后在XCode中编译项目并在手机上安装,运行时需允许相应权限。