Dokumentation

Interaktivitet (logiknoder)

Logiken styr hur din upplevelse reagerar. I panelen Noder kopplar du ihop händelser (saker som inträffar) med åtgärder (saker som ska göras) – du behöver inte kunna koda.

Så fungerar det

Varje nod är ett kort. Du kopplar utgången på en händelse till ingången på en åtgärd genom att dra en koppling mellan deras punkter. När händelsen utlöses körs de anslutna åtgärderna – och du kan kedja flera åtgärder efter varandra.

Koppla händelser till åtgärder: här spelas en animation upp när man trycker på ett objekt.

Högerklicka på arbetsytan (eller använd paletten) för att lägga till en nod. Noderna är färgkodade – händelser i bärnstensgult, åtgärder i himmelsblått.

Om du vill arbeta med flera noder samtidigt håller du ned Skift och drar över tom arbetsyta för att markera med ruta, eller Skift-klickar (Ctrl- eller Cmd-klick fungerar också) för att lägga till noder i markeringen. En markering flyttas som en enhet när du drar i den, och Delete tar bort den – högerklicka för samma alternativ.

Händelser

HändelseUtlöses när…
Vid scenstartscenen visas för första gången (målbilden hittas, eller du kommer dit via Gå till scen).
Vid tryckanvändaren trycker på det objekt du har valt (ett 3D-objekt eller ett element i UI-överlägget på skärmen).
Vid kollisiontvå valda objekt nuddar varandra – se Kollisioner nedan.
Vid handberöring / Vid avslutad beröringen hand eller ett finger börjar eller slutar röra vid det interaktiva objekt du har valt – se Handinteraktion och fysik.
Vid grepp / Vid släppdet interaktiva objekt du har valt plockas upp eller släpps.

Åtgärder

ÅtgärdVad den gör
Gå till scenByt till en annan scen, med valfri övergång (tona, poppa upp, glid upp, snurra) och varaktighet.
Spela ljudSpela upp ett importerat ljudklipp, med eller utan loop, på den Volym som reglaget anger. Utgången Vid start körs direkt; Efter ljud körs när ljudet har spelats till slutet (aldrig i loop, och inte alls om Stoppa ljud, en ny uppspelning av samma ljudfil eller ett scenbyte kommer först).
Stoppa ljudStoppa ett ljud som spelas – alla uppspelningar av det valda ljudklippet stoppas och spolas tillbaka.
Spela videoStarta uppspelningen av ett valt videoobjekt på en Volym (0 spelar det utan ljud) och Hastighet, med eller utan loop. Vid start körs direkt; Efter video körs när videon har spelats till slutet (aldrig i loop, och inte alls om Stoppa video, en ny uppspelning på samma objekt eller ett scenbyte kommer först). En webbläsare som blockerar ljud tills någon trycker spelar den utan ljud.
Stoppa videoStoppa ett valt videoobjekt och spola tillbaka det till början.
Spela animationSpela upp ett animationsklipp på ett objekt (ett nyckelbildsklipp eller en modells inbyggda animation). Utgången Vid start körs direkt. Efter animation körs när klippet har nått sitt slut: aldrig för ett klipp som upprepas, och inte alls om Stoppa animation, en annan Spela animation på samma objekt eller ett scenbyte kommer först.
Stoppa animationStoppa en pågående animation så att den fryser där den är.
Visa objekt / Dölj objektVisa eller dölj ett objekt.
TonaTona in eller ut ett objekt under det antal sekunder du anger. Tona in visar det och tar det till dess egen opacitet (Opacitet i Inspektören). Tona ut gör det osynligt och döljer det sedan, så att det inte längre går att trycka på. Det som är kopplat till utgången körs när toningen är klar. En nyare Tona på samma objekt fortsätter där det är.
VäntaVänta ett antal sekunder innan nästa åtgärd i kedjan körs.
Sätt fysik / Sätt interaktivSlå på eller av tyngdkraften, eller möjligheten att röra vid och greppa, för ett objekt med Kollisioner.
Sätt Kan puttasLåt en öppen hand putta ett objekt med Kollisioner och Fysik, eller hindra det.
Knuffa objektGe ett objekt med Fysik en knuff.
Återställ objektSätt tillbaka ett objekt där scenen startade det, i vila.

Obs

Ljud och videor fortsätter aldrig efter sin scen: när upplevelsen går över till en annan scen med Gå till scen stoppas allt som fortfarande spelas – även ljud i loop – automatiskt.

Ett exempel

Så här får du ett objekt att dyka upp, spela ett ljud, vänta och sedan gå vidare till nästa scen när någon trycker på det:

  1. Lägg till en Vid tryck-nod och välj objektet.
  2. Koppla den till Visa objekt → Spela ljud → Vänta (2 s) → Gå till scen.

Variabler, matematik och logik

Ytterligare tre nodkategorier gör att du kan bygga smartare beteenden – hålla koll på poäng, räkna ut något eller fatta ett beslut. Paletten grupperar dem under rubriker som du kan fälla ihop när du inte använder dem.

En variabel är ett namngivet värde som din upplevelse kan komma ihåg och ändra medan den körs – poäng, en räknare eller ett på/av-läge. Skapa variabler i panelen Variabler till vänster: ge varje variabel ett namn, en typ (Tal, Text eller Sant / falskt) och ett startvärde. En variabel kan vara scenspecifik (återställs varje gång dess scen börjar) eller global (delas mellan scener under hela sessionen).

De här kategorierna använder två sorters kopplingar:

  • Kopplingar av typen Flöde (som tidigare) avgör vad som körs härnäst.
  • Kopplingar av typen Värde för över ett tal, en text eller ett sant/falskt-värde från en nods utgång till en annans ingång – de visas i blått nedan.
Värdekopplingar (blå) matar in data i noderna; här ökar varje tryck poängen med 1.
KategoriNoder
VariablerSätt variabel (lägg in ett värde i en variabel) och Hämta variabel (läs av dess aktuella värde).
OperatorerVärde (ett fast värde), Matematik (addera / subtrahera / multiplicera / dividera / rest), Jämför (lika med, mindre än, större än… → sant/falskt) och Och / eller / inte.
LogikOm (kör grenen Sant eller Falskt), Medan (upprepa så länge ett villkor gäller) och För (räkna från ett startvärde till ett slutvärde).

Om du vill visa en variabel på skärmen lägger du till ett Text-element i UI-överlägget och aktiverar alternativet Visa variabel (live) – texten visar då värdet och uppdateras i samma ögonblick som det ändras, perfekt för en poängställning som följer med i realtid.

Obs

Variabeländringar och beslut med Om / Medan / För sker omedelbart när logiken körs. Vänta håller bara tillbaka åtgärderna efter sig – inte att en variabel sätts eller att ett villkor kontrolleras. Loopar har dessutom en säkerhetsgräns, så att en upplevelse aldrig kan hänga sig.

Kollisioner: när två objekt nuddar varandra

Händelsen Vid kollision utlöses när två objekt stöter ihop.

  1. Markera varje objekt och slå på Kollisioner i Inspektören – båda objekten måste ha det påslaget.
  2. Lägg till en Vid kollision-nod och välj Objekt A och Objekt B.
  3. Koppla den till det som ska hända – ett ljud, en poängändring, ett scenbyte.
Noden Vid kollision utlöses en gång när begränsningsrutorna runt två objekt med påslagna kollisioner rör vid varandra.

Den utlöses en gång när objektens begränsningsrutor först överlappar varandra, och sedan igen först efter att de har varit isär i minst en kvarts sekund och nuddar varandra på nytt. Så om du håller ihop dem, eller om ett objekt studsar eller vickar mot det andra en kort stund, utlöses den inte igen. Ordningen på A och B spelar ingen roll. Kollisioner gäller 3D-objekt i scenen, inte element i UI-överlägget på skärmen.

Rutan runt varje objekt följer dess Begränsning när du har ändrat den (till valfri typ utom Mesh), och annars objektet som det ritas. Ett Plan med Golv påslaget räknas alltid som fast, så en Vid kollision-nod kan också välja det.

Obs

Om du tar bort ett objekt eller en scen som en nod pekar på rensar AR Works den referensen och visar ett varningsmärke på noden, så att det syns tydligt att noden behöver ställas in på nytt, i stället för att den bara slutar fungera utan förvarning.

Tips

Använd Förhandsvisa för att testa din logik direkt – tryck på objekt rakt i webbläsaren.