Diagnose und behebung: Inhalte werden nicht angezeigt

Dieser Artikel bietet systematische fehlerbehebungsmethoden und verbesserungsempfehlungen für häufige probleme beim nicht-anzeigen virtueller inhalte im 3D-objekt-tracking, um entwicklern zu helfen, probleme schnell zu lokalisieren und zu lösen.

Häufige ursachen und fehlerbehebungsmethoden

Das nicht-anzeigen von inhalten betrifft normalerweise fehlgeschlagenes objekterkennen, implementierungsfehler oder berechtigungseinschränkungen. Hier sind die hauptursachen und schritte zur fehlersuche:

Objekterkennung fehlgeschlagen

Phänomen: Nachdem die kamera auf das zielobjekt gerichtet wurde, erscheinen virtuelle inhalte überhaupt nicht.
Fehlerbehebungsmethoden:

• Modellqualität prüfen: Stellen sie sicher, dass 3D-modelle und objekte die anforderungen an dateiformate, texturgeometrie usw. in modellvorbereitung erfüllen.
• Zielobjekt prüfen: Stellen sie sicher, dass die oberfläche des zielobjekts keine reflektierenden oder spiegelnden materialien aufweist.
• Protokolle überprüfen: Überprüfen sie die anwendungsprotokolle, um festzustellen, ob das zielmodell erfolgreich geladen wurde.

Verbesserungsempfehlungen:

• Modell optimieren: Stellen sie sicher, dass texturen ausreichend detailliert sind und die geometrie keine löcher aufweist.
• Logik überprüfen: Stellen sie sicher, dass die anwendung das zielmodell korrekt geladen hat. Bei ladefehlern, siehe kapitel ziel-ladefehler zur überprüfung und behebung.

Implementierungsfehler

Phänomen: Objekt wurde erkannt, aber virtuelle inhalte werden nicht angezeigt oder befinden sich in abnormaler position.

• Unity
• Native

Fehlerbehebungsmethoden:

• ObjectTarget-konfiguration prüfen:
  • Überprüfen sie basierend auf dem Source-typ, ob es auf die korrekte datei im ordner StreamingAssets verweist.
  • Wurde Scale basierend auf den tatsächlichen abmessungen des objekts angepasst? (z.B. wenn die aus der modelldatei berechneten boundingBox-abmessungen 10 x 10 x 30 betragen, das objekt aber tatsächlich 0,1m x 0,1m x 0,3m misst, sollte Scale auf 0,01 gesetzt werden).
• Prefab-hierarchie bestätigen:
  • Virtuelle inhalte müssen sich auf derselben ebene wie das 3D-zielmodell befinden und untergeordnete knoten von ObjectTarget sein. Virtuelle inhalte dürfen nicht deaktiviert sein.
  • Die Rotation-eigenschaft des 3D-zielmodells muss im Y-bereich auf 180 gesetzt sein.
  • Die platzierung virtueller inhalte muss vollständig um die position des 3D-zielmodells herum erfolgen.

Verbesserungsempfehlungen:

• Konfiguration zurücksetzen: Löschen und neu erstellen von ObjectTarget in der szene, prefab gemäß spezifikation einfügen und 3D-modell binden.
• Protokolle prüfen: Suchen sie nach ObjectTargetController-bezogenen fehlern, wie z.B. fail to load target data.

Berechtigungsprobleme

Phänomen: Inhalte wurden ursprünglich angezeigt, verschwinden aber nach einiger laufzeit.
Fehlerbehebungsmethoden:
Bestätigen sie, ob einer der folgenden fälle zutrifft:

• Verwendung auf einem XR-headset
• Verwendung einer benutzerdefinierten kamera
• Verwendung auf einem smartphone mit AR Engine/ARFoundation

Wenn einer dieser fälle zutrifft, verwenden sie möglicherweise eine testlizenz.

Verbesserungsempfehlungen:

• Verwenden sie eine vollversion der lizenz.

Probleme mit virtuellen inhalten

Phänomen: Inhalte wurden ursprünglich korrekt angezeigt, sind aber bei sehr nah/weit positionierter kamera vom zielobjekt nicht sichtbar.
Fehlerbehebungsmethoden:

• Nah-/fernclipping-einstellungen prüfen: Stellen sie sicher, dass die near/far-clipping-einstellungen beim rendern virtueller inhalte in einem vernünftigen bereich liegen.
• Modellgröße der inhalte prüfen: Bei zu großen inhaltsmodellen kann näherung ans zielobjekt zu clipping führen; bei zu kleinen modellen können inhalte in der ferne zu klein zum erkennen werden.

Verbesserungsempfehlungen:

• Legen sie geeignete near/far-clipping-werte fest.
• Stellen sie sicher, dass die physikalische größe virtueller inhalte im verhältnis zum zielobjekt angemessen ist.

Zusammenfassung und best practices

Probleme mit nicht angezeigten inhalten werden typischerweise durch 3D-objektmodelle, programmimplementierung, berechtigungen oder die inhalte selbst verursacht. Empfohlene fehlerbehebungsreihenfolge:

1. Prüfen sie, ob es sich um eine vollversion der lizenz handelt.
2. Überprüfen sie die angemessenheit der virtuellen inhalte selbst.
3. Bestätigen sie die qualität des 3D-zielmodells.
4. Bestätigen sie, ob probleme in der programmimplementierung oder entwicklerkonfiguration vorliegen.

Bei fortbestehenden problemen können sie über das EasyAR-offizielle forum oder technischen support protokolldateien, bildschirmaufnahmen usw. zur weiteren analyse bereitstellen.