EasyAR CRS案例使用说明

ImageTracking_CloudRecognition

演示如何使用云识别功能。

• 演示如何创建和使用本地缓存
• 演示如何在跟踪时停止网络请求

运行前配置

使用云识别需配置服务器访问信息，这些信息可以在EasyAR 官网的开发中心中 云识别管理页面 中获得。在Unity中输入这些信息有两种方法：

一种是全局配置，所有使用全局配置的云识别场景都会使用这个配置。从Unity菜单中选择<EasyAR -> Change Global Cloud Recognizer Service Config>并在Inspector面板中输入从开发中心获取的信息。

另一种是在场景中配置，它只对当前场景有效。

用法

标记1：显示系统状态和操作提示。
标记2：结束/开始云识别。
标记3：清空当前云识别的Targets和缓存。

详解

触发云识别

从EasyAR Sense 4.1开始，所有 CloudRecognizer 的请求都由用户代码触发，SDK内部将不再触发从服务器发送和接收数据的调用。也就是说你可以自由控制请求的频次。

最低请求间隔限制为300ms。

周期性地触发云识别

建议在 ARSession.FrameChange 事件处理中触发云识别，这个事件会在frame图像数据变化的时候发生。可以在事件中获取 InputFrame 。

在这个sample中，如果target在被跟踪或是前一次的resolve未完成或时间间隔未到达预设值（1s）的时候，resolve不会被调用。

云识别结果

云识别是EasyAR的独立功能，可以在不与图像跟踪一起使用。如果在识别之后不需要跟踪，直接使用resolve结果即可。

跟踪云返回的Target

如果需要跟踪服务器识别到的图像，就需要用到result中的target信息。

在这个sample中target被clone了一份，因为它会在ImageTargetController中被引用，因此需要保留一份内部object的引用。

创建一个有 ImageTargetController 的 GameObject ，并将resolve回调中的 ImageTarget 赋给 ImageTargetController.TargetSource ，这样controller可以使用 ImageTargetController.DataSource.Target 来初始化。

没有必要多次加载同一个target，并且这样做也会失败。

使用离线缓存

一个好的实践是，将识别到的target保持在文件存储中，以便在下次启动时加载。这会对下次应用启动时的识别有好处，可以减少响应时间，而且可以在离线状态下使用识别过的target。

可以使用 ImageTarget.save 将target保存为 .etd 文件。

然后可以在下次运行时通过 ImageTargetController.DataSource.TargetDataFile 类型的数据使用 .etd 文件创建target。