Mega FAQ
開発中に問題が発生することは避けられません。このページは、よくある問題をすばやく特定して解決するためのものです。まず FAQ の一覧から始めます。ここで答えが見つからない場合は、後続の章を参照するか、問題レポートを提出してください。
よくある質問 (FAQ)
以下は、開発者が EasyAR Mega を統合および使用するときによく遭遇する問題と解決策です。
Q: アプリケーションに Invalid Key と表示されるのはなぜですか？
A: 通常、次のいずれかが原因です。
- License が無効または期限切れ
- License が Bundle ID / Package Name と一致しない
- ヘッドセットデバイスには別途 XR License が必要
- カスタムカメラ機能には正式版 License が必要
Q: アプリケーションにウォーターマークがあるのはなぜですか？
A: 使用している License が正式版ではなく試用版であることを示しています。
Q: アプリケーションにカウントダウン表示（timeout within * seconds）が出るのはなぜですか？
A: これは試用製品期間中の制限です。正式版の EasyAR Sense ライセンスと正式版 EasyAR Mega サービスを使用すると、この問題を解決できます。
Q: アプリケーションを開くと黒画面になるのはなぜですか？
A: この場合、通常は画面情報またはログにエラー原因が出力されます。システムが出力した具体的な原因に基づいて解決できます。解決できない場合は、ログ、スクリーンショット、詳細なデバイス情報などの技術情報をフィードバックしてください。
Q: アプリケーションが localization できず、返される状態が常に NotFound なのはなぜですか？
A: 通常、次のいずれかが原因です。
- localization サービスがまだ起動中:
この時点では localization サービスがすべての Mega マップを完全に読み込み終えていないため、特定のエリアで localization が成功することを保証できません。 - マップのカバー範囲外:
現在の物理位置が、読み込んだ Mega マップのカバー範囲内にあることを確認してください。 - シミュレーションテスト設定エラー:
現地で実行していないにもかかわらず、MegaLocationInputModeが誤ってOnsiteに設定されています。 - 環境条件が不十分:
極端な光（暗すぎる、明るすぎる）、白い壁や磨かれた床など広い単色の壁面または床面は、visual localization に影響します。
Q: アプリケーションが localization できず、返される状態が異常なのはなぜですか？
A: 通常、次のいずれかが原因です。
- Request timeout:
この場合、システムはRequestTimeoutを返します。 - Request 間隔が短すぎる:
この場合、システムはRequestIntervalTooLowを返します。 - その他の異常エラー:
この場合、システムはUnknownErrorを返します。一般的に、この種の異常は接続または伝送過程の失敗、あるいは Mega サービス自体のエラーに対応します。MegaBlockLocalizationResponse.ErrorMessageインターフェイスから詳細情報を取得できます。
Q: Mini Program プラグインの利用申請が失敗するのはなぜですか？
A: Mini Program プラグインは WeChat Developer Tools の “visitor mode” での使用をサポートしておらず、個人主体の Mini Program での使用もサポートしていないためです。企業主体の WeChat Mini Program AppId を使用して申請してください。
Q: Mini Program の承認が通らないのはなぜですか?
A: developer center から Mega Mini Program plugin license を取得し、使用している AppId が license 内のものと同じであることを確認する必要があります。
Q: 自分の Mini Program が XX のスマートフォンで使用できないのはなぜですか?
A: Mini Program に Mega を統合するには、WeChat の VisionKit コンポーネントに依存します。その system requirements と device support list については、WeChat documentationを参照してください。
Q: Localization は成功しましたが、仮想コンテンツの位置がずれている、または drifting しているように見えるのはなぜですか?
A: Localization 効果に関わる問題の原因は複雑であることが多く、考えられる原因は次のとおりです。
- Mapping 精度の問題:
このエリアの Mega map 自体に精度誤差が存在する可能性があります。これは通常、map collection または reconstruction 段階で発生します。確認のため、ビジネスサポートにお問い合わせください。 - Initialization 時のジャンプ:
Localization 開始直後の数秒間、位置が軽くジャンプする場合があります。これは device の SLAM システムがまだ initialization を完了していないためです。WeChat Mini Program ではこのプロセスが特に明らかで、一部の devices では比較的長い時間がかかることもあります。 - 環境の動的変化:
物理環境が大きく変化した場合、たとえば大型の設置物を移動したり一時的な展示板を追加したりした場合、map が現実と一致しなくなる可能性があります。この場合は map を更新する必要があります。 - Device システム誤差:
多くの devices は長時間連続実行した後、その SLAM システムの累積誤差によって drifting が発生する可能性があります。 - Localization 誤差の問題:
Visual localization 自体には精度誤差があります。通常、この誤差は仮想コンテンツの視覚体験には影響しません。誤差が大きく、明らかなずれや drifting が発生する場合、分析と解決には詳細なデータが必要です。issue diagnosis and report で説明されている方法を参照して、データを収集しフィードバックしてください。
Q: デバッグ用に EIF データを収集して使用するにはどうすればよいですか?
A: EIF データは強力な debugging tool です。次のセクションを参照してください。
- 収集方法: collect simulated runtime data を読み、スマートフォンまたは headset で EIF ファイルを記録する方法を確認してください。
- Replay 方法: development environment、Unity または WeChat Mini Program に応じて、そのセクション内の該当する replay guide を参照してください。
より具体的なヘルプを探す
上記 FAQ で問題が解決しない場合は、次のトピックページでより詳しい解決策を確認できます。
- コンテンツが表示されない - コンテンツレンダリングのトラブルシューティングに焦点を当てます。
- コンテンツの揺れとドリフト - コンテンツの揺れとドリフトを詳しく分析します。
- WeChat Mini Program 統合の既知問題 - mini program プラットフォーム固有の問題のまとめです。
新しい問題を報告
上記に含まれない、SDK またはプラットフォーム自体に関連すると思われる問題に遭遇した場合は、製品改善にご協力ください。詳しい手順や案内は 問題レポート を参照してください。
レポートを提出する前に、次の情報を準備してください。問題解決に大きく役立ちます。
- 問題説明: 発生している現象、頻度、操作手順を明確に説明してください。
- デバイス情報: デバイスモデル、OS バージョン、EasyAR SDK バージョン。
- EIF データ: 問題を再現できる EIF 記録ファイル を必ず提供してください。これは最も重要な診断根拠です。
- ログファイル: アプリケーションの完全なログ（Logcat または Console 出力）。
- 画面録画またはスクリーンショット: 問題発生時の画面録画またはスクリーンショット。
上記情報を フォーラム、メール、またはビジネス窓口 からお送りください。フィードバックありがとうございます。