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