Unity エディターを使用した注釈の作成とアップロード
この記事では、Unity エディター上の Mega Studio を使用して注釈を作成し、アップロードする方法について説明します。
開始する前に
- Unity で Mega Studio を使用する ことができること
- モデルの準備: サンプルプロジェクトで使用されているモデル（愛嬌のあるパンダ）、または xr-frame 公式デモで使用されているロボットモデル、あるいは XRFame が読み込める GLTF 形式とサポートされる拡張 を参考に、xr-frame の要件を満たすモデルファイルを準備してください。
- モデルファイルを Unity にインポートしてください。
ヒント
Mega プラグインには com.unity.cloud.gltfast の依存関係が既に追加されているため、モデルファイルを直接 Unity Assets にドラッグできます。
注釈が必要な理由
EasyAR Mega Annotation（EMA）は、クロスプラットフォーム（座標系定義が異なる）の空間位置を同期するために使用できます。
Unity 環境における注釈のローカル座標系: X 正方向が後方、Y 正方向が上方、Z 正方向が右方向。
xr-frame 環境における注釈のローカル座標系: X 正方向が後方、Y 正方向が上方、Z 正方向が左方向。
上記の方向の違いは、Unity と xr-frame が採用する座標系定義（左手系/右手系）の違いに起因します。
EMA を使用して空間位置を同期することには、以下の顕著な利点があります:
- 開発プロセスの簡素化: クロスプラットフォームの座標変換を自動的に処理し、手動計算による煩雑なロジックやエラーの発生を回避します。
- デバッグ効率の向上: MegaToolbox で直接ロードできるため、実機テストとデータ検証を迅速に行えます。
操作手順
アノテーションツールの作成
Unityの Hierarchy パネルで右クリックし、 EasyAR Mega > Tool > Annotation Tool (Edit-Mode) を順に選択します。
作成が完了すると、シーン内に EasyAR.Mega.Annotation と MegaBlocks という2つのノードが生成されます。
EasyAR.Mega.Annotation ノードを選択すると、その Inspector パネルにユーザー名/メールアドレスとパスワードの入力欄が表示されます。
アカウントへのログイン
EasyAR アカウントとパスワードを入力してログインをクリックします。成功すると、 Inspector パネルに Studio ツールが表示されます。
Mega クラウド位置情報ライブラリの選択
Mega Cloud Service の右側にあるアイコンをクリックします。
使用するライブラリを選択します。
位置情報ライブラリと Mega Blocks の情報の読み込みに成功すると、Studio ツールパネルは以下のように表示されます。
Block 高密度モデルの読み込み
Block 名の右側にある 読み込み をクリックすると、その Block の高密度モデルを動的に読み込めます。
モデルの読み込みが完了すると Scene タブページに表示されます。左下に図のようなマークが表示されている場合は、現在の視野内のモデルの読み込みが完了していないことを示します。このマークが消えるまでしばらく待つと、読み込みが完了したことを示します。
アノテーションの作成
シーン内で Ctrl キー（Windows）/ Command キー（Mac）を押しながら、アノテーションを追加したい場所でマウスの左ボタンをクリックします。
モデルの使用
インポートしたモデルをシーンノードにドラッグし、アノテーションの子ノードとします。
モデルの Inspector パネルにある Position と Rotation をすべて 0 に変更し、Scale は必要に応じて調整します。
注記
EMA はすべての座標変換ロジックを担っています。モデルの Position と Rotation を 0 に設定するのは、モデルの幾何学的中心をアノテーションポイントと完全に一致させるためです。すべての移動と回転の調整は、その親ノード（アノテーションノード）を操作することによって行う必要があります。
[オプション] モデル位置の精密調整
モデルの位置と向きを精密に調整する必要がある場合は、Unity エディタを使用して 3D コンテンツを実世界に正確に配置する方法を参照してください。
新しいアノテーションデータパッケージの作成
Inspector パネルのアノテーションデータパッケージの右側にあるアイコンをクリックします。
ボックスにアノテーションデータの名前を入力し、右側のチェックマークをクリックします。
作成が成功すると以下のように表示されるので、その後、下部の 確定 をクリックします。
アップロードアイコンをクリックしてアップロードします。
アップロードが成功すると通知が表示されます。
アノテーション ID の記録
xr-frame 上で対応するアノテーションデータを読み込むには、アノテーションデータの名前または ID を記録する必要があります。
アップロードが成功すると、クラウド位置情報ライブラリ内にも対応する情報が表示されます。
ここでもアップロードされたアノテーションデータの名前と ID を確認できます。
