Sistema de Eventos

Descripción
El Sistema de Eventos es esencial para cualquier estudio. Es la forma en que configuras los valores para ser registrados, haces que el experimento avance y creas tareas. Los usuarios pueden crear un sistema de eventos para ejecutar toda la funcionalidad, lógica e interacciones en una tarea. Un evento a menudo actúa como un mediador entre objetos y variables.
- Para una lista completa de activadores
- Para la lista completa de acciones
- Para más información sobre el menú de Selección de Valores para configurar valores bajo eventos

El sistema de eventos se compone de activadores y acciones. Aquí configuras reglas, como 'cuando esto sucede' (activador) 'entonces haz esto' (acción). Por ejemplo: si un participante hace clic en una imagen específica (activador), entonces muestra una imagen diferente y aleatoria (acción).
Para una introducción sobre cómo funcionan los eventos en Labvanced, por favor consulta este video breve:
Creando Eventos - Visión General
Los eventos se gestionan en el Editor de Tareas bajo la pestaña "Eventos" en la esquina superior derecha. Se pueden crear nuevos eventos haciendo clic en + Frame Event para eventos que deben ocurrir en ese cuadro o haciendo clic en + Trial Event, lo que aplica el evento a todos los cuadros. Todos los eventos existentes se muestran en una vista de lista en el panel de la derecha. Los eventos se definen a nivel de cuadro y pueden ser separados/específicos para cada cuadro o duplicados/iguales en cada cuadro a través de un ensayo.

De cualquier manera, un evento siempre se define para todos los ensayos dentro de un grupo de ensayos para el/los cuadro(s) especificado(s). Sin embargo, la lógica personalizada permite a los usuarios ejecutar eventos solo en ciertos ensayos, condiciones o en otras circunstancias.
Seleccionando un Activador
Cuando creas un nuevo evento, la selección de activador se abre como una rejilla de mosaicos. Los tipos de activadores están organizados por categoría (Entrada del Usuario, Señal Fisiológica, Ensayo y Cuadro, Variable, Objeto de Medios, API y Global). Un cuadro de búsqueda en la parte superior te permite filtrar los tipos de activadores por nombre. Haz clic en cualquier mosaico para establecerlo como el activador del evento.
Una vez que se selecciona un activador, el evento muestra una barra compacta con el nombre y el ícono del activador actual. Para cambiar a un activador diferente, haz clic en el botón Change trigger (ícono de lápiz) para reabrir la rejilla de mosaicos.
El video de abajo da una visión general de los activadores y acciones disponibles en Labvanced:
El orden de ejecución de los eventos se puede ajustar. Por defecto, los eventos con el mismo activador están más arriba en la lista y se ejecutarán primero. Los eventos también se pueden copiar y eliminar. Al seleccionar un evento existente, los detalles se muestran en el panel de la parte inferior derecha (Propiedades del Evento). Para una mejor visión general, los eventos existentes también se pueden reabrir (ícono junto al campo de nombre).
Activadores
El activador define cuándo se ejecutará el evento. Esto podría ser un clic del mouse en un objeto particular, una cierta entrada del teclado, un cambio en una variable, el inicio de un archivo de video, o muchas otras cosas. Todos los activadores y sus configuraciones / parámetros se explican en la siguiente lista:
| Categoría de Activador | Opciones de Activador | Descripción |
|---|---|---|
User Input Triggers | Los activadores de entrada del usuario se refieren a cualquier activador que puede ser activado manualmente por el usuario/participante realizando acciones como mover su mouse, hacer clic en un elemento del teclado, desplazarse, etc. | |
Physiological Signal Triggers | Los activadores de señal fisiológica ocurren cuando hay una entrada fisiológica especificada, como mirar un elemento específico o cambios en los movimientos de la cabeza. | |
Trial and Frame Triggers | Estos activadores ocurren en relación con los ensayos y cuadros experimentales, como cuando un cuadro comienza o termina. | |
Variable Value Changed Trigger | Variable (Valor Cambiado) | Se produce un activador para el evento cuando hay un cambio en el valor de una variable específica. |
Media Object Trigger | Activador de Objeto de Medios | Este activador ocurre con respecto a objetos multimedia, como cuando hay una pausa en un archivo de video/audio, una grabación se completa, etc. |
API Triggers | Estos son activadores que ocurren cuando hay datos entrantes de una API. | |
Global Triggers | Los activadores globales se refieren a cualquier cambio mayor en un experimento, como que se pause o que un participante en un estudio multiusuario se retire. |
Activadores de Entrada del Usuario
Los activadores de entrada del usuario se refieren a cualquier activador que puede ser activado manualmente por el usuario/participante.

La tabla a continuación proporciona una visión general introductoria de todos los Activadores de Entrada del Usuario disponibles en Labvanced. Cada uno de ellos se describe con mayor detalle en las secciones siguientes.
| Opción de Activador de Entrada del Usuario | Visión General |
|---|---|
Mouse Trigger | Cualquier movimiento del mouse puede ser utilizado como un activador para iniciar un evento, como: desplazarse, hacer clic, pasar el cursor, etc. También puedes asociar elementos o objetivos específicos con un activador. Por ejemplo, un clic del mouse se utilizará como un activador solo si se hace clic en una imagen específica. |
Keyboard Trigger | Cualquier tecla del teclado puede ser utilizada como un activador para iniciar un evento. Puedes especificar letras o números específicos del teclado como activadores. |
Button-Clicks | Los objetos de botón que se crean en Labvanced pueden ser utilizados como activadores para iniciar eventos. |
Enter on Input | Este activador se utiliza comúnmente cuando un participante presiona 'Enter' durante un experimento, como medio de enviar su respuesta escrita o entrada en áreas de campo de texto. |
Scroll Trigger | Este activador ocurre cuando el participante se desplaza. Puedes especificar las direcciones de desplazamiento en x o y, así como sobre qué elementos ocurre el desplazamiento para ser utilizados como activadores de eventos. |
Gamepad/ Joystick Trigger | Este activador te permite utilizar controladores de gamepad y joystick en tu diseño experimental como un dispositivo de entrada para registrar datos. |
Activador de Mouse
La opción ‘Activador de Mouse’ es un activador de eventos muy popular, ya que inicia un evento basado en cualquier interacción del mouse, como: mover el mouse hacia arriba/abajo, hacer clic, pasar el cursor sobre un objeto específico, salir de un objeto específico, ¡o cualquier movimiento en absoluto!

El ejemplo a continuación muestra un ‘Activador de Mouse’ que ocurrirá cuando se realice un ‘Clic’ con el clic ‘Izquierdo’ del mouse en el objeto ‘Objetivo’ llamado ‘Imagen_1’:

A continuación, se presenta una visión general completa de las opciones que tienes al trabajar con activaciones por mouse:
| Menú | Área del menú | Opciones y especificaciones de activación por mouse |
|---|---|---|
Action lista desplegable: | ![]() | Las siguientes opciones de activación por mouse están disponibles en la lista desplegable:
|
Button lista desplegable: | ![]() |
|
Targets opciones: | En el ejemplo anterior, ‘Imagen_1’ es el objetivo del clic del botón que activará el evento. Se pueden agregar múltiples objetivos haciendo clic en la opción ‘+Add Target’ en la parte inferior. |
|
- Nota: Después de seleccionar el desencadenador de mouse en el sistema de eventos, tienes la opción de utilizar y referenciar valores de mouse específicos para desencadenadores en diversas acciones con el menú de selección de valores.
Activaciones por Teclado
La opción ‘Desencadenador de Teclado’ es otra forma popular de tener un evento que se active. Esencialmente, cualquier entrada del teclado puede usarse como desencadenador. Esto incluye: presionar, mantener o soltar una tecla.

En el ejemplo siguiente, el desencadenador se establece para ser una presión de teclado que ocurre cuando los valores numéricos específicos del objetivo (0, 2 o 6) son presionados:

A continuación, se presenta una visión general completa de las teclas y opciones que tienes al trabajar con activaciones por teclado:
| Menú | Área del menú | Opciones de activación por teclado |
|---|---|---|
Action lista desplegable: | ![]() |
|
Keys qué tecla desencadena el evento | ![]() | Qué tecla se usa como desencadenador se especifica seleccionando las opciones aquí haciendo clic en +Add:
+Add: |
| Opciones Adicionales | ![]() | La opción habilitar botones del teclado numérico permite el uso de teclas del teclado numérico como desencadenadores dentro del experimento. Para la opción permite la propagación de eventos, si múltiples eventos tienen el mismo desencadenador de teclado, entonces todos se activarán/dispararán sin él. Solo el primero se activará y la ejecución del evento se detendrá después de que se haya completado el primer evento. |
- Nota: Después de seleccionar el desencadenador de teclado en el sistema de eventos, tienes la opción de utilizar y referenciar valores de teclado específicos para desencadenadores en diversas acciones con el menú de selección de valores.
Desencadenador de Clic en Botón
Si tienes un botón u objeto de navegación colocado en el editor, puedes utilizarlos como parte de un evento donde hacer clic en el botón actúa como un desencadenador para una acción.

Hacer clic en este desencadenador muestra el siguiente menú donde puedes especificar qué botón específico actuará como desencadenador:

Aquí hay un vistazo más de cerca a los elementos destacados:
| Menú | Área del menú | Opciones de desencadenador de clic en botón |
|---|---|---|
Objetivo: +Set Target | ![]() | |
Button: opción | ![]() | Especificar qué botón específico en el marco |
- Nota: Después de seleccionar el desencadenador de Clic en Botón en el sistema de eventos, tienes la opción de utilizar y referenciar valores específicos para clic en botón en diversas acciones con el menú de selección de valores.
Desencadenador de Enter en Input
Desencadenadores en: La tecla Enter/Return es presionada en el teclado mientras un elemento específico está activo.
Parámetros:
Agregar Objetivos: Agregar un elemento de entrada al Evento.
Nota: Después de seleccionar el desencadenador de Enter en Input en el sistema de eventos, tienes la opción de utilizar y referenciar valores específicos de Enter en Input en diversas acciones con el menú de selección de valores.
Desencadenador de Desplazamiento
Desencadenadores en: La barra de desplazamiento, desplazamiento en el panel táctil o rueda de desplazamiento del mouse se usa en un elemento específico.
Parámetros:
- Elegir si el desplazamiento es en el eje Y o el eje X (desplazamiento vertical u horizontal).
Objetivo: Establecer el elemento objetivo al que se aplicará el desencadenador de desplazamiento.
Nota: Para texto largo, en el panel de 'Propiedades del Objeto' bajo la sección 'Estilo', las opciones Overflow-Xy/o Overflow-Y deben tener scroll como la opción seleccionada.
- Nota: Después de seleccionar el desencadenador de Desplazamiento en el sistema de eventos, tienes la opción de utilizar y referenciar valores específicos de desplazamiento en diversas acciones con el menú de selección de valores.
Desencadenador de Gamepad/ Joystick
El Gamepad/ Joystick Trigger permite hacer uso de controladores de gamepad y joystick en tu diseño experimental como un dispositivo de entrada para grabar datos. Nota: recuerda habilitar esta opción en la pestaña Settings.
Desencadenadores de Señal Fisiológica
Estos desencadenadores solo se aplicarán si el seguimiento ocular y/o el seguimiento de cabeza han sido habilitados para la tarea.
Desencadenador de Mirada de Seguimiento Ocular
Desencadenadores en:
- En general, este desencadenador se aplicará cuando se haya habilitado el seguimiento ocular.
- Solo desencadenar al mirar elementos específicos
Parámetros:
Si has seleccionado desencadenar solo en elementos específicos, agrega esos elementos como objetivos.
Nota: Después de seleccionar el desencadenador de Mirada de Seguimiento Ocular en el sistema de eventos, tienes la opción de utilizar y referenciar valores específicos de mirada en diversas acciones con el menú de selección de valores.
Desencadenador de Fijación de Seguimiento Ocular
Este desencadenador aún está en su fase BETA.
- Nota: Después de seleccionar el desencadenador de teclado en el sistema de eventos, tienes la opción de utilizar y referenciar valores específicos de fijación en seguimiento ocular en diversas acciones con el menú de selección de valores.
Desencadenador de Seguimiento de Cabeza
Desencadenadores en:
Cambios en la orientación de la cabeza o movimiento de la cabeza.
Nota: Después de seleccionar el desencadenador de Seguimiento de Cabeza en el sistema de eventos, tienes la opción de utilizar y referenciar valores específicos de Seguimiento de Cabeza en diversas acciones con el menú de selección de valores.
### Disparadores de Prueba y Marco
#### Disparador de Inicialización de Tarea
Se activa en:
* El primer fotograma del primer ensayo de una tarea. Se ejecutará solo una vez por tarea, a pesar de aparecer en la pestaña de Eventos para todas las instancias de ese fotograma.
Este disparador se combina bien con las acciones de Mezclar y Leer Desde. Con estas combinaciones, puedes mezclar entradas de array o fotogramas de datos al comenzar la tarea y asignar sujetos a conjuntos de estímulos sin tener que crear múltiples eventos para leer estímulos o datos.
Parámetros: Ninguno
* **Nota:** Después de seleccionar el disparador de Inicialización de Tarea en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de Inicialización de Tarea](#trigger-on-task-initialization-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
#### Disparador de Inicialización de Fotograma
Se activa en:
* La inicialización del fotograma, antes de que se vuelva visible para el participante.
Este disparador se combina bien con las acciones de Mezclar, Leer Desde y Dibujar Número Aleatorio. Con estas combinaciones, estas acciones pueden completarse antes de que aparezca el fotograma, dejando un camino claro para que otras acciones comiencen al iniciar el fotograma.
**Nota:** No uses el disparador de Inicialización de Fotograma con eventos que registren una variable o que involucren variables del sistema, como Número de Prueba o Número de Condición. Esto se debe a que el disparador de Inicialización de Fotograma ocurre entre ensayos, por lo que no hay un conteo totalmente exacto del ensayo o condición que está a punto de mostrarse.
Parámetros: Ninguno
* **Nota:** Después de seleccionar el disparador de Inicialización de Fotograma en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de Inicialización de Fotograma](#trigger-on-frame-init-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
**Nota sobre los Disparadores de Inicialización de Tarea y Fotograma:** Debido a que los disparadores de Inicialización de Tarea y Fotograma ocurren antes de que la tarea o el fotograma comience, las variables creadas durante este tiempo se restablecerán cuando la tarea/fotograma realmente comience. Aparecerá una advertencia al utilizar este evento:

Recuerda desmarcar la casilla "Restablecer al Iniciar Ensayo" en la ventana de propiedades de la variable si no deseas que los valores de la variable se restablezcan.
#### Disparador de Inicio de Fotograma
Se activa en:
* Inicio del fotograma
Parámetros: Ninguno
* **Nota:** Después de seleccionar el disparador de Inicio de Fotograma en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de Inicio de Fotograma](#trigger-on-frame-start-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
#### Disparador de Fin de Fotograma
Se activa en:
* Fin del fotograma (después de que el fotograma ya no sea visible)
Parámetros: Ninguno
* **Nota:** Después de seleccionar el disparador de Fin de Fotograma en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de Fin de Fotograma](#trigger-on-frame-end-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
### Disparador de Cambio de Valor de Variable
#### Cambio de Valor de Variable
Se activa en:
* El valor de una variable cambia de su valor inicial
Parámetros:
* Variables: Selecciona una o más variables en las que deseas "escuchar" cambios. Cualquier cambio en el valor de estas variables activará inmediatamente la Acción correspondiente.
* **Nota:** Después de seleccionar el disparador de Cambio de Valor de Variable en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de Cambio de Valor de Variable](#trigger-variable-value-changed-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
### Disparadores de Objeto Multimedia
#### Disparador de Objeto Multimedia
Anteriormente conocido como los disparadores separados "Controlar Audio/Video" y "Controlar Objeto".
Se activa en:
* Inicio, pausa o detención de un archivo de video o audio
* Carga de Archivo Finalizada, Archivo Seleccionado, Grabación Terminada de un objeto de grabación
* Captura de Cámara Finalizada o Carga Completa de un objeto de captura de cámara
Parámetros:
* Objetivo: Selecciona un elemento de objeto que existe en el fotograma
* Ejecutar En: Selecciona el subtipo de disparador
* Opciones para Objetos de Audio o Video:
* Reproducción Comenzada: Se activa cuando el elemento comienza a reproducirse
* Reproducción Detenida: Se activa cuando el elemento se pausa
* Reproducción Finalizada: Se activa cuando el elemento deja de reproducirse
* Opciones para Objetos de Video, Audio o Grabación de Pantalla:
* Grabación Finalizada: Se activa cuando la grabación de audio se ha detenido
* Carga Completa: Se activa cuando la carga de archivos se ha completado
* Opciones para Objetos de Carga de Archivos:
* Archivo Seleccionado: Se activa cuando se selecciona un archivo
* Carga Completa: Se activa cuando la carga de archivos se ha completado
* Opciones para Objetos de Captura de Cámara:
* Captura Finalizada: Se activa cuando la cámara ha tomado con éxito una captura
* Carga Completa: Se activa cuando la captura ha terminado de cargarse
* **Nota:** Después de seleccionar el disparador de Objeto Multimedia en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de Objeto Multimedia](#trigger-media-object-trigger-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
### Disparadores de API
Si necesitas enviar o comunicar datos desde un servidor externo a Labvanced, entonces se pueden utilizar los ‘Disparadores de API’ y [‘Acciones de API’](/content/learn/es/guide/task-editor/event-system.html#api-actions). Los siguientes pueden usarse como disparadores:
* Disparador de Websocket
* Disparador de OpenAI
* PostMessage Recibido
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/api_trigger_menu.webp" alt="El menú de disparadores de API en Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
#### Disparador de Websocket
El Disparador de Websocket se utiliza cuando se recibe un mensaje del websocket/API que se procesará como el disparador para la Acción.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_trigger.webp" alt="La opción de menú del disparador de Websocket." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Al hacer clic en esta opción, aparecen los siguientes elementos.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_dialog.webp" alt="El menú de diálogo del disparador de Websocket." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
* **Aceptar/Recibir de:** Detecta automáticamente la dirección IP del host local. Puede ser cambiada manualmente en la pestaña [`Settings`](/content/learn/es/guide/settings/) bajo `Special Features`.
* **Disparador/mensaje:** ingresa el mensaje que servirá como disparador. Escribe 'cualquiera' para aceptar más de un mensaje como disparador.
Para un ejemplo de cómo se utilizan los Disparadores / Acciones de API, consulta esta demostración [https://www.labvanced.com/page/library/51053](https://www.labvanced.com/page/library/51053) haciendo clic en la opción ‘Inspeccionar’ en el cuadro de diálogo.
**[Para más información sobre el Acceso a la API, visita esta página.](https://www.labvanced.com/content/learn/es/guide/api-access/)**
* **Nota:** Después de seleccionar el disparador de WebSocket en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de WebSocket](#trigger-websocket-trigger-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
#### Disparador de OpenAI
El ‘Disparador de OpenAI’ se puede usar para iniciar una acción basada en información entrante de OpenAI.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_trigger.webp" alt="El menú de Disparador de OpenAI en Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Seleccionar esta opción mostrará los siguientes parámetros:
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_dialog.webp" alt="Las opciones del menú de disparador de OpenAI." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
**NOTA:** También consulta [esta guía paso a paso](/content/learn/es/walkthroughs/2024-09-chatgpt-study-example/) donde construimos un estudio paso a paso, integrando ChatGPT en un estudio y utilizando este disparador.
En el ejemplo a continuación, el marco de datos que se ha asignado se llama ‘df’ y el resultado del ‘Disparador de OpenAI’ se añadirá a este marco de datos. Este marco de datos debe tener dos columnas. La primera columna denotará el ‘rol’ y la segunda columna el ‘mensaje de chat.’ Los valores de la acción se agregarán automáticamente al marco de datos que está vinculado aquí.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_trigger_example.webp" alt="Un ejemplo del disparador de OpenAI en Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Si también estás utilizando la [‘Acción Enviar a OpenAI’,](#send-to-openai-action) entonces necesitas utilizar el mismo marco de datos allí como has indicado aquí.
* **Nota:** Después de seleccionar el disparador de OpenAI en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de OpenAI](#trigger-openai-trigger-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
#### Disparador de PostMessage Recibido
El `PostMessage Received` disparador se activa cuando el experimento en ejecución recibe un mensaje entrante de una fuente externa a través de la API postMessage del navegador. Es útil para conectar un experimento a una página principal, una aplicación personalizada o un sitio web externo incrustado que envía datos al estudio.
[Aprende más.](/content/learn/es/guide/events/postmessage-received-trigger.html)
* **Nota:** Después de seleccionar el disparador de PostMessage Recibido en el sistema de eventos, tienes la opción de utilizar y referenciar [valores específicos de disparador de PostMessage Recibido](#trigger-postmessage-received-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
### Disparadores Globales
Los Disparadores Globales ocurren siempre que se produce un cambio importante dentro del experimento, es decir, algo que es 'Global', como pausar el experimento o un participante que abandona un estudio multiusuario. Las siguientes opciones se enumeran como Disparadores Globales:
* Pausar / Reanudar Experimento
* Participante Abandonó Estudio Multiusuario
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_menu.webp" alt="El menú de disparadores globales en Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
#### Pausar/Reanudar Experimento
El disparador ‘Pausar / Reanudar Experimento’ es una opción que te permite ejecutar un evento basado en la pausa o reanudación del experimento.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/pause_trigger.webp" alt="La opción de usar una pausa en el experimento como disparador." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Al seleccionar este disparador, aparece la siguiente vista donde puedes especificar más sobre la naturaleza del disparador, si debe ejecutarse cuando el experimento se pause o continúe/reanude:
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_dialog.webp" alt="Menú de diálogo para este disparador global" width="50%">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_options.webp" alt="Opciones disponibles en el menú de disparadores globales" width="50%">
</p>
* **Experimento Pausado:** El participante pausa (sale de pantalla completa) el estudio.
* **Experimento Continuado:** El participante reanuda el estudio. Este disparador funciona bien para estudios de seguimiento ocular. Se puede usar para enviar al participante de vuelta a un ensayo o marco anterior si ha abandonado su Soporte de Barbilla Virtual.
* **Nota:** Después de seleccionar el disparador Pausar/Reanudar Experimento en el sistema de eventos, tienes la opción de utilizar y hacer referencia a [valores específicos del disparador](#trigger-global-experiment-event-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
#### Participante Abandonó Estudio Multiusuario
Si un participante abandona un estudio multiusuario, eso también puede usarse como un disparador para un evento. Si un participante abandona un estudio multiusuario, esto afecta al experimento a nivel global porque impide que otros participantes continúen con el estudio.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus.webp" alt="La opción Participante Abandonó Estudio Multiusuario como un disparador en Labvanced" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Al seleccionar este disparador, puedes especificar qué tipo de acción ocurrirá si un participante abandona un estudio multiusuario.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus_dialog.webp" alt="El cuadro de diálogo del disparador de participante que abandonó el estudio multiusuario." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
* **Nota:** Después de seleccionar el disparador Participante Abandonó Estudio Multiusuario en el sistema de eventos, tienes la opción de utilizar y hacer referencia a [valores específicos del disparador](#trigger-user-leaves-experiment-values) a través de varias acciones con el [menú de selección de valores.](#the-value-select-menu)
## Acciones
Las acciones definen lo que debería suceder cuando se ejecute el evento. Pueden usarse para cambiar variables y propiedades de objetos, registrar datos, leer y escribir datos desde/hacia arreglos, o saltar al siguiente ensayo o tarea. A menudo hay varias acciones por evento. Usando "ControlActions", uno puede usar operaciones lógicas (instrucciones If-Else), Bucles, funciones de devolución de llamada, así como anidar acciones dentro de otras (por ejemplo, un bucle while dentro de una instrucción if). Por lo tanto, el sistema de eventos puede verse como un entorno de programación gráfica. En esta vista, los disparadores actúan como las invocaciones de funciones, mientras que las acciones describen la lógica funcional. Este enfoque garantiza que casi cualquier lógica experimental pueda implementarse sin el uso de ciertas estructuras programáticas/sintácticas.
La tabla a continuación proporciona una visión general introductoria de las acciones que están disponibles en Labvanced:
| Categoría de Acción <img width=200/> | Opciones de Acción <img width=500/>| Descripción <img width=400/> |
| :----: | -- | ----- |
| [`Object Actions`](#object-actions)| <ul><li> [Establecer Propiedad del Objeto](#set-object-property-action) </li> <li> [Controlar Objeto Multimedia](#control-media-object-action) </li> <li> [Copiar Objeto](#copy-object-action) </li> <li> [Para Cada Objeto](#foreach-object-action) </li> </ul> | Las acciones de objeto se refieren a cualquier manipulación que ocurrirá en un objeto que existe dentro de la tarea. |
| [`Variable Actions`](#variable-actions) | <ul><li> [Establecer / Registrar Variable](#set-record-variable-action) </li> <li> [Copiar al Portapapeles](#copy-to-clipboard-action) </li> <li>[Dibujar Número Aleatorio](#draw-random-number-action) </li> <li> [Obtener Parámetro URL](#get-url-parameter-action) </li> <li> [Leer de / Escribir en Dispositivo](#read-from-write-to-device-action) </li> <li> [Leer de / Escribir en Variable Compartida](#read-from-write-to-shared-variable-action) </li> <li> [Matemáticas y Estadísticas](#math-statistics-action) </li> <li>[Registrar Variables al Instante](#record-variables-instantly-action) </li> <li>[Filtro de Media Móvil](#moving-average-filter-action) </li> <li> [Distribuir Variable](#distribute-variable-action) </li> </ul> | Cualquier acción que lee o registra un valor variable. |
| [`Array Actions`](#array-actions) | <ul><li> [Seleccionar de Arreglo (Leer)](#select-read-from-array-action) </li> <li> [Agregar / Quitar Entradas de Arreglo](#add-remove-array-entries-action) </li> <li> [Cambiar Entrada de Arreglo (Reemplazar)](#change-replace-array-entry-action) </li> <li> [Barajar Entradas de Arreglo](#shuffle-array-entries-action) </li> </ul> | Las operaciones de arreglo implican seleccionar, agregar, eliminar, cambiar y barajar arreglos y sus entradas. |
| [`Data Frame Operations`](#data-frame-operations) | <ul><li> [Leer de / Escribir en Marco de Datos](#read-from-write-to-data-frame-action) </li> <li> [Barajar Entradas del Marco de Datos](#shuffle-data-frame-entries-action) </li> </ul> | Estas acciones son relevantes si estás trabajando con archivos .csv (marcos de datos) en tu experimento. |
| [`Jump Actions`](#jump-actions) | <ul><li> [Saltar A](#jump-to-action) </li> <li> [Aceptar / Terminar Sesión](#accept-end-session-action) </li> <li> [Rechazar / Terminar Sesión](#reject-end-session-action) </li> <li>[Redirigir a URL](#redirect-to-url-action)</li></ul> | Te permite navegar por el experimento saltando a una sección específica, así como aceptar y rechazar secciones del participante. |
| [`Control Actions`](#control-actions) | <ul><li> [Acciones de Requisitos (Si...Entonces)](#requirement-actions-if-then-else-if-action) </li><li> [Acciones Repetidas (Bucle Mientras)](#repeated-actions-while-loop-action) </li><li> [Acciones con Retraso (Devolución de Llamada de Tiempo)](#delayed-actions-time-callback-action) </li><li> [Grupo de Acciones](#action-group) </li></ul> | Las acciones de control se utilizan para ejecutar secuencias específicas de eventos, como lógica if/then, bucles (como reproducir un sonido repetido o parpadear una imagen), así como configurar un retraso para cuando ocurra una acción. |
| [`API Actions`](#api-actions) | <ul><li> [Enviar PostMessage](#send-postmessage-action) </li><li> [Enviar a Websocket](#send-to-websocket-action) </li><li> [Enviar a OpenAI](#send-to-openai-action) </li></ul> | Se refiere a acciones específicas de API para enviar datos a una API. |
| [`Code Actions`](#code-actions) | <ul><li> [Ejecutar JavaScript](#run-javascript-action) </li> <li> [Establecer CSS Global](#set-global-css-action) </li></ul> | Las acciones de código te permiten trabajar con JavaScript o CSS.
| [`Paste Action`](#paste-action) | Acción de Pegar | Te permite pegar una acción que copiaste previamente. |
### Acciones de Objetos
Las acciones de objeto se refieren a cualquier manipulación que ocurrirá en un objeto que existe dentro de la tarea. Hay varias opciones de Acción de Objeto:
* Establecer Propiedad del Objeto
* Controlar Objeto Multimedia
* Copiar Objeto
* Para Cada Objeto
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/object_actions_menu.webp" alt="La opción Acciones de Objetos en Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
#### Establecer Propiedad del Objeto Acción
Con la acción ‘Establecer Propiedad del Objeto’ puedes cambiar la apariencia de un objeto como desees, especificando el objeto en cuestión, la propiedad a cambiar y el nuevo valor.
[Aprende más.](/content/learn/es/guide/events/set-object-property-action.html)
#### Controlar Objeto Multimedia Acción
Anteriormente, las acciones separadas "Controlar Audio/Video" y "Controlar Objeto".
Efecto: Cambia la reproducción de elementos de video/audio o cambia el estado de elementos de carga/grabación.
Parámetros:
* Objetivo: Seleccionar un objeto multimedia
* Efecto: Seleccionar una subacción
* Opciones de Objeto de Audio o Video:
* Comenzar Reproducción: Comienza a reproducir el archivo de video/audio
* Detener Reproducción: Detiene el archivo de video/audio
* Pausar Reproducción: Pausa el archivo de video/audio
* SaltarATiempo: te permite especificar un tiempo en milisegundos para saltar en el archivo de audio/video
* Silenciar: apaga el sonido del objeto
* Activar Sonido: restaura el sonido del objeto
* Opciones de Objeto de Audio, Video o Grabación de Pantalla:
* Comenzar Grabación: Comienza una nueva grabación (de audio)
* Detener Grabación: Detiene la grabación (de audio)
* Comenzar Carga: Comienza la carga del archivo
* Borrar Grabación: Elimina los datos de grabación (de audio).
* Comenzar Reproducción: Comienza a reproducir el archivo grabado
* Detener Reproducción: Detiene la reproducción del archivo grabado
* Pausar Grabación: pausa la grabación del objeto
* Reanudar Grabación: reanuda la grabación del objeto
* Opciones de Objeto de Carga de Archivos:
* Comenzar Carga: comienza el proceso de carga para el archivo seleccionado
* Borrar Archivo: Elimina el archivo seleccionado
* Elegir Archivo: permite al participante elegir el archivo deseado
* Opciones de Objeto de Captura de Cámara:
* Comenzar Cámara: enciende la cámara del participante
* Detener Cámara: apaga la cámara del participante
* Comenzar Carga: comienza a cargar la instantánea al experimento
* Tomar Instantánea: toma una foto usando la cámara del participante
Copiar acción de objeto
Efecto: Copia un objeto, reemplazando la necesidad de varios objetos separados y eventos duplicados.
Parámetros:
- Fuente: Elige el objeto en el marco a copiar.
- Número de copias: Ingresa el número de copias a realizar del objeto fuente.
- Establecer nuevo nombre de elemento: Elige entre varios parámetros para determinar los nombres de las copias.
- Asignar nombre con postfix incrementando: Agrega una etiqueta numérica al final del nuevo nombre de elemento para diferenciar las copias.
- Secuencia de acción: Te permite elegir (de la lista habitual de acciones) qué pasará con las copias. Selecciona "CurrentObject" como el objetivo para aplicar la acción a todas las copias.
ForEach acción de objeto
Efecto: Aplica una acción a varios objetos del mismo tipo.
Parámetros:
- Filtro: Elige el tipo de elemento a dirigir.
- Permitir filtro de nombre adicional: Escribe el nombre del objeto(s) a dirigir. Para varios objetos en un marco donde algunos tienen nombres idénticos, esto funciona bien.
- Secuencia de acción: Te permite elegir (de la lista habitual de acciones) qué pasará con los elementos seleccionados. Selecciona "CurrentObject" como el objetivo para aplicar la acción a todos los elementos que cumplen con los criterios especificados anteriormente.
Acciones de variable
Las acciones de variable se utilizan para establecer o crear valores de variables, registrar y definir valores, incluyendo valores a través de sesiones.

La tabla a continuación proporciona una visión general introductoria de todas las opciones de acción de variable disponibles en Labvanced. Cada una de ellas se describe en mayor detalle en las secciones siguientes.
| Opción de acción de variable | Descripción |
|---|---|
Set / Record Variable | Escribir o establecer un valor de variable |
Copy to Clipboard | Copiar un valor de variable al portapapeles interno de la computadora. |
Draw Random Number | Dibuja uno o varios número(s) aleatorios y los guarda en una variable |
Get URL Parameter | Guarda un valor de la URL única del participante |
Read from / Write to Device | Lee o escribe una variable desde/hacia el almacenamiento del dispositivo local. Esta acción guarda datos en el dispositivo del participante en lugar de enviar los datos a los servidores de Labvanced. |
Read from / Write to Shared Variable | Lee de o escribe a una variable que se comparte entre sesiones de un estudio. La variable puede ser compartida con todos los participantes o privada para cada individuo. |
Math & Statistics | Realiza una operación matemática de algunas variables de entrada (arreglos) y guarda el resultado en una variable de salida. |
Record Variables Instantly | Crea una instantánea de todos los valores de variables y envía esto al servidor de Labvanced. |
Moving Average Filter | Calcula un promedio móvil (un promedio de datos en constante actualización) de alguna entrada y almacena el resultado en una nueva variable. |
Distribute Variable | Enviará un valor a otros participantes. El valor se almacena en una variable. |
Establecer / Grabar acción de variable
La acción ‘Establecer / Grabar variable’ está destinada a ser utilizada en cada experimento en Labvanced, ya que es cómo se almacenan y registran los valores y las medidas de comportamiento.

Al hacer clic en esta acción, aparecerá el siguiente menú de diálogo donde puedes especificar qué variable debe ser registrada y el valor de interés:

| Elemento del menú | Área del menú | Descripción |
|---|---|---|
Select | ![]() | Al hacer clic en seleccionar, indicas qué variable debe almacenar el valor. Desde aquí, también puedes crear una nueva variable. |
| Icono de lápiz | El icono de lápiz simboliza el menú de selección de valor que se utiliza para definir y especificar los valores exactos que deben ser asignados a la variable seleccionada (como se especifica en el botón verde a la izquierda del signo igual (=)). |
En el ejemplo a continuación, creamos una nueva variable llamada counter y utilizamos una opción aritmética del menú de selección de valor para hacer que el valor de la variable aumente en 1 (basado en el desencadenador definido en el paso anterior).

La imagen a continuación registra las coordenadas X,Y del mouse con el fin de capturar el seguimiento del mouse durante un estudio. La imagen a continuación muestra cómo se están utilizando tres acciones para hacer posible el registro del valor de la variable. La variable (a la izquierda) se crea manualmente mientras que el valor en el lado derecho del signo igual (=) es un valor específico del desencadenador del mouse que el sistema proporciona y al que puedes referirte al registrar valores.

Nota: La acción Set / Record Variable también se utiliza comúnmente en el contexto de Control Actions donde puedes especificar condiciones usando ‘if / then’ y ‘while loops’ basados en valores de variable.
Copiar a portapapeles Acción
Efecto: Copia un valor de variable al portapapeles interno de la computadora.
Dibujar acción de número aleatorio
Efecto: Dibuja uno o varios número(s) aleatorios y los guarda en una variable
Parámetros:
- Tipo: Elegir entre valores continuos y discretos
- Distribución: Elegir entre distribución gaussiana y uniforme
- Múltiples extracciones (booleano verdadero/falso): Elegir extraer una vez o múltiples veces.
- Nr de Extracciones: Seleccionar el número de extracciones
- Mín: Definir el valor mínimo para la distribución uniforme
- Máx: Definir el valor máximo para la distribución uniforme
- Media: Definir el valor medio para la distribución gaussiana
- Desviación estándar: Definir la desviación estándar para la distribución gaussiana
- Guardar en Variable: Seleccionar una variable donde se almacenen el(los) valor(es).
Obtener acción de parámetro URL
Efecto: guarda un valor de la URL única del participante
Parámetros:
- Nombre del parámetro: ingresa el nombre del parámetro deseado
- Guardar en Variable: seleccionar la variable en la que guardar el valor del parámetro
Esta acción podría combinarse con otras acciones para construir URLs únicas para los participantes o extraer información necesaria para el análisis de datos.
Leer de/Escribir en acción de dispositivo
Efecto: Lee o escribe una variable desde/hacia el almacenamiento del dispositivo local. Esta acción guarda datos en el dispositivo del participante en lugar de enviar los datos a los servidores de Labvanced.
Parámetros:
- Elegir leer desde o escribir en el dispositivo local.
- Elegir la variable a leer o escribir.
Caso de uso: Estudios longitudinales/multi-sesión
- Con esta acción, los datos específicos del dispositivo pueden ser transferidos de sesión a sesión, siempre que el mismo participante esté utilizando el mismo dispositivo para cada sesión.
- Por ejemplo, puedes usar esta acción para registrar qué imágenes se presentaron a cada participante en la Sesión 1 y asegurar que diferentes imágenes se les presenten en la Sesión 2.
- Crear un arreglo de imágenes y seleccionar aleatoriamente algunas para presentar en cada sesión.
- Escribir en el dispositivo: el número de índice de las imágenes presentadas en la Sesión 1.
- Leer del dispositivo: en la Sesión 2, leer los índices de las imágenes de la Sesión 1 e incluir una acción de JavaScript que impida que esos índices sean seleccionados para la segunda sesión.
Leer de/Escribir en acción de variable compartida
Efecto: Lee de o escribe a una variable que se comparte entre sesiones de un estudio. La variable puede ser compartida con todos los participantes o privada para cada individuo.
Parámetros:
- Elegir la variable para sincronizar. Debe ser escalar o un arreglo.
- Opciones avanzadas
- Clave de almacenamiento: elegir el nombre de una variable que sirva como clave para acceder a la variable sincronizada.
- Método de lectura o escritura:
- Leer, modificar y luego escribir la variable compartida: lee la variable, realiza un cambio, luego envía la variable al estudio.
- Solo leer valor compartido del servidor: llama a la variable que se comparte dentro del estudio, pero no hace ningún cambio.
- Solo escribir variable al servidor: realiza cambios en la variable compartida, pero no la muestra a los participantes.
- Compartir valores entre diferentes participantes (no solo entre sesiones): permite a los participantes ver los valores de variables sincronizadas de cada uno a través de sesiones. Esta opción se selecciona por defecto, pero puede deseleccionarse haciendo clic en la casilla de verificación.
- Secuencia de acción:
- Elegir qué sucede con la variable compartida/sincronizada de la lista de todas las acciones disponibles.
Caso de Uso: Estudios Longitudinales/Multi-Sesión
* Con esta acción, los datos específicos de los participantes pueden ser transferidos de sesión a sesión y pueden ser compartidos entre participantes a través de sesiones.
* Por ejemplo, puedes usar esta acción para registrar una puntuación en una prueba y luego permitir que el participante compare su puntuación con la puntuación media de los otros participantes que han completado la prueba.
* Otro ejemplo (similar a la Acción Leer desde/Escribir en Dispositivo) es hacer que los participantes elijan 5 imágenes que les gusten de un conjunto, realicen una tarea y luego presenten esas 5 imágenes nuevamente en una sesión posterior. La diferencia es que esta Acción se puede usar para mostrar a otros participantes las imágenes que fueron seleccionadas, o para excluir esas imágenes de las opciones disponibles para otro participante.
#### Acción de Matemáticas y Estadísticas
Efecto: Realiza una operación matemática de alguna variable de entrada (arreglo) y guarda el resultado en una variable de salida.
Parámetros:
* Tipo: Elige entre Operaciones de Arreglo, Álgebra Lineal y Pruebas Estatísticas
* Operación: Elige una operación matemática (por ejemplo, suma, mínimo, desviación estándar, etc.)
* Arreglo de Entrada: Elige una variable de entrada (Arreglo) sobre la cual se ejecuta la operación
* Parámetros: Algunas operaciones tienen parámetros adicionales.
* Salida: Selecciona una variable de salida donde se almacenará el resultado.
#### Acción de Grabar Variables Instantáneamente
Efecto: Crea una instantánea de todos los valores de las variables y envía esto al servidor de Labvanced.
Parámetros: Ninguno
#### Acción de Filtro de Promedio Móvil
Efecto: Calcula un promedio móvil (un promedio que se actualiza constantemente de los datos) de alguna entrada y almacena el resultado en una nueva variable.
Parámetros:
* Forma del Filtro: Selecciona el tipo de filtro
* Promedio Móvil Simple: Calcula un promedio móvil simple, donde todas las muestras tienen el mismo peso.
* Promedio Móvil Ponderado Lineal: Pondera las muestras de tal manera que los pesos de las muestras disminuyen linealmente.
* Promedio Móvil Exponencial: Pondera las muestras de tal manera que los pesos de las muestras disminuyen exponencialmente.
* Número de Muestras: Determina cuántas muestras se utilizan por paso.
* Entrada: Elige una variable de entrada (Arreglo) sobre la cual se calcula el promedio móvil.
* Salida: Selecciona una variable de salida donde se almacenará el resultado.
#### Acción de Distribuir Variable
La acción de Distribuir Variable es esencial para [estudios multiusuario en Labvanced.](https://www.labvanced.com/content/technology/es/multi-user-psychology-studies/) Con esta acción, un valor de variable puede ser compartido entre participantes, permitiendo esencialmente que la información (incluidas las ubicaciones de estímulos y cualquier cambio) se refleje en las pantallas de los participantes.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_menu.webp" alt="La Acción de Distribuir Variable en el menú de acciones de Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Al seleccionar esta acción, aparecerá el siguiente cuadro de diálogo donde puedes especificar qué valor de variable se está distribuyendo entre los participantes.
La imagen a continuación es cómo se ve el cuadro de diálogo de Acción de Distribuir Variable funcional cuando todos los elementos del menú están llenos. En este ejemplo, la variable distribuida es una acción que se está usando como una forma de crear un chat entre dos participantes distribuyendo el valor de una variable desde un objeto de campo de entrada.
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_example.webp" alt="La variable de Distribución que se utilizará con todas las opciones de menú configuradas como ejemplo." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
Consulta esta demostración que incorpora la variable de distribución y la función del cuadro de chat aquí: [Tarea de Descripción de Imagen con Complemento de Chat.](https://www.labvanced.com/page/library/3008)
Una explicación completa de los elementos del menú de diálogo se puede encontrar a continuación:
| Elemento del Menú | Área del Menú | Opciones y Descripción de la Acción de Distribuir Variable |
|:-----:|-----| ---------|
| **`Distribute value to`** |  | Elige a qué otros participantes se debe enviar el valor. <ul><li>**Todos los participantes:** Enviar este valor a todos los participantes</li><li>**Participantes Seleccionados:** Enviar el valor a participantes seleccionados. </li></ul> |
| **`Choose target variable and value`** |  | <ul><li> **Variable Objetivo:** Elige una variable objetivo donde se almacenará el valor. </li><li>**Valor:** Determina el valor que debe ser enviado a otros participantes.</li> </ul>|
| **`Block`** |  | Si está habilitado, la Variable Objetivo no puede ser cambiada hasta que la distribución del valor actual se haya completado. |
| **`Rate Limit Strategy`**|  | La Estrategia de Limitación de Tasa es una manera de proteger tu experimento de desbordar el servidor y actúa como una estrategia de precaución para controlar la tasa a la que se envían las solicitudes (es decir, actualizaciones a través de la variable distribuida) al servidor. Las siguientes opciones de estrategia están disponibles: <ul><li>**Debounce:** Cuando esta acción se ejecuta más de una vez por cada intervalo de tiempo de 100 ms, los nuevos mensajes del servidor serán 'debounced' (solo el mensaje más reciente se enviará después de un intervalo de 100 ms sin ninguna ejecución de esta acción).</li><li>**Throttle:** Cuando esta acción se ejecuta más de una vez por cada intervalo de tiempo de 100 ms, los nuevos mensajes serán limitados (es decir, después de que hayan pasado 100 ms desde el último mensaje enviado, solo se distribuirá el mensaje más reciente).</li><li>**Descartar:** Cuando esta acción se ejecuta más de una vez por cada intervalo de tiempo de 100 ms, los nuevos mensajes dentro de esa ventana de 100 ms serán descartados.</li><li>**Cola:** Cuando esta acción se ejecuta más de una vez por cada intervalo de tiempo de 100 ms, los nuevos valores de variable serán encolados (hasta un tamaño máximo de cola de 10 mensajes).</li></ul> |
### Acciones de Arreglo
#### Seleccionar (Leer) desde Arreglo Acción
Efecto: Leerá una variable de un arreglo y almacenará este valor en una variable escalar.
Parámetros:
* Variable de Arreglo: Arreglo de entrada para leer el valor.
* Tipo de Índice: Determina qué tipo de índice se usa.
* Fijo: Usa un índice fijo para la operación de lectura. En este caso, escribe la posición desde donde se debe leer la información (basada en 1).
* Variable: Usa una variable numérica como índice para la operación de lectura. En este caso, selecciona una variable escalar numérica para determinar la posición de la lectura.
* Fin del Arreglo: Leer desde el final del arreglo.
* Variable de Salida: Selecciona una variable escalar donde se almacenará el valor leído.
#### Agregar / Eliminar Entradas de Arreglo Acción
Efecto: Agregará y/o eliminará entradas de / a un arreglo.
Parámetros:
* Variable de Arreglo: Variable de arreglo donde debe ejecutarse la operación de agregar o eliminar.
* Tipo de Índice: Determina qué tipo de índice se usa.
* Fijo: Usa un índice fijo para la operación de insertar / eliminar. En este caso, escribe la posición del arreglo donde se deben insertar / eliminar las entradas. (basado en 1).
* Variable: Usa una variable numérica como índice para la operación de insertar / eliminar. En este caso, selecciona una variable escalar numérica para determinar dónde se deben insertar / eliminar las entradas.
* Fin del Arreglo: Insertar / eliminar desde el final del arreglo.
* Número de entradas a eliminar: Eliminará las entradas del arreglo (antes de insertar nuevas entradas) comenzando desde la posición de índice definida. 0 indica que no se eliminarán valores.
* Variable(s) a Insertar: Selecciona una o más variable(s) escalar(es), que se agregarán a la variable de arreglo en la posición de índice definida.
#### Cambiar (Reemplazar) Entrada de Arreglo Acción
Efecto: Reemplazará / cambiará un valor dentro de un arreglo.
Parámetros:
* Variable de Arreglo: Variable de arreglo en la que se debe modificar un valor
* Tipo de Índice: Determina qué tipo de índice se usa.
* Fijo: Usa un índice fijo para la operación de reemplazo. En este caso, escribe la posición del arreglo que se debe cambiar (basada en 1).
* Variable: Usa una variable numérica como índice para la operación de reemplazo. En este caso, selecciona una variable escalar numérica para determinar la posición de la operación de reemplazo.
* Fin del Arreglo: Reemplaza la última entrada del arreglo.
* Variable de Entrada: Selecciona una variable (escalar) que contenga el nuevo valor.
#### Mezclar Entradas de Arreglo Acción
Efecto: Mezclará las entradas / orden dentro de un arreglo.
Parámetros: Ninguno
### Operaciones de Marco de Datos
#### Leer desde / Escribir en Acción de Marco de Datos
Efecto: Lee valores de o escribe valores en un marco de datos y los guarda en una nueva variable de arreglo.
Parámetros:
* Variable de marco de datos: selecciona la variable del marco de datos que se va a leer.
* Leer o Escribir: Elige leer desde el marco de datos seleccionado o escribir en el marco de datos seleccionado.
* Por fila o columna: Elige cómo se deben leer los datos.
* Tipo de índice: Elige el tipo de variable de índice que se utilizará para leer el marco de datos. Puede ser fijo, variable o la última fila.
* Variable de índice: Elige la variable que se utilizará como índice para leer el marco de datos.
* Variable de salida: Elige la variable donde se almacenarán los datos leídos/escritos como salida. Debe ser una variable de arreglo.
#### Mezclar Entradas de Marco de Datos Acción
Efecto: Mezcla el orden de las entradas en el marco de datos.
Parámetros:
* Selecciona el marco de datos a mezclar.
* Selecciona si el marco de datos debe ser mezclado por filas o columnas.
Acciones de Salto
Saltar a Acción
Efecto: "Salta" al participante a un paso diferente en el experimento. Esta acción puede cambiar el orden de los ensayos y tareas en un experimento y puede usarse para crear una lógica experimental individualizada para cada participante.
Parámetros:
- Saltar a: Determina a dónde saltar en el experimento.
- Siguiente Marco: Salta al siguiente marco. Si no hay más marcos definidos en un ensayo, saltará al primer marco del siguiente ensayo.
- Siguiente Ensayo: Salta al siguiente ensayo. Si no hay más ensayos definidos, saltará al primer ensayo de la siguiente tarea.
- Siguiente Tarea: Salta a la siguiente tarea. Si no hay más tareas definidas, saltará a la primera tarea del siguiente bloque.
- Siguiente Bloque: Salta al siguiente bloque. Si no hay más bloques definidos, la sesión terminará.
- Marco Anterior: Salta al marco anterior. Si no hay marcos anteriores, la acción no se ejecutará.
- Marco Específico: Salta a un marco específico. Los usuarios seleccionan directamente el marco al que saltar.
- Ensayo Específico: Salta a un ensayo específico. Los usuarios seleccionan directamente el número de ensayo al que saltar.
- Tarea Específica: Salta a la primera instancia de la tarea especificada en el bloque actual. Los usuarios seleccionan directamente la tarea a la que saltar.
- Bloque Específico: Salta a la primera instancia del bloque especificado. Los usuarios seleccionan directamente el bloque al que saltar.
- Comprobar Respuestas Requeridas Antes: Si está habilitado, el experimento verificará si todas las respuestas requeridas ya han sido respondidas. Si no, la acción de salto no se ejecuta.
Aceptar/Terminar Sesión Acción
Efecto: Aceptará los datos del participante, finalizará la sesión de grabación y mostrará el código de financiación colectiva.
Parámetros:
- Grabar datos del ensayo antes de terminar la sesión: Si está habilitado, los datos del ensayo más recientes se almacenarán (se enviarán al servidor) antes de salir del estudio.
- Mostrar página de finalización predeterminada: Si está habilitado, aparecerá la pantalla de finalización predeterminada de Labvanced. Si esta es una sesión de financiación colectiva (se utilizó un enlace de financiación colectiva), se mostrará el código de compensación al participante. Si está deshabilitado, el experimento finalizará después de mostrar el marco actual y no mostrará la pantalla de finalización predeterminada con el código de compensación.
Rechazar/Terminar Sesión Acción
Efecto: Termina la sesión de grabación, NO marca los datos del participante como completos y NO muestra la pantalla de finalización predeterminada con el código de compensación.
Al utilizar esta acción para rechazar los datos de un participante, los usuarios deben mostrar un mensaje apropiado a los participantes que explique la razón por la que no serán recompensados por su tiempo.
Parámetros: Ninguno
Redirigir a URL Acción
Efecto: Redirige al participante a una URL específica.
Nota: La URL debe incluir el https:// al principio para que esta acción funcione.
Acciones de Control
Acciones de Requisito (If... Then... Else If) Acción
Efecto: Evalúa una declaración if-then y ejecuta una serie de acciones de forma dependiente. Cada declaración If / Else-If consiste en comparaciones anidadas AND / OR para evaluar si se cumplen todos los requisitos (la declaración es verdadera) o no (la declaración es falsa). Si la declaración es verdadera, se ejecutan las acciones bajo "Then".
Parámetros:
- Agregar Requisito: Agrega un nuevo requisito a una declaración. El menú "valor-seleccionar" aparecerá a ambos lados para realizar una comparación lógica. En el medio de la declaración, se puede elegir cómo deben compararse ambos lados (por ejemplo, igual, menor que, desigual, etc.).
- Agregar Grupo OR: Solo uno de todos los requisitos dentro de un Grupo OR tiene que ser verdadero para que todo el grupo sea verdadero. Agregue un grupo OR si las sub-acciones deben ejecutarse en varios casos.
- Agregar Grupo AND: Todos los requisitos dentro de un Grupo AND tienen que ser verdaderos para que todo el grupo sea verdadero. Agregue un grupo AND si las sub-acciones deben ejecutarse solo cuando se cumplan varios requisitos.
- Secuencia de Acción: Cada declaración If / Else-If tiene una lista de acciones, que se definen bajo "Then". La secuencia de acciones lista todas las acciones para una cierta declaración If / Else-If. Se puede agregar una nueva acción a través del ícono "Agregar Acción". La secuencia de acciones se ejecutará solo si se cumplen los requisito(s) de la declaración If / Else-if asociada.
- Agregar Caso Else-If: La Acción de Requisito puede consistir en varias declaraciones If / Else-If --> Then separadas. Sin embargo, solo se puede ejecutar una declaración. Si una declaración If / Else-If se evalúa positivamente (devuelve verdadero), se ejecutan las acciones en el bloque Then y el resto de la Acción de Requisito se omite.
- Agregar Caso Else (verdadero / falso): Si está habilitado, se agrega una opción predeterminada / de recuperación a la acción de requisito. Si ninguna de las declaraciones If / Else-If se ejecuta (devuelve verdadero), se ejecutarán las acciones definidas en el caso else.
Acciones Repetidas (While Loop) Acción
Efecto: Ejecuta repetidamente una serie de acciones, ya sea de inmediato o dentro de un intervalo definido. Se puede especificar una condición de parada para detener la ejecución del bucle.
Parámetros:
- Tipo de Ejecución: Elija entre ejecución inmediata o ejecución programada.
- Ejecutar bucle completo: Esto ejecutará el bucle continuamente hasta que se cumpla la condición de parada.
- Ejecutar cada ... ms: Esto ejecutará el bucle con un intervalo definido (por ejemplo, el bucle se ejecuta cada 50 ms).
- Definir el número de bucles: Cuando se selecciona "Ejecutar cada ... ms", los usuarios tienen la opción de asignar un valor entero numérico para el número de veces que se debe ejecutar el bucle. Esto reemplaza la necesidad de definir una condición de parada.
- Intervalo de Ejecución: Esto determina el intervalo de ejecución.
- Comenzar de inmediato (verdadero / falso): Si está habilitado, esto ejecutará el bucle de inmediato. Si está deshabilitado, el bucle comenzará en el siguiente intervalo de ejecución.
- Permitir múltiples inicios (verdadero / falso): Si está habilitado, se pueden iniciar varias instancias del bucle en paralelo. Si está deshabilitado, solo se puede ejecutar una instancia del bucle a la vez.
- Habilitar condición de parada (verdadero / falso): Si está habilitado, se puede especificar una condición de parada para el bucle.
- Condición de Parada: La condición de parada se puede utilizar para especificar una expresión lógica sobre cuándo debe detenerse la ejecución del bucle. Similar a las declaraciones If / Else-If, se pueden combinar grupos AND, grupos OR y requisitos para la comparación lógica.
- Secuencia de Acción: La secuencia de acciones lista todas las acciones que se ejecutan en cada iteración del bucle. Se puede agregar una nueva acción a través del ícono "Agregar Acción".
Acciones Demoradas (Time Callback) Acción
Efecto: Ejecuta una serie de acciones después de un cierto retraso de tiempo.
Parámetros:
- Tipo de Retraso: Elija entre un retraso fijo o un retraso variable.
- Retraso Fijo: Las acciones se ejecutarán después de un retraso fijo.
- Retraso Variable: Las acciones se ejecutarán después de un retraso especificado en una variable (numérica).
- Retraso: La duración del retraso en milisegundos (ms).
- Secuencia de Acción: La secuencia de acciones lista todas las acciones que se ejecutan después del retraso de tiempo especificado. Se puede agregar una nueva acción a través del ícono "Agregar Acción".
Grupo de Acciones
Las acciones también se pueden organizar en grupos de acciones. Los grupos de acciones permiten agrupar ciertas acciones juntas para una estructura visual más fácil, pero también si se desea copiar, duplicar o eliminar varias acciones a la vez.
Acciones API
Si necesitas enviar o comunicar datos desde un servidor externo a Labvanced, entonces se pueden usar ‘Acciones API’ y ‘Disparadores API’. Tienes las siguientes acciones disponibles bajo esta categoría:
- Enviar PostMessage
- Enviar a Websocket
- Enviar a OpenAI
Para que estas acciones estén ‘disponibles’ o sean utilizables, debes ingresar una clave de API en la pestaña Settings.

Enviar Acción PostMessage
La acción Send PostMessage envía un mensaje de un experimento Labvanced en ejecución a un objetivo externo, como una página web padre o un marco incrustado, utilizando la API postMessage del navegador.
Enviar a Websocket Acción

Al seleccionar esta acción, aparecen las siguientes opciones:

El ejemplo anterior y la estructura completa del evento se pueden acceder aquí: https://www.labvanced.com/page/library/51053 haciendo clic en ‘Inspeccionar.’
| Ítem del Menú | Descripción |
|---|---|
| Enviar a: | Especifica la Dirección del Websocket que está listada en la pestaña Settings bajo Special Features. |
| Disparador / mensaje a enviar: | Especifica el disparador o mensaje que deseas enviar. |
| Enviar Variable (opcional): | Indica la variable que también se puede enviar como parte de la acción. |
Para más información sobre el acceso API, por favor visita esta página.
Enviar a OpenAI Acción
La acción ‘Enviar a OpenAI’ permite enviar información, como un valor de entrada de cadena, a OpenAI. Por favor nota que para que esta opción esté disponible, debes listar tu clave de API en la pestaña Settings bajo Special Features.

Las siguientes opciones aparecerán al hacer clic en este evento:

Aquí hay un ejemplo funcional de cómo se ve este evento cuando se proporciona toda la información necesaria:

Para una mejor comprensión de cómo puede utilizar esta función y verla en acción, no dude en ponerse en contacto con nosotros para una demostración enviando este formulario de contacto.
NOTA: También consulte esta guía donde construimos un estudio paso a paso, integrando ChatGPT en un estudio y utilizando esta acción.
Aquí hay una explicación más profunda de los campos incluidos en la acción 'Enviar a OpenAI':
| Elemento de menú | Área de menú | Opciones de acción 'Enviar a OpenAI' |
|---|---|---|
Model Type | ![]() | |
Chat History Dataframe | ![]() | Enlace a una variable de marco de datos con dos columnas. La primera columna denota el ‘rol’ y la segunda columna el ‘mensaje de chat.’ Los valores de la acción se agregarán automáticamente al marco de datos que está vinculado aquí. El marco de datos también se puede manipular con acciones de marco de datos. Para más referencia, por favor consulte la documentación de OpenAI. |
Insert Message ‘+’ | ![]() | Al hacer clic en esto, aparecerá el cuadro de diálogo de variable. Necesitará indicar qué valor de ‘Variable’ se está enviando a OpenAI, así como el 'rol' del mensaje asociado:
|
Como OpenAI está evolucionando a diario, consulte la documentación de OpenAI para más aclaraciones.
Acciones de código
En algunos casos, su experimento puede requerir que use código personalizado. Con estas acciones, ¡puede hacer precisamente eso! Las siguientes opciones están disponibles en el menú 'Acciones de código':
- Ejecutar JavaScript
- Establecer CSS global

Acción Ejecutar JavaScript
La acción 'Ejecutar JavaScript' le permite programar eventos específicos y leer/establecer variables de Labvanced en su estudio ingresando JavaScript personalizado que se ejecutará como una acción cuando se active.

Cuando se selecciona la acción 'Ejecutar JavaScript', verá un área (un editor de código) donde se debe escribir el código JavaScript, así como instrucciones sobre cómo usarlo:

Acción Establecer CSS Global
Con la acción 'Establecer CSS Global', puede usar código CSS personalizado para cambiar un aspecto del estudio al activarse un desencadenador.

El siguiente campo se abre al hacer clic en esta acción:

Un ejemplo de usar la acción 'Establecer CSS Global' sería cambiar el color de fondo del estudio cuando un participante selecciona un color específico de una pregunta de opción múltiple.
Acción Pegar
Esta opción le permite pegar una acción que ha creado y copiado previamente. Le permite trabajar más rápido al diseñar su experimento para que no tenga que seguir seleccionando los mismos elementos una y otra vez. Por ejemplo, si tiene un evento que es similar a uno que ya existe, puede simplemente copiarlo, pegarlo, y modificarlo, en lugar de construirlo desde el principio.
El Menú de Selección de Valores
Al trabajar con ciertos eventos, notará que aparece un icono de pluma. Esto se llama el Menú de Selección de Valores porque le permite seleccionar e instruir qué tipo de valores deben ser registrados o deben ser rastreados. Es una opción muy poderosa e importante que seguro usará para su diseño y configuración experimental.
Este icono de pluma / Menú de Selección de Valores aparece en varias ubicaciones para ciertas acciones en el sistema de eventos, como la acción Establecer / Registrar Variable, la acción Establecer Propiedad de Objeto, y la acción Requisito (Si... Entonces), como se muestra a continuación.

Hacer clic en el icono de pluma lleva a un menú desplegable donde se especifica el valor que se va a leer o escribir. El menú desplegable siempre comenzará enumerando una opción de valor específica del desencadenador y luego continuará con las otras 5 categorías (Tiempo Actual, Valor Constante, Variable, Marco / Tarea / Opción, y Operaciones), todas las cuales tienen sus propias opciones. Estas se describirán más abajo.

La imagen anterior muestra cómo se ve el Menú de Selección de Valores cuando se está utilizando un Desencadenador de Ratón. Como puede ver, el primer elemento del menú a la izquierda comienza con una categoría específica del desencadenador y luego avanza a las otras 5 categorías (Tiempo Actual, etc).
Opciones del Menú
La tabla a continuación explica más a fondo las categorías y opciones:
| Categoría | Opciones | Descripción |
|---|---|---|
Trigger-specific | Depende del tipo de desencadenador que ha seleccionado previamente para el evento. | Según el desencadenador que haya seleccionado para un evento, tendrá una lista específica de opciones que aparecerá en la parte superior del menú de selección de valores para elegir. Por favor, consulte la sección sobre Valores específicos del desencadenador para ver una lista completa de opciones y descripciones. |
Current Time | Medir y llamar valores de tiempo. | |
Constant Value |
| Asignar valores constantes según el tipo de variable que necesite, como cadena o numérico. Estos se utilizan a veces en combinación con otras opciones como Arithmetic para crear contadores. |
Variable |
| Especificar o referirse a una variable o seleccionar un valor de un array o marco de datos. |
Frame / Task / Object |
| Le permite obtener valores asociados con propiedades de objeto, el marco, el seguimiento ocular (si está activado) y el dispositivo (frecuencia de actualización de la pantalla). |
Operations |
| Utilice operaciones para realizar cambios especificados en sus variables, como combinar valores de variables, transformar cadenas para que estén todas en minúsculas, o ejecutar operaciones matemáticas. |
Valores de Tiempo Actual
Con la opción 'Tiempo Actual' puede registrar o referirse a valores en relación con el tiempo.
Las siguientes opciones están disponibles:
Tiempo Actual: Marca de Tiempo UNIX
Este valor captura una marca de tiempo en formato UNIX en milisegundos.
Tiempo Actual: Tiempo Desde el Inicio del Marco
Este valor captura la cantidad de tiempo que ha transcurrido desde el inicio del marco. La mayoría de las veces, esto equivale al tiempo de reacción.
Valores constantes
Asigne valores constantes según el tipo de variable que necesite, como cadena o numérico. Estos a veces se utilizan en combinación con otras opciones como Arithmetic para crear contadores.
Las siguientes opciones están disponibles:
Constante: Cadena
Asigna un valor de cadena / texto.
Constante: Numérico
Asigna un valor numérico / de número.
Constante: Booleano
Asigna un valor de verdadero o falso.
Constante: Categórico
Asigna un valor de nivel (principalmente para factores).
Constante: Fecha
Asigna un valor de fecha.
Constante: Hora
Asigna un valor de hora.
Constante: Color
Asigna un valor de color (cadena hex).
Valores de variables
Especifique o haga referencia a una variable o seleccione un valor de un arreglo o marco de datos. Las siguientes opciones están disponibles:
Seleccionar Variable
Le permite seleccionar y apuntar a una variable.
Seleccionar Valor de Arreglo
Le permite seleccionar un valor de un arreglo.
Seleccionar Valor de Marco de Datos
Le permite seleccionar un valor de un marco de datos que ha creado.
Valores de Marco / Tarea / Objeto
Le permite obtener valores asociados con las propiedades del objeto, el marco, el seguimiento ocular (si está activado) y el dispositivo (tasa de refresco de la pantalla).
Propiedad del objeto
Lee una propiedad de objeto.
Marco
| Opciones de valor de marco | Descripción |
|---|---|
Last cached Mouse X Position | El último valor de coordenada X del mouse del participante. |
Last cached Mouse Y Position | El último valor de coordenada Y del mouse del participante. |
Last cached Mouse [X,Y] Array | El último valor de coordenada [X,Y] del mouse del participante en formato de arreglo. |
Frame Name | El nombre del marco. |
Seguimiento ocular
| Opciones de valor de seguimiento ocular | Descripción |
|---|---|
Last cached Coordinate X | El último valor de coordenada X de la mirada del participante. |
Last cached Coordinate Y | El último valor de coordenada Y de la mirada del participante. |
Last cached Coordinate [X,Y] Array | El último valor de coordenada [X,Y] de la mirada del participante en formato de arreglo. |
Last cached Coordinate + Time [X,Y,T] Array | El último valor de coordenada [X,Y] de la mirada del participante, más el valor de captura de cámara T en formato de arreglo. |
Dispositivo
- Tasa de refresco: El valor de la tasa de refresco del dispositivo del participante.
Operaciones
Utilice operaciones para realizar cambios específicos en sus variables, como combinar valores de variables, transformar cadenas para que estén en minúsculas o realizar operaciones matemáticas.
Las siguientes opciones están disponibles:
Aritmética
Las operaciones aritméticas son útiles para muchos propósitos diferentes, incluidos la combinación de cadenas e incluso la modificación de propiedades de objetos.

Esencialmente, la operación aritmética le permite realizar operaciones en múltiples valores.
Al seleccionar esta opción, se verá un icono adicional de bolígrafo (es decir, Menú de selección de valores), así como una lista de operaciones, como la adición.

Los valores se pueden manipular utilizando estas 5 operaciones diferentes:
- (+) adición
- (-) sustracción
- (/) división
- (*) multiplicación
- (%) módulo
El siguiente ejemplo muestra cómo utilizar operaciones aritméticas para crear una nueva variable de cadena (en el botón verde), llamada 'intermediateVar'.

El nuevo valor de la variable (de 'intermediateVar') está definido utilizando varias operaciones aritméticas junto con una combinación de variables creadas previamente (es decir, 'userChatName' y 'chatInput'), junto con valores de cadena constantes, es decir, el punto y coma : y el espacio en blanco <br>. Esta acción crea el efecto de un chat de usuario que se puede utilizar en un estudio multusuario.
Operación de cadena
| Opciones de operación de cadena | Descripción |
|---|---|
To Lowercase | Cambia todas las letras en una variable de cadena a letras minúsculas. → Ej: (AAABBB) se transforma en (aaabbb) |
To Uppercase | Cambia todas las letras en una variable de cadena a letras mayúsculas. → Ej: (aaabbb) se transforma en (AAABBB) |
To Link | Transforma la cadena en una variable en una URL que se abre en otra ventana |
Remove Whitespaces | Elimina cualquier espacio entre las letras en una variable de cadena. → Ej: (aaa bbbb cccc) se transforma en (aaabbbbccc) |
Trim Whitespaces | Elimina los espacios al principio de una variable de cadena. → Ej: ( aaabbbcccc) se transforma en (aaabbbcccc) |
Replace Substring Regexp | Reemplaza ciertas letras en una variable de valor de cadena. → Ej: (aaabbbccc) reemplaza bbb por xxx, lo que transforma el valor a (aaaxxxccc) |
Operación matemática
Realiza una operación matemática en un valor escalar.
| Opciones de operación matemática | Descripción |
|---|---|
abs | Devuelve el número absoluto de un valor. |
sqrt | Devuelve la raíz cuadrada de un valor. |
round | Devuelve el valor redondeado con 0 a 3 decimales. |
floor | Devuelve el valor redondeado hacia abajo. |
ceil | Devuelve el valor redondeado hacia arriba. |
cos | Devuelve el valor del coseno. |
sin | Devuelve el valor del seno. |
tan | Devuelve el valor de la tangente. |
Valores específicos del desencadenador
Los valores específicos del desencadenador se refieren a valores que están asociados con el desencadenador definido dentro de un evento particular. Por ejemplo, si su evento utiliza un desencadenador de mouse, entonces, en ciertas áreas donde se especifica la acción (como al usar una Set / Record Variable acción o una Set Object Property acción), puede hacer referencia a los valores específicos del desencadenador de mouse en el menú de selección de valores.
En el siguiente ejemplo, se utilizan valores específicos del desencadenador para un desencadenador de mouse para registrar valores x e y y un arreglo [X,Y] utilizando una Set / Record Variable acción.

A continuación se muestra una tabla de todos los tipos de valores específicos del desencadenador que se pueden encontrar en Labvanced, seguida de una explicación detallada de cada opción.
| Nombre | Opciones de valor - Resumen |
|---|---|
Trigger (Mouse) |
|
Trigger (Keyboard) |
|
Trigger (Button Bar) |
|
Trigger (Enter On Input) |
|
Trigger (Scroll) |
|
Trigger (Gamepad/ Joystick) |
|
Trigger (Eyetracking Gaze) |
|
Trigger (Eyetracking Fixation) |
|
Trigger (Head Tracking) |
|
Trigger (On Task Initialization) |
|
Trigger (On Frame Init) |
|
Trigger (on Frame Start) |
|
Trigger (On Frame End) |
|
Trigger (Variable Value Changed) |
|
Trigger (Media Object Trigger) |
|
Trigger (Websocket Trigger) |
|
Trigger (OpenAI Trigger) |
|
Trigger (PostMessage Received) |
|
Trigger (Global Experiment Event) |
|
Trigger (User Leaves Experiment) |
|
Valores de disparo (Mouse)
Cuando se utiliza un disparo de mouse, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:

| Opciones de disparo (Mouse) | Descripción |
|---|---|
Mouse X | Devuelve la posición actual del Mouse X en coordenadas de marco. |
Mouse Y | Devuelve la posición actual del Mouse Y en coordenadas de marco. |
Mouse [X,Y] Array | Las coordenadas de mouse [X,Y] en formato de arreglo. |
Stimulus Name | El nombre del objeto que activó el evento (por ejemplo, qué imagen fue clickeada). |
Stimulus Info | La información del estímulo del objeto que activó el evento. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo. |
Valores de disparo (Teclado)
Cuando se utiliza un disparo de teclado, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:
| Opciones de disparo (Teclado) | Descripción |
|---|---|
Id of Key | El valor ID de la tecla que fue presionada como disparo. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo. |
Valores de disparo (Barra de Botones)
Cuando se utiliza un disparo de clic en botón, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:
| Opciones de disparo (Barra de Botones) | Descripción |
|---|---|
Stimulus Name | El nombre del objeto botón que activó el evento. |
Stimulus Info | La información del estímulo del objeto botón que activó el evento. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo. |
Valores de disparo (Enter en Entrada)
Cuando se utiliza un disparo de Enter en Entrada, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:
| Opciones de disparo (Enter en Entrada) | Descripción |
|---|---|
Id of Key | El valor ID de la tecla que fue presionada como disparo. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo. |
Valores de disparo (Desplazamiento)
Cuando se utiliza un disparo de desplazamiento, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:
| Opciones de disparo (Desplazamiento) | Descripción |
|---|---|
Stimulus Name | El nombre del objeto botón que activó el evento. |
Stimulus Info | La información del estímulo del objeto botón que activó el evento. |
Scroll Position X | La posición de desplazamiento en X del mouse cuando se activó el evento. |
Scroll Position Y | La posición de desplazamiento en Y del mouse cuando se activó el evento. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo de desplazamiento en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo de desplazamiento. |
Valores de disparo (Gamepad/Joystick)
Cuando se utiliza un Gamepad/Joystick trigger, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:

| Opciones de disparo (Gamepad/Joystick) | Descripción |
|---|---|
Gamepad Device Id | El ID o nombre del gamepad que está conectado. |
Pressed Keys (Array) | Las teclas que fueron presionadas. |
Pressed OR Hold Keys (Array) | Las teclas que fueron presionadas o mantenidas. |
Released Keys (Array) | Las teclas que fueron liberadas. |
Axes (Array) | Los valores de los ejes. |
Gamepad Timestamp (Unixtime) | La marca de tiempo del gamepad en tiempo Unix. |
Trigger Timestamp (Unixtime) | Marca de tiempo de cuándo ocurre el disparo en tiempo Unix. |
Trigger Time (From Frame Onset) | Marca de tiempo en tiempo Unix de cuándo ocurre el disparo en relación con el inicio del marco. |
Valores de disparo (Gaze de Seguimiento Ocular)
Cuando se utiliza un disparo de mirada de seguimiento ocular, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:

| Opciones de disparo (Gaze de Seguimiento Ocular) | Descripción |
|---|---|
Coordinate X | El valor de la coordenada X de la mirada. |
Coordinate Y | El valor de la coordenada Y de la mirada. |
Coordinate [X,Y] Array | Las coordenadas de la mirada X,Y en formato de arreglo. |
Stimulus Name | El nombre del estímulo que inició el disparo de mirada. |
Stimulus Info | La información del estímulo detrás del estímulo que inició el disparo de mirada. |
Camera Capture Time T | El momento exacto en que ocurrió la instantánea. En el pipeline de seguimiento ocular de Labvanced, primero ocurre una instantánea de la cámara antes de que el algoritmo y la red neuronal realicen cálculos de mirada. Por lo tanto, Camera Capture Time T es una marca de tiempo UNIX de cuándo ocurrió la instantánea inicial. Para obtener más información sobre la tecnología detrás de nuestro seguimiento ocular basado en webcam, consulte nuestra página de tecnología ET. |
Gaze Confidence C | Este valor varía de 0 a 1 y se refiere a la confianza y probabilidad de que haya un ojo abierto en la instantánea de la imagen y, esencialmente, sirve como un ‘detector de parpadeo’. Consulte nuestro artículo revisado por pares publicado para obtener más detalles. |
Coord. + Time [X,Y,T] Array | Un arreglo que contiene las coordenadas x/y de la mirada y la marca de tiempo del tiempo de captura de la cámara (T) como se describió anteriormente. |
Coord. + Time + Confidence [X,Y, T,C] Array | Un arreglo que contiene las coordenadas x/y de la mirada y la marca de tiempo del tiempo de captura de la cámara (T) y la confianza de la mirada (C) como se describió anteriormente. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo de mirada en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo de mirada. |
Valores de disparo (Fijación de Seguimiento Ocular)
Cuando se utiliza un disparo de fijación de seguimiento ocular, se pueden llamar los siguientes valores específicos del disparo al trabajar con ciertas acciones:
| Opciones de disparo (Fijación de Seguimiento Ocular) | Descripción |
|---|---|
Fixation Centroid X | El punto central de la fijación como un valor X. |
Fixation Centroid Y | El punto central de la fijación como un valor Y. |
Fixation Duration | La duración de la fijación detectada. |
Fixation Start Time | El tiempo de inicio de la fijación detectada. |
Fixation End Time | El tiempo de finalización de la fijación detectada. |
Fixation Dispersion | Se refiere a cuán dispersos están los valores de la mirada dentro de una fijación detectada. |
Stimulus Name | El nombre del objeto botón que activó el evento. |
Stimulus Info | La información del estímulo del objeto botón que activó el evento. |
[X, Y, Dur, Start, End, Disp] | Un arreglo de lo siguiente: valores x- e y- del centroide de la fijación, la duración de la fijación, el tiempo de inicio, el tiempo de finalización y el valor de dispersión. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo ocurrió el disparo de fijación en formato de tiempo Unix con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el inicio de la aparición del marco hasta que ocurrió el disparo de fijación. |
Valores del Trigger (Seguimiento de Cabeza)
Cuando se utiliza un trigger de Seguimiento de Cabeza, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Seguimiento de Cabeza) | Descripción |
|---|---|
Camera Capture Time T | Cuando la cámara capturó el cuadro, es decir, un timestamp unix de cuándo ocurrió la captura del cuadro. Este es el momento en que la imagen / cuadro fue capturado antes de que ocurriera cualquier procesamiento. |
Facemesh Dataframe | Un cuadro de datos que contiene los 468 puntos de referencia faciales detectados por el modelo de malla facial. Cada fila representa un punto de referencia con sus coordenadas x, y, y z en el espacio de cuadro normalizado. Utiliza este valor para acceder a la geometría facial detallada por cuadro, como puntos de referencia de labios, ojos o mandíbula. |
Head Turn | Giro de la cabeza de izquierda a derecha, esto se refiere al yaw en la literatura. |
Head Tilt | Inclinación de la cabeza de arriba a abajo, conocido como pitch de cabeza en la literatura. |
Head Roll | Captura el movimiento de la cabeza girando de un lado a otro. |
Head Position [X,Y, T] Array | Este array captura los valores numéricos asociados con la posición de la cabeza, incluyendo las coordenadas x y y para el centro de la cabeza junto con la variable de timestamp (T). |
Nose Position [X,Y, T] Array | Este array captura los valores numéricos asociados con la posición de la nariz específicamente, incluyendo las coordenadas x y y para donde está ubicada la nariz junto con la variable de timestamp (T) de cuándo ocurrió la medición. |
Nose Vector [X,Y, Z, T] Array | Esta medición funciona proyectando un vector desde la punta de la nariz y es útil para probar si el participante está atendiendo a la pantalla (esto es especialmente importante para estudios donde el seguimiento ocular no está habilitado). Por lo tanto, si la nariz apunta fuera de pantalla (es decir, el participante no está atendiendo al experimento), el valor Z disminuye de 1 y se acerca a 0. |
Trigger Timestamp (Unixtime) | Punto de tiempo durante el experimento cuando ocurre el trigger donde se detectó el seguimiento de cabeza y cuenta cuándo ocurrió el trigger en el sistema. Esencialmente, este es el momento donde se procesa la imagen / cuadro y este valor se ve afectado en gran medida por la tarjeta gráfica del participante. En teoría, debería estar lo más cerca posible del valor T. |
Trigger Time from Frame Onset | Este es el valor de tiempo de cuándo ocurrió el trigger en relación con cuándo sucedió el comienzo del cuadro. |
Valores del Trigger (Inicialización de Tarea)
Cuando se utiliza un Trigger de Inicialización de Tarea, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Inicialización de Tarea) | Descripción |
|---|---|
Trigger Timestamp (Unixtime) | El Timestamp Unix del trigger en milisegundos. |
Trigger Time (From Frame Onset) | El tiempo en milisegundos de cuándo ocurrió el trigger desde el comienzo del cuadro. |
Valores del Trigger (Inicialización de Cuadro)
Cuando se utiliza un Trigger de Inicialización de Cuadro, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Inicialización de Cuadro) | Descripción |
|---|---|
TrialNr | El Número de Ensayo de cuándo ocurrió el Trigger de Inicialización de Cuadro. |
Trigger Timestamp (Unixtime) | El Timestamp Unix del trigger en milisegundos. |
Trigger Time (From Frame Onset) | El tiempo en milisegundos de cuándo ocurrió el trigger desde el comienzo del cuadro. |
Valores del Trigger (al Comienzo del Cuadro)
Cuando se utiliza un Trigger al Comienzo del Cuadro, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (al Comienzo del Cuadro) | Descripción |
|---|---|
Trigger Timestamp (Unixtime) | El Timestamp Unix del trigger en milisegundos. |
Trigger Time (From Frame Onset) | El tiempo en milisegundos de cuándo ocurrió el trigger desde el comienzo del cuadro. |
Valores del Trigger (al Fin del Cuadro)
Cuando se utiliza un Trigger al Fin del Cuadro, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (al Fin del Cuadro) | Descripción |
|---|---|
Total Frame Time | El tiempo total en milisegundos que se pasó en el cuadro. |
Trigger Timestamp (Unixtime) | El Timestamp Unix del trigger en milisegundos. |
Trigger Time (From Frame Onset) | El tiempo en milisegundos de cuándo ocurrió el trigger desde el comienzo del cuadro. |
Valores del Trigger (Valor de Variable Cambiado)
Cuando se utiliza un Trigger de Valor de Variable Cambiado, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Valor de Variable Cambiado) | Descripción |
|---|---|
New Value in Variable | Se refiere al nuevo valor de una variable. |
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de cambio de variable en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el cambio del valor de la variable. |
Valores del Trigger (Trigger de Objeto de Medios)
Cuando se utiliza un Trigger de Objeto de Medios, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Trigger de Objeto de Medios) | Descripción |
|---|---|
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de objeto de medios en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el trigger de objeto de medios. |
Valores del Trigger (Trigger de Websocket)
Cuando se utiliza un Trigger de Websocket, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Trigger de Websocket) | Descripción |
|---|---|
Message | Un mensaje que se puede usar para describir y etiquetar, lo que te permite (en el extremo receptor) filtrar entre diferentes tipos de datos. |
Data | Un valor que puede contener diferentes tipos de datos, como elecciones del participante, timestamps, coordenadas del mouse x/y, etc. |
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de Websocket en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el trigger de WebSocket. |
Valores del Trigger (Trigger de OpenAI)
Cuando se utiliza un Trigger de OpenAI, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Trigger de OpenAI) | Descripción |
|---|---|
Chat GPT Answer | El valor de la respuesta de ChatGPT. |
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de OpenAI en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el trigger de OpenAI. |
Valores del Trigger (Mensaje Post recibido)
Cuando se utiliza un trigger de Mensaje Post Recibido, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Mensaje Post recibido) | Descripción |
|---|---|
Message Content | La carga de datos del postMessage recibido, tal como la envió la fuente externa. |
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de Mensaje Post Recibido en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el trigger. |
Valores del Trigger (Evento Global del Experimento)
Cuando se utiliza un Trigger de Pausa / Reanudar Experimento, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Evento Global del Experimento) | Descripción |
|---|---|
Total Frame Time | Se refiere al Tiempo Total del Cuadro asignado antes del Trigger. |
Reason for Global Event | Un valor de cadena que indica la razón del trigger, como cuando un participante abandona el estudio. |
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de Evento Global en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el trigger de Evento Global. |
Valores del Trigger (Usuario Sale del Experimento)
Cuando se utiliza un Trigger de Participante que Salió del Estudio Multijugador, se pueden llamar los siguientes valores específicos del trigger al trabajar con ciertas acciones:
| Opciones del Trigger (Usuario Sale del Experimento) | Descripción |
|---|---|
Remaining Number of Participants | El número de participantes que quedan en el estudio. |
Trigger Timestamp (Unixtime) | El timestamp de cuándo ocurrió el trigger de Usuario Sale del Experimento en formato Unix Time con milisegundos. |
Trigger Time (From Frame Onset) | El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del cuadro hasta cuándo ocurrió el trigger de Usuario Sale del Experimento. |










