Table of Contents

診断と修復：アプリケーション内のコンテンツが表示されない問題

「現実世界は見えるけれど、仮想コンテンツが表示されない。」これは AR 開発で最も頻繁に発生する問題の一つです。この問題は、Mega 定位自身からあなたのレンダリングロジックまで、複数の段階で発生する可能性があります。

この記事では、この問題をシステマティックに調査して解決する方法を案内します。

調査フロー：外部から内部へ

「先に外部、次に内部」の原則に従うことで、問題を効率的に特定することができます。以下の手順を順番に実行してください。

手順一：外部ツールを使用して Mega 定位状態を検証する (コードを変更する必要はありません)

あなたのアプリケーションコードを深く調べる前に、まず Mega 定位サービス自体が正常に動作しているかを確認してください。これは最も重要なステップで、問題が Mega 定位自体にあるのか、レンダリングなどのアプリケーション開発統合問題にあるのかを判断するのに役立ちます。

  1. Mega Toolbox (モバイル端末) を使用する

    • テスト用の携帯電話に Mega Toolbox App をインストールします (まだインストールされていない場合)。
    • App を開き、現場検証と診断ツールにアクセスします。
    • あなたのアカウントにログインし、あなたのアプリケーションと同じ定位ライブラリを選択します。
    • 携帯電話を、あなたのアプリケーションでテストした際にコンテンツが表示されなかった同じ場所に持っていきます。
    • 結果を観察する：
      • Toolbox が定位に成功した場合（画面上の状態が Found と表示される）：おめでとうございます！ Mega 定位サービスは正常に動作しています。問題はあなたのアプリケーション内部、特にレンダリングとコンテンツ表示のロジックにあります。手順二に進んでください。
      • Toolbox が定位に失敗した場合（画面上の状態が NotFound またはその他の表示）：問題は定位サービス自体にあります。次のセクションを参照して詳細な分析を行ってください。

  2. PC 端末でのシミュレーション実行を使用する (EIF を収集した場合)

    • このシーンについて EIF データを録画している場合は、PC 端末の Unity エディタで session 検証ツールを使用してこのデータを再生できます。
    • 結果を観察する：
      • 再生時に定位に成功した場合（画面上の状態が Found と表示される）：問題はあなたのアプリケーションコードまたはデバイス固有の環境にあります。
      • 再生時に定位に失敗した場合（画面上の状態が NotFound またはその他の表示）：問題は定位サービス自体にあります。次のセクションを参照して詳細な分析を行ってください。

手順二：アプリケーション内部のレンダリングとコンテンツのロジックを確認する

手順一で Mega 定位サービス自体が正常であることが確認された場合、問題はあなたのアプリケーションコードにあります。以下の点を確認してください。

  1. コンテンツが正しいノードの下に配置されているか：

    • 3D オブジェクトをツールが自動生成した MegaBlocks > Block_* ノードの下に正しく配置していますか？
    • コンテンツと Block ノードの階層関係を確認し、実行時に仮想コンテンツのレンダリング位置が正しいことを確認してください。

  2. MegaTracker の Block Root が正しく設定されているか：

    • AR Session を展開し、Mega Tracker の Block Root がツールが生成した MegaBlocks ノードであることを確認してください。

  3. MegaBlocks ノードが変更されていないか：

    • Block_* ノードの名前を変更していないこと、および local transform 属性のいずれの数値も変更していないことを確認してください。

  4. イベントリスニングが正しく設定されているか：

    • MegaTracker の定位コールバック処理ロジックを変更したことはありますか？
    • あなたのコードは、定位状態が成功したイベントがトリガーされた後にのみ、仮想コンテンツのインスタンス化または表示操作を実行していますか？

  5. ヘッドセットのレンダリングと透明度：

    • あなたの仮想オブジェクトが他のオブジェクトによって隠されていませんか？ レンダリングキューとシェーダーを確認してください。
    • VST (ビデオ透視) デバイスを使用している場合は、レンダリングがビデオストリームの上に正しく重ねられていることを確認してください。
    • OST (光透視) デバイスを使用している場合は、環境光が強すぎるためにコンテンツが見えにくくなっていないか確認してください。

  6. コンテンツ自体の問題：

    • あなたがインスタンス化したプレファブ（Prefab）自体に問題はありませんか？ たとえば、モデルファイルが欠落している、シェーダーエラー、拡大率が 0 など。シーン内に同じオブジェクトを手動で配置し、正常に表示されるかどうかを確認してみてください。

一般的な定位失敗の原因分析と改善提案

手順一で Mega Toolbox も定位できないことがわかった場合、定位問題を詳しく調べて解決する必要があります。以下は一般的な原因と対策です。

  • 原因一：マップと環境が一致していない
    現場の環境は、マップを収集して作成したときと比べて大きく変化しているか、体験するエリアが収集時にカバーされていないか、またはマップ自体が間違っています。
    改善提案：

    • 定位ライブラリに読み込まれているマップが、現在の物理空間のシーンと一致していることを確認してください。
    • 環境が改造された場合（たとえば、改装、展示品の交換）、マップを再収集して生成する必要があります。
    • マップを収集して作成したときに問題が発生したエリアがカバーされていない場合、補足更新を行ってマップを再生成する必要があります。

  • 原因二：初期化環境が不適切
    テクスチャが少ないエリア（たとえば、無地の壁、地面に向かって）でアプリケーションを起動します。
    改善提案：

    • ユーザーに、テクスチャが豊富なエリアでアプリケーションを起動するように案内し、システムが迅速に初期定位を完了できるようにしてください。
    • アプリケーションの UI に、「携帯電話を持ち上げて左右を見回してください」などの明確な指示を表示してください。

  • 原因三：ネットワークまたはサービスの問題
    ネットワーク遅延により定位サービスのリクエストがタイムアウトしたか、定位サービス自体に障害が発生したか、または同時使用上限を超えています。後者の場合は、すぐに私たちにフィードバックしてください。

  • 原因四：アルゴリズムの能力限界に達した
    Mega 定位は、高度なコンピュータビジョン、AI などのアルゴリズムに基づいていますが、万能ではなく、一定のアルゴリズム能力の限界があります。特定のシーンやポイントで定位が持続的に失敗する場合、スクリーンレコーディングや EIF データの録画などによって私たちにフィードバックし、アルゴリズムの継続的な改善と更新を支援してください。

また、Mega 定位には通常 1 - 2 秒程度の時間がかかります。ネットワークの混雑、高い同時使用率、携帯電話の発熱による降周波数など、現実のシナリオの複雑さを考慮すると、この時間はさらに長くなる可能性があります。したがって、アプリケーション内に明確なロード/待機画面を設計し、ユーザーに「定位中...」と通知して、ユーザーが待機中にサービスが停止したと誤解したり、定位できないと思ったりしないようにしてください。

注記
  • 初回の定位は通常、その後の定位よりも遅くなります。これは、システムが初回の定位成功後に関連するコンテンツを読み込む必要があるからです。これは正常な現象です。
  • デバイスを素早く移動すると、定位が失われる可能性があります。ユーザーにデバイスをゆっくりと移動するように案内してください。

まとめとベストプラクティス

  • 常に外部ツールを使って最初に検証する：これにより、問題の範囲を「定位」または「レンダリング」にすばやく絞り込むことができます。
  • 適切なユーザー期待値を設定する：UI での指示により、ユーザーに定位に時間がかかることを知らせ、適切な環境へ導きます。
  • コンテンツロジックに注意する：コンテンツのバインドなどの設定が正しいことを確認してください。
  • ログを活用する：重要なノード（イベントのトリガー、姿勢の取得、応答状態など）でログを出力することで、コードのロジック問題を素早く特定することができます。

以上のシステマティックな調査により、ほとんどの「コンテンツが表示されない」問題を解決できるはずです。問題が依然として解決しない場合は、EIF データとログを用意し、問題報告 の方法で詳細な報告を私たちに提出してください。