Table of Contents

Verwenden des session-validierungstools

Dieser Artikel beschreibt, wie Sie das session-validierungstool verwenden, um session-workflows im Editor schnell zu validieren und simulierte läufe mit EIF-dateien durchzuführen.

Bevor Sie beginnen

Simulierte läufe verwenden EIF-dateien als eingabe, daher müssen Sie vor dem start zunächst eine EIF-datei aufnehmen:

Außerdem sollten Sie folgendes wissen:

session-validierungstool

Das session-validierungstool hilft entwicklern, session-workflows schnell im Unity-editor zu validieren und simulierte läufe mit EIF-dateien durchzuführen.

Standardmäßig ist das session-validierungstool im Inspector-fenster des AR Session (EasyAR)-objekts sichtbar und ist teil des DiagnosticsController-editors:

alt text

Klicken Sie auf die ↗-schaltfläche oben rechts, um das tool in einem separaten fenster zu öffnen. Wenn das fenster geschlossen oder die ↘-schaltfläche gedrückt wird, wird das tool wieder im Inspector-fenster angezeigt.

alt text

Die wirkung des tools während des laufs wird in folgendem video gezeigt:

Dieses video zeigt die verwendung des session-validierungstools, aufgenommen im Unity-play-modus. Die obere hälfte zeigt links die Hierarchy-ansicht, in der mitte die Scene-ansicht und rechts die Game-ansicht. Die untere hälfte zeigt das session-validierungstool. Der inhalt der Game-ansicht entspricht dem, was benutzer in der realen welt auf ihrem smartphone sehen.

Links oben im tool wird der wiedergabefortschritt der EIF-datei angezeigt, der sich mit dem fortschritt ändert. Links unten wird der aktuelle status der session angezeigt. Rechts werden die komponenten der session und verfügbare center-modi gezeigt.

In der szene sind drei gleichzeitig aktive AR-funktionen sichtbar:

  • Motion Tracking: Wird vom frame-player bereitgestellt. Die blaue kugel ist der XR Origin, der blaue kegel repräsentiert die benutzerposition.
  • Dense Spatial Mapping: Man sieht, wie sich halbtransparente netzmodelle mit der bewegung der perspektive kontinuierlich generieren.
  • Sparse Spatial Tracking: Im video wird ein weihnachtsbaum verfolgt, das überlagerte virtuelle objekt ist eine hellblaue point-cloud.

Tool starten

Klicken Sie auf die ▶-schaltfläche oben im tool, um es zu starten. Diese schaltfläche hat den gleichen effekt wie das drücken der ▶-schaltfläche in der Unity-toolbar.

alt text

Wenn das tool läuft, wird die schaltfläche zu ■. Ein klick stoppt das tool.

Wenn das tool in einem separaten fenster angezeigt wird, können Sie im auswahlfeld rechts neben der ▶-schaltfläche das session-objekt auswählen. Falls das fenster zurückgesetzt wurde und die session verloren ging, können Sie sie hier erneut auswählen.

EIF-wiedergabe steuern

Um die EIF-wiedergabefunktion des tools zu verwenden, müssen Sie vor dem start die option Frame Player aktivieren. Das tool übernimmt dann die auswahl der frame-source während des session-assembly-prozesses, unabhängig von der einstellung von AssembleOptions.FrameSource, und aktiviert die frame-player-komponente.

alt text

Daher wird während des laufs ein hinweis angezeigt, dass die verwendete frame-source vom tool verwaltet wird:

alt text

Anmerkung

Das tool verwaltet die auswahl der frame-source nur im Unity-editor. Diese option hat keinen einfluss auf gepackte anwendungen.

Während des normalen laufs wird die EIF-wiedergabesteuerung im oberen teil des tools angezeigt (markierter bereich):

alt text

Mit diesen schaltflächen können Sie die wiedergabe der EIF-datei steuern:

  • ▶: Wiedergabe (fortsetzen von pause oder stop)
  • ▮▮: Pause
  • ■: Stop
  • ▮◀: 5 sekunden zurück springen (wenn von der datei unterstützt)
  • ◀◀: Wiedergabegeschwindigkeit verringern (wenn von der datei unterstützt)
  • ▶▶: Wiedergabegeschwindigkeit erhöhen (wenn von der datei unterstützt)
  • ▶▮: 5 sekunden vorwärts springen (wenn von der datei unterstützt)
  • ▲: Datei öffnen
  • Fortschrittsbalken: Klicken, um zur position zu springen (wenn von der datei unterstützt)

Sie können inhalte und interaktionslogik in der szene anpassen, während die wiedergabe läuft. So können sie einen großen teil der entwicklungsarbeit am computer erledigen und die effekte direkt sehen.

Anmerkung

Wenn neue daten wiedergegeben werden oder die position springt, werden vorhandene daten in der szene nicht gelöscht. Der status der AR-komponenten wird nicht zurückgesetzt. Sie verhalten sich, als ob die kameradaten plötzlich von einem frame zum nächsten springen würden.

Während dies für einige funktionen keine große rolle spielt, kann es bei funktionen, die von motion tracking abhängen (z.B. dense spatial mapping, Mega), zu anormalen zuständen führen, die die laufleistung beeinträchtigen.

Session-workflow steuern

Um die session-workflow-steuerung des tools zu verwenden, müssen Sie vor dem start die option Session Workflow aktivieren. Diese option ist standardmäßig aktiviert.

alt text

Während des normalen laufs wird die session-workflow-steuerung unterhalb der wiedergabesteuerung angezeigt (markierter bereich):

alt text

Oberhalb dieses bereichs werden die statusinformationen EasyARController.IsReady und ARSession.State angezeigt.

Unterhalb dieses bereichs befinden sich schaltflächen zur steuerung des session-workflows:

  • Initialize: Session initialisieren (kann mit dem im Project Settings konfigurierten oder manuell eingegebenen license key erfolgen)
  • Assemble: Session zusammenbauen ohne zu starten
  • StartSession (Assembled): Zusammen gebaute session starten
  • StartSession: Session zusammenbauen und starten
  • StopSession: Session stoppen
  • StopSession (keep image): Session stoppen, aber bildhintergrund behalten
  • Deinitialize: Session deinitialisieren
Anmerkung

Da diese steuerungen direkt methoden von ARSession und EasyARController aufrufen, können sie damit die auswirkungen von session-statusänderungen auf inhalte validieren. Beachten sie jedoch, dass wenn ihre anwendungsskripte ähnliche methoden aufrufen, der ablauf der anwendung möglicherweise nicht den erwartungen entspricht.

Session-komponenten steuern

Um die session-komponentensteuerung des tools zu verwenden, müssen Sie vor dem start die option Session Workflow aktivieren. Diese option ist standardmäßig aktiviert.

alt text

Während des normalen laufs wird die session-komponentensteuerung unten oder rechts im tool angezeigt (markierter bereich), je nach fensterbreite:

alt text

Der inhalt dieses bereichs hängt von der spezifischen session ab. Im beispiel werden image tracking, dense spatial mapping und sparse spatial tracking verwendet, daher zeigt das tool steuerelemente für diese drei funktionen.

Im allgemeinen zeigt dieser bereich alle verfügbaren AR-funktionskomponenten in der session an und bietet aktivierungs-/deaktivierungssteuerung (enabled), einschließlich:

  • AR Session: Aktivierung/Deaktivierung der session selbst
  • Image Renderer: Aktivierung/Deaktivierung des renderings des physikalischen kamerabilds
  • Camera: Aktivierung/Deaktivierung der virtuellen kamera
  • Frame Source: Aktivierung/Deaktivierung der frame-source (nur steuerbar, wenn frame-player nicht aktiviert ist; bei aktiviertem frame-player wird die steuerung durch den EIF-wiedergabesteuerungsbereich ersetzt)
  • Frame Filter: Aktivierung/Deaktivierung spezifischer AR-funktionen
  • Frame Recorder: Aktivierung/Deaktivierung der EIF-aufnahmekomponente (nur sichtbar, wenn frame-player nicht aktiviert ist; bei aktiviertem frame-player wird diese komponente nicht in die session eingebaut)

Außerdem werden verfügbare center-modi und der session-report angezeigt.

Anmerkung

Die im tool angezeigten verfügbaren center-modi und session-reports sind ergebnisse des editor-laufs und können auf echten geräten abweichen.

Verwandte themen