Documentatie

Interactiviteit (logicanodes)

Met logica bepaal je hoe je ervaring reageert. In het paneel Nodes koppel je gebeurtenissen (dingen die gebeuren) aan acties (dingen die moeten gebeuren) – zonder te programmeren.

Hoe het werkt

Elke node is een kaart. Je verbindt de uitgang van een gebeurtenisnode met de ingang van een actienode door een verbinding tussen hun stippen te slepen. Zodra de gebeurtenis plaatsvindt, worden de verbonden acties uitgevoerd – en je kunt meerdere acties achter elkaar zetten.

Koppel gebeurtenissen aan acties: hier speelt een tik op een object een animatie af.

Klik met de rechtermuisknop op het canvas (of gebruik het palet) om een node toe te voegen. Nodes zijn kleurgecodeerd: gebeurtenissen in amber, acties in hemelsblauw.

Wil je met meerdere nodes tegelijk werken? Houd dan Shift ingedrukt en sleep over een leeg stuk canvas om een selectiekader te trekken, of klik met Shift ingedrukt (Ctrl/Cmd-klik werkt ook) om nodes aan de selectie toe te voegen. Een selectie verplaatst in z’n geheel mee als je sleept, en met de toets Delete verwijder je de hele selectie. Dezelfde optie vind je in het rechtsklikmenu.

Gebeurtenissen

GebeurtenisGaat af als…
Bij scènestartde scène voor het eerst verschijnt (de doelafbeelding wordt gevonden, of je komt aan via de actie Naar scène gaan).
Bij tikkende gebruiker tikt op het object dat je kiest (een 3D-object of een element van de UI-overlay op het scherm).
Bij botsingtwee gekozen objecten elkaar raken – zie Botsingen hieronder.
Bij handaanraking / Bij einde aanrakingeen hand of vinger begint of stopt met het aanraken van het interactieve object dat je kiest – zie Interactie met de hand en fysica.
Bij vastpakken / Bij loslatenhet interactieve object dat je kiest wordt opgepakt of losgelaten.

Acties

ActieWat het doet
Naar scène gaanSchakelt over naar een andere scène, met een optionele overgang (vervagen, opschalen, omhoog schuiven, draaien) en duur.
Geluid afspelenSpeelt een geïmporteerd audiobestand af, eventueel herhalend, op het Volume dat de schuifregelaar instelt. De uitgang Bij start wordt meteen uitgevoerd; Na geluid wordt uitgevoerd zodra het geluid tot het eind is afgespeeld (nooit bij herhalen, en helemaal niet als Geluid stoppen, opnieuw afspelen van hetzelfde bestand of een scènewissel eerder komt).
Geluid stoppenStopt een geluid dat wordt afgespeeld – elke spelende kopie van het gekozen audiobestand stopt en spoelt terug naar het begin.
Video afspelenStart het afspelen van een gekozen video-object op een Volume (0 speelt het zonder geluid) en Snelheid, herhalend of niet. Bij start wordt meteen uitgevoerd; Na video wordt uitgevoerd zodra de video tot het eind is afgespeeld (nooit bij herhalen, en helemaal niet als Video stoppen, opnieuw afspelen op hetzelfde object of een scènewissel eerder komt). Een browser die geluid blokkeert tot iemand tikt, speelt het zonder geluid.
Video stoppenStopt een gekozen video-object en spoelt het terug naar het begin.
Animatie afspelenSpeel een animatieclip af op een object (een keyframe-clip of de ingebouwde animatie van een model). De uitgang Bij start wordt meteen uitgevoerd. Na animatie wordt uitgevoerd zodra de clip zijn einde bereikt: nooit bij een clip die herhaalt, en helemaal niet als Animatie stoppen, een andere Animatie afspelen op hetzelfde object of een scènewissel eerder komt.
Animatie stoppenStopt een lopende animatie en bevriest die in de huidige stand.
Object tonen / Object verbergenToont of verbergt een object.
VervagenLaat een object in het aantal seconden dat je instelt in- of uitfaden. Infaden toont het en brengt het naar zijn eigen dekking (de Dekking in de Inspector). Uitfaden maakt het onzichtbaar en verbergt het daarna, zodat je er niet meer op kunt tikken. Wat aan de uitgang hangt, wordt uitgevoerd zodra het vervagen klaar is. Een nieuwer Vervagen op hetzelfde object gaat verder vanaf waar het is.
WachtenWacht een aantal seconden voordat de volgende actie in de keten wordt uitgevoerd.
Fysica instellen / Interactief instellenZet de zwaartekracht, of het aanraken en vastpakken, aan of uit voor een object met Botsingen.
Kan worden geduwd instellenLaat een open hand een object met Botsingen en Fysica duwen, of houdt dat tegen.
Object duwenGeeft een object met Fysica een duw.
Object resettenZet een object terug waar de scène het aan het begin neerzette, in rust.

Info

Geluiden en video’s blijven nooit doorspelen na hun scène: als de ervaring met Naar scène gaan overstapt naar een andere scène, stopt alles wat nog speelt – ook geluiden die herhaald worden – automatisch.

Een uitgewerkt voorbeeld

Zo laat je een object verschijnen, speel je een geluid af, wacht je even en ga je daarna naar de volgende scène – alles zodra erop wordt getikt:

  1. Voeg de node Bij tikken toe en kies het object.
  2. Verbind die met Object tonen → Geluid afspelen → Wachten (2 s) → Naar scène gaan.

Variabelen, rekenen en logica

Met nog drie categorieën nodes bouw je slimmer gedrag – een score bijhouden, een som maken of een beslissing nemen. In het palet staan ze onder inklapbare kopjes, die je kunt dichtklappen als je ze niet gebruikt.

Een variabele is een waarde met een naam die je ervaring kan onthouden en wijzigen terwijl die loopt – een score, een teller of een aan/uit-status. Maak variabelen aan in het paneel Variabelen aan de linkerkant: geef elke variabele een naam, een type (Getal, Tekst of Waar / Onwaar) en een beginwaarde. Een variabele kan scènelokaal zijn (wordt opnieuw ingesteld telkens als de scène begint) of globaal (gedeeld over alle scènes voor de hele sessie).

Deze categorieën werken met twee soorten verbindingen:

  • Flow-verbindingen (zoals eerder) bepalen wat er daarna wordt uitgevoerd.
  • Waarde-verbindingen dragen een getal, een tekst of een waar/onwaar-waarde over van de uitgang van de ene node naar de ingang van een andere – hieronder in blauw weergegeven.
Waardeverbindingen (blauw) voeren gegevens naar nodes; hier komt er bij elke tik 1 punt bij.
CategorieNodes
VariabelenVariabele instellen (een waarde in een variabele zetten) en Variabele ophalen (de huidige waarde lezen).
OperatorenWaarde (een vaste waarde), Rekenen (optellen / aftrekken / vermenigvuldigen / delen / rest), Vergelijken (gelijk aan, kleiner dan, groter dan… → waar/onwaar) en En / Of / Niet.
LogicaAls (de tak Waar of Onwaar uitvoeren), Zolang (herhalen zolang een voorwaarde klopt) en Tellen (tellen van een beginwaarde tot een eindwaarde).

Om een variabele op het scherm te tonen, voeg je een Tekst-element toe in de UI-overlay en stel je de optie Variabele tonen (live) in. De tekst toont dan de waarde en wordt direct bijgewerkt zodra die verandert – ideaal voor een live score.

Info

Wijzigingen van variabelen en beslissingen met Als / Zolang / Tellen gebeuren direct terwijl de logica wordt uitgevoerd. Een node Wachten houdt alleen de acties erna tegen – niet het instellen van een variabele of het controleren van een voorwaarde. Lussen hebben bovendien een veiligheidsgrens, zodat een ervaring nooit kan vastlopen.

Botsingen: wanneer twee objecten elkaar raken

De gebeurtenis Bij botsing treedt op wanneer twee objecten tegen elkaar botsen.

  1. Selecteer elk object en zet Botsingen aan in de Inspector – het moet bij beide objecten aan staan.
  2. Voeg een node Bij botsing toe en kies Object A en Object B.
  3. Verbind die met alles wat er moet gebeuren – een geluid, een scorewijziging, een scènewissel.
De gebeurtenis Bij botsing treedt één keer op wanneer de begrenzingskaders van twee objecten waarvoor botsingen zijn ingeschakeld elkaar raken.

Dit gebeurt één keer zodra de begrenzingskaders van de objecten elkaar voor het eerst overlappen, en pas opnieuw nadat ze minstens een kwart seconde uit elkaar zijn geweest en elkaar weer raken. Houd je ze tegen elkaar aan, of stuitert of wiebelt een object even tegen het andere, dan wordt de gebeurtenis dus niet opnieuw geactiveerd. De volgorde van A en B maakt niet uit. Botsingen werken voor 3D-objecten in de scène, niet voor elementen van de UI-overlay op het scherm.

Het kader rond elk object volgt de Begrenzing zodra je die hebt gewijzigd (naar elk type behalve Mesh), en anders het object zoals het getekend is. Een Vlak met Vloer aan telt altijd als vast, dus een node Bij botsing kan het ook kiezen.

Info

Als je een object of scène verwijdert waarnaar een node verwijst, wist AR Works die verwijzing en toont het een waarschuwingsbadge op de node. Zo is meteen duidelijk dat de node opnieuw moet worden gekoppeld, in plaats van dat hij stilzwijgend niets doet.

Tip

Gebruik Voorbeeld om je logica direct te testen – tik gewoon in de browser op objecten.