Table of Contents

启用 Mega Go 编辑器工具

本文介绍如何在 Unity 编辑器中启用 Mega Go 编辑器工具,方便在编辑器中摆放与实景对齐的 3D 内容。

开始之前

Nota

以下内容及工具仅适用于使用 EasyAR Mega Go 开发 Unity 应用的过程。需要插件版本 >= 4003.1。

Mega Go 不支持小程序开发。

本文内容需要工程中已经导入如下 Unity 包:

  • com.easyar.sense
  • com.easyar.mega

创建编辑器工具

在编辑器中选择跟踪目标,点击 Create Editor Tool 按钮。

Consiglio

如果应用需要在脚本中创建跟踪目标而非编辑器内创建,可以在编辑器内摆放完成后,把跟踪目标和/或其子物体记录下来,在运行时通过脚本配置跟踪目标并把子物体挂载到跟踪目标下。

加载文件

根据 target Source 的 PathType 不同,可以加载 StreamingAssets 目录或自定义目录下的 emg 文件。当前会被加载的文件路径会显示在编辑器工具中。

Consiglio

emg 文件应从 EasyAR 开发中心 Mega Go 页面中下载。

点击 Load 按钮,这会根据当前配置加载 emg 文件。

加载成功后,会看到 Block 的部分信息显示在编辑器工具中。Block 所在服务的 APP ID 也会显示在编辑器工具中。

连接服务

填写可以连接该服务的 API Key、API Secret,检查服务信息并连接服务。

Consiglio

API Key 和 API Secret 可以从EasyAR开发中心获取。

alt text

需要保证使用的 API Key 有权限访问 Mega Go 服务。

alt text

权限不足时,会看到连接服务验证失败的错误信息。

alt text

正常连接服务之后,可以看到数据更新时间及 block 编辑器数据的控制界面。

Consiglio

如果数据已过期,会看到数据过期的错误信息。

Consiglio

如果数据已从测试版本升级,但仍在使用测试 .emg 文件,会看到试用数据无效的错误信息。

管理场景中的工具数据

编辑器工具的数据存储于 EasyAR.Mega.EditorTool 节点下,删除该节点等价于删除编辑器工具的数据。

Attenzione

不能直接修改 EasyAR.Mega.EditorTool 节点的内容,尤其不能修改该节点的 Transform,否则可能导致编辑器工具无法正常工作或跟踪时内容显示位置错误。

Importante

Mega Go 的编辑器工具只能在有效期内从服务器获取数据,过期后编辑器工具将无法从服务获取 mesh 等数据。保留在电脑缓存内的数据仍可以继续使用,直至 EMG 文件变更。缓存仅对当前工程有效。

更换 EMG 文件

编辑器工具展示的 block 数据不会随 EMG 文件变化而自动更新。在 EMG 文件更新之后,需要点击 X 按钮删除编辑器工具,然后点击 Load 按钮重新加载 EMG 文件。

Consiglio

如果 EMG 文件是从 Source 配置的文件路径加载,编辑器工具会在 Source 配置变更后自动重置并回退到文件加载前的状态。

Attenzione

如果组件运行时加载的 EMG 文件与编辑器工具使用的文件不同,可能导致实景环境与编辑器工具中显示的不一致,影响内容摆放的准确性及运行时内容显示的正确性。

后续步骤