Mega 追跡效果異常排查ガイド
Mega は端末とクラウドを融合した技術を採用しており、クラウドでの位置特定に成功した後、デバイスの SLAM を組み合わせて持続的な追跡を維持し、AR コンテンツをリアルな世界に正確に固定します。理想的な追跡状態は、ドリフトがなく、低ジャターで、高い流暢性を備えるべきです。このドキュメントは、Mega の位置特定プロセスにおける追跡異常問題に焦点を当て、正しい期待値、一般的なエラーの分類、デバイスの違いによる影響を理解し、いつ EasyAR の技術サポートに連絡する必要があるかを明確にするのに役立ちます。
期待される効果
追跡異常は通常、マッピングデータの品質、環境要因、またはデバイスの互換性に起因します。あなたは MegaToolbox を使用して問題を排查することができます。問題がランタイムのアプリケーションの効果に関係する場合、あなたのアプリを直接使用して体験することもできます。
高品質の Mega Block と良好な環境では、追跡効果は以下の基準に合致する必要があります。
- 安定した固定:位置特定に成功した後、仮想コンテンツは世界座標に固定され、明らかなドリフトはありません。
- 強力な回復:一時的な遮断、急速な回転、または光の変化の後、自動的に追跡を回復します。
- 性能の流暢性:コンテンツのレンダリングは正常で、明らかなジャターはありません。
- 環境制限:無地の壁、空曠な地面、ガラス、または強い反射面の近くでは、追跡効果が低下します。
あなたの体験が上記の説明に合致する場合、追跡効果は基本的に正常です。
正常な現象:わずかなジャターまたは一時的なロストは許容範囲内です。特に作成プロセスの検証段階ではそうです。長時間安定していれば、正常と見なされます。
Mega Toolbox を使用した自助診断
追跡異常は通常、位置特定に成功した後に発生します。あなたが開発したアプリで追跡効果が異常な場合、Mega Toolbox(詳細は Mega Toolbox 操作マニュアル - 現場検証と診断ツール を参照)で位置特定の状況を確認する必要があります。両者の効果が一致しない場合は、まずプログラムの実装に問題がないか確認してください。
操作手順
- あなたのテスト用の携帯電話に Mega Toolbox をインストールしてください。
- Toolbox を開き、
現場検証と診断ツールに入り、あなたのアカウントとパスワードでログインしてください。 - SLAM 方式を選択し、位置特定ライブラリを選択してください。
- 携帯電話を問題が発生した正確な位置に持っていき、Toolbox 画面の表示を観察してください。
位置特定ライブラリの設定方法、および現場でのテスト方法については、具体的に 現場の実際の動作効果のプレビュー を参照してください。
Toolbox の表示結果に基づく判断
Mega Toolbox は最重要な診断ツールです。これは独立した携帯電話アプリであり、問題が Mega から来ているのか、あなたのアプリから来ているのかを判断するのに役立ちます。
位置特定異常
Toolbox 画面に
FoundとNotFound以外の状態が表示される場合は、位置特定失敗の対処ガイド を参照して解決してください。位置特定成功
Toolbox 画面の状態が
Foundと表示され、配置されたコンテンツも正常に表示されます。正常な状況は次の通りです:
- コンテンツはシーンに比較的適合し、一定期間内にゆっくりと移動します。
- 仮想コンテンツがシーンから一定の範囲を超えると、直接修正されます。
異常な状況は次の通りです:
- シーン内のコンテンツが常に一方向に漂います。
- コンテンツが一方向に漂ってから引き戻され、また漂って引き戻されます。
- コンテンツがますます大きくなったり、小さくなったりするなど。
- いくつかの場所のコンテンツが飛び移ります。
エラー状況の分類と排查
Toolbox を使用してテストを行い、異常現象に基づいて、対応する提案を確認することができます。
| 異常分類 | 考えられる原因 | 対処提案 |
|---|---|---|
| デバイス状態が常に NotTracking と表示される | 環境に明らかな特徴がない、光線が悪い、または携帯電話の機種が不適切など | 環境によるものか、携帯電話の機種によるものかを確認し、テストエリアまたは携帯電話の機種を変更してみることができます |
| シーン内のコンテンツが常に一方向に漂う | 携帯電話の機種が不適切で、SLAM にドリフトがある | より良い機種に変更して試してみてください |
| コンテンツが一方向に漂ってから引き戻され、また漂って引き戻される | 携帯電話の機種が不適切で、SLAM にドリフトがある | より良い機種に変更して試してみてください |
| コンテンツがますます大きくなったり、小さくなったりするなど | 携帯電話の機種が不適切で、SLAM にドリフトがある | より良い機種に変更して試してみてください |
| いくつかの場所のコンテンツが飛び移る | シーン内にいくつかの似たようなエリアが存在する可能性があり、これらのエリアから位置特定を開始すると、干渉が発生する可能性があります | 他の独特なエリアから位置特定を開始するか、Bluetooth を使用して補助してください |
さらなるテスト
問題をより正確に特定するために、以下の方法でさらなるテストを行うことができます。あなたが開発者の場合は、Mega がサポートするデバイスとプラットフォームアプリケーション を参照してください。
より良い機種でテストする
異なるデバイスでは追跡効果に差があり、主にカメラの品質、センサーの精度、プロセッサーの性能に影響されます。作成プロセスの検証時には、いくつかの異なる機種でテストを行い、互換性を確保することをお勧めします。ARKit または ARCore デバイスで追跡効果が正常であれば、問題のデバイスの性能に起因することが確定します。性能が低いデバイスの場合は、異なる SLAM 方式を選択してテストを行うことができます。
異なる SLAM 方式を選択する
一部の性能が低い機種では、携帯電話のセンサーの精度と演算能力の影響を受けて、SLAM の精度が比較的低くなります。Toolbox の 現場検証と診断ツール ページで、異なる SLAM 方式を選択してテストを行い、FiveDof、ThreeDof、または ZeroDof を使用して異なる追跡効果を体験することができます。
![]()
フィードバックが必要な状況
作成プロセス中のほとんどの追跡異常はデバイスの原因ですが、以下の状況は Block アルゴリズムまたはサービスの問題に関係する可能性があり、EasyAR サポートにフィードバックすることをお勧めします。
- 複数の機種、複数のエリアでテストした後も、頻繁なドリフトが依然として存在する。
- Toolbox で位置特定できない、または位置特定が異常である。
- 同じ Block が異なる天候、光線の下で大きく異なる効果を示し、補充更新でも解決できない。
なお問題がある場合は、現場の問題の説明、デバイス情報、現場での実行時の画面録画、EIF ファイル、および Mega サービス情報/Block 診断情報 を EasyAR の担当者にフィードバックする必要があります。問題をフィードバックする前に、Mega Studio でこの EIF が問題を再現できることを確認する必要があります。
このガイドを通じて、あなたは作成段階で追跡異常を迅速に排查し、Mega Block の全体的な品質を向上させることができます。