Menú de Selección de Valores | Selección y asignación de valores en eventos

Al trabajar con ciertos eventos, notarás que aparece un ícono de lápiz. Esto se llama el Menú de Selección de Valores porque te permite seleccionar e instruir qué tipo de valores se deben registrar o seguir. Es una opción muy poderosa e importante que seguramente utilizarás para tu diseño experimental y configuración.

Este ícono de lápiz / Menú de Selección de Valores aparece en varias ubicaciones para ciertas acciones en el sistema de eventos, como la acción de Establecer / Registrar Variable, la acción de Establecer Propiedad del Objeto, y la acción de Requerimiento (Si... Entonces), como se muestra a continuación.

La ubicación de selección de valores en Labvanced.

Hacer clic en el ícono de lápiz lleva a un menú desplegable donde especificas el valor que se debe leer o escribir. El menú desplegable siempre comenzará listando una opción de valor específica para la activación y luego continuará con las otras 5 categorías (Hora Actual, Valor Constante, Variable, Marco / Tarea / Opción, y Operaciones), todas las cuales tienen sus propias opciones. Estas se describirán más adelante.

El Menú de Selección de Valores en Labvanced

La imagen anterior muestra cómo se ve el Menú de Selección de Valores cuando se utiliza un Trigger de Mouse. Como puedes ver, el primer elemento del menú a la izquierda comienza con una categoría específica de activación y luego pasa a las otras 5 categorías (Hora Actual, etc.).

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 activación que hayas seleccionado previamente para el evento.	Basado en la activación que has seleccionado para un evento, tendrás una lista específica de opciones que aparecerá en la parte superior del menú de selección de valores para elegir. Por favor, consulta la sección sobre Valores específicos de activación para ver una lista completa de opciones y descripciones.
`Current Time`	Marca de Tiempo UNIX Tiempo Desde el Inicio del Marco	Mide y llama valores de tiempo.
`Constant Value`	Cadena Numérico Booleano Categórico Fecha Hora Color	Asigna valores constantes basados en el tipo de variable que necesitas, como cadena o numérica. Estos a veces se utilizan en combinación con otras opciones como `Arithmetic` para crear contadores.
`Variable`	Seleccionar Variable Seleccionar Valor de Array Seleccionar Valor de Marco de Datos	Especifica o refiere a una variable o selecciona un valor de un array o marco de datos.
`Frame / Task / Object`	Propiedad del Objeto Marco Seguimiento Ocular Dispositivo	Te permite obtener valores asociados con propiedades de objetos, el marco, seguimiento ocular (si está activado) y el dispositivo (tasa de refresco de la pantalla).
`Operations`	Aritmética Operación de Cadena Operación Matemática	Utiliza operaciones para realizar cambios específicos en tus variables, como combinar valores de variables, transformar cadenas para que estén todas en minúsculas, o ejecutar operaciones matemáticas.

Valores de Hora Actual

Con la opción ‘Hora Actual’ puedes registrar o referirte a valores con respecto al tiempo.

Las siguientes opciones están disponibles:

Marca de Tiempo UNIX
Tiempo Desde el Inicio del Marco

Hora Actual: Marca de Tiempo UNIX

Este valor captura una marca de tiempo en formato UNIX en milisegundos.

Hora Actual: Tiempo Desde el Inicio del Marco

Este valor captura la cantidad de tiempo que ha transcurrido desde el inicio del marco. Más a menudo, esto es equivalente al tiempo de reacción.

Valores Constantes

Asigna valores constantes basados en el tipo de variable que necesitas, como cadena o numérica. Estos a veces se utilizan en combinación con otras opciones como Arithmetic para crear contadores.

Las siguientes opciones están disponibles:

Cadena
Numérico
Booleano
Categórico
Fecha
Hora
Color

Constante: Cadena

Asigna un valor de cadena / texto.

Constante: Numérico

Asigna un valor numérico / 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 hexadecimal).

Valores de Variables

Especifica o refiere a una variable o selecciona un valor de un array o marco de datos. Las siguientes opciones están disponibles:

Seleccionar Variable
Seleccionar Valor de Array
Seleccionar Valor de Marco de Datos

Seleccionar Variable

Te permite seleccionar y señalar a una Variable.

Seleccionar Valor de Array

Te permite seleccionar un valor de un array.

Seleccionar Valor de Marco de Datos

Te permite seleccionar un valor de un marco de datos que has creado.

Valores de Marco / Tarea / Objeto

Te permite obtener valores asociados con propiedades de objetos, el marco, seguimiento ocular (si está activado) y el dispositivo (tasa de refresco de la pantalla).

Propiedad del Objeto
Marco
Seguimiento Ocular
Dispositivo

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 un formato de array.
`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 un formato de array.
`Last cached Coordinate + Time [X,Y,T] Array`	El último valor de coordenada [X,Y] de la mirada del participante, más el valor T de Captura de Cámara en un formato de array.

Dispositivo

Tasa de Refresco: El valor de la tasa de refresco del dispositivo del participante.

Operaciones

Utiliza operaciones para realizar cambios específicos en tus variables, como combinar valores de variables, transformar cadenas para que estén todas en minúsculas, o ejecutar operaciones matemáticas.

Las siguientes opciones están disponibles:

Aritmética
Operación de Cadena
Operación Matemática

Aritmética

Las operaciones aritméticas son útiles para muchos propósitos diferentes, incluyendo la combinación de cadenas e incluso la modificación de propiedades de objetos.

El menú de Aritmética en Labvanced.

Esencialmente, la operación aritmética te permite realizar operaciones en múltiples valores.

Al seleccionar esta opción, aparecerá un ícono de lápiz adicional (es decir, Menú de Selección de Valores), así como una lista de operaciones, como la suma.

La ubicación de la opción de Aritmética en Labvanced.

Los valores pueden ser manipulados utilizando estas 5 operaciones diferentes:

(+) suma
(-) resta
(/) división
(*) multiplicación
(%) módulo

El siguiente ejemplo muestra cómo utilizar operaciones aritméticas para crear una nueva variable de tipo cadena (en el botón verde), llamada 'intermediateVar'.

Ejemplo de operaciones aritméticas que se utilizan para crear una nueva variable de tipo cadena.

El valor de la nueva variable (de 'intermediateVar') se define utilizando varias operaciones aritméticas junto con una combinación de variables previamente creadas (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 usar en un estudio con múltiples usuarios.

Operación-Cadena

Opciones de Operación-Cadena	Descripción
`To Lowercase`	Cambia todas las letras en una variable de tipo cadena a letras minúsculas. → Ej: (AAABBB) se transforma en (aaabbb)
`To Uppercase`	Cambia todas las letras en una variable de tipo 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 tipo cadena. → Ej: (aaa bbbb cccc) se transforma en (aaabbbbccc)
`Trim Whitespaces`	Elimina los espacios al inicio de una variable de tipo cadena. → Ej: ( aaabbbcccc) se transforma en (aaabbbcccc)
`Replace Substring Regexp`	Reemplaza ciertas letras en una variable de valor de cadena. → Ej: (aaabbbccc) reemplaza bbb con xxx lo que transforma el valor a (aaaxxxccc)

Operación-Matemática

Realiza una operación matemática sobre 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 truncado.
`ceil`	Devuelve el valor elevado.
`cos`	Devuelve el valor del coseno.
`sin`	Devuelve el valor del seno.
`tan`	Devuelve el valor de la tangente.

Valores Específicos del Trigger

Los valores específicos del trigger se refieren a los valores que están asociados con el trigger definido dentro de un evento particular. Por ejemplo, si su evento utiliza un trigger 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 trigger de mouse en el menú de selección de valores.

En el ejemplo a continuación, se utilizan valores específicos del trigger para un mouse para registrar los valores de x e y y una matriz [X,Y] utilizando una Set / Record Variable acción.

Demostrando cómo se utilizan los valores específicos de disparador de mouse para capturar el seguimiento del mouse.

A continuación se presenta una tabla de todos los tipos de valores específicos del trigger que se pueden encontrar en Labvanced, seguida de una explicación detallada de cada opción.

Nombre	Opciones de Valor - Resumen
`Trigger (Mouse)`	Mouse X Mouse Y Mouse [X,Y] Array Nombre del Estímulo Información del Estímulo Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Keyboard)`	Id de la Tecla Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Button Bar)`	Nombre del Estímulo Información del Estímulo Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Enter On Input)`	Id de la Tecla Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Scroll)`	Nombre del Estímulo Información del Estímulo Posición de Scroll X Posición de Scroll Y Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Gamepad/ Joystick)`	Id del Dispositivo de Gamepad Teclas Presionadas (Matriz) Teclas Presionadas o Sostenidas (Matriz) Teclas Liberadas (Matriz) Ejes (Matriz) Marca de tiempo del Gamepad (Unixtime) Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Eyetracking Gaze)`	Coordenada X Coordenada Y Coordenada [X,Y] Array Nombre del Estímulo Información del Estímulo Tiempo de Captura de Cámara T Confianza de la Mirada C Coordenada + Tiempo [X,Y, T] Array Coordenada + Tiempo + Confianza [X,Y, T,C] Array Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Eyetracking Fixation)`	Centróide de Fijación X Centróide de Fijación Y Duración de la Fijación Tiempo de Inicio de Fijación Tiempo de Fin de Fijación Dispersión de la Fijación Nombre del Estímulo Información del Estímulo [X,Y, Dur, Inicio, Fin, Disp] Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Head Tracking)`	Tiempo de Captura de Cámara T Giro de la Cabeza Inclinación de la Cabeza Rolido de la Cabeza Posición de la Cabeza [X,Y, T] Array Posición de la Nariz [X,Y, T] Array Vector de la Nariz [X,Y, Z, T] Array Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger desde el Inicio del Fotograma
`Trigger (Emotion Detection)`	Máxima Emoción Máxima Puntuación de Emoción Puntuación de Valencia Puntuación de Excitación Tiempo de Captura de Cámara T [Máxima Emoción, Puntuación, T] Array [Valencia, Excitación, T] Array [Todas las Emociones, T] Array [Todas las Emociones, Valencia, Excitación, T] Array Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (On Task Initialization)`	Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (On Frame Init)`	TrialNr Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (on Frame Start)`	Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (On Frame End)`	Tiempo Total del Fotograma Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Variable Value Changed)`	Nuevo Valor en la Variable Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Media Object Trigger)`	Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Websocket Trigger)`	Mensaje Datos Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (OpenAI Trigger)`	Respuesta de Chat GPT Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (Global Experiment Event)`	Tiempo Total del Fotograma Razón del Evento Global Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)
`Trigger (User Leaves Experiment)`	Número Restante de Participantes Marca de tiempo del Trigger (Unixtime) Tiempo del Trigger (Desde el Inicio del Fotograma)

Valores del Trigger (Mouse)

Cuando se utiliza un trigger de mouse, los siguientes valores específicos del trigger pueden ser llamados al trabajar con ciertas acciones:

Las opciones disponibles de valores de trigger de mouse

Opciones del Trigger (Mouse)	Descripción
`Mouse X`	Devuelve la posición actual del Mouse X en coordenadas de fotograma.
`Mouse Y`	Devuelve la posición actual del Mouse Y en coordenadas de fotograma.
`Mouse [X,Y] Array`	Las coordenadas [X,Y] del mouse en formato de matriz.
`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 cuando ocurrió el trigger en formato de Tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el inicio del fotograma hasta cuando ocurrió el trigger.

#### Valores del Trigger (Teclado)
Cuando se utiliza un [trigger de teclado](#keyboard-triggers), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones: 

| Opciones del Trigger (Teclado) | Descripción |
| :---: | ---|
| **`Id of Key`** | El valor ID de la tecla que se presionó como el trigger. |
| **`Trigger Timestamp (Unixtime)`** | La marca de tiempo de cuándo ocurrió el trigger en formato Unix Time con milisegundos. |
| **`Trigger Time (From Frame Onset)`** | El tiempo transcurrido en milisegundos medido desde el inicio del comienzo del marco hasta que ocurrió el trigger. |

#### Valores del Trigger (Barra de Botones)

Cuando se utiliza un [trigger de clic en botón](#button-click-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

| Opciones del Trigger (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 trigger en formato Unix Time con milisegundos. |
| **`Trigger Time (From Frame Onset)`** | El tiempo transcurrido en milisegundos medido desde el inicio del comienzo del marco hasta que ocurrió el trigger. |

#### Valores del Trigger (Entrar en Entrada)

Cuando se utiliza un [trigger de Entrar en Entrada](#enter-on-input-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

| Opciones del Trigger (Entrar en Entrada) | Descripción |
| :---: | ---|
| **`Id of Key`** | El valor ID de la tecla que se presionó como el trigger. |
| **`Trigger Timestamp (Unixtime)`** | La marca de tiempo de cuándo ocurrió el trigger en formato Unix Time con milisegundos. |
| **`Trigger Time (From Frame Onset)`** | El tiempo transcurrido en milisegundos medido desde el inicio del comienzo del marco hasta que ocurrió el trigger. |


#### Valores del Trigger (Desplazamiento)

Cuando se utiliza un [trigger de Desplazamiento](#scroll-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

| Opciones del Trigger (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 disparó el evento.  |
| **`Scroll Position Y`** | La posición de desplazamiento en Y del mouse cuando se disparó el evento.|
| **`Trigger Timestamp (Unixtime)`** | La marca de tiempo de cuándo ocurrió el trigger de desplazamiento en formato Unix Time con milisegundos. |
| **`Trigger Time (From Frame Onset)`** | El tiempo transcurrido en milisegundos medido desde el inicio del comienzo del marco hasta que ocurrió el trigger de desplazamiento. |

#### Valores del Trigger (Gamepad/ Joystick)

Cuando se utiliza un [`Gamepad/Joystick trigger`](#gamepad-joystick-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

<p style="text-align:center;">
<img width="80%" style="padding: 10px; border:1px solid #39AECB" height="auto" loading="lazy" src="/content_imgs/learn/guide/task-editor/imgs/events/gamepad_trigger_specific.webp" alt="opción de menú de trigger de game pad">
</p>

| Opciones del Trigger (Gamepad/ Joystick) | Descripción |
| :---: | ---|
| **`Gamepad Device Id`** | El ID o nombre del gamepad que estaba 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 Unixtime.|
| **`Trigger Timestamp (Unixtime)`** | Marca de tiempo de cuándo ocurre el trigger en Unixtime. |
| **`Trigger Time (From Frame Onset)`** | Marca de tiempo en Unixtime de cuándo ocurre el trigger en relación con el inicio del marco. |

#### Valores del Trigger (Gaze de Seguimiento Ocular)

Cuando se utiliza un [trigger de mirada de seguimiento ocular](#eyetracking-gaze-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/ET_gaze_trigger_specific_values.webp" alt="Las opciones de valor del trigger de mirada" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Opciones del Trigger&nbsp;(Gaze de Seguimiento Ocular)&nbsp;| 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 trigger de mirada. |
| **`Stimulus Info`** | La información del estímulo detrás del estímulo que inició el trigger de mirada.  |
| **`Camera Capture Time T`** |  El momento exacto en que ocurrió la instantánea. En el pipeline de seguimiento ocular de Labvanced, una instantánea de cámara ocurre primero antes de que el algoritmo y la red neuronal realicen los cálculos de mirada. Por lo tanto, `Camera Capture Time T` es un Timestamp UNIX de cuándo ocurrió la instantánea inicial. Para más información sobre la tecnología detrás de nuestro seguimiento ocular basado en webcam, consulta nuestra [página de tecnología ET.](/content/technology/es/labvanced-eye-tracking/)   |
| **`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 actúa como un 'detector de parpadeo'. Consulta nuestro [artículo revisado por pares publicado](https://link.springer.com/article/10.3758/s13428-023-02237-8) para 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 trigger de mirada en formato Unix Time con milisegundos. |
| **`Trigger Time (From Frame Onset)`** | El tiempo transcurrido en milisegundos medido desde el inicio del comienzo del marco hasta que ocurrió el trigger de mirada. |

#### Valores del Trigger (Fijación de Seguimiento Ocular)

Cuando se utiliza un [trigger de fijación de seguimiento ocular](#eyetracking-fixation-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

| Opciones del Trigger&nbsp;(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`** | La hora de inicio de la fijación detectada. |
| **`Fixation End Time`** | La hora 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, la hora de inicio, la hora de finalización y el valor de dispersión. |
| **`Trigger Timestamp (Unixtime)`** | La marca de tiempo de cuándo ocurrió el trigger de fijación en formato Unix Time con milisegundos. |
| **`Trigger Time (From Frame Onset)`** | El tiempo transcurrido en milisegundos medido desde el inicio del comienzo del marco hasta que ocurrió el trigger de fijación. |

#### Valores del Trigger (Seguimiento de Cabeza)

Cuando se utiliza un [trigger de Seguimiento de Cabeza](#headtracking-trigger), se pueden invocar los siguientes valores específicos del trigger al trabajar con ciertas acciones:

| Opciones del Trigger&nbsp;(Seguimiento&nbsp;de&nbsp;Cabeza) | Descripción |
| :---: | ---|
| **`Camera Capture Time T`** | Cuando la cámara capturó el marco, es decir, un timestamp unix de cuándo ocurrió la captura del marco. Este es el momento en que se capturó la imagen / marco antes de que ocurra cualquier procesamiento. |
| **`Head Turn`** | Giro de la cabeza de izquierda a derecha, esto se refiere como el yaw en la literatura. |
| **`Head Tilt`** | Inclinación de la cabeza de arriba hacia abajo, conocido como pitch de cabeza en la literatura. |
| **`Head Roll`** | Captura el movimiento de la cabeza rodando de lado a lado. |
| **`Head Position [X,Y, T] Array`** | Este arreglo captura los valores numéricos asociados con la posición de la cabeza, esto incluye las coordenadas x e y para el centro de la cabeza junto con la variable de timestamp (T). |
| **`Nose Position [X,Y, T] Array`** | Este arreglo captura los valores numéricos asociados con la posición específica de la nariz, esto incluye las coordenadas x e y para la ubicación de 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 comprobar si el participante está prestando atención 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 la pantalla (es decir, el participante no está prestando atención 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 en sí, 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 / marco 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 con respecto a cuándo ocurrió el inicio del marco. |

Valores del Disparador (Detección de Emociones)

Cuando se utiliza un disparador de Detección de Emociones, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Detección de Emociones)	Descripción
`Max Emotion`	La emoción máxima detectada. Valor de cadena con los siguientes parámetros disponibles: `angry`, `contempt`, `disgust`, `fear`, `happy`, `neutral`, `sad`, `surprise`.
`Max Emotion Score`	La puntuación de la `Max Emotion` detectada.
`Valence Score`	La puntuación numérica para la detección de valencia.
`Arousal Score`	La puntuación numérica para la excitación detectada.
`Camera Capture Time T`	El valor de la marca de tiempo ajustada según cuándo ocurrió la captura de la imagen. Nota: Esta es una marca de tiempo más precisa que `Trigger Timestamp` para cuándo ocurrió la detección de emociones, ya que el algoritmo requiere unos milisegundos para capturar y procesar la imagen después de que se inicia el disparador.
`[Max Emotion, Score, T] Array`	Un arreglo de: Max Emotion (etiqueta de cadena), Score (numérico), Camera Capture T (Unixtime).
`[Valence, Arousal, T] Array`	Un arreglo de: Valence (numérico), Arousal (numérico), Camera Capture T (Unixtime).
`[All Emotions, T] Array`	Registra puntuaciones para las 8 emociones y el Camera Capture T. Nota: Las 8 puntuaciones de emoción son relativas entre sí y suman 1.
`[All Emotions, Valence, Arousal, T] Array`	Registra puntuaciones para las 8 emociones, Valence, Arousal y Camera Capture T. Nota: Las 8 puntuaciones de emoción son relativas entre sí y suman 1.
`Trigger Timestamp (Unixtime)`	La marca de tiempo del disparador en Unixtime. Ver `Camera Capture Time T` para un valor de tiempo más preciso.
`Trigger Time (From Frame Onset)`	Tiempo (en milisegundos) que transcurrió desde el inicio del marco hasta que ocurrió el disparador.

Valores del Disparador (Al Inicializar la Tarea)

Cuando se utiliza un Disparador de Inicialización de Tarea, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Al Inicializar la Tarea)	Descripción
`Trigger Timestamp (Unixtime)`	La marca de tiempo Unix del disparador en milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo en milisegundos de cuándo ocurrió el disparador desde el inicio del marco.

Valores del Disparador (Al Inicializar el Marco)

Cuando se utiliza un Disparador de Inicialización de Marco, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Al Inicializar el Marco)	Descripción
`TrialNr`	El Número de Ensayo de cuándo ocurrió el Disparador de Inicialización de Marco.
`Trigger Timestamp (Unixtime)`	La marca de tiempo Unix del disparador en milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo en milisegundos de cuándo ocurrió el disparador desde el inicio del marco.

Valores del Disparador (Al Comenzar el Marco)

Cuando se utiliza un Disparador de Comienzo de Marco, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Al Comenzar el Marco)	Descripción
`Trigger Timestamp (Unixtime)`	La marca de tiempo Unix del disparador en milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo en milisegundos de cuándo ocurrió el disparador desde el inicio del marco.

Valores del Disparador (Al Finalizar el Marco)

Cuando se utiliza un Disparador de Finalización de Marco, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Al Finalizar el Marco)	Descripción
`Total Frame Time`	El tiempo total en milisegundos que se pasó en el marco.
`Trigger Timestamp (Unixtime)`	La marca de tiempo Unix del disparador en milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo en milisegundos de cuándo ocurrió el disparador desde el inicio del marco.

Valores del Disparador (Valor Variable Cambiado)

Cuando se utiliza un Disparador de Valor Variable Cambiado, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Valor Variable Cambiado)	Descripción
`New Value in Variable`	Se refiere al nuevo valor de una variable.
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuándo ocurrió el disparador de cambio de variable en formato de tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del marco hasta cuándo ocurrió el cambio de valor de la variable.

Valores del Disparador (Disparador de Objeto Multimedia)

Cuando se utiliza un Disparador de Objeto Multimedia, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Disparador de Objeto Multimedia)	Descripción
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuándo ocurrió el disparador de objeto multimedia en formato de tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del marco hasta cuándo ocurrió el disparador de objeto multimedia.

Valores del Disparador (Disparador de Websocket)

Cuando se utiliza un Disparador de Websocket, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Disparador de Websocket)	Descripción
`Message`	Un mensaje que se puede usar para describir y etiquetar que le permite (del lado receptor) filtrar entre diferentes tipos de datos.
`Data`	Un valor que puede contener diferentes tipos de datos, como elecciones de participantes, marcas de tiempo, coordenadas del mouse x/y, etc.
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuándo ocurrió el disparador de Websocket en formato de tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del marco hasta cuándo ocurrió el disparador de WebSocket.

Valores del Disparador (Disparador de OpenAI)

Cuando se utiliza un Disparador de OpenAI, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Disparador de OpenAI)	Descripción
`Chat GPT Answer`	El valor de la respuesta de ChatGPT.
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuándo ocurrió el disparador de OpenAI en formato de tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del marco hasta cuándo ocurrió el disparador de OpenAI.

Valores del Disparador (Evento Global del Experimento)

Cuando se utiliza un Disparador de Pausa / Reanudar Experimento, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (Evento Global del Experimento)	Descripción
`Total Frame Time`	Se refiere al Tiempo Total del Marco que se asignó antes del Disparador.
`Reason for Global Event`	Un valor de cadena que indica la razón del disparador, como la salida del participante del estudio.
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuándo ocurrió el disparador de Evento Global en formato de tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del marco hasta cuándo ocurrió el disparador de Evento Global.

Valores del Disparador (El Usuario Deja el Experimento)

Cuando se utiliza un Disparador de Participante Salió del Estudio Multiusuario, se pueden llamar los siguientes valores específicos del disparador al trabajar con ciertas acciones:

Opciones del Disparador (El Usuario Deja el Experimento)	Descripción
`Remaining Number of Participants`	El número de participantes que quedan en el estudio.
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuándo ocurrió el disparador de El Usuario Deja el Experimento en formato de tiempo Unix con milisegundos.
`Trigger Time (From Frame Onset)`	El tiempo transcurrido en milisegundos medido desde el comienzo del inicio del marco hasta cuándo ocurrió el disparador de El Usuario Deja el Experimento.