Objeto Temporizador

El Objeto Temporizador muestra un temporizador visible de cuenta regresiva o de cuenta hacia arriba en la pantalla durante un ensayo. Se integra completamente con el sistema de eventos de Labvanced: controla el temporizador utilizando acciones StartTimer, PauseTimer y ResetTimer, y genera activadores cuando comienza, se pausa, finaliza o cruza un límite de un segundo completo. El valor actual del tiempo está disponible como una variable legible y escribible, lo que facilita ramificar la lógica del experimento según el tiempo transcurrido o restante.

Tabla de Contenidos

Agregar el Objeto Temporizador
Asistente de Configuración del Temporizador
Propiedades del Objeto
Controlar el Temporizador con Acciones
Activación de Eventos desde el Temporizador
Usar el Tiempo Actual como Variable
Lectura Adicional

Agregar el Objeto Temporizador

En la barra de herramientas del editor de tareas, abre el grupo Buttons & Navigation y selecciona Timer para agregar un Objeto Temporizador al marco actual.

Barra de herramientas del editor de tareas de Labvanced con el Objeto Temporizador destacado en el grupo Botones y Navegación

Cuando agregas el elemento, se abre automáticamente un Asistente de Configuración del Temporizador. Puedes completar el asistente para preconfigurar el temporizador y agregar eventos comunes en un paso, o hacer clic en Skip para configurar todo manualmente.

Asistente de Configuración del Temporizador

El asistente de configuración abarca las opciones de configuración más comunes y puede añadir eventos iniciales opcionalmente.

Opción	Descripción
Duración del Temporizador (segundos)	Establece cuánto tiempo se ejecuta el temporizador. Ingresa un número entero positivo. El valor predeterminado es 60 segundos.
Direccionalidad	`Count down` comienza en la duración y cuenta hacia 0. `Count up` comienza en 0 y cuenta hacia la duración.
Mostrar décimas de segundo	Cuando está marcado, el temporizador se muestra en formato MM:SS.T en lugar de MM:SS.
Iniciar temporizador al comienzo del marco	Agrega un evento que se activa `StartTimer` automáticamente cuando comienza el marco.
Saltar al siguiente marco cuando el temporizador termine	Agrega un evento que se activa `Jump to Next Frame` cuando se activa el disparador `TimerEnded`.

Puedes omitir cualquiera de los eventos automáticos y configurarlos manualmente en el editor de eventos.

Propiedades del Objeto

Todas las configuraciones a continuación se encuentran en el panel de Propiedades del Objeto cuando se selecciona el Objeto Temporizador.

Configuraciones del temporizador

Propiedad	Predeterminado	Descripción
`Duration (seconds)`	60	La duración total durante la cual funciona el temporizador, en segundos.
`Directionality`	Cuenta regresiva	`Count down` comienza en la duración y cuenta hacia 0. `Count up` comienza en 0 y cuenta hacia la duración.
`Show tenths of a second`	Apagar	Cuando está activado, el temporizador se muestra en formato MM:SS.T. Cuando está apagado, se muestra en formato MM:SS. No modificable a través de eventos en tiempo de ejecución.

Note: Current Time (seconds) no aparece en el panel de Propiedades, pero es legible y escribible en tiempo de ejecución a través de la acción Set Object Property en el sistema de eventos. Ver Usar el Tiempo Actual como Variable.

Panel de Propiedades del Objeto para un Objeto Temporizador mostrando duración, tiempo actual y campos de cuenta hacia arriba

Estilo

Propiedad	Qué controla
`Visibility`	Opacidad de 0 (invisible) a 1 (totalmente visible).
`Border-Size`	Ancho del borde en píxeles. El valor predeterminado es 0 (sin borde).
`Border-Color`	Color del borde. No tiene efecto visible cuando `Border-Size` es 0.
`BG-Color`	Relleno de fondo de la caja delimitadora. Activa `Transparent` para eliminar el relleno.
`Roundness`	Redondeo de las esquinas de 0 (esquinas afiladas) a 1 (redondeo máximo: una elipse en elementos rectangulares, un círculo en elementos cuadrados).

CSS Personalizado

Marca Change CSS Properties en la sección Estilo para revelar el área de texto de CSS. Escribe allí reglas CSS estándar. Labvanced asigna automáticamente cada regla al objeto seleccionado, por lo que tus selectores solo afectan el DOM interno de ese elemento.

Estilizando la visualización del tiempo

Dirígete a span para cambiar la fuente, color, tamaño o peso de la lectura del tiempo:

span {
  font-size: 3em;
  color: #c0392b;
  font-family: "Courier New", monospace;
  font-weight: bold;
  letter-spacing: 0.05em;
}

Objeto Temporizador con CSS personalizado aplicado que muestra fuente y contenedor estilizados

Modificaciones al estilo del Objeto Temporizador a través de CSS usando el panel de Propiedades del Objeto.

Nota sobre la precedencia de propiedades

El color de fondo, el borde y el radio de borde establecidos en el panel de Estilo se aplican como estilos en línea en el elemento, que tienen prioridad sobre las reglas CSS personalizadas. Si necesitas que el CSS personalizado sobrescriba un valor del panel de Estilo, añade !important a tu regla. Para estas tres propiedades, generalmente es más sencillo usar los controles del panel de Estilo.

Controlando el Temporizador con Acciones

Utiliza la acción Control Element en el sistema de eventos para controlar el temporizador programáticamente.

Acción	Qué hace
`StartTimer`	Inicia el temporizador desde su posición actual. Si el temporizador estaba pausado, se reanuda desde donde se detuvo.
`PauseTimer`	Pausa el temporizador en su posición actual sin reiniciarlo.
`ResetTimer`	Detiene el temporizador y reinicia `Current Time` a su posición inicial: duración para cuenta regresiva, 0 para cuenta hacia arriba.

Ejemplo: iniciar el temporizador automáticamente cuando comienza el marco

Disparador: On Frame Start
Acción: Control Element → Set Target: tu Objeto Temporizador → StartTimer

Ejemplo: pausar el temporizador cuando se hace clic en un botón

Disparador: On Mouse Click → Set Target: tu botón de pausa
Acción: Control Element → Set Target: tu Objeto Temporizador → PauseTimer

Activación de Eventos desde el Temporizador

El Objeto Temporizador genera los siguientes disparadores, que puedes usar como la condición "cuándo" en cualquier evento.

Disparador	Cuándo se activa
`TimerStarted`	Cuando `StartTimer` es llamado y el temporizador comienza a funcionar.
`TimerPaused`	Cuando `PauseTimer` es llamado y el temporizador se detiene.
`TimerEnded`	Cuando el temporizador alcanza su fin: 0 para cuenta regresiva, o la duración para cuenta hacia arriba.
`TimerThreshold`	Se activa una vez cada vez que el temporizador cruza un límite de un segundo completo mientras está en funcionamiento. Usa esto para ejecutar lógica en intervalos regulares de un segundo.

Ejemplo: avanzar al siguiente marco cuando el temporizador termine

Disparador: Media Object Trigger → Set Target: tu Objeto Temporizador → Execute on: TimerEnded
Acción: Jump to Next Frame

Ejemplo: registrar una variable cada segundo

Disparador: Media Object Trigger → Set Target: tu Objeto Temporizador → Execute on: TimerThreshold
Acción: Set / Record Variable → tu variable de grabación

Usar el Tiempo Actual como Variable

La propiedad Current Time (seconds) es un valor de tiempo de ejecución legible y escribible. Puedes usar la acción Set Object Property para leer el tiempo actual en otra variable, o para buscar el temporizador a una posición específica.

Esto hace posible:

Registrar el tiempo exacto restante cuando un participante responde
Ramificar el flujo del experimento según cuánto tiempo ha transcurrido
Sincronizar dos temporizadores escribiendo el mismo valor en ambos

Ejemplo: registrar el tiempo restante en la respuesta

Disparador: On Key Press → Set Target: tu tecla objetivo
Acción 1: Set / Record Variable → crear una variable (por ejemplo, time_at_response), fuente del valor: Object Property → Set Target: tu Objeto Temporizador → Current Time (seconds)
Acción 2: Jump to Next Frame