Objet Timer

L'objet Timer affiche un chronomètre visible de compte à rebours ou de compte à rebours à l'écran pendant un essai. Il s'intègre complètement au système d'événements de Labvanced : vous contrôlez le timer en utilisant les actions StartTimer, PauseTimer, et ResetTimer, et il déclenche des événements lorsque il démarre, se met en pause, se termine, ou franchit une frontière de seconde entière. La valeur actuelle du temps est disponible en tant que variable lisible et modifiable, ce qui permet de ramifier facilement la logique de l'expérience en fonction du temps écoulé ou restant.

Table des Matières

Ajouter l'Objet Timer
Assistant de Configuration du Timer
Propriétés de l'Objet
Contrôler le Timer avec des Actions
Déclencher des Événements depuis le Timer
Utiliser le Temps Actuel comme Variable
Lectures Complémentaires

Ajouter l'Objet Timer

Dans la barre d'outils de l'éditeur de tâches, ouvrez le groupe Buttons & Navigation et sélectionnez Timer pour ajouter un objet Timer au cadre actuel.

Barre d'outils de l'éditeur de tâches Labvanced avec l'Objet Timer mis en évidence dans le groupe Boutons & Navigation

Lorsque vous ajoutez l'élément, un Assistant de Configuration du Timer s'ouvre automatiquement. Vous pouvez compléter l'assistant pour préconfigurer le timer et ajouter des événements courants en une seule étape, ou cliquer sur Skip pour configurer tout manuellement.

Assistant de Configuration du Timer

L'assistant de configuration couvre les choix de configuration les plus courants et peut optionnellement ajouter des événements de démarrage pour vous.

Option	Description
Durée du Timer (secondes)	Définit combien de temps le timer fonctionne. Entrez un entier positif. La valeur par défaut est 60 secondes.
Directionnalité	`Count down` commence à la durée et compte vers 0. `Count up` commence à 0 et compte vers la durée.
Afficher les dixièmes de seconde	Lorsque coché, le timer s'affiche au format MM:SS.T au lieu de MM:SS.
Démarrer le timer au début du cadre	Ajoute un événement qui déclenche `StartTimer` automatiquement lorsque le cadre commence.
Passer au cadre suivant lorsque le timer se termine	Ajoute un événement qui se déclenche `Jump to Next Frame` lorsque le déclencheur `TimerEnded` se déclenche.

Vous pouvez ignorer n'importe lequel des événements automatiques et les configurer manuellement dans l'éditeur d'événements à la place.

Propriétés de l'Objet

Tous les paramètres ci-dessous se trouvent dans le panneau Propriétés de l'Objet lorsque l'Objet Timer est sélectionné.

Paramètres du Timer

Propriété	Par défaut	Description
`Duration (seconds)`	60	La durée totale pendant laquelle le timer fonctionne, en secondes.
`Directionality`	Compte à rebours	`Count down` commence à la durée et compte vers 0. `Count up` commence à 0 et compte vers la durée.
`Show tenths of a second`	Désactivé	Lorsqu'il est activé, le timer s'affiche au format MM:SS.T. Lorsqu'il est désactivé, il s'affiche au format MM:SS. Non modifiable via des événements au runtime.

Note: Current Time (seconds) n'apparaît pas dans le panneau des Propriétés, mais il est lisible et modifiable au runtime via l'action Set Object Property dans le système d'événements. Voir Utiliser le Temps Actuel comme Variable.

Panneau des Propriétés de l'Objet pour un Objet Timer montrant les champs Durée, Temps Actuel, et Compte en Montée

Style

Propriété	Ce qu'elle contrôle
`Visibility`	Opacité de 0 (invisible) à 1 (pleinement visible).
`Border-Size`	Largeur de la bordure en pixels. La valeur par défaut est 0 (pas de bordure).
`Border-Color`	Couleur de la bordure. N'a pas d'effet visible lorsque `Border-Size` est 0.
`BG-Color`	Remplissage d'arrière-plan de la boîte englobante. Activez `Transparent` pour supprimer le remplissage.
`Roundness`	Arrondi des coins de 0 (coins vifs) à 1 (arrondi maximum : une ellipse sur les éléments rectangulaires, un cercle sur les éléments carrés).

CSS Personnalisé

Cochez Change CSS Properties dans la section Style pour révéler la zone de texte CSS. Écrivez des règles CSS standard là-dedans. Labvanced scope automatiquement chaque règle à l'objet sélectionné, donc vos sélecteurs n'affectent que le DOM interne de cet élément.

Styliser l'affichage du temps

Ciblez span pour changer la police, la couleur, la taille ou le poids de la lecture du temps :

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

Objet Timer avec CSS personnalisé appliqué montrant une police et un conteneur stylés

Modifications du style de l'Objet Timer via CSS en utilisant le panneau Propriétés de l'Objet.

Remarque sur la priorité des propriétés

La couleur de fond, la bordure, et le rayon de bordure définis dans le panneau Style sont appliqués en tant que styles en ligne sur l'élément, qui prennent priorité sur les règles CSS personnalisées. Si vous avez besoin que le CSS personnalisé remplace une valeur du panneau Style, ajoutez !important à votre règle. Pour ces trois propriétés, utiliser les contrôles du panneau Style est généralement plus simple.

Contrôler le Timer avec des Actions

Utilisez l'action Control Element dans le système d'événements pour contrôler le timer par programme.

Action	Ce qu'elle fait
`StartTimer`	Démarre le timer depuis sa position actuelle. Si le timer était en pause, il reprend là où il s'est arrêté.
`PauseTimer`	Met le timer en pause à sa position actuelle sans le réinitialiser.
`ResetTimer`	Arrête le timer et réinitialise `Current Time` à sa position de départ : durée pour le compte à rebours, 0 pour le compte en montée.

Exemple : démarrer le timer automatiquement lorsque le cadre commence

Déclencheur : On Frame Start
Action : Control Element → Set Target : votre Objet Timer → StartTimer

Exemple : mettre le timer en pause lorsque un bouton est cliqué

Déclencheur : On Mouse Click → Set Target : votre bouton de pause
Action : Control Element → Set Target : votre Objet Timer → PauseTimer

Déclencher des Événements depuis le Timer

L'objet Timer déclenche les événements suivants, que vous pouvez utiliser comme la condition "quand" dans n'importe quel événement.

Déclencheur	Quand il se déclenche
`TimerStarted`	Lorsque `StartTimer` est appelé et que le timer commence à fonctionner.
`TimerPaused`	Lorsque `PauseTimer` est appelé et que le timer s'arrête.
`TimerEnded`	Lorsque le timer atteint sa fin : 0 pour compte à rebours, ou la durée pour compte en montée.
`TimerThreshold`	Se déclenche une fois chaque fois que le timer franchit une frontière de seconde entière pendant qu'il fonctionne. Utilisez ceci pour exécuter une logique à des intervalles réguliers d'une seconde.

Exemple : passer au cadre suivant lorsque le timer se termine

Déclencheur : Media Object Trigger → Set Target : votre Objet Timer → Execute on : TimerEnded
Action : Jump to Next Frame

Exemple : enregistrer une variable chaque seconde

Déclencheur : Media Object Trigger → Set Target : votre Objet Timer → Execute on : TimerThreshold
Action : Set / Record Variable → votre variable d'enregistrement

Utiliser le Temps Actuel comme Variable

La propriété Current Time (seconds) est une valeur lisible et modifiable à l'exécution. Vous pouvez utiliser l'action Set Object Property pour lire le temps actuel dans une autre variable ou pour diriger le timer vers une position spécifique.

Cela permet de :

Enregistrer le temps exact restant lorsque un participant répond
Ramifier le flux de l'expérience en fonction du temps écoulé
Synchroniser deux timers en écrivant la même valeur dans les deux

Exemple : enregistrer le temps restant à la réponse

Déclencheur : On Key Press → Set Target : votre touche cible
Action 1 : Set / Record Variable → créer une variable (ex. time_at_response), source de valeur : Object Property → Set Target : votre Objet Timer → Current Time (seconds)
Action 2 : Jump to Next Frame