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 |
自動収集機能 (近日提供予定)
自動収集と フィードバック のサポートをまもなく強化し、より便利なデータ提出方法を提供します。
- バックグラウンド録画: 必要な データセット のバックグラウンド収集をオンデマンドで開始
- 自動アップロード: データを自動的にパッケージ化して EasyAR 技術チームへ アップロード
- オンデマンド取得: 異常状態 をリアルタイムに自分で取得
- Progress トラッキング: 分類し、進捗 を継続的に追跡
操作ガイド ナビゲーションまとめ
デバイスプラットフォーム の要件に応じて、詳細操作ガイド に直接移動してください。
| 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 方法