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

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

一般的な原因と troubleshooting 方法

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

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

image recognition score を確認: target image detection tool を使用して image をアップロードし、recognition score を確認します。4-5 星に達する必要があります。
image 品質を検証: image が best practices の texture、サイズ、比率要件を満たしていることを確認します。
target image entity を確認: poster や card など target image entity の表面に反射がなく、平らで折り目がないことを確認します。
logs を確認: application logs を確認し、TargetLoad event を検索して、target image が正常にロードされたか確認します。

改善提案:

image を最適化: コントラストを上げ、繰り返し pattern を避け、主題が画像の 70% 以上を占めるようにします。
image を置き換え: image 最適化後も問題が続く場合、公式 Sample のテスト画像、例えば namecard.jpg を使用して、問題が image 自体にあるかを検証します。
物理 entity を確保: target entity はできるだけマットまたは比較的粗い表面を使用し、表面を平らに保ち、折れや曲がりがないようにします。
ロジックを確認: アプリケーションがテストに使用する target image を正しくロードしていることを確認します。

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

Troubleshooting:

ImageTarget 設定を確認:
- Source タイプに応じて、StreamingAssets フォルダー内の正しいファイルを指しているか確認します。
- Scale が実際の物理サイズに設定されているか確認します。
prefab 階層を確認: Cube などの仮想コンテンツは ImageTarget の child node であり、無効化されていてはいけません。

改善提案:

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

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

改善提案:

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

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

改善提案:

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

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