使用 session 验证工具模拟运行使用 Mega 能力的 AR 工程
この記事は、開発者が Unity エディタ上で session 検証ツールを利用して録画した EIF データを読み込み、Mega 機能を使用した AR プロジェクトをシミュレート実行する方法を案内することを目的としています。
開始前に
- クイックスタートを完了し、Mega 機能を含む Unity アプリケーションの実行方法を理解してください。
- EIF が何であるかを理解してください。
- シミュレーション実行データの収集方法を学んでください。
なぜ session 検証ツールを使ったシミュレーション実行が良い方法なのか
リモート開発：炎天下や厳寒の中で現場に駐在する必要はありません。EIF データを利用することで、オフィスで大規模な地理空間に基づく AR アプリケーションを開発できます。
クロスプラットフォームデバッグ：様々なモバイルデバイスに頻繁に接続する必要はありません。PC 上で携帯電話やヘッドマウントディスプレイなどの異なる端末の位置決めと追跡効果をシミュレートできます。
問題フィードバックの「金の基準」：異常を再現できる EIF ファイルは、EasyAR チームが位置決めと追跡問題を解決するための重要な根拠です。
注記
EIF データは非常に正確に記録されていますが、シミュレーションの効果と実際の使用効果には依然として差異がある可能性があります。
また、シミュレーションデータは現場のカバレッジが限られているため、最終的なリリース前に必ず実地テストを行ってください。
現場で録画した EIF ファイルを準備する
選択した録画形式に応じて、録画された EIF データは .mkveif ファイル（または .eif ファイルと .eif.json ファイル、この 2 つのファイルは欠かせません）である必要があります。
.eif と .eif.json：
.mkveif：
session 検証ツールを起動する
シーン内の AR Session (EasyAR) をクリックし、その Inspector パネル上の Frame Player がオンになっていることを確認します。
実行する
ツールバーのボタンをクリックするか、Session Validation Tool 上の実行ボタンをクリックして、Unity エディタ上で現在のシーンを実行します。
実行後、ポップアップが表示されますが、これは正常な現象です。現在 Frame Player を使用していることを示すだけです。
ツール上のボタンをクリックして EIF ファイルを開きます。
正常に開くと自動的に再生され、ツールバーを使用して一時停止/再開などの制御ができます。正常に録画された mkveif ファイルはシークバーでのジャンプがサポートされています。
実行結果：
block 稠密モデルを読み込んだ場合、block 稠密モデルも表示されたままになります。これは位置の比較やモデルが配置されていない場所での位置決め効果を確認する場合に役立ちます。
block モデルの表示をオフにすると、現実のシーンに仮想物体が重ねられた効果が見られます。
重要
使用中に、画面上または目の前に表示される診断情報のテキストに気付くでしょう。UI メッセージ出力をよく読み、開発段階、テスト段階、アプリケーションのリリース後にどのような設定を行い、どのような制御スイッチを残すべきかを慎重に検討してください。EasyAR とのコミュニケーションでは通常これらの情報が必要になるため、すぐに閉じるのではなく、積極的に利用することをお勧めします。
デフォルト設定では、起動後、最初に block を位置決めするまで内容は表示されません。
位置決め後、block ノードの active が true になり、内容が表示され、位置が更新され続けます。
ActiveController コンポーネントのオプションを使用してこの動作を制御できます。
[オプション] パノラマ画像を使用する
注記
一部のデータではパノラマ画像がサポートされていません。
実行中に、Panorama Preview Marker の選択ボックスをクリックすると、パノラママーカーが表示されます。
任意のパノラママーカーをクリックすると、パノラマ画像のプレビューが表示されます。
ヒント
- エディタが play モードに入った後、メッシュベースの空間モデルの遮蔽は引き続き有効ですが、精度は LOD 切り替えの無効化の影響を受けます。
- パノラマ画像ウィンドウでは、カメラを回転させることはできますが、ズームや移動はできません。
- パノラマ画像ウィンドウでは、異なる位置のパノラマ画像ビューに移動できます。
[オプション] LCC 3D ガウススプラッシュを使用する
注記
このセクションの内容は、そのドメインデバイスを使用して収集し、マッピングを完了した後の使用シナリオに適用されます。他のデバイスでのマッピング結果には LCC 3DGS データが含まれていません。
LCC 3D ガウススプラッシュ（そのドメイン LCC）機能を使用している場合、シミュレーション実行時に 3DGS の結果を同時にレンダリングし、モデルと 3DGS の位置合わせ効果を確認できます。
まず、LCC データを読み込み、Mesh と位置合わせする必要があります。
Camera に SceneGameCameraSync スクリプトが存在する場合、それを Disable にする必要があります。
3DGS をレンダリングしながら EIF ファイルを再生したシミュレーション実行の結果は次のようになります。