样例使用说明¶

准备工作¶

阅读平台需求，了解EasyAR Sense Unity Plugin支持的系统和Unity版本，然后从Unity官方获取并安装Unity。

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

从下载页获取最新的EasyAR Sense Unity Plugin的发布包。sample包含在这个插件包中。

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

创建工程时，Template 选择 3D, Core。如果你在使用URP，可以参考配置 Universal Render Pipeline (URP) 来进行配置。

插件使用 Unity's package 组织文件，通过 tarball 文件分发。插件的发布文件是一个zip包，解压这一个zip包可以看到readme和 tgz 文件，注意不要解压这个 tgz 文件。

通常建议把上述 tgz 文件放在工程目录中，比如 Packages 文件夹。然后通过Unity的 Package Manager window 来使用本地tarball文件安装插件。

在弹出的对话框中选择 com.easyar.sense-*.tgz 文件。

注意：在导入后， tgz 文件不能被删除或移动到另一个位置，因此通常需要在导入前将这个文件放在合适的地方。如果你希望与他人共享工程，可以将文件放在工程目录内，如果有使用版本管理，也需要加入。

样例随插件包一起分发。可以使用 Unity的 Package Manager window 将样例导入工程中。

你可以使用 **All Handheld AR** 一次性导入所有可以在手机上运行的sample，或是使用比如 **WorldSenseing All** 一次性导入一个类别的sample。

或者也可以导入名字中没有 ** 的单个sample。

注意： ** 开头的sample不能与其它sample同时导入工程，否则会出现重复资产。

眼镜的sample只能一个一个导入，且它们不会被 **All Handheld AR** 导入，这些sample没有被包含在sample启动器中。

从Unity菜单中选择 EasyAR > Sense > Configuration 并在 Project Settings 面板中输入License Key。该页面也可以通过 Edit > Project Settings > EasyAR 进入。

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

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

打开 Build Settings ，

将Unity工程中的样例场景添加到 Build Settings 中。如果工程中包含启动器，将启动器的场景（AllSamplesLauncher）移动到所有场景中的第一个。

如果存在AllSamplesLauncher 场景，可以打开（双击场景文件或 File > Open Scene）这个场景以运行所有sample，或者也可以选择打开（双击场景文件或 File > Open Scene）某个独立的sample场景并运行。

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

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

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