EasyAR Mega Annotation 格式简介

EasyAR Mega Annotation（EMA）是用于交换空间标注数据的数据格式，文件通常使用 .ema 扩展名。EMA 文档可以描述所引用的 Mega Block 和标注之间的关系，以及应用或第三方定义的扩展数据。

使用场景

EMA 格式常用于以下场景：

• 面向小程序开发，提供 创建与实景精确对齐的 3D 内容 能力，解决因微信未提供编辑器而无法参照 block mesh 进行内容摆放和预览的问题。
• 面向导航场景，例如 AR 导航方案，为跨 app 和小程序的导航功能提供统一的导航点图数据。
• 使用 Mega Toolbox，通过标注模型 预览效果。

注意

如果应用仅在 Unity 中运行，一般无需使用 EMA 格式数据，使用 Unity 本身的场景及序列化功能即可完成相关功能。

生产和存储

Mega Studio 可以生产和编辑 EMA 数据，支持以下功能：

• 在 3D 场景中 可视化编辑标注数据。
• 导入/导出 EMA 文档。
• 连接 Mega 定位库，上传/下载 EMA 文档。

EMA 文档可以作为独立文件存储在本地，或存储在 Mega 定位库中。定位库中每个 EMA 文档大小限制为 4 MB。

读取和使用

可以在不同平台上读取和使用 EMA 文档。

• Unity
• 小程序

• 数据接口
• 使用 EmaDecoder.Decode 解码 EMA 文档
• Unity 端暂未提供从服务加载 EMA 文档的接口

可以参考 MegaBlock_Ema 示例使用。

格式版本

EMA 文档通过根对象的 version 字段声明格式版本。

版本	格式定义
0.5	EasyAR Mega Annotation 格式 0.5