Mega mapping failure troubleshooting guide
マッピングの過程で、アップロードの失敗や生成の失敗といった問題が発生することがあります。ほとんどの場合、データ収集の品質が低いことが原因です。データ収集時にはデータ収集ドキュメントの要件を厳守することで、デバイスパラメータの誤りやルート計画の不備などによる問題を回避できます。収集ドキュメントに従って収集を行ったにもかかわらずマッピング中に問題が発生した場合は、このドキュメントを参照してさらにトラブルシューティングを行ってください。
正常なマッピングプロセス
EasyAR Mega Blockのマッピングプロセスは、主にデータアップロード、軌跡生成、位置特定マップ、密マップ生成のいくつかのステップに分かれています。
データアップロード
GoPro Max/Max2で収集したファイルは容量が大きい（1時間の動画で約30GB）ため、ネットワーク状況によってアップロード時間が長くなる可能性があります。アップロードが成功すると、
Mega Block mappingマッピングタスクの操作欄でアップロードファイルを表示でき、ファイル名と数がローカルファイルと一致するか確認する必要があります。データが一致すればアップロードは正常です。アップロードが成功すると、マッピングステータスがキューイング中または生成中と表示される場合があり、.LRV形式の動画をオンラインで再生することもできます。
注記
データアップロード中にもデータの検証が行われます。このプロセスは比較的速く、エラーが報告されなければ無視して構いません。
軌跡生成
Mega Blockマッピングシステムはデータ収集時の軌跡を復元する必要があり、これには時間がかかる場合があります。マッピングプロセスが正常であれば、軌跡生成中またはマッピング完了後に、
Block mappingでマッピング軌跡を確認できます。収集した軌跡が正常かどうかをユーザーが確認しやすいように、EasyARは軌跡プレビュー機能を提供しています。マッピングが完了したすべてのGoPro Max/Max2データに対して
空間軌跡をプレビュー機能が利用可能で、空間軌跡に基づいてデータ収集の欠落がないか確認できます。
屋外で収集したデータについては、EasyARは
GPS軌跡をプレビュー機能も提供しています
Mega Block マップ生成
Mega Blockマップ生成は計算量が多いため、このステージは比較的時間がかかります。マッピングが完了すると、タスクステータスは
タスク完了と表示されます。同時に、EasyARが提供するマッピングレポートも確認できます。
GoPro Max/Max2 マッピング失敗の現象と対応策
データアップロード失敗
データアップロードステージでは、ネットワークやデータの影響により2つの問題が発生する可能性があります：ネットワークが不安定な場合、アップロードが止まったり、ネットワークが切断されたりする問題が発生します；収集したデータに問題がある場合、ファイル検査に合格できません。
ファイルアップロード失敗
典型的な現象：アップロード進捗が止まる、後戻りする、またはネットワーク切断が表示される。
原因：通常はネットワーク環境が悪いためで、ユーザー自身で対処できます。
まずページの更新や再ログインを試みてください（長時間ログインしている場合を避けるため）
再アップロードをクリック：データフォルダを再度選択し、すべてのファイルを最初からアップロードします（アップロード初期に失敗した場合に適しています）。
アップロード再開をクリック：前回アップロードに失敗したデータフォルダ（フォルダ内のファイルは変更不可）を選択し、失敗したファイルからアップロードを再開します。
ネットワーク最適化：アップロード中はブラウザウィンドウをアクティブに保ち、ブラウザを閉じたり、ページを更新したり、他のメニューをクリックしたりしないでください。ネットワークを安定させ、他の大容量ネットワーク活動は避けてください。
注記
EasyARは、良好な有線または無線ネットワーク環境でのマッピングデータアップロードを強く推奨します。GoPro Max/Max2のファイルは大きいため、モバイルデータ通信の使用は推奨しません。
ファイル検査不合格
典型的なメッセージ：XXX 動画が破損しています！、以下のファイルでエラーが検出されました：XXX、XXX ファイル名の動画フレームレート設定が誤っています！
原因：動画ファイルがアップロードされると、EasyARシステムはファイルを迅速に検査し、不合格データを事前に除外して待ち時間を短縮します。収集要件を遵守していないか、SDカードの損傷やGoProデバイスの問題が原因である可能性があります。
XXX 動画が破損しています！または以下のファイルでエラーが検出されました：XXXが表示された場合GoProメモリカードからファイルを再度コピーしてアップロードしてみてください
別のPCやブラウザでアップロードしてみてください
収集時に異常シャットダウンなどが発生した可能性があるため、再収集する必要があります
XXX ファイル名の動画フレームレート設定が誤っています！が表示された場合- GoPro Max 設定ガイドまたはGoPro Max2 設定ガイドに従って正しいフレームレートを設定してください
注記
ページを更新しても検査に合格しない場合は、EasyARの収集仕様に従ってデータを再収集する必要があります。
マッピング失敗
Blockマッピングステータスで生成失敗が表示された場合、マッピング失敗レポートを確認できます。
入力ファイルが破損していないか確認してください（花屏による可能性があります）が表示された場合、動画ファイルに花屏（画像乱れ）がないか確認する必要があります。入力ファイルが破損していないか確認してください（異常シャットダウン、または撮影時のTFカード記録の遅延による可能性があります）【動画エラー時間：xx s】が表示された場合、エラー時間付近の動画に異常がないか確認する必要があります。内部エラー、フィードバックをお願いします（撮影中にカメラが落下、衝突、急激な移動、完全な暗闇環境の通過、エレベーターの利用による可能性があります）が表示された場合、収集中にカメラが落下・衝突などの急激な移動が発生したか、収集者がエレベーターを利用して異常な加速度が発生したか、収集ルートに完全な暗闇のシーンが含まれている可能性があります。入力ファイルが破損していないか確認してくださいが表示された場合、動画プレーヤーで収集した動画を再生し、異常がないか確認する必要があります。サーバー異常、後で再試行してくださいが表示された場合、しばらく待ってからマッピングを再試行してください。
ヒント
マッピングレポートに内部エラー、フィードバックをお願いしますが表示された場合、またはレポートに原因が示されていない場合は、マッピングレポートをEasyARスタッフにフィードバックしてください。
注記
マッピングレポートに動画エラー時間が示されていて、入力が複数の動画ファイルである場合、対応する動画のエラー時間点を自身で換算してください。
スマートフォン マッピング失敗
スマートフォンによるマッピングは通常、成功率が高いです。失敗した場合は、まず以下を確認してください：
- 収集中に同じ場所に留まり続けていないか
- 環境光が十分か
- カメラを遮蔽していないか
収集が正しく行われたことを確認しても失敗する場合は、マッピングレポートをEasyARスタッフにフィードバックしてください。
問題のフィードバック
上記の自己チェックを完了し、データ自体に明らかな品質問題（花屏なし、パラメータエラーなし）がないことを確認したにもかかわらずマッピングが失敗する場合は、以下の標準プロセスに従ってEasyARチームにフィードバックしてください。
問題処理とフィードバック
問題を特定したら、以下の方法で情報を収集しフィードバックしてください。技術チームが迅速に問題を特定し修正します：
フィードバック情報
技術チームが迅速に問題を特定できるよう、以下の情報を必ず提供してください：
マッピングレポート：Mega開発センターからダウンロード形式のマッピングレポートを提供してください。タスクID、エラーメッセージなどが含まれています。
収集計画ルート図：収集計画のスクリーンショットや動画を提供すると、問題をより迅速に特定できます。
上記の資料をまとめて、担当するEasyARテクニカルサポート担当者に送付してください。
フィードバック処理の見込み
技術担当者はマッピングレポートに基づき、ログと生データを確認し、可能性のある原因を分析します：
- 収集の重大な違反（激しい揺れ、完全な暗闇など）：仕様に従って再収集が必要です
- アルゴリズムパラメータの適応問題：高度なマッピングモードを有効化し、クラウドパラメータを調整してBlockマップの再生成を試みます
通常のパラメータ調整で効果がない場合、開発チームが介入し、データが特定のシナリオ（極端な弱テクスチャなど）のアルゴリズムの死角に該当するかどうかを分析し、アルゴリズムの反復で修正できるかどうかを評価します。