Mega 診断データ収集

このガイドは、標準化された視覚的異常データ収集の手順を提供します。規範化されたデータ収集とフィードバックを通じて、開発者が問題を正確に記述し、EasyAR技術チームが視覚的位置推定に関連する技術的障害を効率的に特定、再現、解決するのを支援します。

内容の概要

EasyAR Mega位置推定サービスの統合プロセスにおいて、正確なデータ収集は問題診断の核心的前提条件です。本ガイドは以下の主要な要素を網羅します：

問題の識別：一般的な異常現象の分類と予備評価。
スクリーンショット・画面録画の規範：異なるデバイスプラットフォーム向けの視覚的証拠収集方法。
実行データの収集：各プラットフォームのランタイム環境データの抽出とエクスポート。
情報フィードバック基準：技術チームが問題を再現可能にするために必要な「最小情報セット」の確保。

異常現象の分類と予備判断

問題を報告する前に、以下の分類に基づいて異常現象を明確にしてください：

一般的な異常挙動

完全な位置推定不能：シーンを認識できず、ステータスが継続的に"NotFound"と表示される。
位置推定精度のずれ：位置推定は成功するが精度が不足し、明らかな空間的ずれが生じる。
位置推定の不安定：画面が揺れる、ドリフトする、または頻繁にトラッキングが失われる。
特定区域での異常：特定のエリアまたは特定のポイントで位置推定性能が劣る。
デバイス互換性の差異：特定の機種でのみ性能が低下する。

可能性のある原因の推測

シーン関連：コンテンツ配置位置のずれ、マップ品質の低さ、環境照明または特徴点（例：広い白壁）の不足、類似ポイントによる干渉。
技術環境：ネットワークの不安定、サービス利用料の未払い、QPS制限超過、SDKバージョンの互換性問題、API呼び出しロジックの誤り。
ハードウェア権限：デバイスセンサー（IMU）がモーショントラッキングをサポートしていない、カメラまたはストレージ権限が有効になっていない。

規範化フィードバックフロー

調査効率を高めるため、以下の3つを含む完全なフィードバックパッケージの提出を強く推奨します：

基本情報リスト（最小情報セット）

リソース識別子：アカウント情報、Mega AppId、Block Id。
バージョン情報：EasyAR Sense SDKバージョンまたはミニプログラムプラグインバージョン。
問題の詳細：異常現象の詳細な説明とそのトリガー条件。
環境パラメータ：デバイスモデル、OSバージョン、WeChatバージョン、現在のネットワーク環境（4G/5G/WiFi）。

視覚的証拠（動画とスクリーンショット）

再現プロセスの画面録画：起動から異常発生までの位置推定プロセスを完全に記録。
キーフレームのスクリーンショット：異常発生瞬間の画面スナップショットを取得。
複数角度での記録：異なる位置、異なる照明条件下での視覚的リファレンスを提供。

ランタイムデータ（核心的な調査根拠）

EIFデータ：EasyAR Senseベースのランタイム記録。PC端末での再生分析をサポート。
Dumpデータ：WeChatミニプログラム特有の実行状態スナップショット。
アプリケーションログ：アプリ実行ログ（Logcat/Console）およびエラースタックトレース。

ヒント

詳細はこちら：問題の明確な伝達方法

実行環境と収集方法の分類

データ収集方法は実行デバイスとプラットフォームによって異なります。実際の環境に応じたガイダンスを選択してください。

デバイス分類の説明

モバイルデバイス：スマートフォン（iOS/Android）。
ヘッドマウントディスプレイデバイス：
- OST（Optical See-Through）：光学透過型（例：XREAL、Rokid）。
- VST（Video See-Through）：ビデオ透過型（例：Apple Vision Pro、PICO）。

スクリーンショットと画面録画のガイダンス

プラットフォームタイプ	参照ガイド
スマートフォン / WeChatミニプログラム	スマートフォンでのスクリーンショット・画面録画とエクスポート
OSTヘッドセット	OSTでの画面録画とエクスポート
VSTヘッドセット	VSTでの画面録画とエクスポート

ランタイムデータ収集（EIF/Dump）

シナリオタイプ	収集方法
EasyAR Senseネイティブアプリ	スマートフォンアプリでのEIF記録 / ヘッドセットでのEIF記録
WeChatミニプログラム	ミニプログラムでのDumpデータ記録とエクスポート
クイック収集ツール	Mega ToolboxでのEIF記録 / ToolboxでのDump記録

自動収集機能（近日提供予定）

自動収集とフィードバックをサポートする機能を近くアップグレードし、より便利なデータ提出方法を提供します：

バックグラウンド記録：必要に応じてバックグラウンドで必要なデータセットを収集開始
自動アップロード：自動でパッケージ化しEasyAR技術チームにアップロード
オンデマンドキャプチャ：異常状態をリアルタイムで自律的に捕捉
進捗追跡：分類と継続的な進捗追跡

操作ガイダンスナビゲーションまとめ

デバイスプラットフォームの要件に応じて、詳細な操作ガイドに直接ジャンプ：

タイプ	画面録画・スクリーンショット収集ガイド	ランタイムデータ収集ガイド
スマートフォンアプリ	スマートフォンでのスクリーンショット・画面録画とエクスポート	スマートフォンアプリでのEIF記録、Mega ToolboxでのEIF記録、EIFデータのエクスポート説明
OSTヘッドセット	OSTでの画面録画とエクスポート	ヘッドセットデバイスでのEIF記録とエクスポート
VSTヘッドセット	VSTでの画面録画とエクスポート	ヘッドセットデバイスでのEIF記録とエクスポート
WeChatミニプログラム	スマートフォンでのスクリーンショット・画面録画とエクスポート	WeChatミニプログラムでのDump記録とエクスポート、WeChatミニプログラムToolboxでのDump記録

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

事前検討フロー：プロジェクトリリース前に、チームメンバーがデータ収集フローに慣れることを推奨。
事前自己診断：フィードバック前に、技術環境の問題、コンテンツ配置の問題、デバイス権限の問題などを排除したか確認。
データの完全性：完全なデータを規範的に収集：最小情報セット、視覚的異常動画とスクリーンショット、ランタイムデータ。
タイムリーなコミュニケーション：完全なデータを提出後、EasyAR技術チームとのコミュニケーションを維持。

技術サポートチャネル

ヘルプドキュメント：Megaドキュメントまたはトラブルシューティングを参照。
技術サポート：すぐに相談するまたはメールを support@sightp.com まで送信。

次のトピック： スマートフォンでのスクリーンショット・画面録画とエクスポート方法

Table of Contents