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