Mega よく寄せられる質問
開発中に問題が発生することは避けられません。このドキュメントは、一般的な問題を迅速に特定し解決するための手助けを目的としています。まずはよく寄せられる質問（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：なぜ私のアプリが位置特定できず、ステータスが常に NotFound のままなのですか？
A：通常、以下のいずれかの理由が原因です：
- 位置情報サービスがまだ起動中である：
この時点では、位置情報サービスがすべての Mega マップの読み込みを完全に完了しておらず、特定のエリアでの位置特定の成功を保証できません。 - マップのカバー範囲外にいる：
現在いる物理的な位置が、読み込んだ Mega マップのカバー範囲内にあることを確認してください。 - シミュレーションテストの設定ミス：
現場で実行していないのに、MegaLocationInputModeが誤ってOnsiteに設定されている。 - 環境条件が悪い：
極端な光量（暗すぎるまたは明るすぎる）、広範囲にわたる単色の壁や床（白い壁、研磨された床など）は、視覚的位置特定に影響を与えます。
Q：なぜ私のアプリが位置特定できず、異常なステータスが返されるのですか？
A：通常、以下のいずれかの理由が原因です：
- リクエストがタイムアウトした：
この場合、システムはRequestTimeoutを返します。 - リクエスト間隔が短すぎる：
この場合、システムはRequestIntervalTooLowを返します。 - その他の異常エラー：
この場合、システムはUnknownErrorを返します。一般的に、この種の例外は接続や伝送中の失敗、または Mega サービス自体のエラーに対応します。詳細はMegaBlockLocalizationResponse.ErrorMessageインターフェースから取得できます。
Q：なぜ私のミニアプリのプラグイン使用申請が失敗するのですか？
A：これは、WeChat デベロッパーツールの「ゲストモード」ではミニアプリプラグインの使用がサポートされておらず、また、主体が個人のミニアプリでも使用がサポートされていないためです。企業主体の WeChat ミニアプリ AppId を使用して申請してください。
Q：为什么我的小程序授权が未承認ですか？
A：開発センターから Mega 小程序プラグインライセンスを取得し、使用している AppId がライセンス内のものと同じであることを確認する必要があります。
Q：なぜ私の小程序は XX スマートフォンで使用できないのですか？
A：小程序への Mega 統合は、WeChat の VisionKit コンポーネントに依存しています。そのシステム要件および対応デバイスのリストについては、WeChat ドキュメントを参照してください。
Q：位置特定は成功したのに、仮想コンテンツの位置がずれている、またはドリフトしているように見えます？
A：位置特定の効果に関する問題は、原因が複雑な場合が多く、以下の可能性があります：
- マッピング精度の問題：
そのエリアの Mega マップ自体に精度誤差がある可能性があります。これは通常、マップの収集または再構築段階で発生します。ビジネス担当に確認してください。 - 初期化時のジャンプ：
位置特定が開始して数秒間は、位置がわずかにジャンプすることがあります。これはデバイスの SLAM システムの初期化が完了していないためです。WeChat 小程序ではこのプロセスが特に顕著です（一部のデバイスでは時間がかかる場合もあります）。 - 環境の動的変化：
物理環境が大幅に変化した場合（例：大きな備品の移動、仮設パネルの設置）、マップと現実が一致しなくなる可能性があります。この場合はマップの更新が必要です。 - デバイスシステム誤差：
ほとんどのデバイスは、長時間連続稼働すると、SLAM システムの累積誤差によりドリフトが発生します。 - 位置特定誤差の問題：
ビジュアル位置特定自体には精度誤差があります。通常、この誤差は仮想コンテンツの視覚的体験に影響しません。誤差が顕著なずれやドリフトを引き起こすほど大きい場合は、詳細なデータによる分析と解決が必要です。問題診断と報告で紹介されている方法に従ってデータを収集し、フィードバックしてください。
Q：デバッグのために EIF データを収集・使用するにはどうすればよいですか？
A：EIF データは強力なデバッグツールです。以下の章を参照してください：
- 収集方法：スマートフォンまたはヘッドセットで EIF ファイルを記録する方法については、シミュレーション実行データの収集をお読みください。
- 再生方法：開発環境（Unity または WeChat 小程序）に応じて、該当章の再生ガイドラインを参照してください。
より具体的なヘルプを探す
上記の FAQ で問題が解決しない場合は、以下のトピック別ページで詳細な解決策を参照してください:
- コンテンツが表示されない - コンテンツレンダリングに関するトラブルシューティングに焦点を当てます。
- コンテンツの跳動とドリフト - コンテンツの跳動やドリフトの詳細な分析。
- WeChatミニプログラム統合の既知の問題 - ミニプログラムプラットフォーム固有の問題をまとめました。
新しい問題を報告する
上記でカバーされていない、SDK またはプラットフォーム自体の問題と思われる事象に遭遇した場合は、製品改善のためご協力ください。詳細な手順やガイダンスについては、問題報告 を参照してください。
報告を提出する前に、以下の情報を準備してください。これらは問題解決に大きく役立ちます:
- 問題の説明：発生している現象、頻度、再現手順を明確に記述してください。
- デバイス情報：デバイスモデル、OSバージョン、EasyAR SDKバージョン。
- EIFデータ：問題を再現できる EIF記録ファイル を必ず提供してください。これは最も重要な診断材料です。
- ログファイル：アプリケーションの完全なログ（Logcat または Console 出力）。
- 画面録画またはスクリーンショット：問題発生時の画面録画またはスクリーンショット。
上記情報を フォーラム、メールまたはビジネス窓口 経由で提出してください。ご協力に感謝いたします！