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.
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
| Evento | Ocurre cuando… |
|---|---|
| Al iniciar la escena | la escena aparece por primera vez (se encuentra el objetivo o llegas a ella con Ir a escena). |
| Al tocar | se toca el objeto que elijas (un objeto 3D o un elemento de la Capa de interfaz en pantalla). |
| Al colisionar | dos objetos elegidos se tocan; consulta Colisiones más abajo. |
| Al tocar con la mano / Al dejar de tocar | una 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 soltar | se agarra o se suelta el objeto interactivo que elijas. |
Acciones
| Acción | Qué hace |
|---|---|
| Ir a escena | Cambia a otra escena, con una transición opcional (fundido, zoom, deslizamiento, giro) y una duración. |
| Reproducir sonido | Reproduce 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 sonido | Detiene un sonido en reproducción: todas las copias activas del recurso de audio elegido se detienen y vuelven al inicio. |
| Reproducir video | Inicia 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 video | Detiene un objeto de video elegido y lo devuelve al inicio. |
| Reproducir animación | Reproduce 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ón | Detiene una animación en reproducción y la deja congelada donde está. |
| Mostrar objeto / Ocultar objeto | Muestra u oculta un objeto. |
| Fundido | Haz 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á. |
| Esperar | Espera unos segundos antes de que se ejecute la siguiente acción de la cadena. |
| Asignar física / Asignar interactivo | Activa o desactiva la gravedad, o el poder tocar y agarrar, en un objeto con Colisiones. |
| Asignar si se puede empujar | Permite que una mano abierta empuje un objeto con Colisiones y Física, o lo impide. |
| Empujar objeto | Da un empujón a un objeto con Física. |
| Restablecer objeto | Devuelve un objeto al lugar donde lo puso la escena al empezar, en reposo. |
Nota
Un ejemplo práctico
Para mostrar un objeto, reproducir un sonido, esperar un momento y saltar a la siguiente escena cuando se toque:
- Agrega un nodo Al tocar y elige el objeto.
- 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.
| Categoría | Nodos |
|---|---|
| Variables | Asignar variable (guarda un valor en una variable) y Obtener variable (lee su valor actual). |
| Operadores | Valor (un valor fijo), Cálculo (sumar / restar / multiplicar / dividir / resto), Comparar (igual, menor que, mayor que… → verdadero/falso) y Y / O / No. |
| Lógica | Si (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
Colisiones: cuando dos objetos se tocan
El evento Al colisionar se activa cuando dos objetos chocan entre sí.
- Selecciona cada objeto y activa Colisiones en el Inspector: ambos objetos deben tenerlo activado.
- Agrega un nodo Al colisionar y elige Objeto A y Objeto B.
- Conéctalo con lo que deba ocurrir: un sonido, un cambio de puntuación, un cambio de escena.
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
Consejo