Table of Contents

Diagnose und Behebung: Inhalt wird nicht angezeigt

Dieser Artikel behandelt häufige Probleme, bei denen virtuelle Inhalte im 3D object 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 fehlgeschlagener object recognition, Fehlern bei der Funktionsimplementierung oder permission-Einschränkungen zusammen. Die wichtigsten Ursachen und troubleshooting-Schritte sind:

Fehlgeschlagene object recognition

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

  • Modellqualität prüfen: Stellen Sie sicher, dass 3D model und object die Anforderungen an file format, texture, geometry usw. in model preparation erfüllen.
  • Target object prüfen: Stellen Sie sicher, dass die Oberfläche des target object kein reflektierendes oder spiegelndes Material aufweist.
  • Logs prüfen: Prüfen Sie application logs und bestätigen Sie, ob das target model erfolgreich geladen wurde.

Verbesserungsvorschläge:

  • Modell optimieren: Stellen Sie sicher, dass textures ausreichend reichhaltig sind und die geometry keine Löcher aufweist.
  • Logik prüfen: Stellen Sie sicher, dass die Anwendung das target model korrekt geladen hat. Wenn das Laden fehlschlägt, lesen Sie target loading failure zur Prüfung und Behebung.

Fehler bei der Funktionsimplementierung

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

Troubleshooting:

  • ObjectTarget-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 entsprechend der tatsächlichen Größe des object geändert wurde. Wenn zum Beispiel die aus der Modelldatei berechnete BoundingBox-Größe 10 x 10 x 30 beträgt und die tatsächliche Größe des object 0.1m x 0.1m x 0.3m ist, sollte Scale auf 0.01 gesetzt werden.
  • Prefab-Hierarchie bestätigen:
    • Virtueller Inhalt muss auf derselben Ebene wie das target 3D model liegen, und beide müssen child nodes von ObjectTarget sein. Virtueller Inhalt darf nicht deaktiviert sein.
    • Die Eigenschaft Rotation des target 3D model muss die Richtung Y auf 180 setzen.
    • Die Platzierung des virtuellen Inhalts muss vollständig um die Position des target 3D model herum erfolgen.

Verbesserungsvorschläge:

  • Konfiguration zurücksetzen: Löschen Sie ObjectTarget in der scene und erstellen Sie es neu, ziehen Sie das prefab gemäß Spezifikation hinein und binden Sie das 3D model.
  • Logs prüfen: Suchen Sie nach Fehlern im Zusammenhang mit ObjectTargetController, 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 zum target object angemessen sein.

Zusammenfassung und Best Practices

Nicht angezeigter Inhalt wird normalerweise durch das object 3D model, 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 des target 3D model bestätigen;
  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.