Table of Contents

Recording eif data: 高忠実度な根拠による ar 問題の再現

拡張現実（AR）アプリケーションにおいて、特定の複雑な空間位置特定問題（追跡の揺れ、現実と仮想の位置ずれ、コンテンツのドリフトなど）は、画面録画やログだけでは完全に再現することが困難な場合があります。このため、当社はEIFデータ録画機能を提供します——これは以下の主要情報を同期して記録する専有の高忠実度データダンプフォーマットです：

  • デバイス基本情報（モデル、OS、SDKバージョンなど）
  • タイムスタンプ付きカメラ画像フレーム
  • デバイスのカメラ内部パラメータ行列、外部パラメータ行列
  • IMU センサーデータ
  • 外部補助入力の追加データ（GNSSなど）

Why is recording eif data crucial?

重要

問題を再現可能な EIF データは計り知れない価値があります。

EIFデータは、問題発生時の詳細なコンテキストを完全に再現でき、開発チームがオフライン環境でユーザーが遭遇したシナリオを正確に再現することを可能にし、問題の特定効率を大幅に向上させます。画面録画やログと比較して、EIFは以下の利点があります：

  1. 正確な再現：開発者はデバッグツールで直接EIFデータを再生し、あなたが遭遇したバグを再現できます。
  2. 根本的な診断：画像、センサー、外部入力などの包括的なデータ分析を通じて、開発者は問題が技術のどの段階にあるかを判断できます。
  3. 時間の節約：長いコミュニケーションループを回避し、問題報告から解決までのサイクルを大幅に短縮します。

How to record eif data

EasyARはEIFデータを録画する2つの方法を提供します。

  1. SDKが提供するAPIインターフェースを直接使用し、アプリ内にEIFデータ録画機能を実装する。
  2. 公式提供の Mega Toolbox App を使用する。通常、EasyAR Megaの開発や問題フィードバックに適しています。

具体的な操作手順については、技術文書を参照し、あなたの使用スタイルおよびデバイスに応じた操作ガイドを入手してください。

ヒント

APIインターフェースを呼び出してアプリ内でEIFを録画する機能については、以下のリンクを参照してください：入力フレームの録画とシミュレーション実行。

Mega Toolbox Appの使用方法については、以下のリンクを参照してください：Toolboxを使用した携帯電話のEIFファイル録画。

簡単な録画プロセスの概要（Mega Toolbox Appを例として）：

  1. Mega Toolbox Appを開き、"現地位置テスト＆位置問題フィードバックデータ録画"をクリックします。
  2. アカウントにログインし、位置特定ライブラリを選択してテストを開始します。
  3. 問題を再現してください。問題を安定して再現できる操作パターン（デバイスの向き、閲覧方法、撮影ポイントなど）を見つけます。
  4. 準備が整ったら、赤い"録画"ボタンをクリックして録画を開始します。
  5. 問題が発生した後、赤い"停止して保存"ボタンをクリックします。
  6. システムが自動的にEIFファイルを生成します。デバイスをPCに接続してローカルストレージにエクスポートした後、提出してください。
注記

EIFファイルは大きくなる可能性があります（数百MBから数GB）。問題の核心部分を含む短いクリップのみを録画することをお勧めします（通常10～30秒で十分です）。

ベストプラクティスの推奨事項

フィードバックが効率的に処理されるようにするため、提出時には以下の4種類の情報をすべて含めてください：

情報タイプ 説明
EIF データファイル 核心的な診断根拠。問題再現プロセスを含めることが必須です
主観的な現象の説明 観察した動作を明確に説明します（例：「ナビゲーションの矢印が左折時に突然天井にジャンプした」）
画面録画またはスクリーンショット 問題を視覚化する補助として、「ユーザーが最終的に見た画面」を直感的に示します
補助的なコンテキスト情報 以下を含みます：
• デバイスのモデルとOSバージョン
• アプリケーションが使用しているEasyAR SDKのバージョン番号
• 問題が発生した環境の説明（屋内/屋外、照明、空間の大きさ）
• Megaクラスアプリは追加で位置特定ライブラリ情報を提供する必要があり、Unityツールからエクスポート可能です
• CRSクラウド認識アプリは追加でクラウド認識ライブラリ情報を提供する必要があります
ヒント

例：「Apple Vision Pro（visionOS 26）上で EasyAR Sense Unity Plugin 4000.0.1 を使用し、屋内ショッピングモールでナビゲーション中、特定の位置でナビゲーションパスに突然エラーが発生しました。EIFファイルを録画済み：avp_wrong_path_20251218.mkveif、付録画面録画、環境写真および位置特定ライブラリ情報：MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json。」

上記の完全な情報パッケージを提供することで、問題の分析と修正プロセスが大幅に加速されます。ご協力に感謝いたします！