Dokumentation

Interaktivität (Logikknoten)

Die Logik bestimmt, wie dein AR-Erlebnis reagiert. Im Bereich „Knoten“ verbindest du Ereignisse (was passiert) mit Aktionen (was getan werden soll) – ganz ohne Programmieren.

Funktionsweise

Jeder Knoten ist eine Karte. Du verbindest den Ausgang eines Ereignis-Knotens mit dem Eingang eines Aktion-Knotens, indem du eine Verbindung zwischen ihren Punkten ziehst. Wird das Ereignis ausgelöst, laufen die verbundenen Aktionen ab – und du kannst mehrere Aktionen hintereinanderschalten.

Verbinde Ereignisse mit Aktionen: Hier spielt das Antippen eines Objekts eine Animation ab.

Klicke mit der rechten Maustaste auf die Arbeitsfläche (oder nutze die Palette), um einen Knoten hinzuzufügen. Die Knoten sind farbig gekennzeichnet – Ereignisse in Bernsteingelb, Aktionen in Himmelblau.

Um mit mehreren Knoten gleichzeitig zu arbeiten, halte die Umschalttaste gedrückt und ziehe auf der leeren Arbeitsfläche einen Auswahlrahmen auf – oder klicke mit gedrückter Umschalttaste auf Knoten, um sie zur Auswahl hinzuzufügen (Strg- oder Cmd-Klick funktioniert ebenfalls). Eine Auswahl lässt sich gemeinsam verschieben, und die Entf-Taste löscht sie – dieselbe Option findest du im Rechtsklick-Menü.

Ereignisse

EreignisAusgelöst, wenn…
Bei Szenenstartdie Szene zum ersten Mal erscheint (das Zielbild wird erkannt, oder du gelangst über „Szene wechseln“ dorthin).
Beim Antippenjemand das von dir gewählte Objekt antippt (ein 3D-Objekt oder ein Element des UI-Overlays auf dem Bildschirm).
Bei Kollisionzwei gewählte Objekte sich berühren – siehe Kollisionen weiter unten.
Bei Handberührung / Bei Berührungsendeeine Hand oder ein Finger beginnt oder aufhört, das gewählte interaktive Objekt zu berühren – siehe Handinteraktion und Physik.
Beim Greifen / Beim Loslassendas gewählte interaktive Objekt aufgehoben oder losgelassen wird.

Aktionen

AktionWas sie macht
Szene wechselnWechselt zu einer anderen Szene, optional mit Übergang (Überblenden, Aufpoppen, Hochschieben, Drehen) und Dauer.
Ton abspielenSpielt einen importierten Audioclip ab, auf Wunsch in einer Schleife, mit der Lautstärke, die sein Regler einstellt. Der Ausgang Beim Start läuft sofort; Nach dem Ton läuft, sobald der Ton zu Ende gespielt hat (nie in einer Schleife, und gar nicht, wenn vorher Ton stoppen, ein weiteres Ton abspielen desselben Audios oder ein Szenenwechsel kommt).
Ton stoppenStoppt einen laufenden Ton – jede laufende Wiedergabe des gewählten Audioclips wird angehalten und springt zurück an den Anfang.
Video abspielenStartet die Wiedergabe eines gewählten Videoobjekts mit einer Lautstärke (0 spielt es stumm) und Geschwindigkeit, mit oder ohne Schleife. Beim Start läuft sofort; Nach dem Video läuft, sobald das Video zu Ende gespielt hat (nie in einer Schleife, und gar nicht, wenn vorher Video stoppen, ein weiteres Video abspielen auf demselben Objekt oder ein Szenenwechsel kommt). Ein Browser, der Ton erst nach einem Tippen erlaubt, spielt es stumm.
Video stoppenStoppt ein gewähltes Videoobjekt und setzt es an den Anfang zurück.
Animation abspielenSpiele einen Animationsclip auf einem Objekt ab (einen Keyframe-Clip oder die eingebettete Animation eines Modells). Der Ausgang Beim Start läuft sofort. Nach der Animation läuft, sobald der Clip sein Ende erreicht hat: nie bei einem Clip mit Wiederholung, und gar nicht, wenn vorher Animation stoppen, ein weiteres Animation abspielen auf demselben Objekt oder ein Szenenwechsel kommt.
Animation stoppenStoppt eine laufende Animation und friert sie im aktuellen Zustand ein.
Objekt anzeigen / Objekt ausblendenBlendet ein Objekt ein oder aus.
ÜberblendenBlende ein Objekt über die eingestellten Sekunden ein oder aus. Einblenden zeigt es und bringt es auf seine eigene Deckkraft (die Deckkraft im Inspektor). Ausblenden macht es unsichtbar und verbirgt es dann, sodass es nicht mehr angetippt werden kann. Was an seinem Ausgang hängt, läuft, sobald die Überblendung fertig ist. Eine neuere Überblendung auf demselben Objekt macht dort weiter, wo es gerade ist.
WartenWartet eine bestimmte Anzahl von Sekunden, bevor die nächste Aktion in der Kette ausgeführt wird.
Physik setzen / Interaktiv setzenSchaltet für ein Objekt mit Kollisionen die Schwerkraft oder das Berühren und Greifen ein oder aus.
Schiebbar setzenLässt eine offene Hand ein Objekt mit Kollisionen und Physik schieben oder verhindert das.
Objekt anstoßenGibt einem Objekt mit Physik einen Stoß.
Objekt zurücksetzenSetzt ein Objekt zurück an die Stelle, an der die Szene es gestartet hat, in Ruhe.

Hinweis

Töne und Videos überdauern ihre Szene nie: Wechselt das AR-Erlebnis mit Szene wechseln zu einer anderen Szene, wird alles, was noch läuft, automatisch gestoppt – auch Töne in einer Schleife.

Ein Beispiel

So lässt du beim Antippen ein Objekt erscheinen, einen Ton abspielen, kurz warten und dann zur nächsten Szene wechseln:

  1. Füge einen Beim Antippen-Knoten hinzu und wähle das Objekt aus.
  2. Verbinde ihn mit Objekt anzeigen → Ton abspielen → Warten (2 s) → Szene wechseln.

Variablen, Rechnen & Logik

Drei weitere Knotenkategorien ermöglichen cleveres Verhalten – etwa einen Punktestand zu führen, etwas zu berechnen oder eine Entscheidung zu treffen. In der Palette sind sie unter ausklappbaren Überschriften gruppiert, die du einklappen kannst, wenn du sie gerade nicht brauchst.

Eine Variable ist ein benannter Wert, den sich dein AR-Erlebnis merken und während des Ablaufs ändern kann – ein Punktestand, ein Zähler oder ein Ein-/Aus-Zustand. Variablen legst du im Bereich Variablen links an: Gib jeder einen Namen, einen Typ (Zahl, Text oder Wahr / Falsch) und einen Startwert. Eine Variable kann szenenlokal sein (sie wird jedes Mal zurückgesetzt, wenn ihre Szene beginnt) oder global (sie gilt in allen Szenen für die gesamte Sitzung).

Diese Kategorien arbeiten mit zwei Arten von Verbindungen:

  • Ablauf-Verbindungen (wie bisher) bestimmen, was als Nächstes läuft.
  • Wert-Verbindungen übertragen eine Zahl, einen Text oder einen Wahr-/Falsch-Wert vom Ausgang eines Knotens zum Eingang eines anderen – unten blau dargestellt.
Wertverbindungen (blau) liefern Daten an Knoten; hier erhöht jedes Antippen die Punkte um 1.
KategorieKnoten
VariablenVariable setzen (legt einen Wert in einer Variablen ab) und Variable lesen (liest ihren aktuellen Wert).
OperatorenWert (ein fester Wert), Rechnen (addieren / subtrahieren / multiplizieren / dividieren / Rest), Vergleichen (gleich, kleiner als, größer als … → wahr/falsch) und Und / Oder / Nicht.
LogikWenn (führt den Zweig „Wahr“ oder „Falsch“ aus), Solange (wiederholt, solange eine Bedingung erfüllt ist) und Für (zählt von einem Start- bis zu einem Endwert).

Um eine Variable auf dem Bildschirm anzuzeigen, füge im UI-Overlay ein Text-Element hinzu und wähle bei der Option Variable anzeigen (live) die Variable aus. Der Text zeigt dann ihren Wert an und aktualisiert sich sofort, sobald sich dieser ändert – ideal für einen Live-Punktestand.

Hinweis

Variablenänderungen und Entscheidungen mit den Knoten „Wenn“, „Solange“ und „Für“ passieren sofort, während die Logik läuft. Warten hält nur die Aktionen zurück, die danach kommen – nicht das Setzen einer Variablen und nicht die Prüfung einer Bedingung. Schleifen sind außerdem durch eine Obergrenze abgesichert, damit ein AR-Erlebnis nie einfrieren kann.

Kollisionen: wenn sich zwei Objekte berühren

Das Ereignis Bei Kollision wird ausgelöst, wenn zwei Objekte zusammenstoßen.

  1. Wähle jedes Objekt aus und schalte im Inspector Kollisionen ein – das muss bei beiden Objekten aktiviert sein.
  2. Füge einen Knoten Bei Kollision hinzu und wähle Objekt A und Objekt B aus.
  3. Verbinde ihn mit allem, was passieren soll – einem Ton, einer Punkteänderung oder einem Szenenwechsel.
„Bei Kollision“ wird einmal ausgelöst, wenn sich die Begrenzungsboxen zweier Objekte mit aktivierten Kollisionen berühren.

Das Ereignis wird einmal ausgelöst, wenn sich die Begrenzungsboxen der Objekte erstmals überlappen, und erst wieder, nachdem sie mindestens eine Viertelsekunde getrennt waren und sich erneut berühren. Wenn du sie aneinanderhältst oder ein Objekt kurz am anderen abprallt oder wackelt, wird es also nicht erneut ausgelöst. Die Reihenfolge von A und B spielt keine Rolle. Kollisionen gibt es nur für 3D-Objekte der Szene, nicht für UI-Overlay-Elemente auf dem Bildschirm.

Die Box um jedes Objekt folgt seiner Begrenzung, sobald du sie geändert hast (auf jeden Typ außer Mesh), und sonst dem Objekt, wie es gezeichnet ist. Eine Ebene mit eingeschaltetem Boden gilt immer als fest, daher kann ein Knoten Bei Kollision auch sie auswählen.

Hinweis

Wenn du ein Objekt oder eine Szene löschst, auf die ein Knoten verweist, entfernt AR Works diesen Verweis und zeigt am Knoten ein Warnsymbol an. So ist klar zu erkennen, dass der Knoten neu zugewiesen werden muss, statt stillschweigend nichts zu tun.

Tipp

Mit der Vorschau kannst du deine Logik sofort testen – tippe die Objekte direkt im Browser an.