Table of Contents

Diagnose und Behebung: Target-Laden fehlgeschlagen

Die 3D-Objekttracking-Funktion hängt stark von der Qualität des eingegebenen 3D-Modells ab. Wenn das Laden des Zielmodells fehlschlägt, gibt EasyAR detaillierte Fehlerprotokolle aus, um Entwicklern bei der Fehlersuche zu helfen. Dieses Kapitel listet häufige Ursachen und Lösungen für Material-, Textur- und Modelldateiprobleme auf.

Fehler bei Material-/Texturkartendateien

Diese Fehler werden normalerweise durch Pfadkonfiguration oder Dateiformatprobleme verursacht.

Log-Meldung Fehlerursache Lösung
Material file not exist Der Pfad zur Materialdatei (.mtl) existiert nicht oder wird nicht korrekt referenziert Prüfen Sie, ob die .mtl-Datei im Modellordner vorhanden ist und ob der mtllib-Pfad in der .obj-Datei korrekt als relativer Pfad darauf zeigt
Current material has no name Der Materialdefinition fehlt ein Name (newmtl ist nicht angegeben) Fügen Sie in der .mtl-Datei für jedes Material einen Namen hinzu, z. B. newmtl Material1
No texture map exists in material Im Material ist keine Texturkarte angegeben (map_Ka oder map_Kd fehlt) Fügen Sie in der .mtl-Datei einen Texturpfad hinzu, z. B. map_Kd texture.jpg
Read texture map file failed Die Texturdatei kann nicht gelesen werden (falscher Pfad oder nicht unterstütztes Format) Prüfen Sie, ob die Texturdatei im Modellordner liegt, im JPG/PNG-Format vorliegt und der Pfad keine Leerzeichen enthält

Modelldateifehler

Diese Fehler werden normalerweise durch nicht standardkonforme OBJ-Dateiformate oder Kodierungsprobleme verursacht.

Log-Meldung Fehlerursache Lösung
Error in opening OBJ file Der Pfad zur Modelldatei existiert nicht oder die Berechtigungen reichen nicht aus Prüfen Sie den Dateipfad und stellen Sie sicher, dass die Datei lesbar ist
Error in reading OBJ file Datei konnte nicht gelesen werden (Kodierung nicht UTF-8 oder Datei beschädigt) Öffnen Sie die .obj-Datei in einem Texteditor und speichern Sie sie mit UTF-8-Kodierung
Material not exist Das von der Fläche referenzierte Material wurde in der .mtl-Datei nicht gefunden Prüfen Sie das Feld usemtl in der .obj-Datei und stellen Sie sicher, dass es mit dem newmtl-Namen in der .mtl-Datei übereinstimmt
Vertex format invalid Ungültiges Vertex-Koordinatenformat (Daten der v-Zeile entsprechen nicht der Spezifikation) Prüfen Sie das v-Format: v x y z (z. B. v -4.322898 6.063079 -40.241329) und stellen Sie sicher, dass es numerische Werte sind
Vertex texture coordinate format invalid Ungültiges Vertex-Texturkoordinatenformat (Daten der vt-Zeile entsprechen nicht der Spezifikation) Prüfen Sie das vt-Format: vt u v (z. B. vt 0.929688 0.094622) und stellen Sie sicher, dass die Werte zwischen 0 und 1 liegen
Face format invalid Die Fläche enthält weniger als 3 Vertices (Daten der f-Zeile sind ungültig) Prüfen Sie die f-Zeile und stellen Sie sicher, dass jede Fläche mindestens 3 Vertices enthält
Both vertex index and vertex texture coordinate index are required Ungültiges Flächenformat (Vertex- oder Texturindex fehlt) Prüfen Sie das Format der f-Zeile und stellen Sie sicher, dass Vertex- und Texturindizes enthalten sind (z. B. f 1/1 2/2 3/3)
Vertex index format invalid Ungültiger Flächen-Vertex-Index (Index außerhalb des Bereichs oder keine Ganzzahl) Prüfen Sie die Vertex-Indizes in der f-Zeile und stellen Sie sicher, dass sie positive Ganzzahlen sind und die Gesamtzahl der Vertices nicht überschreiten
Vertex texture coordinate index format invalid Ungültiger Flächen-Texturkoordinatenindex Prüfen Sie die Texturindizes in der f-Zeile und stellen Sie sicher, dass sie positive Ganzzahlen sind und die Gesamtzahl der Texturkoordinaten nicht überschreiten

Best Practices

Wenn ein Ladefehler auftritt, prüfen Sie anhand der Informationen in den obigen Tabellen. Im Allgemeinen sollten Sie diese grundlegenden Richtlinien befolgen:

  • Wenn Ihr Modell aus professionellen Tools wie Blender oder Maya exportiert wurde, aktivieren Sie beim Export unbedingt "write materials" und "include UVs" (oder ähnliche Optionen), und stellen Sie sicher, dass alle Dateien im selben Ordner liegen.
  • Referenzpfade in von Tools exportierten Modelldateien können absolute Pfade sein. Prüfen Sie diese unbedingt und ändern Sie sie in relative Pfade, vermeiden Sie Leerzeichen in Dateinamen, und stellen Sie sicher, dass die Dateikodierung UTF-8 ist.
  • Detaillierte Anforderungen an Modellformat und Spezifikationen finden Sie unter Modellvorbereitung.

Tipp: Wenn das Problem weiterhin nicht gelöst werden kann, packen Sie die Modelldateien und Fehlerprotokolle und holen Sie Hilfe über das offizielle EasyAR-Forum oder den technischen Support ein.