Table of Contents

UI-Meldungen

Zur Laufzeit des EasyAR Sense Unity Plugin gibt es drei Arten von Meldungen.

  • Laufzeitausnahmen, einschließlich Sense Error, Session Error, Error und Warning
  • Session Dump
  • Spezielle Ausnahmen für die EasyAR-Mega-Entwicklung

Sie können die Ausgabeweise der ersten beiden Meldungstypen nach Bedarf anpassen. Dies kann im Editor über die Komponente DiagnosticsController an der session konfiguriert werden oder in Skripten über die Schnittstelle DiagnosticsController.MessageOutput.

diagnostics ui messages

Tipp

In Version 4000 wird DiagnosticsController beim Öffnen der Szene automatisch zur session hinzugefügt, wenn die Szene mit einer älteren Plugin-Version erstellt wurde. In manchen Unity-Versionen wird dies möglicherweise nicht automatisch hinzugefügt; in diesen Unity-Versionen wird DiagnosticsController zur Laufzeit automatisch mit Standardwerten erstellt.

Laufzeitausnahmen

Während das Plugin läuft, können gelegentlich Probleme, die von internen Komponenten erkannt werden, als Meldungen im System erscheinen. Einige dieser Meldungen können schwerwiegende Fehler sein, bei denen die Nutzung nicht fortgesetzt werden kann; einige können absichtlich ausgelöst werden; andere können auf nicht unterstützte Geräte zurückgehen. Nach Schweregrad von hoch nach niedrig werden sie in folgende Kategorien eingeteilt:

  • SenseError: EasyAR Sense-Fehler, normalerweise im Zusammenhang mit der EasyAR Sense license.
  • SessionError: ARSession-Fehler, normalerweise im Zusammenhang damit, dass das Gerät einige Funktionen nicht unterstützt, oder mit falscher Konfiguration.
  • Error: andere Fehlerinformationen
  • Warning: Warninformationen

Aufgrund der Besonderheiten der Unity-Entwicklung zeigen wir diese Meldungen standardmäßig in der UI an, um die Entwicklung zu unterstützen.

Im Editor oder in Skripten können Sie steuern, wie diese Meldungen angezeigt werden. Die auswählbaren Ausgabemodi sind:

  • UIAndLog: Ausgabe in UI und Log. Auf einem Headset wird sie 5 Meter vor den Augen angezeigt.
  • Log: Ausgabe in das Systemlog.
Tipp
  • In der Entwicklungs- und Testphase wird empfohlen, die Standardkonfiguration UIAndLog zu verwenden.
  • Bei der Veröffentlichung wird empfohlen, die Option auf Log zu ändern. Sie können UIAndLog auch beibehalten, aber diese UI-Meldungen sind für Endbenutzer normalerweise nicht freundlich.
  • Vor dem Ausführen wird empfohlen, session-Verfügbarkeit und Geräteunterstützung zu prüfen und für nicht unterstützte Geräte sinnvolle Hinweise zu geben.

Sense Error

Sense Error ist eine spezielle Fehlerart. Wenn dieser Fehler auftritt, können EasyAR-Funktionen nicht weiter verwendet werden. Häufige Ursachen:

  • Die license ist nicht korrekt konfiguriert oder die Prüfung schlägt fehl. Dieser Fehler kann durch erneute Initialisierung mit einer korrekten license behoben werden.
  • Auf einigen Geräten, darunter AR Foundation, AR Engine, alle Geräte mit benutzerdefinierter Kamera oder verschiedene Headsets, wurde die feste begrenzte Nutzungsdauer von Testprodukten überschritten, etwa Personal Edition license, Test-XR license oder Test-Mega-Dienst. Dieser Fehler kann nicht behoben werden.

Session Error

Session Error ist ein Fehler, bei dem die aktuelle ARSession nicht weiterarbeiten kann. Eine Änderung der Konfiguration und ein erneutes Ausführen von ARSession können diese Fehler möglicherweise beheben. Diese Fehler werden im Allgemeinen durch falsche Konfiguration, eine während des Startablaufs ausgelöste Ausnahme, die die Zusammensetzung unterbricht, ein Gerät, das von der aktuellen ARSession-Konfiguration nicht unterstützt wird, oder verlorene ARSession-Komponenten zur Laufzeit verursacht.

Häufige Fälle:

  • Fehler bei der Session-Zusammensetzung: zum Beispiel wird das Gerät nicht unterstützt oder der Frame Source eines unterstützten Geräts ist nicht korrekt in ARSession konfiguriert.
  • Fehler beim Session-Start: Falsche Konfigurationsinformationen des cloud service führen zu einem Fehler beim Erstellen der cloud service-Funktion, oder Konfigurationsinformationen sind nicht ausgefüllt, einschließlich Mega-Dienst, cloud recognition-Dienst, SpatialMap-Dienst usw.
  • Fehler während der Session-Laufzeit: ARSession-Komponenten werden extern zerstört, RendererFeature ist in einer URP-Umgebung nicht korrekt konfiguriert usw.

Im Allgemeinen sollten Konfigurationsfehler und Ausnahmen im Startablauf, die die Zusammensetzung unterbrechen, während der Entwicklung vermieden werden. Nicht unterstützte Geräte treten hauptsächlich bei Funktionen auf, die motion tracking erfordern. Lesen Sie Motion tracking und EasyAR-Funktionen, um zu erfahren, bei welchen Funktionen auf Geräteunterstützung zu achten ist, und wählen Sie in der Entwicklungsphase geeignete Geräte für das Debugging.

Session Dump

Die Meldung SessionDump zeigt den zur Laufzeit des Plugins gesammelten Betriebszustand von ARSession, einschließlich einiger wichtiger Zustände der einzelnen Komponenten. Diese Zustandsinformationen helfen sehr dabei, den Betrieb von EasyAR zu verstehen und Probleme zu analysieren.

Im Editor oder in Skripten können Sie steuern, wie diese Zustände angezeigt werden. Die auswählbaren Ausgabemodi sind:

  • UI: Anzeige in der UI und Aktualisierung in jedem Frame. Auf einem Headset wird sie 5 Meter vor den Augen angezeigt.
  • Log: Ausgabe in das Systemlog. Da in jedem Frame ausgegeben wird, beeinflusst dies die Laufzeitleistung; die Verwendung wird daher in Entwicklung oder Test empfohlen.
  • None: keine Ausgabe.
Tipp
  • In der Entwicklungs- und Testphase wird empfohlen, die Standardkonfiguration UI zu verwenden. Die oben angezeigten Informationen sind für die Kommunikation mit EasyAR-Mitarbeitern unverzichtbar.
  • Nach dem offiziellen Onlinegang wird empfohlen, auf None zu wechseln und einen Software-Schalter zum Aktivieren von UI beizubehalten oder Daten über andere Systeme zu sammeln. Wenn Sie EasyAR ein Problem melden, wird EasyAR diese Informationen von Ihnen oder Ihren Benutzern anfordern, um den Betriebszustand der Anwendung zu beurteilen.
  • In den meisten Fällen muss die App-Seite bei Problemen nach dem Onlinegang zuerst Fehler untersuchen und analysieren. Probleme lassen sich besser lösen, wenn App-Probleme ausgeschlossen und ausreichend Informationen gesammelt wurden. Es gibt viele Drittanbieter-SDKs und Plattformen für Logsammlung und -analyse; ihre Verwendung vor dem Onlinegang wird empfohlen. Wenn Sie keine Erfahrung oder Ressourcen für solche Plattformen haben, ist es relativ einfach, einen Schalter zum Aktivieren von UI beizubehalten, etwa einen versteckten Schalter, damit Benutzer die sichtbaren Informationen melden können.

Spezielle Ausnahmen für die EasyAR-Mega-Entwicklung

In der Mega-Entwicklung gibt es außerdem eine Art nicht steuerbarer Warnmeldungen. Diese Meldungen werden in der UI angezeigt, wenn bestimmte Konfigurationsbedingungen erfüllt sind, und Entwickler können sie nicht direkt schließen.

Es wird empfohlen, auf die Meldung selbst zu achten; der Text beschreibt Ursache und Konfigurationsmethode. Entwickler müssen die Anforderungen verschiedener Konfigurationen für verschiedene Nutzungsweisen verstehen und entsprechend dem Entwicklungsfortschritt sinnvoll wählen.

Diese Meldungen werden absichtlich angezeigt, weil diese Funktionen unter bestimmten Nutzungsbedingungen die Entwicklung des Content-Ablaufs unterstützen, gleichzeitig aber keine sinnvollen Laufzeitergebnisse liefern können. Achten Sie darauf, solche Meldungen nicht in den Release mitzunehmen.

Verwandte Themen