Mega 診断データ収集
このガイドは、視覚効果 の異常に関するデータ収集を標準化するための手順を提供します。標準化されたデータ収集と フィードバック により、開発者は問題を正確に説明でき、EasyAR 技術チームは 視覚ローカライズ に関連する技術的 障害 を効率的に特定、再現、解決できます。
はじめに
EasyAR Mega ローカライズサービス を統合する過程では、正確なデータ収集が問題診断の中心的な前提です。このガイドでは、次の重要なステップを扱います。
- 問題識別: 一般的な異常を分類し、初期評価を行います。
- スクリーンショットと録画の仕様: さまざまな デバイスプラットフォーム における 視覚証拠 の方法。
- 実行時データ収集: 各プラットフォームの 実行時環境データ の抽出とエクスポート。
- フィードバック情報の標準: 技術チームが問題を再現するために必要な "最小情報セット" を確保します。
異常現象の分類と初期判断
問題を報告する前に、次の分類に照らして異常現象を明確にしてください。
よくある異常症状
- 完全にローカライズできない: シーン を認識できず、状態 が "NotFound" のまま続く。
- ローカライズ精度の偏差: ローカライズ は成功するが 精度 が不足し、明らかな 空間的なずれ がある。
- Unstable ローカライズ: 画面 に 揺れ や ドリフト が発生する、または トラッキング が頻繁に失われる。
- 区域的な異常: 特定のエリアまたは特定ポイントで ローカライズ の効果が悪い。
- デバイス互換性の差異: 特定の機種で性能が悪い。
考えられる原因の推測
- シーン関連: コンテンツ配置 のずれ、建図品質の低さ、環境光や 特徴点 の不足 (大きな白壁など)、似た点による干渉。
- 技術環境: network 揺れ、サービス料金未払い、QPS 超過、SDK バージョン 互換性、API 呼び出しロジックエラー。
- ハードウェア権限: デバイスセンサー (IMU) が motion トラッキング をサポートしていない、または カメラ/ストレージ権限 が有効になっていない。
標準化されたフィードバックプロセス
トラブルシューティング の効率を高めるため、以下の 3 つの部分を含む 完全なフィードバックパッケージ の提出を強く推奨します。
基本情報チェックリスト (最小情報セット)
- リソース識別子: アカウント情報、Mega AppId、Block Id。
- バージョン情報: EasyAR Sense SDK バージョン または ミニプログラムプラグインバージョン。
- 問題の詳細: 異常現象の詳細説明と トリガー条件。
- 環境パラメータ: デバイスモデル、OS バージョン、WeChat バージョン、現在のネットワーク環境 (4G/5G/WiFi)。
視覚証拠 (動画とスクリーンショット)
- 再現プロセスの 録画: 起動から異常発生までの ローカライズ プロセスを完全に記録します。
- Key-frame スクリーンショットs: 異常が発生した瞬間の スクリーンショット を取得します。
- 複数角度の記録: 異なる位置、異なる照明条件での 視覚参照 を提供します。
実行時データ (トラブルシューティング の中核となる根拠)
- EIF データ: EasyAR Sense に基づく 実行時記録。PC 側での 再生 と分析をサポートします。
- Dump データ: WeChat Mini Program 固有の 実行時状態スナップショット。
- アプリケーションログ: App 実行ログ (Logcat/Console) と エラースタック。
ヒント
参考: 問題の詳細情報を明確に伝える方法
実行環境 と収集方法の分類
データ収集方法は、実行デバイスとプラットフォームによって異なります。実際の 環境 に応じて該当するガイドを選択してください。
デバイス分類
- モバイルデバイス: スマートフォン (iOS/Android)。
- ヘッドセットデバイス:
- OST (Optical See-Through): Optical see-through。例: XREAL、Rokid。
- VST (Video See-Through): Video see-through。例: Apple Vision Pro、PICO。
Screenshot と 録画 ガイド
| プラットフォームタイプ | 参照ガイド |
|---|---|
| スマートフォン / WeChat ミニプログラム | スマートフォン の スクリーンショット、録画、export |
| OST headset | OST 録画とエクスポート |
| VST headset | VST 録画とエクスポート |
実行時データ収集 (EIF/Dump)
| シーンタイプ | 収集方法 |
|---|---|
| EasyAR Sense ネイティブアプリケーション | スマートフォン app EIF recording / Headset EIF recording |
| WeChat Mini Program | Mini Program Dump データ 録画とエクスポート |
| クイック収集ツール | Mega Toolbox EIF recording / Toolbox Dump recording |
Mega 診断モード
Mega 診断モードは、すでに公開運用中で、アプリ開発者が問題調査に関与できない App または WeChat Mini Program に適しています。アプリケーションは、この機能をサポートする SDK または Mini Program プラグインを統合している必要があります。
対象の cloud localization library で診断モードを有効にしてデバイスをバインドした後、App または Mini Program を再起動すると runtime data が自動的に記録されます。通常使用中に問題が発生したら、できるだけ早く Mega diagnostic tool で記録を保存してアップロードし、EasyAR 技術サポートが分析できるようにします。完全な手順は Mega 診断モード を参照してください。
アプリ開発者が関与できる場合は、上記の runtime data 収集ガイドに従って EIF または dump データを記録することを優先してください。
操作ガイド ナビゲーションまとめ
デバイスプラットフォーム の要件に応じて、詳細操作ガイド に直接移動してください。
| Type | Screen recording and スクリーンショット collection guide | 実行時データ収集 guide |
|---|---|---|
| スマートフォン application | スマートフォン の スクリーンショット、録画、export | スマートフォン app EIF recording、Mega Toolbox EIF recording、EIF データ export instructions |
| OST headset | OST 録画とエクスポート | Headset EIF 録画とエクスポート |
| VST headset | VST 録画とエクスポート | Headset EIF 録画とエクスポート |
| WeChat Mini Program | スマートフォン の スクリーンショット、録画、export | WeChat Mini Program Dump 録画とエクスポート、WeChat Mini Program Toolbox Dump recording |
ベストプラクティス の推奨事項
- 事前調査プロセス: プロジェクト公開前に、チームメンバーが データ収集プロセス に慣れておくことを推奨します。
- 先にセルフチェック: フィードバック 前に、technical 環境 issues、コンテンツ配置 issues、デバイス権限の問題 などを排除したか確認してください。
- データ完全性: フィードバック最小情報セット、視覚異常 の動画と スクリーンショット、実行時データ を標準化して完全に収集します。
- タイムリーなコミュニケーション: 完全なデータを提出した後も、EasyAR 技術チームとのコミュニケーションを継続してください。
技術サポート チャネル
- ヘルプドキュメント: Mega ドキュメント または トラブルシューティング を参照してください。
- 技術サポート: 今すぐ問い合わせる または support@sightp.com へメールを送信してください。
次のトピック: スマートフォン の スクリーンショット、録画、export 方法