Documentazione

Interattività (nodi logici)

La logica è ciò che permette alla tua esperienza di reagire. Nel pannello Nodi colleghi gli eventi (ciò che accade) alle azioni (ciò che deve succedere), senza bisogno di programmare.

Come funziona

Ogni nodo è un blocco. Colleghi l’uscita di un nodo evento all’ingresso di un nodo azione trascinando un collegamento tra i loro punti. Quando l’evento si attiva, vengono eseguite le azioni collegate, e puoi concatenarne diverse una dopo l’altra.

Collega gli eventi alle azioni: qui, toccando un oggetto si avvia un’animazione.

Fai clic con il tasto destro sull’area di lavoro (oppure usa la palette) per aggiungere un nodo. I nodi sono colorati per tipo: ambra per gli eventi, azzurro per le azioni.

Per lavorare su più nodi insieme, tieni premuto Maiusc e trascina su un punto vuoto dell’area di lavoro per selezionarli con un riquadro, oppure fai clic tenendo premuto Maiusc (funziona anche Ctrl/Cmd+clic) per aggiungere nodi alla selezione. La selezione si sposta tutta insieme quando la trascini e il tasto Canc la elimina; lo stesso comando si trova nel menu del clic destro.

Eventi

EventoSi attiva quando…
All’avvio della scenala scena compare per la prima volta (il target viene trovato oppure ci arrivi con Vai alla scena).
Al toccol’utente tocca l’oggetto che hai scelto (un oggetto 3D oppure un elemento dell’Overlay UI sullo schermo).
Alla collisionedue oggetti scelti si toccano. Vedi Collisioni più sotto.
Al tocco della mano / Alla fine del toccouna mano o un dito inizia o smette di toccare l’oggetto interattivo che hai scelto. Vedi Interazione con la mano e fisica.
Alla presa / Al rilasciol’oggetto interattivo che hai scelto viene preso o lasciato.

Azioni

AzioneCosa fa
Vai alla scenaPassa a un’altra scena, con una transizione facoltativa (dissolvenza, zoom, dal basso, rotazione) e la durata che preferisci.
Riproduci suonoRiproduce un audio importato, con ripetizione facoltativa, al Volume impostato dal suo cursore. L’uscita All’avvio si attiva subito; Dopo il suono si attiva quando il suono è arrivato alla fine (mai in ripetizione, e per niente se prima arriva Ferma suono, un’altra riproduzione dello stesso audio o un cambio di scena).
Ferma suonoFerma un suono in riproduzione: ogni copia in riproduzione dell’audio scelto si ferma e torna all’inizio.
Riproduci videoAvvia la riproduzione di un oggetto video a tua scelta con un Volume (0 lo riproduce senza audio) e una Velocità, in ripetizione o no. All’avvio si attiva subito; Dopo il video si attiva quando il video è arrivato alla fine (mai in ripetizione, e per niente se prima arriva Ferma video, un’altra riproduzione sullo stesso oggetto o un cambio di scena). Un browser che blocca l’audio fino a un tocco lo riproduce senza audio.
Ferma videoFerma un oggetto video scelto e lo riporta all’inizio.
Riproduci animazioneRiproduci una clip di animazione su un oggetto (una clip a fotogrammi chiave o l’animazione incorporata di un modello). L’uscita All’avvio si attiva subito. Dopo l’animazione si attiva quando la clip arriva alla fine: mai per una clip che si ripete, e per niente se prima arriva Ferma animazione, un altro Riproduci animazione sullo stesso oggetto o un cambio di scena.
Ferma animazioneFerma un’animazione in riproduzione, bloccandola nella posizione raggiunta.
Mostra oggetto / Nascondi oggettoFa comparire o nasconde un oggetto.
DissolvenzaFai comparire o svanire un oggetto nei secondi che imposti. Dissolvenza in entrata lo mostra e lo porta alla sua opacità (l’Opacità nell’Ispettore). Dissolvenza in uscita lo rende invisibile e poi lo nasconde, così non si può più toccare. Ciò che è collegato alla sua uscita parte quando la dissolvenza è finita. Una dissolvenza più recente sullo stesso oggetto riprende da dove si trova.
AttesaAspetta il numero di secondi indicato prima di eseguire la prossima azione della catena.
Imposta fisica / Imposta interattivoAttiva o disattiva la gravità, oppure la possibilità di toccare e prendere, per un oggetto con Collisioni.
Imposta se si può spingerePermette a una mano aperta di spingere un oggetto con Collisioni e Fisica, oppure lo impedisce.
Spingi oggettoDà una spinta a un oggetto con Fisica.
Reimposta oggettoRiporta un oggetto dove la scena lo aveva messo all’inizio, fermo.

Nota

Suoni e video non sopravvivono mai alla propria scena: quando l’esperienza passa a un’altra scena con Vai alla scena, tutto ciò che è ancora in riproduzione, compresi i suoni in ripetizione, si ferma in automatico.

Un esempio pratico

Per far comparire un oggetto, riprodurre un suono, attendere e poi passare alla scena successiva quando l’oggetto viene toccato:

  1. Aggiungi un nodo Al tocco e scegli l’oggetto.
  2. Collegalo a Mostra oggetto → Riproduci suono → Attesa (2 s) → Vai alla scena.

Variabili, calcoli e logica

Altre tre categorie di nodi ti permettono di creare comportamenti più evoluti: tenere un punteggio, fare un calcolo o prendere una decisione. La palette le raggruppa sotto titoli comprimibili che puoi chiudere quando non ti servono.

Una variabile è un valore con un nome che la tua esperienza può ricordare e modificare mentre è in esecuzione: un punteggio, un contatore o uno stato acceso/spento. Crea le variabili nel pannello Variabili a sinistra: dai a ciascuna un nome, un tipo (Numero, Testo oppure Vero / Falso) e un valore iniziale. Una variabile può essere locale alla scena (si reimposta ogni volta che la scena inizia) oppure globale (condivisa tra le scene per tutta la sessione).

Queste categorie usano due tipi di collegamento:

  • I collegamenti Flusso (come sopra) decidono che cosa viene eseguito dopo.
  • I collegamenti Valore portano un numero, un testo o un valore vero/falso dall’uscita di un nodo all’ingresso di un altro, e qui sotto sono mostrati in blu.
I collegamenti dei valori (in blu) portano i dati ai nodi; qui ogni tocco aggiunge 1 al punteggio.
CategoriaNodi
VariabiliImposta variabile (inserisce un valore in una variabile) e Leggi variabile (legge il suo valore attuale).
OperatoriValore (un valore fisso), Calcolo (somma / sottrazione / moltiplicazione / divisione / resto), Confronta (uguale, minore di, maggiore di… → vero/falso) ed E / O / Non.
LogicaSe (esegue il ramo Vero o quello Falso), Mentre (ripete finché una condizione resta vera) e Per (conta da un valore iniziale a uno finale).

Per mostrare una variabile sullo schermo, aggiungi un elemento Testo nell’Overlay UI e attiva l’opzione Mostra variabile (in tempo reale): il testo visualizza il valore e si aggiorna nell’istante in cui cambia, ideale per un punteggio sempre aggiornato.

Nota

Le modifiche alle variabili e le decisioni Se / Mentre / Per avvengono immediatamente mentre la logica viene eseguita. Un nodo Attesa trattiene solo le azioni che lo seguono, non l’impostazione di una variabile né il controllo di una condizione. I cicli hanno inoltre un limite di sicurezza, così un’esperienza non può mai bloccarsi.

Collisioni: quando due oggetti si toccano

L’evento Alla collisione si attiva quando due oggetti si urtano.

  1. Seleziona ogni oggetto e attiva Collisioni nell’Inspector: l’opzione deve essere attiva su entrambi gli oggetti.
  2. Aggiungi un nodo Alla collisione e scegli Oggetto A e Oggetto B.
  3. Collegalo a ciò che deve succedere: un suono, una variazione del punteggio, un cambio di scena.
L’evento Alla collisione si attiva una sola volta, quando i riquadri di delimitazione di due oggetti con le collisioni attive si toccano.

Si attiva una sola volta quando i riquadri di delimitazione dei due oggetti iniziano a sovrapporsi, e di nuovo solo dopo che sono rimasti separati per almeno un quarto di secondo e si toccano ancora: tenerli a contatto, o un oggetto che rimbalza o vibra per un attimo contro l’altro, non lo riattiva. L’ordine di A e B non conta. Le collisioni valgono per gli oggetti 3D della scena, non per gli elementi dell’Overlay UI sullo schermo.

Il riquadro di ogni oggetto segue i suoi Limiti se li hai modificati (con qualsiasi tipo tranne Mesh), altrimenti l’oggetto così come è disegnato. Un Piano con Pavimento attivo conta sempre come solido, quindi anche un nodo Alla collisione può indicarlo.

Nota

Se elimini un oggetto o una scena a cui punta un nodo, AR Works cancella quel riferimento e mostra un badge di avviso sul nodo, così è evidente che il nodo va riassegnato, invece di restare inattivo senza alcun segnale.

Consiglio

Usa Anteprima per provare subito la logica: tocca gli oggetti direttamente nel browser.