Documentación

Interactividad (nodos de lógica)

La lógica es lo que hace que tu experiencia reaccione. En el panel Nodos conectas eventos (lo que sucede) con acciones (lo que se hace), sin escribir código.

Cómo funciona

Cada nodo es una tarjeta. Conectas la salida de un nodo de evento con la entrada de un nodo de acción arrastrando un cable entre sus puntos. Cuando el evento se activa, se ejecutan las acciones conectadas, y puedes encadenar varias acciones seguidas.

Conecta eventos con acciones: aquí, al tocar un objeto se reproduce una animación.

Haz clic derecho en el lienzo (o usa la paleta) para agregar un nodo. Los nodos tienen un color según su tipo: los eventos son ámbar y las acciones, azul cielo.

Para trabajar con varios nodos a la vez, mantén presionada la tecla Mayús y arrastra sobre un espacio vacío del lienzo para seleccionar con un recuadro, o haz clic con Mayús (también funciona Ctrl/Cmd + clic) para agregar nodos a la selección. La selección se mueve en conjunto al arrastrarla, y la tecla Supr la elimina; con clic derecho tienes la misma opción.

Eventos

EventoOcurre cuando…
Al iniciar la escenala escena aparece por primera vez (se encuentra el objetivo o llegas a ella con Ir a escena).
Al tocarse toca el objeto que elijas (un objeto 3D o un elemento de la Capa de interfaz en pantalla).
Al colisionardos objetos elegidos se tocan; consulta Colisiones más abajo.
Al tocar con la mano / Al dejar de tocaruna mano o un dedo empieza o deja de tocar el objeto interactivo que elijas; consulta Interacción con la mano y física.
Al agarrar / Al soltarse agarra o se suelta el objeto interactivo que elijas.

Acciones

AcciónQué hace
Ir a escenaCambia a otra escena, con una transición opcional (fundido, zoom, deslizamiento, giro) y una duración.
Reproducir sonidoReproduce un recurso de audio importado, opcionalmente en bucle, con el Volumen que marca su control deslizante. Su salida Al empezar se ejecuta enseguida; Después del sonido se ejecuta cuando el sonido termina (nunca en bucle, y no se ejecuta si antes llega Detener sonido, otro Reproducir sonido del mismo audio o un cambio de escena).
Detener sonidoDetiene un sonido en reproducción: todas las copias activas del recurso de audio elegido se detienen y vuelven al inicio.
Reproducir videoInicia la reproducción de un objeto de video elegido con un Volumen (0 lo reproduce sin sonido) y una Velocidad, en bucle o no. Al empezar se ejecuta enseguida; Después del video se ejecuta cuando el video termina (nunca en bucle, y no se ejecuta si antes llega Detener video, otro Reproducir video en el mismo objeto o un cambio de escena). Un navegador que bloquea el sonido hasta que se toca la pantalla lo reproduce sin sonido.
Detener videoDetiene un objeto de video elegido y lo devuelve al inicio.
Reproducir animaciónReproduce un clip de animación en un objeto (un clip de fotogramas clave o la animación integrada de un modelo). Su salida Al empezar se ejecuta enseguida. Después de la animación se ejecuta cuando el clip llega a su final: nunca con un clip que se repite, y no se ejecuta si antes llega Detener animación, otro Reproducir animación en el mismo objeto o un cambio de escena.
Detener animaciónDetiene una animación en reproducción y la deja congelada donde está.
Mostrar objeto / Ocultar objetoMuestra u oculta un objeto.
FundidoHaz aparecer o desaparecer un objeto en los segundos que indiques. Aparecer lo muestra y lo lleva a su propia opacidad (la Opacidad del Inspector). Desvanecer lo vuelve invisible y luego lo oculta para que ya no se pueda tocar. Lo que esté conectado a su salida se ejecuta cuando termina el fundido. Un fundido más reciente en el mismo objeto continúa desde donde está.
EsperarEspera unos segundos antes de que se ejecute la siguiente acción de la cadena.
Asignar física / Asignar interactivoActiva o desactiva la gravedad, o el poder tocar y agarrar, en un objeto con Colisiones.
Asignar si se puede empujarPermite que una mano abierta empuje un objeto con Colisiones y Física, o lo impide.
Empujar objetoDa un empujón a un objeto con Física.
Restablecer objetoDevuelve un objeto al lugar donde lo puso la escena al empezar, en reposo.

Nota

Los sonidos y los videos nunca duran más que su escena: cuando la experiencia pasa a otra escena con Ir a escena, todo lo que siga reproduciéndose, incluidos los sonidos en bucle, se detiene automáticamente.

Un ejemplo práctico

Para mostrar un objeto, reproducir un sonido, esperar un momento y saltar a la siguiente escena cuando se toque:

  1. Agrega un nodo Al tocar y elige el objeto.
  2. Conéctalo con Mostrar objeto → Reproducir sonido → Esperar (2 s) → Ir a escena.

Variables, cálculo y lógica

Tres categorías más de nodos te permiten crear comportamientos más elaborados, como llevar una puntuación, hacer una suma o tomar una decisión. La paleta las agrupa bajo encabezados plegables que puedes contraer cuando no los uses.

Una variable es un valor con nombre que tu experiencia puede recordar y cambiar mientras se ejecuta, como una puntuación, un contador o un estado de activado/desactivado. Crea variables en el panel Variables de la izquierda: dale a cada una un nombre, un tipo (Número, Texto o Verdadero / Falso) y un valor inicial. Una variable puede ser local de la escena (se restablece cada vez que empieza su escena) o global (se comparte entre escenas durante toda la sesión).

Estas categorías funcionan con dos tipos de cable:

  • Los cables de flujo (como antes) deciden qué se ejecuta a continuación.
  • Los cables de valor llevan un número, un texto o un valor verdadero/falso de la salida de un nodo a la entrada de otro; se muestran en azul más abajo.
Los cables de valor (azules) llevan datos a los nodos; aquí, cada toque suma 1 a los puntos.
CategoríaNodos
VariablesAsignar variable (guarda un valor en una variable) y Obtener variable (lee su valor actual).
OperadoresValor (un valor fijo), Cálculo (sumar / restar / multiplicar / dividir / resto), Comparar (igual, menor que, mayor que… → verdadero/falso) y Y / O / No.
LógicaSi (ejecuta la rama Verdadero o la rama Falso), Mientras (repite mientras se cumpla una condición) y Para (cuenta desde un valor inicial hasta uno final).

Para mostrar una variable en pantalla, agrega un elemento Texto en la Capa de interfaz y activa su opción Mostrar variable (en vivo): el texto muestra entonces el valor y se actualiza en el instante en que cambia, ideal para una puntuación en vivo.

Nota

Los cambios de variables y las decisiones de Si / Mientras / Para ocurren de inmediato mientras se ejecuta la lógica. Un nodo Esperar solo retrasa las acciones que van después, no la asignación de una variable ni la comprobación de una condición. Además, los bucles tienen un tope de seguridad para que una experiencia nunca se congele.

Colisiones: cuando dos objetos se tocan

El evento Al colisionar se activa cuando dos objetos chocan entre sí.

  1. Selecciona cada objeto y activa Colisiones en el Inspector: ambos objetos deben tenerlo activado.
  2. Agrega un nodo Al colisionar y elige Objeto A y Objeto B.
  3. Conéctalo con lo que deba ocurrir: un sonido, un cambio de puntuación, un cambio de escena.
Al colisionar se activa una sola vez cuando se tocan las cajas de dos objetos con colisiones.

Se activa una sola vez cuando las cajas de los objetos se superponen por primera vez, y de nuevo solo después de que hayan estado separados al menos un cuarto de segundo y vuelvan a tocarse. Así, mantenerlos juntos, o que uno rebote o tiemble un instante contra el otro, no lo vuelve a activar. El orden de A y B no importa. Las colisiones son para los objetos 3D de la escena, no para los elementos de la Capa de interfaz en pantalla.

La caja de cada objeto sigue sus Límites cuando los has cambiado (a cualquier tipo menos Malla), y si no, el objeto tal como se dibuja. Un Plano con Suelo activado siempre cuenta como sólido, así que un nodo Al colisionar también puede elegirlo.

Nota

Si eliminas un objeto o una escena a los que apunta un nodo, AR Works borra esa referencia y muestra una insignia de advertencia en el nodo, para que se note enseguida que hay que volver a elegir su destino en lugar de que no haga nada en silencio.

Consejo

Usa la Vista previa para probar tu lógica al instante: toca los objetos directamente en el navegador.