EasyAR Mega Annotation 形式の概要

EasyAR Mega Annotation（EMA）は、空間アノテーションデータを交換するためのデータ形式です。ファイルは通常 .ema 拡張子を使用します。EMA ドキュメントは、参照される Mega Block とアノテーションの関係、およびアプリケーションや第三者が定義した拡張データを記述できます。

利用シーン

EMA 形式は一般的に次のシーンで使用されます:

• Mini Program 開発向けに、現実世界と正確に位置合わせされた 3D コンテンツを作成する機能を提供し、WeChat が editor を提供していないため block mesh を参照してコンテンツ配置やプレビューができない問題を解決します。
• AR ナビゲーション方案などのナビゲーションシーン向けに、app と Mini Program をまたぐナビゲーション機能へ統一されたナビゲーション点グラフデータを提供します。
• Mega Toolbox を使用し、アノテーションモデルを通じて効果をプレビューします。

注記

アプリケーションが Unity 内でのみ動作する場合、通常 EMA 形式データを使用する必要はありません。Unity 自体のシーンおよびシリアライズ機能で関連機能を実現できます。

生成と保存

Mega Studio は EMA データを生成および編集でき、次の機能をサポートします:

• 3D シーン内でアノテーションデータを視覚的に編集します。
• EMA ドキュメントをインポート/エクスポートします。
• Mega localization database に接続し、EMA ドキュメントをアップロード/ダウンロードします。

EMA ドキュメントは独立したファイルとしてローカルに保存することも、Mega localization database に保存することもできます。localization database 内の各 EMA ドキュメントのサイズ上限は 4 MB です。

読み取りと使用

EMA ドキュメントはさまざまなプラットフォームで読み取り、使用できます。

• Unity
• Mini Program

• データ API
• EmaDecoder.Decode を使用して EMA ドキュメントをデコードします
• Unity では現在、サービスから EMA ドキュメントを読み込むインターフェイスは提供されていません

使用方法は MegaBlock_Ema サンプルを参照してください。

形式バージョン

EMA ドキュメントはルートオブジェクトの version フィールドで形式バージョンを宣言します。

バージョン	形式定義
0.5	EasyAR Mega Annotation 形式 0.5