Table of Contents

Ui nachrichten

EasyAR Sense Unity Plugin hat zur Laufzeit drei Arten von Nachrichten.

  • Laufzeitausnahmen, einschließlich Sense Error, Session Error, Error, Warning
  • Session Dump
  • EasyAR Mega-Entwicklungsspezifische Ausnahmen

Sie können die Ausgabemethode der ersten beiden Nachrichtentypen nach Bedarf anpassen. Dies kann über die Komponente DiagnosticsController auf der Session im Editor konfiguriert werden oder über die Schnittstelle DiagnosticsController.MessageOutput in Skripten.

diagnostics ui messages

Tipp

In Version 4000 wird DiagnosticsController automatisch zur Session hinzugefügt, wenn eine Szene mit einer älteren Plugin-Version erstellt und geöffnet wird. In einigen Unity-Versionen wird sie möglicherweise nicht automatisch hinzugefügt. In diesen Unity-Versionen wird DiagnosticsController zur Laufzeit automatisch mit Standardwerten erstellt.

Laufzeitausnahmen

Während der Plugin-Laufzeit werden manchmal Probleme erkannt, die von internen Komponenten als Nachrichten im System ausgegeben werden. Einige dieser Nachrichten können schwerwiegende Fehler sein, die eine weitere Nutzung unmöglich machen, andere können absichtlich ausgelöst werden, oder es kann sich um nicht unterstützte Geräte handeln usw. Sie werden nach Schweregrad von hoch nach niedrig wie folgt klassifiziert:

  • SenseError: EasyAR Sense-Fehler, normalerweise im Zusammenhang mit der EasyAR Sense-Lizenz.
  • SessionError: ARSession-Fehler, normalerweise im Zusammenhang mit nicht unterstützten Gerätefunktionen oder fehlerhaften Konfigurationen.
  • Error: Andere Fehlermeldungen
  • Warning: Warnmeldungen

Aufgrund der Besonderheiten der Unity-Entwicklung werden diese Nachrichten standardmäßig auf der UI angezeigt, um die Entwicklung zu unterstützen.

Sie können steuern, wie diese Nachrichten angezeigt werden, entweder im Editor oder in Skripten. Die verfügbaren Ausgabemodi sind:

  • UIAndLog: Ausgabe auf UI und in Protokolle. Auf Head-Mounted-Displays wird sie 5 Meter vor dem Benutzer angezeigt.
  • Log: Ausgabe in die Systemprotokolle.
Tipp
  • Es wird empfohlen, während der Entwicklungs- und Testphase die Standardkonfiguration UIAndLog zu verwenden.
  • Es wird empfohlen, die Option vor der Veröffentlichung auf Log zu ändern. Sie können auch UIAndLog beibehalten, aber diese UI-Nachrichten sind für Endbenutzer normalerweise nicht benutzerfreundlich.
  • Es wird empfohlen, vor dem Start die Session-Verfügbarkeit und Geräteunterstützung zu prüfen und nicht unterstützte Geräte angemessen zu kennzeichnen.

Sense error

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

  • Lizenz wurde nicht korrekt konfiguriert oder die Validierung ist fehlgeschlagen. Dieser Fehler kann durch erneute Initialisierung mit einer gültigen Lizenz behoben werden.
  • Verwendung von Testprodukten (Personal Edition-Lizenz, Testversion der XR-Lizenz oder Testversion des Mega-Dienstes usw.) auf bestimmten Geräten (einschließlich AR Foundation, AR Engine und allen Geräten mit benutzerdefinierter Kamera oder verschiedenen Headsets) über die festgelegte begrenzte Zeit hinaus. Dieser Fehler kann nicht behoben werden.

Session error

Session Error ist ein Fehler, bei dem die aktuelle ARSession nicht weiterarbeiten kann. Das Ändern der Konfiguration und ein Neustart der ARSession können diesen Fehler möglicherweise beheben. Diese Fehler werden normalerweise durch Konfigurationsfehler, Ausnahmen während des Startvorgangs, die zum Abbruch der Zusammenstellung führen, nicht unterstützte Geräte für die aktuelle ARSession-Konfiguration oder den Verlust von ARSession-Komponenten während des Betriebs verursacht.

Häufige Fälle:

  • Session-Zusammenstellungsfehler: Z.B. nicht unterstütztes Gerät oder die für das Gerät unterstützte Frame Source wurde nicht korrekt in der ARSession konfiguriert.
  • Session-Startfehler: Fehlerhafte Konfigurationsinformationen für Cloud-Dienste führen zu Fehlern bei der Erstellung von Cloud-Service-Funktionen, oder Konfigurationsinformationen wurden nicht ausgefüllt (einschließlich Mega-Dienst, Cloud-Erkennungsdienst, SpatialMap-Dienst).
  • Fehler während des Session-Betriebs: ARSession-Komponente wurde extern zerstört, RendererFeature in URP-Umgebung nicht korrekt konfiguriert usw.

Im Allgemeinen sollten Konfigurationsfehler und Ausnahmen während des Startvorgangs, die zum Zusammenstellungsabbruch führen, während der Entwicklung vermieden werden. Probleme mit nicht unterstützten Geräten treten hauptsächlich bei Funktionen auf, die Bewegungsverfolgung erfordern. Lesen Sie Bewegungsverfolgung und EasyAR-Funktionen, um zu erfahren, bei welchen Funktionen die Geräteunterstützung zu beachten ist, und wählen Sie während der Entwicklung geeignete Geräte für Tests aus.

Session dump

SessionDump-Nachrichten zeigen den Laufzeitzustand der ARSession an, der vom Plugin gesammelt wird, einschließlich einiger Schlüsselzustände der verschiedenen Komponenten. Diese Statusinformationen sind sehr hilfreich, um die Funktionsweise von EasyAR zu verstehen und Probleme zu analysieren.

Sie können steuern, wie dieser Status angezeigt wird, entweder im Editor oder in Skripten. Die verfügbaren Ausgabemodi sind:

  • UI: Wird auf der UI angezeigt und bei jedem Frame aktualisiert. Auf Head-Mounted-Displays wird sie 5 Meter vor dem Benutzer angezeigt.
  • Log: Ausgabe in die Systemprotokolle. Da sie bei jedem Frame erfolgt, beeinträchtigt dies die Leistung. Empfohlen für Entwicklung oder Tests.
  • None: Keine Ausgabe.
Tipp
  • Es wird empfohlen, während der Entwicklungs- und Testphase die Standardkonfiguration UI zu verwenden. Die dort angezeigten Informationen sind für die Kommunikation mit EasyAR-Mitarbeitern unerlässlich.
  • Es wird empfohlen, nach dem offiziellen Release auf None zu ändern und gleichzeitig einen Software-Schalter zum Aktivieren von UI beizubehalten oder die Datenerfassung über ein anderes System durchzuführen. Bei der Meldung von Problemen an EasyAR werden diese Informationen von Ihnen oder Ihren Benutzern angefordert, um den Anwendungszustand zu beurteilen.
  • In den meisten Fällen muss bei Problemen nach der Veröffentlichung zunächst eine Problembehebung und -analyse auf Anwendungsseite erfolgen. Nur Probleme, die nach Ausschluss von Anwendungsfehlern und mit ausreichenden Informationen gemeldet werden, können effektiv gelöst werden. Es gibt viele Drittanbieter-SDKs und Plattformen für die Protokollerfassung und -analyse, deren Einsatz vor dem Release empfohlen wird. Wenn Sie keine Erfahrung mit diesen Plattformen haben oder keine Ressourcen dafür haben, ist das Beibehalten eines Schalters zum Aktivieren von UI (z.B. ein versteckter Schalter) eine einfache Möglichkeit, damit Benutzer die gesehenen Informationen melden können.

EasyAR mega-entwicklungsspezifische ausnahmen

Bei der Mega-Entwicklung gibt es eine weitere Art von nicht steuerbaren Warnmeldungen. Diese Meldungen werden unter bestimmten Konfigurationsbedingungen auf der UI angezeigt und können von Entwicklern nicht direkt deaktiviert werden.

Es wird empfohlen, sich auf die Meldung selbst zu konzentrieren. Der Text gibt den Grund für das Auftreten und die Konfigurationsmethode an. Entwickler müssen die Anforderungen verschiedener Konfigurationen für unterschiedliche Nutzungsweisen verstehen und entsprechend dem Entwicklungsfortschritt angemessen auswählen.

Diese Meldungen werden absichtlich angezeigt, da unter bestimmten Nutzungsbedingungen diese Funktionen zwar die Inhaltsflusentwicklung unterstützen, aber gleichzeitig keine vernünftigen Laufzeitergebnisse liefern können. Achten Sie darauf, die Anwendung nicht mit aktivierten Meldungen zu veröffentlichen.

Verwandte themen