样例使用说明

准备工作

准备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之前需要先在官网 www.easyar.cn 注册并 获取许可证授权


配置编辑器工程

创建空Unity工程

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

../_images/image_0.png ../_images/image_0_1.png

导入插件Sample内容包

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

../_images/image_1.png ../_images/image_2.png

填写许可证(License Key)

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

../_images/image_3.png ../_images/image_4.png

服务配置

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

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

添加场景

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

../_images/image_5.png

在编辑器中运行

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

../_images/image_55.png

如果电脑上连接着摄像头,经过上面的配置之后,就可以直接在Unity编辑器中运行EasyAR Sense Unity Plugin的样例了。

../_images/image_56.png

需要注意的是,并不是所有功能都可以在编辑器中运行,部分功能只能在Android或iOS设备上运行。无法在编辑器中使用的sample在运行时会有消息提示和错误log输出。

../_images/image_57.png

在Android设备上运行

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

../_images/image_60.png

在iOS设备上运行

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