Eventos

Descripción general

En términos simples, los Eventos son el "cerebro" o la "lógica" de tu experimento. Son las reglas que configuras que le dicen a tu estudio qué hacer y cuándo hacerlo.

Piénsalos como simples declaraciones "Si-Entonces" o reglas de causa y efecto que dan vida a tu experimento.

  • SI esto sucede... (Este es el Trigger)
  • ENTONCES haz eso. (Esta es la Acción)

Cada elemento interactivo, cada pieza de tiempo dinámico y cada cambio condicional en tu estudio de Labvanced es controlado por un Evento.

Los dos componentes principales de un Evento

Cuando creas un evento en Labvanced, siempre trabajarás con estas dos partes:

1. Trigger (El "Cuándo")

El Trigger es la condición específica que causa que el evento se active. Piénsalo como un 'escucha' que está siendo buscado. El trigger es como la "causa" en una relación de causa y efecto.

Para una lista completa de Triggers disponibles, consulta aquí.

Triggers comunes incluyen:

  • Triggers de entrada del usuario: Mouse Move, On Key Press, Joystick.
  • Triggers de señal fisiológica: Eye Tracking Gaze (por ejemplo, para cuando miras una imagen particular), Head Tracking
  • Triggers de ensayo y marco: On Trial Start, On Frame Start.
  • Cambio de variable: Variable (Value Change) (por ejemplo, cuando la variable 'puntaje' aumenta).
  • Triggers de objeto multimedia: Playback Started, Playback Ended.

2. Acción (El "Qué")

La Acción es lo que el experimento realmente hace una vez que el Trigger ha ocurrido. Es el "efecto" y el resultado subsiguiente para cuando ha ocurrido un trigger específico.

Para una lista completa de Acciones disponibles, consulta aquí.

Acciones comunes incluyen:

  • Acciones de salto: Jump to Frame, Jump to Next Trial.
  • Acciones de objeto: Set Object Property (por ejemplo, hacer que una imagen sea invisible)
  • Acciones de variable: Set/Record Variable (por ejemplo, sumar 1 al 'puntaje', especificar un registro de tiempo de reacción)
  • Acciones de API: Send to WebSocket, Send to OpenAI.

Ejemplos prácticos de Eventos

Aquí hay algunos escenarios comunes en experimentos de psicología y cómo se construyen con Eventos:

Escenario 1: Hacer clic en un botón "Siguiente" para proceder.

  • Trigger: On Mouse Click (en el objeto del botón)
  • Acción: Jump to Next Frame

Escenario 2: Una tarea sencilla de Tiempo de Reacción (presiona 'J' cuando veas un círculo).

  • Trigger: On Key Press
  • Acción 1: Set/Record Variable (Variable para registrar la pulsación de la tecla)
  • Acción 2: Set/Record Variable (Variable para el tiempo desde el inicio del Marco (por ejemplo), para el tiempo de reacción)
  • Acción 3: Jump to Next Trial

Puedes tener múltiples acciones para un trigger.

Escenario 3: Mostrar texto durante exactamente 500ms.

  • Evento 1:
    • Trigger: On Frame Start
    • Acción: Control Action específicamente la opción Delayed Action configurada en 500ms, especificar la Secuencia de Acción para Set Object Property del objeto de texto para tener una propiedad Visibility de 0.

¿Por qué son tan importantes los Eventos?

Sin eventos, un estudio en Labvanced sería solo estático. Los eventos son lo que hacen que tu experimento:

  • Interactivo: Permiten que el estudio responda a las acciones de los participantes.
  • Dinámico: El flujo del experimento puede cambiar en función del rendimiento (por ejemplo, en tareas adaptativas).
  • Temporizado con precisión: Te dan control a nivel de milisegundo sobre cuándo aparecen y desaparecen los estímulos.
  • Rico en datos: Son el mecanismo para registrar puntos de datos críticos como tiempos de reacción, elecciones y precisión en el momento exacto en que ocurren.

En resumen, los Eventos son los bloques de construcción que usas para programar toda la lógica y el flujo de tu experimento en la interfaz visual sin código de Labvanced. Dominarlos es la clave para crear estudios sofisticados y profesionales tanto para experimentos en línea como en laboratorio y en investigación psicológica.

Creando un Evento

Para crear un evento, abre cualquier tarea en el panel de Eventos del editor de tareas y haz clic en Frame Event (this frame only) para agregar un evento limitado al marco actual, o Trial Event (on each frame) para agregar uno que se ejecute en cada marco del ensayo.

El asistente de eventos se abre con todos los triggers disponibles mostrados en la primera página en un diseño de cuadrícula. Selecciona tu trigger directamente desde esta vista: no se necesita un clic extra para abrir un selector de trigger. Una vez seleccionado, el asistente avanza a la etapa de acción donde defines qué sucede cuando se activa el trigger.

Note: Para una referencia completa de todos los triggers y acciones disponibles, consulta la referencia del Sistema de Eventos.

Lectura adicional - Triggers

Lectura adicional - Acciones