Table of Contents

Diagnose und behebung: Inhalte werden nicht angezeigt

Dieser Artikel bietet systematische methoden zur problembehebung und verbesserungsvorschläge für häufige probleme, bei denen virtuelle inhalte bei der ebenen bildverfolgung nicht angezeigt werden, um entwicklern zu helfen, probleme schnell zu lokalisieren und zu lösen.

Häufige ursachen und lösungsansätze

Nicht angezeigte inhalte betreffen in der regel bilderkennung, implementierungsfehler oder berechtigungseinschränkungen. Hier sind die hauptursachen und schritte zur problembehebung:

Bilderkennung fehlgeschlagen

Symptom: Nachdem die kamera auf das zielbild ausgerichtet wurde, erscheinen virtuelle inhalte überhaupt nicht.
Lösungsansätze:

  • Bilderfassbarkeit prüfen: Verwenden sie das zielbild-prüftool, laden sie das bild hoch und stellen sie sicher, dass die bewertung der erfassbarkeit (muss 4-5 sterne betragen) korrekt ist.
  • Bildqualität validieren: Stellen sie sicher, dass das bild den anforderungen an textur, größe und seitenverhältnis in den best practices entspricht.
  • Zielbild-entität prüfen: Stellen sie sicher, dass die oberfläche der zielbild-entität (z.b. poster, karte) nicht reflektiert, flach und ohne falten ist.
  • Protokolle überprüfen: Prüfen sie die anwendungsprotokolle, suchen sie nach dem TargetLoad-ereignis und bestätigen sie, ob das zielbild erfolgreich geladen wurde.

Verbesserungsvorschläge:

  • Bild optimieren: Kontrast erhöhen, sich wiederholende muster vermeiden, sicherstellen, dass das hauptmotiv über 70% des bildes ausfüllt.
  • Bild ersetzen: Wenn das problem nach der bildoptimierung weiterhin besteht, verwenden sie ein testbild aus der offiziellen sample (z.b. namecard.jpg), um zu überprüfen, ob das problem beim bild selbst liegt.
  • Entität sicherstellen: Zielentitäten sollten nach möglichkeit matte oder raue oberflächen haben, flach und ohne falten oder krümmungen sein.
  • Logik prüfen: Sicherstellen, dass die anwendung das für den test verwendete zielbild korrekt geladen hat.

Implementierungsfehler

Symptom: Bild wurde erkannt, aber virtuelle inhalte werden nicht angezeigt oder sind fehlpositioniert.

Lösungsansätze:

  • ImageTarget-konfiguration prüfen:
    • Je nach Source-typ überprüfen, ob es auf die korrekte datei im StreamingAssets-ordner verweist.
    • Ob Scale auf die tatsächliche physikalische größe eingestellt ist.
  • Prefab-hierarchie bestätigen: Virtuelle inhalte (z.b. cube) müssen untergeordnete knoten von ImageTarget sein und dürfen nicht deaktiviert sein.

Verbesserungsvorschläge:

  • Konfiguration zurücksetzen: ImageTarget in der szene löschen und neu erstellen, prefab gemäß vorschrift einziehen und bild binden.
  • Test vereinfachen: Temporär benutzerdefinierte skripte entfernen, nur grundlegenden cube behalten, um eine minimale lauffähige szene zu bestätigen.
  • Protokolle prüfen: Nach ImageTargetController-bezogenen fehlern suchen, wie z.b. fail to load target data.

Berechtigungsprobleme

Symptom: Inhalte wurden ursprünglich angezeigt, verschwinden aber nach einiger laufzeit.
Lösungsansätze:
Bestätigen sie, ob einer der folgenden fälle zutrifft:

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

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

Verbesserungsvorschläge:

  • Verwenden sie eine vollversion-lizenz.

Probleme mit virtuellen inhalten

Symptom: Inhalte wurden ursprünglich angezeigt, sind aber bei sehr naher/weiter kameraposition zum zielobjekt nicht sichtbar.
Lösungsansätze:

  • Nah- und fernschnitt prüfen: Stellen sie sicher, dass ihre nah- und fernschnitt-einstellungen beim rendern virtueller inhalte im sinnvollen bereich liegen.
  • Modellgröße prüfen: Bei zu großen inhaltsmodellen kann näherung zum zielobjekt zum durchdringen des modells führen, sodass inhalte unsichtbar werden; bei zu kleinen modellen können inhalte bei entfernung vom zielobjekt zu klein dargestellt werden, um erkennbar zu sein.

Verbesserungsvorschläge:

  • Passende nah- und fernschnitt-werte festlegen.
  • Sicherstellen, dass virtuelle inhalte im verhältnis zur physikalischen größe der zielbild-entität angemessen dimensioniert sind.

Zusammenfassung und best practices

Nicht angezeigte inhalte werden typischerweise durch bilder, programmimplementierung, berechtigungen oder die inhalte selbst verursacht. Empfohlene vorgehensweise zur problembehebung:

  1. Prüfen, ob es sich um eine vollversion-lizenz handelt;
  2. Prüfen, ob virtuelle inhalte angemessen gestaltet sind;
  3. Zielbildqualität validieren;
  4. Bestätigen, ob probleme in der programmimplementierung oder entwicklerkonfiguration vorliegen.

Bei anhaltenden problemen können sie über das easyar-offizielle forum oder technischen support protokolldateien, bildschirmaufnahmen etc. zur weiteren analyse bereitstellen.