Table of Contents

Diagnose und Behebung: Inhalt wird nicht angezeigt

Dieser Artikel behandelt häufige Probleme, bei denen virtuelle Inhalte im planar image tracking nicht angezeigt werden können. Er bietet systematische troubleshooting-Methoden und Verbesserungsvorschläge, damit Entwickler Probleme schnell finden und lösen können.

Häufige Ursachen und troubleshooting-Methoden

Nicht angezeigte Inhalte hängen normalerweise mit image recognition, Fehlern bei der Funktionsimplementierung oder permission-Einschränkungen zusammen. Die wichtigsten Ursachen und troubleshooting-Schritte sind:

Fehlgeschlagene image recognition

Symptom: Nachdem die Kamera auf die target image gerichtet wurde, erscheint der virtuelle Inhalt überhaupt nicht. Troubleshooting:

  • Recognition score des Bildes prüfen: Verwenden Sie das target image detection tool, um die image hochzuladen und den recognition score zu bestätigen, der 4-5 Sterne erreichen sollte.
  • Image-Qualität prüfen: Stellen Sie sicher, dass die image die Anforderungen an texture, Größe und Seitenverhältnis in best practices erfüllt.
  • Target image entity prüfen: Stellen Sie sicher, dass die Oberfläche der target image entity, z. B. Poster oder Karte, nicht reflektiert und flach ohne Falten bleibt.
  • Logs prüfen: Prüfen Sie application logs, suchen Sie nach dem TargetLoad event und bestätigen Sie, ob die target image erfolgreich geladen wurde.

Verbesserungsvorschläge:

  • Image optimieren: Kontrast erhöhen, wiederholte Muster vermeiden und sicherstellen, dass das Hauptmotiv mehr als 70% des Bildes einnimmt.
  • Image ersetzen: Wenn das Problem nach der Optimierung weiterhin besteht, verwenden Sie ein Testbild aus dem offiziellen Sample, z. B. namecard.jpg, um zu prüfen, ob die image selbst die Ursache ist.
  • Physische Entität sicherstellen: Die target entity sollte möglichst eine matte oder relativ raue Oberfläche verwenden und flach ohne Falten oder Biegung bleiben.
  • Logik prüfen: Stellen Sie sicher, dass die Anwendung die für den Test verwendete target image korrekt geladen hat.

Fehler bei der Funktionsimplementierung

Symptom: Die image wurde erkannt, aber der virtuelle Inhalt wird nicht angezeigt oder seine Position ist abnormal.

Troubleshooting:

  • ImageTarget-Konfiguration prüfen:
    • Prüfen Sie je nach Source-Typ, ob auf die richtige Datei im Ordner StreamingAssets verwiesen wird.
    • Prüfen Sie, ob Scale auf die tatsächliche physische Größe gesetzt ist.
  • Prefab-Hierarchie bestätigen: Virtueller Inhalt, z. B. Cube, muss ein child node von ImageTarget sein und darf nicht deaktiviert sein.

Verbesserungsvorschläge:

  • Konfiguration zurücksetzen: Löschen Sie ImageTarget in der scene und erstellen Sie es neu, ziehen Sie das prefab gemäß Spezifikation hinein und binden Sie die image.
  • Test vereinfachen: Entfernen Sie vorübergehend custom scripts und behalten Sie nur den grundlegenden Cube bei, um die minimale lauffähige scene zu bestätigen.
  • Logs prüfen: Suchen Sie nach Fehlern im Zusammenhang mit ImageTargetController, z. B. fail to load target data.

Permission-Probleme

Symptom: Es funktionierte zunächst normal, aber nach einiger Laufzeit verschwindet der Inhalt. Troubleshooting: Bestätigen Sie, ob einer der folgenden Fälle zutrifft:

  • Verwendung auf einem XR headset
  • Verwendung einer custom camera
  • Verwendung von AR Engine/ARFoundation auf einem Telefon

Wenn einer der oben genannten Fälle zutrifft, verwenden Sie möglicherweise eine Trial-License.

Verbesserungsvorschläge:

  • Verwenden Sie eine offizielle License.

Probleme mit virtuellem Inhalt

Symptom: Der Inhalt wird zunächst normal angezeigt, ist aber nicht sichtbar, wenn die Kamera sehr nah oder sehr weit vom target object entfernt ist. Troubleshooting:

  • Near- und far clipping-Einstellungen prüfen: Stellen Sie sicher, dass die near und far clipping-Einstellungen beim Rendern virtueller Inhalte in einem sinnvollen Bereich liegen.
  • Größe des content model prüfen: Wenn das content model zu groß ist, kann Nähe zum target object zu Durchdringung führen, sodass der Inhalt unsichtbar wird; wenn das content model zu klein ist, kann Entfernung vom target object dazu führen, dass es zu klein angezeigt wird, um klar erkennbar zu sein.

Verbesserungsvorschläge:

  • Geeignetes near und far clipping einstellen.
  • Die physische Größe des virtuellen Inhalts sollte im Verhältnis zur target image entity angemessen sein.

Zusammenfassung und Best Practices

Nicht angezeigter Inhalt wird normalerweise durch die image, die Programminplementierung, permissions oder den Inhalt selbst verursacht. Empfohlene troubleshooting-Reihenfolge:

  1. Prüfen, ob die License eine offizielle Version ist;
  2. Prüfen, ob der virtuelle Inhalt selbst geeignet ist;
  3. Qualität der target image prüfen;
  4. Bestätigen, ob Probleme in Programminplementierung oder Entwicklungskonfiguration vorhanden sind.

Wenn das Problem weiterhin besteht, stellen Sie log files, Bildschirmaufzeichnungen und andere Materialien über das offizielle EasyAR-Forum oder den technischen Support für weitere Analysen bereit.