Table of Contents

診断と修正: コンテンツが表示されない

本記事は、3D object tracking において仮想コンテンツを表示できない一般的な問題を対象に、体系的な troubleshooting 方法と改善提案を提供し、開発者が問題を素早く特定して解決できるようにします。

一般的な原因と troubleshooting 方法

コンテンツが表示されない問題は、通常 object recognition の失敗、機能実装エラー、または permission 制限に関係します。主な原因と troubleshooting 手順は次のとおりです。

Object recognition の失敗

現象: カメラを target object に向けても、仮想コンテンツがまったく表示されない。 Troubleshooting:

  • モデル品質を確認: 3D model と object が model preparation の file format、texture、geometry などの要件を満たしていることを確認します。
  • target object を確認: target object の表面に反射または鏡面 material がないことを確認します。
  • logs を確認: application logs を確認し、target model が正常にロードされたかを確認します。

改善提案:

  • モデルを最適化: textures が十分に豊富で、geometry に穴がないことを確認します。
  • ロジックを確認: アプリケーションが target model を正しくロードしていることを確認します。ロードに失敗した場合は、target loading failure を参照して確認と修正を行います。

機能実装エラー

現象: object は認識されたが、仮想コンテンツが表示されない、または位置が異常。

Troubleshooting:

  • ObjectTarget 設定を確認:
    • Source タイプに応じて、StreamingAssets フォルダー内の正しいファイルを指しているか確認します。
    • Scale が object の実際のサイズに基づいて変更されているか確認します。例えば、モデルファイルから計算された BoundingBox サイズが 10 x 10 x 30 で、object の実際のサイズが 0.1m x 0.1m x 0.3m の場合、Scale は 0.01 に設定する必要があります。
  • prefab 階層を確認:
    • 仮想コンテンツは target 3D model と同じ階層にあり、どちらも ObjectTarget の child nodes である必要があります。仮想コンテンツは無効化されていてはいけません。
    • target 3D model の Rotation プロパティは、Y 方向を 180 に設定する必要があります。
    • 仮想コンテンツの配置は、target 3D model の位置を完全に基準にする必要があります。

改善提案:

  • 設定をリセット: scene 内の ObjectTarget を削除して再作成し、仕様に従って prefab をドラッグして 3D model をバインドします。
  • logs を確認: ObjectTargetController 関連のエラー、例えば fail to load target data を検索します。

Permission 問題

現象: もともとは正常に使用できていたが、しばらく実行するとコンテンツが消える。 Troubleshooting: 次のいずれかに該当するか確認します。

  • XR headset で使用している
  • custom camera を使用している
  • スマートフォンで AR Engine/ARFoundation を使用している

上記のいずれかに該当する場合、trial License を使用している可能性があります。

改善提案:

  • 正式版 License を使用します。

仮想コンテンツの問題

現象: コンテンツは最初正常に表示されるが、カメラが target object に非常に近い/遠いと見えない。 Troubleshooting:

  • near/far clipping 設定を確認: 仮想コンテンツを rendering するときの near/far clipping 設定が合理的な範囲にあることを確認します。
  • content model サイズを確認: content model が大きすぎる場合、target object に近づくとモデルを突き抜けてコンテンツが見えなくなる可能性があります。content model が小さすぎる場合、target object から離れると小さすぎて見えにくくなる可能性があります。

改善提案:

  • 適切な near/far clipping を設定します。
  • target object の物理サイズと比較して、仮想コンテンツの物理サイズが適切である必要があります。

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

コンテンツが表示されない問題は、通常 object 3D model、プログラム実装、permission、またはコンテンツ自体によって発生します。次の順序で troubleshooting することを推奨します。

  1. License が正式版か確認する。
  2. 仮想コンテンツ自体が適切か確認する。
  3. target 3D model の品質を確認する。
  4. プログラム実装または開発設定に問題があるか確認する。

問題が続く場合は、EasyAR 公式フォーラムまたは技術サポートを通じて log files、画面録画などを提供し、追加分析を行ってください。