Información general sobre scripting visual

No todos los artículos enlazados en esta página están traducidos al español. Estamos trabajando en traducir todos los recursos educativos. ¡Gracias por vuestra comprensión!
Las funciones de scripting visual (Visual Scripting) en Effect House te permiten crear efectos interactivos sin tener que preocuparte de escribir código, por lo que podrás añadir fácilmente lógica compleja mediante nodos y variables.
Empezar
Para abrir el panel Visual Scripting, haz clic en el icono de gráfico de la esquina superior izquierda de la interfaz de Effect House. De forma predeterminada, se mostrará un minimapa de navegación en la esquina superior derecha del panel.
Información adicional sobre nodos de Visual Scripting
El Visual Scripting es un sistema de creación basado en nodos, donde cada nodo ejecuta una función distinta dentro de tu flujo de lógica. Al conectar un nodo, este recibirá y pasará información a lo largo de la secuencia. Este sistema de conexiones te permite usar Visual Scripting para añadir desencadenadores, eventos, controladores y más a tus efectos.
Tipos de nodos
1. De forma predeterminada, se añaden dos nodos automáticamente: Start y Update. Start se acciona cuando el efecto se hace más visible, y Update se acciona una vez en cada fotograma.
2. Abre el panel Visual Scripting y pulsa + Add node en la parte inferior de la interfaz. Se mostrará un menú con todos los nodos existentes.

También puedes ejecutar esta acción haciendo clic con el botón derecho en el área en blanco del panel Visual Scripting y seleccionando + Add node.


3. Selecciona un nodo del menú y pulsa el botón azul + Add node o haz doble clic en el nodo para añadirlo al panel.


Ver variables de nodo
Una variable es un símbolo que funciona como marcador de posición para expresiones o cantidades que pueden variar o cambiar. Solo hay que iniciarla una vez, y puedes reutilizarla varias veces durante el proceso de creación de efectos.
Añadir una variable
1. Abre el panel Visual Scripting y pulsa Variables en la parte inferior de la interfaz para ver la lista de variables disponibles.


2. Haz clic en + Add variables en la parte inferior del menú para añadir una variable. Puedes hacer doble clic en el área de texto para cambiar el nombre de cada variable. También puedes abrir la lista desplegable para cambiar el tipo de datos variables y asignar un valor inicial. Si es necesario, haz clic en el icono pequeño de papelera para eliminar una variable.

3. Para recuperar o establecer un conjunto de variables, haz clic en + > Get/Set variable. Se creará automáticamente un nodo de variable y se añadirá al panel Visual Scripting.

Crear tu primer efecto con Visual Scripting
Prueba a crear un efecto sencillo. Usa las acciones Mouth open y Mouth close para cambiar la visibilidad de un cubo. También puedes seguir las instrucciones de las secciones siguientes. Aquí tienes una demostración del resultado final y el paquete del proyecto:

Añadir un objeto y nodos
1. Para empezar, añade un objeto de cubo 3D a la escena pulsando + Add Object > 3D > Cube. Ajusta los parámetros de posición del cubo para colocarlo en la posición deseada en la pantalla.
2. Como vas a usar las acciones de abrir/cerrar boca como desencadenadores, selecciona un video de demostración de boca abierta en la lista desplegable del panel Preview para probar el efecto.


3. Añade los nodos Mouth open y Set visibility al panel Visual Scripting.

4. Comprueba las entradas necesarias. Como Set visibility necesita un objeto, haz clic y mantén pulsado para arrastrar el objeto de cubo desde el panel Hierarchy hasta el panel Visual Scripting.

5. Establece el valor de visibilidad. Activa o desactiva la casilla junto a la entrada Value para establecer el valor en verdadero (visible) o falso (invisible).

Vincular los nodos
1. Vincula la salida de Start de Mouth open a la entrada de Trigger de Set visibility; vincula la salida de Entity de Cube a la entrada de Object de Set visibility; por último, desactiva la casilla junto a la entrada Value de Set visibility.
Ahora podrás comprobar que el cubo se hace invisible cuando se detecte que la boca está abierta.

2. Añada otro nodo Set visibility para que el cubo se haga visible cuando la boca esté cerrada. Vincula los nuevos nodos en consecuencia, y esta vez activa la casilla Visible. Puedes cambiar la posición de los nodos para organizar la interfaz.

3. ¡Enhorabuena! Ahora que ya conoces los conceptos básicos del Visual Scripting, puedes incorporar estas funciones en tus propios efectos.
Tipos de nodo
Hay ocho tipos de nodos en Effect House que te ayudarán a trabajar con interacciones, lógicas y más.
Node types | Icon | Description | Example(s) |
Event | ![]() | La raíz de las acciones que desencadenarán la ejecución del flujo de lógica | Screen tap, que captura un evento táctil. |
Logic | ![]() | Comprueba uno o dos valores y genera resultados de la comparación | Greater than, que comprueba si un valor de entrada es mayor que otro. |
Control | ![]() | Admite varias declaraciones | For loop, If, y Sequence. |
Math | ![]() | Funciones matemáticas | Random,Floor, y Multiply. |
Time | ![]() | Control del tiempo | Get time, que cuenta el tiempo en segundos desde que se inició el efecto. |
Utility | ![]() | El nivel raíz de la entidad y el estado del componente | Set visibility, que establece la visibilidad de una entidad de objet |
Head & Face | ![]() | El nivel raíz de los desencadenadores de rostro y cabeza | Eye blink, que desencadenará el siguiente nodo cuando se detecte la acción de parpadeo. |
Hand | ![]() | El nivel raíz de los desencadenadores de mano | Hand open, que desencadenará el siguiente nodo cuando se detecte la acción de mano abierta. |
Transform | ![]() | El nivel raíz de los desencadenadores relacionados con transformaciones | Local Pose, que obtiene los datos de transformación locales como un objeto de la escena. |
Body | ![]() | El nivel raíz de los desencadenadores de cuerpo | Body detection, que desencadenará el siguiente nodo cuando se detecte un cuerpo en la vista de cámara. |
Información del nodo
Para ver información básica de un nodo, sigue el menú. Usaremos un nodo Mouth open como ejemplo:

- Name: el nombre está en la parte superior de la información del nodo.
- Description: una descripción de la función principal del nodo. El nodo «Mouth open» desencadenará el próximo nodo si detecta que está abierta la acción de boca abierta.
- Inputs y Outputs: los puertos en la parte izquierda de un nodo se denominan «entradas de nodo». Los puertos en la parte derecha de un nodo se denominan «salidas de nodo». Para vincular un nodo con otro, crea una conexión desde un puerto de salida a un puerto de entrada.

También puedes mostrar la información del nodo haciendo clic con el botón derecho en un nodo añadido y seleccionando Node info, o bien haciendo clic directamente en el icono ⓘ.


Administrar el panel Visual Scripting
Subgráficos (Subgraphs)
Los subgráficos son grupos de nodos que te ayudarán a organizar tu Visual Scripting.
Crear un subgráfico
1. Selecciona los nodos que quieras agrupar.
2. Haz clic con el botón derecho en los nodos y selecciona Create subgraph. Para cambiar el nombre del subgráfico, haz doble clic en su nombre en la parte superior del nodo.

Editar un subgráfico
1. Haz doble clic en el nodo del subgráfico para explorar en profundidad y editar los nodos agrupados.
2. Haz clic en el botón Main Graph de la esquina superior izquierda del panel «Visual Scripting» para volver al gráfico de nivel superior. Para desagruparlo, haz clic con el botón derecho en un nodo del subgráfico.

Usar el minimapa para navegar
Name | Icon | Description |
Mini-map | ![]() | El icono de minimapa en la esquina superior derecha del panel Visual Scripting te permite mostrar u ocultar el minimapa. Cuando el minimapa está abierto, puedes arrastrar el rectángulo sobre este para navegar. |
Zoom | ![]() | El icono de casa junto al icono de mapa te permite volver a mostrar el área de visualización de Visual Scripting en la posición original. |