Système d'Événements

Description

Le Système d'Événements est essentiel pour toute étude. C'est ainsi que vous configurez les valeurs à enregistrer, faites progresser l'expérience et créez des tâches. Les utilisateurs peuvent créer un système d'événements pour exécuter toutes les fonctionnalités, logiques et interactions dans une tâche. Un événement agit souvent comme un médiateur entre les objets et les variables.

• Pour une liste complète de déclencheurs
• Pour la liste complète des actions
• Pour plus d'informations sur le menu de sélection de valeur pour définir les valeurs sous les événements

Le système d'événements est composé de déclencheurs et d'actions. Ici, vous configurez des règles, comme 'quand cela se produit' (déclencheur), alors 'faites ceci' (action). Par exemple : si un participant clique sur une image spécifique (déclencheur), alors montrez une image différente et aléatoire (action).

Pour une introduction sur la façon dont les événements fonctionnent dans Labvanced, veuillez consulter cette vidéo rapide :

Création d'Événements - Vue d'Ensemble

Les événements sont gérés dans l'éditeur de tâches sous l'onglet "Événements" dans le coin supérieur droit. De nouveaux événements peuvent être créés par un clic sur + Événement de Frame pour les événements qui doivent se produire sur cette image ou en cliquant sur + Événement d'Essai qui applique l'événement à toutes les images. Tous les événements existants sont affichés dans une vue liste sur le panneau droit. Les événements sont définis au niveau de l'image et peuvent être séparés/spécifiques à chaque image ou dupliqués/identiques sur chaque image d'un essai.

Quoi qu'il en soit, un événement est toujours défini pour tous les essais au sein d'un groupe d'essai pour les images spécifiées. Cependant, la logique personnalisée permet aux utilisateurs d'exécuter des événements uniquement dans certains essais, conditions, ou dans d'autres circonstances.

La vidéo ci-dessous donne un aperçu des déclencheurs et des actions disponibles dans Labvanced :

L'ordre d'exécution des événements peut être ajusté. Par défaut, les événements avec le même déclencheur se trouvent plus haut dans la liste et seront exécutés en premier. Les événements peuvent également être copiés et supprimés. Lors de la sélection d'un événement existant, les spécificités sont affichées dans le panneau inférieur droit (Propriétés de l'Événement). Pour une meilleure vue d'ensemble, les événements existants peuvent également être réouverts (icône à côté du champ de nom).

Déclencheurs

Le déclencheur définit quand l'événement sera exécuté. Cela pourrait être un clic de souris sur un objet particulier, une saisie au clavier, un changement de variable, le début d'un fichier vidéo, ou bien d'autres choses. Tous les déclencheurs et leurs réglages/paramètres sont expliqués dans la liste suivante :

Catégorie de Déclencheur	Options de Déclencheur	Description
Déclencheurs d'Entrée Utilisateur	Déclencheurs de Souris Déclencheurs de Clavier Clics de Bouton Entrée sur Saisie Déclencheur de Défilement Déclencheur de Manette/Joystick	Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur qui peut être activé manuellement par l'utilisateur/participant en faisant quelque chose comme déplacer leur souris, cliquer sur un élément de clavier, défiler, etc.
Déclencheurs de Signaux Physiologiques	Regard de Suivi Oculaire Fixation de Suivi Oculaire Suivi de Tête	Les déclencheurs de signaux physiologiques se produisent lorsqu'il y a une entrée physiologique spécifiée, comme regarder un élément spécifique ou des changements dans les mouvements de tête.
Déclencheurs d'Essai et d'Image	Init Tâche Init Image Début d'Image Fin d'Image	Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux images, comme quand une image commence ou se termine.
Déclencheur de Valeur de Variable Changée	Variable (Valeur Changée)	Un déclencheur pour l'événement se produit lorsqu'il y a un changement dans la valeur d'une variable spécifique.
Déclencheur d'Objet Média	Déclencheur d'Objet Média	Ce déclencheur se produit par rapport aux objets multimédias, comme lorsqu'il y a une pause dans un fichier vidéo/audio, une enregistrement terminé, etc.
Déclencheurs API	Déclencheur Websocket Déclencheur Open AI	Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API.
Déclencheurs Globaux	Mettre en Pause / Reprendre l'Expérience Participant A quitté l'Étude Multi-Utilisateur	Les déclencheurs globaux se réfèrent à tous les changements majeurs d'une expérience, comme lorsqu'elle est mise en pause ou lorsqu'un participant dans une étude multi-utilisateur part.

Déclencheurs d'Entrée Utilisateur

Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur qui peut être activé manuellement par l'utilisateur/participant.

Le tableau ci-dessous fournit un aperçu introductif de tous les Déclencheurs d'Entrée Utilisateur disponibles dans Labvanced. Chacun d'eux est décrit plus en détail dans les sections suivantes.

Option de Déclencheur d'Entrée Utilisateur	Vue d'Ensemble
Déclencheur de Souris	Tout mouvement de souris peut être utilisé comme déclencheur pour initier un événement, comme : défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou cibles spécifiques à un déclencheur. Par exemple, un clic de souris ne sera utilisé comme déclencheur que si une image spécifique est cliquée.
Déclencheur de Clavier	Toute pression sur le clavier peut être utilisée comme déclencheur pour initier un événement. Vous pouvez spécifier des lettres ou des chiffres spécifiques du clavier comme déclencheurs.
Clics de Bouton	Les objets bouton créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements.
Entrée sur Saisie	Ce déclencheur est couramment utilisé lorsqu'un participant appuie sur 'Entrée' pendant une expérience, comme moyen de soumettre sa réponse écrite ou son entrée dans les zones de saisie de texte.
Déclencheur de Défilement	Ce déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier les directions de défilement sur les axes x ou y, ainsi que sur quels éléments le défilement se produit pour être utilisés comme déclencheurs d'événements.
Déclencheur de Manette/Joystick	Ce déclencheur vous permet d'utiliser des manettes et des contrôleurs de joystick dans votre conception expérimentale comme dispositif d'entrée pour enregistrer des données.

Déclencheur de Souris

L'option ‘Déclencheur de Souris’ est un déclencheur d'événement très populaire car elle initie un événement basé sur toute interaction de souris, comme : déplacer la souris vers le haut / vers le bas, cliquer, survoler un objet spécifique, quitter un objet spécifique, ou tout mouvement en général !

L'exemple ci-dessous montre un ‘Déclencheur de Souris’ qui se produira lorsqu'un ‘Clic’ est effectué par le ‘Clic Gauche’ de la souris sur l'objet ‘Cible’ appelé ‘Image_1’ :

Voici un aperçu complet des options que vous avez lorsque vous travaillez avec des déclencheurs de souris :

Éléments du Menu	Zone du Menu	Options et Spécifications du Déclencheur de Souris
Action liste déroulante :		Les options de déclencheur de souris suivantes sont disponibles dans la liste déroulante : Cliquez : Déclenché par un clic de souris Pression : Déclenché par une pression de souris Relâcher : Déclenché par un relâchement de souris Survol : Déclenché en survolant un objet Quitter : Déclenché en quittant un objet Déplacer : Déclenché par tout mouvement de souris
Bouton liste déroulante :		Gauche : Déclenché par le bouton gauche de la souris Droit : Déclenché par le bouton droit de la souris
Cibles options :	Dans l'exemple ci-dessus, ‘Image_1’ est la cible du clic de bouton qui déclenchera l'événement. Plusieurs cibles peuvent être ajoutées en cliquant sur l’‘+Ajouter Cible’ en bas.	Lors de la spécification d'une cible, les options suivantes sont disponibles : Déclencheur sur l'Arrière-Plan de l'Image : le déclencheur de souris peut être activé sans cliquer sur un objet ou un élément. N'importe quel Élément : le déclencheur de souris peut être activé en cliquant sur tout élément de l'image. Ajouter des Cibles : sélectionner les éléments spécifiques qui doivent être cliqués pour activer le déclencheur.

• Note : Après avoir sélectionné le déclencheur de souris dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de souris spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheurs de Clavier

L'option de ‘Déclencheur de Clavier’ est un autre moyen populaire d'avoir un déclencheur d'événement. Essentiellement, toute entrée du clavier peut être utilisée comme déclencheur. Cela inclut : la pression, le maintien ou le relâchement d'une touche.

Dans l'exemple ci-dessous, le déclencheur est configuré pour être une pression sur le clavier qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont pressées :

Voici un aperçu complet des touches et des options que vous avez lorsque vous travaillez avec des déclencheurs de clavier :

Éléments du Menu	Zone du Menu	Options du Déclencheur de Clavier
Action liste déroulante :		Voici les options d'action de clavier disponibles : Pression de Touche : Déclenché par une pression de touche (la touche est enfoncée) Pression OU Maintien de Touche : Déclenche lorsque la touche est enfoncée ou maintenue Relâchement de Touche : Déclenché par le relâchement de la touche Note : Une touche doit être relâchée avant de pouvoir 'déclencher' à nouveau en tant que déclencheur.
Clés quelle touche déclenche l'événement		La touche utilisée comme déclencheur est spécifiée en sélectionnant les options ici en cliquant sur +Ajouter: Flèches : les quatre touches de flèche Chiffres : Chiffres de 0 à 9 Lettres : Toutes les lettres de l'alphabet anglais Spécial : Touches spéciales (Entrée, Espace, Contrôle, Tab, Maj) Touches F : F1 à F10 n'importe quelle touche : n'importe laquelle de ces touches est acceptable Vous pouvez ajouter plusieurs déclencheurs de clavier en cliquant à nouveau sur le bouton +Ajouter:
Options Additionnelles		L'option activer les boutons du pavé numérique permet d'utiliser les touches du pavé numérique comme déclencheurs dans l'expérience. Pour l'option autorise la propagation de l'événement, si plusieurs événements ont le même déclencheur de clavier alors tous se déclenchent sans cela. Seul le premier se déclenchera et l'exécution de l'événement s'arrêtera après que le premier événement soit terminé.

• Note : Après avoir sélectionné le déclencheur de clavier dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de clavier spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur de Clic de Bouton

Si vous avez un objet bouton ou de navigation placé dans l'éditeur, vous pouvez les utiliser comme partie d'un événement où cliquer sur le bouton agit comme un déclencheur pour une action.

Cliquer sur ce déclencheur montre le menu suivant où vous pouvez spécifier quel bouton spécifique agira comme déclencheur :

Voici un aperçu des éléments présentés :

Éléments du Menu	Zone du Menu	Options de Déclencheur de Clic de Bouton
Cible : +Définir la Cible		Sélection d'un élément de bouton comme cible
Bouton: option		Spécifier quel bouton spécifique sur l'image

• Note : Après avoir sélectionné le Déclencheur de Clic de Bouton dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de clic sur bouton spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur Entrée sur Saisie

Déclencheurs sur : La touche Entrée/Retour est pressée sur le clavier pendant qu'un élément spécifique est actif.

Paramètres :

• Ajouter des Cibles : Ajouter un élément d'entrée à l'Événement.

• Note : Après avoir sélectionné le déclencheur Entrée sur Saisie dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques de déclencheur Entrée sur Saisie dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur de Défilement

Déclencheurs sur : La barre de défilement, le défilement sur le pavé tactile, ou la molette de défilement de la souris est utilisée sur un élément spécifique.

Paramètres :

• Choisissez si le défilement est sur l'axe Y ou l'axe X (défilement vertical ou horizontal).

Cible : Définir l'élément cible auquel le déclencheur de défilement s'appliquera.

Note : Pour un long texte, dans le panneau 'Propriétés de l'Objet' sous la section 'Style', les options Débordement-X et/ou Débordement-Y doivent avoir défilement comme option sélectionnée.

• Note : Après avoir sélectionné le déclencheur de défilement dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de défilement spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur de Manette/Joystick

Le Déclencheur de Manette/Joystick vous permet d'utiliser des manettes et des contrôleurs de joystick dans votre conception expérimentale comme dispositif d'entrée pour enregistrer des données. Note : n'oubliez pas d'activer cette option sous l'onglet Paramètres.

En savoir plus.

Déclencheurs de Signaux Physiologiques

Ces déclencheurs ne s'appliqueront que si le suivi oculaire et/ou le suivi de tête a été activé pour la tâche.

Déclencheur de Regard de Suivi Oculaire

Déclencheurs sur :

• En général, ce déclencheur s'appliquera lorsque le suivi oculaire a été activé.
• Déclenche uniquement lorsque vous regardez des éléments spécifiques

Paramètres :

• Si vous avez sélectionné de ne déclencher que sur des éléments spécifiques, ajoutez ces éléments comme cibles.

• Note : Après avoir sélectionné le déclencheur de Regard de Suivi Oculaire dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de regard spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur de Fixation de Suivi Oculaire

Ce déclencheur est encore en phase BETA.

• Note : Après avoir sélectionné le déclencheur de clavier dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de fixation spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur de Suivi de Tête

Déclencheurs sur :

• Changements dans l'orientation de la tête ou le mouvement de la tête.

• Note : Après avoir sélectionné le déclencheur de Suivi de Tête dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de suivi de tête spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheurs d'Essai et d'Image

Déclencheur Init Tâche

Déclencheurs sur :

• La première image du premier essai d'une tâche. Ne sera exécuté qu'une seule fois par tâche, malgré son affichage dans l'onglet Événements pour toutes les instances de cette image.

Ce déclencheur se marie bien avec les actions de Mélanger et Lire à Partir de. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les images de données au début de la tâche et assigner des sujets à des ensembles de stimuli sans avoir à créer plusieurs événements pour lire les stimuli ou les données.

Paramètres : Aucun

• Note : Après avoir sélectionné le déclencheur Init Tâche dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs Init Tâche spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur Init Image

Déclencheurs sur :

• L'initialisation de l'image, avant qu'elle ne devienne visible pour le participant.

Ce déclencheur se marie bien avec les actions de Mélanger, Lire à Partir de et Dessiner Nombre Aléatoire. Avec ces combinaisons, ces actions peuvent être effectuées avant l'apparition de l'image, laissant un chemin clair pour d'autres actions à commencer lorsque l'image commence.

Note : Ne pas utiliser le déclencheur Init Image avec des événements qui enregistrent une variable ou qui impliquent des variables système telles que le Numéro d'Essai ou le Numéro de Condition. Cela est dû au fait que le déclencheur Init Image se produit entre les essais, donc il n'y a pas de compte totalement précis de l'essai ou de la condition qui s'apprête à être affiché.

Paramètres : Aucun

• Note : Après avoir sélectionné le déclencheur Init Image dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs Init Image spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Note sur les Déclencheurs Init Tâche et Init Image : Parce que les Déclencheurs Init Tâche et Init Image se produisent avant que la tâche ou l'image ne commence, les variables créées pendant ce temps seront réinitialisées lorsque la tâche/l'image commence réellement. Un avertissement apparaîtra lors de l'utilisation de cet événement :

N'oubliez pas de décocher la case "Réinitialiser au Début de l'Essai" dans la fenêtre des propriétés de la variable si vous ne voulez pas que les valeurs de la variable soient réinitialisées.

Déclencheur Début d'Image

Déclencheurs Sur :

• Début de l'image

Paramètres : Aucun

• Note : Après avoir sélectionné le déclencheur Début d'Image dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs Début d'Image spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur Fin d'Image

Déclencheurs Sur :

• Fin de l'image (après que l'image ne soit plus visible)

Paramètres : Aucun

• Note : Après avoir sélectionné le déclencheur Fin d'Image dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs Fin d'Image spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur de Valeur de Variable Changée

Valeur de Variable Changée

Déclencheurs Sur :

• La valeur d'une variable change par rapport à sa valeur initiale

Paramètres :

• Variables : Sélectionnez une ou plusieurs variables pour lesquelles vous souhaitez "écouter" les changements. Tout changement dans la valeur de ces variables déclenchera immédiatement l'Action correspondante.

• Note : Après avoir sélectionné le déclencheur Valeur de Variable Changée dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de Valeur de Variable Changée spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheurs d'Objet Média

Déclencheur d'Objet Média

Également connu sous l'ancien nom de "Déclencheur de Contrôle Audio/vidéo" et "Déclencheur de Contrôle d'Objet".

Déclencheurs Sur :

• Début, pause ou arrêt d'un fichier vidéo ou audio
• Fichier Téléchargé Terminé, Fichier Sélectionné, Enregistrement Terminé d'un objet d'enregistrement
• Instantané Terminé ou Téléchargement Complet d'un objet de capture d'image

Paramètres :

• Cible : Sélectionnez un élément d'objet qui existe sur l'image

• Exécuter Sur : Sélectionnez le sous-type de déclencheur

  • Options d'Objet Vidéo ou Audio :
    • Lecture Démarrée : Déclenche lorsque l'élément commence à jouer
    • Lecture Arrêtée : Déclenche lorsque l'élément est interrompu
    • Lecture Terminée : Déclenche lorsque l'élément arrête de jouer
  • Options d'Objet Vidéo, Audio ou Enregistrement d'Écran :
    • Enregistrement Terminé : Déclenche lorsque l'enregistrement audio a cessé
    • Téléchargement Complet : Déclenche lorsque le téléchargement de fichier est terminé
  • Options d'Objet de Téléchargement de Fichier :
    • Fichier Sélectionné : Déclenche lorsque un fichier est sélectionné
    • Téléchargement Complet : Déclenche lorsque le téléchargement du fichier est terminé
  • Options d'Objet de Capture d'Image :
    • Instantané Terminé : Déclenche lorsque la caméra a réussi à prendre un instantané
    • Téléchargement Complet : Déclenche lorsque l'instantané est terminé d'être téléchargé

• Note : Après avoir sélectionné le Déclencheur d'Objet Média dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs d'Objet Média spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheurs API

Si vous devez envoyer ou communiquer des données depuis un serveur externe vers Labvanced, alors les ‘Déclencheurs API’ et les ‘Actions API’ peuvent être utilisés. Les suivants peuvent être utilisés comme déclencheurs :

• Déclencheur Websocket
• Déclencheur OpenAI

Déclencheur Websocket

Le Déclencheur Websocket est utilisé lorsqu'un message provenant du websocket/API sera reçu et traité comme le déclencheur pour l'Action.

En cliquant sur cette option, les éléments suivants apparaissent.

• Accepter/Reçoit de : Détecte automatiquement l'adresse IP de l'hôte local. Peut être changé manuellement dans l'onglet Paramètres sous Fonctionnalités Spéciales.
• Déclencheur/message : saisissez le message qui servira de déclencheur. Tapez 'tout' pour accepter plusieurs messages comme déclencheur.

Pour un exemple d'utilisation des Déclencheurs / Actions API, veuillez consulter cette démo https://www.labvanced.com/page/library/51053 en cliquant sur l'option ‘Inspecter’ dans la boîte de dialogue.

Pour plus d'informations sur l'Accès API, veuillez visiter cette page.

• Note : Après avoir sélectionné le déclencheur WebSocket dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs WebSocket spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheur OpenAI

Le ‘Déclencheur OpenAI’ peut être utilisé pour initier une action basée sur des informations entrantes d'OpenAI.

La sélection de cette option entraînera l'affichage des paramètres suivants :

REMARQUE : Consultez également ce tutoriel où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant ce déclencheur.

Dans l'exemple ci-dessous, le tableau de données qui a été assigné est appelé ‘df’ et le résultat du ‘Déclencheur OpenAI’ sera ajouté à ce tableau de données. Ce tableau de données doit avoir deux colonnes. La première colonne désignera le ‘rôle’ et la deuxième colonne le ‘message de chat.’ Les valeurs de l'action seront automatiquement ajoutées au tableau de données qui est lié ici.

Si vous utilisez également l'action ‘Envoyer vers OpenAI’, vous devez utiliser le même tableau de données là que vous avez indiqué ici.

• Note : Après avoir sélectionné le déclencheur OpenAI dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs OpenAI spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Déclencheurs Globaux

Les Déclencheurs Globaux se produisent chaque fois qu'un changement majeur se produit dans l'expérience, c'est-à-dire quelque chose qui est 'Global' comme mettre l'expérience en pause ou un participant quittant une étude multi-utilisateur ! Les options suivantes sont répertoriées comme Déclencheurs Globaux :

• Mettre en Pause / Reprendre l'Expérience
• Participant A quitté l'Étude Multi-Utilisateur

Mettre en Pause/Reprendre l'Expérience

Le déclencheur ‘Mettre en Pause / Reprendre l'Expérience’ est une option qui vous permet d'exécuter un événement basé sur la pause ou la reprise de l'expérience.

En sélectionnant ce déclencheur, la vue suivante apparaît où vous pouvez spécifier la nature du déclencheur, s'il doit être exécuté lors de la pause de l'expérience ou de sa continuation/reprise :

• Expérience Mise en Pause : Le participant met la pause (sort du plein écran) dans l'étude.

• Expérience Continuée : Le participant reprend l'étude. Ce déclencheur fonctionne bien pour les études de suivi oculaire. Il peut être utilisé pour renvoyer le participant à un essai ou une image précédente s'il a quitté son Appui Virtuel pour le Menton.

• Note : Après avoir sélectionné le déclencheur Mettre en Pause/Reprendre l'Expérience dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Participant A quitté l'Étude Multi-Utilisateur

Si un participant quitte une étude multi-utilisateur, cela peut également être utilisé comme déclencheur pour un événement. Si un participant quitte une étude multi-Utilisateur, cela affecte l'expérience au niveau global car cela empêche les autres participants de continuer l'étude.

En sélectionnant ce déclencheur, vous pouvez spécifier quel type d'action se produira si un participant quitte une étude multi-utilisateur.

• Note : Après avoir sélectionné le déclencheur Participant A quitté l'Étude Multi-Utilisateur dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur dans diverses actions à l'aide du menu de sélection de valeur.

Actions

Les actions définissent ce qui doit se passer lorsque l'événement est exécuté. Elles peuvent être utilisées pour changer des variables et des propriétés d'objets, enregistrer des données, lire et écrire des données à partir de tableaux, ou sauter au prochain essai ou tâche. Souvent, il y a plusieurs actions par événement. En utilisant "ControlActions," on peut utiliser des opérations logiques (instructions If-Else), des Boucles, des fonctions de rappel, ainsi que l'imbrication d'actions les unes dans les autres (par exemple, une boucle while dans une instruction if). Ainsi, le système d'événements peut être vu comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme les invocations de fonction, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit que presque toute logique expérimentale peut être implémentée sans utiliser certaines structures programmatiques / syntaxiques.

Le tableau ci-dessous fournit un aperçu introductif des actions qui sont disponibles dans Labvanced :

Catégorie d'Action	Options d'Action	Description
Actions d'Objet	Définir Propriété d'Objet Contrôler Objet Média Copier Objet PourChaque Objet	Les actions d'objet se réfèrent à toute manipulation qui se produira sur un objet existant dans la tâche.
Actions de Variable	Définir / Enregistrer Variable Copier dans le Presse-papiers Dessiner Nombre Aléatoire Obtenir Paramètre URL Lire / Écrire à partir de l'Appareil Lire / Écrire à partir de la Variable Partagée Math & Statistiques Enregistrer Variables Instantanément Filtre Moyenne Mobile Distribuer Variable	Toute action qui lit ou enregistre une valeur de variable.
Actions de Tableau	Sélectionner dans le Tableau (Lire) Ajouter / Supprimer des Éléments de Tableau Changer Éléments de Tableau (Remplacer) Mélanger Éléments de Tableau	Les opérations sur les tableaux impliquent la sélection, l'ajout, la suppression, le changement et le mélange des tableaux et de leurs éléments.
Opérations sur Cadre de Données	Lire / Écrire dans le Cadre de Données Mélanger les Éléments du Cadre de Données	Ces actions sont pertinentes si vous travaillez avec des fichiers .csv (cadres de données) dans votre expérience.
Actions de Saut	Sauter à Accepter / Terminer Session Rejeter / Terminer Session Rediriger vers URL	Vous permet de naviguer dans l'expérience en sautant à une section spécifique, ainsi qu'à accepter et rejeter les sections des participants.
Actions de Contrôle	Actions de Condition (Si…Alors) Actions Répétées (Boucle While) Actions Retardées (Callback de Temps) Groupe d'Actions	Les actions de contrôle sont utilisées pour exécuter des séquences d'événements spécifiques, comme la logique si/ensuite, le bouclage (comme jouer un son répété ou faire clignoter une image), ainsi que la configuration d'un délai pour le moment où une action se produit.
Actions API	Envoyer vers Websocket Envoyer vers OpenAI	Se réfère aux actions spécifiques aux API pour envoyer des données vers une API.
Actions de Code	Exécuter JavaScript Définir CSS Global	Les actions de code vous permettent de travailler avec JavaScript ou CSS.
Action de Coller	Action de Coller	Vous permet de coller une action que vous avez précédemment copiée.

Actions sur les objets

Les actions sur les objets font référence à toute manipulation qui se produira sur un objet existant dans la tâche. Il existe plusieurs options d'action sur les objets :

• Définir la propriété de l'objet
• Contrôler l'objet multimédia
• Copier l'objet
• PourChaque objet

Action Définir la Propriété de l'Objet

Avec l'action ‘Définir la Propriété de l'Objet’, vous pouvez changer l'apparence d'un objet comme vous le souhaitez en spécifiant l'objet en question, la propriété à changer et la nouvelle valeur.

En savoir plus.

Action Contrôler l'Objet Multimédia

Auparavant les actions séparées "Contrôler Audio/Video" et "Contrôler Objet".

Effet : Modifie la lecture des éléments vidéo/audio ou change l'état des éléments de téléchargement/enregistrement.

Paramètres :

• Cible : Sélectionnez un objet multimédia
• Effet : Sélectionnez une sous-action
  • Options d'Objet Audio ou Vidéo :
    • Démarrer la Lecture : Commence à jouer le fichier vidéo / audio
    • Arrêter la Lecture : Arrête le fichier vidéo / audio
    • Mettre en Pause la Lecture : Met en pause le fichier vidéo / audio
    • JumpToTime : vous permet de spécifier un temps en millisecondes auquel sauter dans le fichier audio/vidéo
    • Muet : désactive le son de l'objet
    • Activer le Son : restaure le son de l'objet
  • Options d'Objet Audio, Vidéo ou Enregistrement Écran :
    • Démarrer l'Enregistrement : Commence un nouvel enregistrement (audio)
    • Arrêter l'Enregistrement : Arrête l'enregistrement (audio)
    • Démarrer le Téléchargement : Commence le téléchargement du fichier
    • Effacer l'Enregistrement : Supprime les données d'enregistrement (audio).
    • Démarrer la Lecture : Commence à jouer le fichier enregistré
    • Arrêter la Lecture : Arrête de jouer le fichier enregistré
    • Mettre en Pause l'Enregistrement : met en pause l'enregistrement de l'objet
    • Reprendre l'Enregistrement : reprend l'enregistrement de l'objet
  • Options d'Objet Téléchargement de Fichier :
    • Démarrer le Téléchargement : commence le processus de téléchargement pour le fichier sélectionné
    • Effacer le Fichier : Supprime le fichier sélectionné
    • Choisir un Fichier : permet au participant de choisir le fichier souhaité
  • Options d'Objet Instantané de Caméra :
    • Démarrer la Caméra : allume la caméra du participant
    • Arrêter la Caméra : éteint la caméra du participant
    • Démarrer le Téléchargement : commence à télécharger l'instantané dans l'expérience
    • Prendre un Instantané : prend une photo en utilisant la caméra du participant

Action Copier l'Objet

Effet : Copie un objet, remplaçant la nécessité de plusieurs objets séparés et d'événements en double.

Paramètres :

• Source : Choisissez l'objet sur le cadre à copier.
• Nombre de copies : Entrez le nombre de copies à réaliser de l'objet source.
• Définir un nouveau nom d'élément : Choisissez parmi plusieurs paramètres pour déterminer les noms des copies.
• Attribuer un nom avec suffixe incrémental : Ajoute une étiquette numérique à la fin du nouveau nom d'élément pour différencier les copies.
• Séquence d'Action : Vous permet de choisir (dans la liste habituelle des actions) ce qui arrivera aux copies. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à toutes les copies.

Action PourChaque Objet

Effet : Applique une action à plusieurs objets du même type.

Paramètres :

• Filtrer : Choisissez le type d'élément à cibler.
• Autoriser un filtre de nom supplémentaire : Tapez le nom de l'objet(s) à cibler. Pour plusieurs objets sur un cadre où certains ont des noms identiques, cela fonctionne bien.
• Séquence d'Action : Vous permet de choisir (dans la liste habituelle des actions) ce qui arrivera aux éléments sélectionnés. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à tous les éléments répondant aux critères spécifiés ci-dessus.

Actions sur les Variables

Les actions sur les variables sont utilisées pour définir ou créer des valeurs de variables, enregistrer et définir des valeurs, y compris des valeurs à travers les sessions.

Le tableau ci-dessous fournit un aperçu introductif de toutes les options d'Action sur les Variables disponibles dans Labvanced. Chacune d'elles est décrite plus en détail dans les sections à venir.

Option d'Action sur les Variables	Description
Définir / Enregistrer la Variable	Écrire ou définir une valeur de variable
Copier dans le Presse-papiers	Copiez une valeur de variable dans le presse-papiers interne de l'ordinateur.
Tirer un Nombre Aléatoire	Tire un ou plusieurs nombre(s) aléatoire(s) et les enregistre dans une variable
Obtenir un Paramètre d'URL	Enregistre une valeur à partir de l'URL unique du participant
Lire depuis / Écrire sur un Dispositif	Lit ou écrit une variable depuis/vers le stockage local du dispositif. Cette Action enregistre des données sur le dispositif du participant plutôt que d'envoyer les données aux serveurs Labvanced.
Lire depuis / Écrire sur une Variable Partagée	Lit ou écrit dans une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou être privée à chaque individu.
Math & Statistiques	Effectue une opération mathématique sur une certaine variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.
Enregistrer les Variables Instantanément	Crée un instantané de toutes les valeurs de variables et envoie cela au serveur Labvanced.
Filtre de Moyenne Mobile	Calcule une moyenne mobile (une moyenne en constante évolution des données) de certaines entrées et stocke le résultat dans une nouvelle variable.
Distribuer la Variable	Envoie une valeur à d'autres participants. La valeur est enregistrée dans une variable.

Action Définir / Enregistrer la Variable

L’Action ‘Définir / Enregistrer la Variable’ est appelée à être utilisée dans chaque expérience dans Labvanced car c'est ainsi que les valeurs et les mesures comportementales sont stockées et enregistrées.

Après avoir cliqué sur cette action, le menu de dialogue suivant apparaîtra où vous pourrez spécifier quelle variable doit être enregistrée et la valeur d'intérêt :

Élément de Menu	Zone de Menu	Description
Sélectionner		En cliquant sur sélectionner, vous indiquez quelle variable doit stocker la valeur. À partir de là, vous pouvez également créer une nouvelle variable.
Icône de Stylo		L'icône de stylo symbolise le menu de sélection de valeur utilisé pour définir et spécifier les valeurs exactes qui devraient être attribuées à la variable sélectionnée (comme spécifié dans le bouton vert à gauche du signe égal (=)).

Dans l'exemple ci-dessous, nous avons créé une nouvelle variable appelée counter et utilisé une option arithmétique du menu de sélection de valeur pour augmenter la valeur de la variable de 1 (basé sur le déclencheur défini dans l'étape précédente).

L'image ci-dessous enregistre les coordonnées X,Y de la souris afin de capturer le suivi de la souris pendant une étude. L'image ci-dessous montre comment trois actions sont utilisées pour rendre possible l'enregistrement de la valeur de la variable. La variable (à gauche) est créée manuellement pendant que la valeur sur le côté droit du signe égal (=) est une valeur spécifique au déclencheur de la souris que le système fournit et à laquelle vous pouvez vous référer lors de l'enregistrement des valeurs.

Remarque : L'Action Définir / Enregistrer la Variable est également couramment utilisée dans le cadre des Actions de Contrôle où vous pouvez spécifier des conditions en utilisant ‘si / alors’ et ‘tant que’ en fonction des valeurs des variables.

Action Copier dans le Presse-papiers

Effet : Copie une valeur de variable dans le presse-papiers interne de l'ordinateur.

Action Tirer un Nombre Aléatoire

Effet : Tire un ou plusieurs nombre(s) aléatoire(s) et les enregistre dans une variable

Paramètres :

• Type : Choisissez entre des valeurs continues et discrètes
• Distribution : Choisissez entre distribution gaussienne et uniforme
• Tirages Multiples (booléen vrai/faux) : Choisissez de tirer une fois ou plusieurs fois.
• Nb de Tirages : Sélectionnez le nombre de tirages
• Min : Définissez la valeur minimale pour la distribution uniforme
• Max : Définissez la valeur maximale pour la distribution uniforme
• Moyenne : Définissez la valeur moyenne pour la distribution gaussienne
• Écart-Type : Définissez l'écart-type pour la distribution gaussienne
• Enregistrer dans la Variable : Sélectionnez une variable où les valeurs seront stockées.

Action Obtenir un Paramètre d'URL

Effet : Enregistre une valeur provenant de l'URL unique du participant

Paramètres :

• Nom du Paramètre : saisissez le nom du paramètre souhaité
• Enregistrer dans la Variable : sélectionnez la variable dans laquelle enregistrer la valeur du paramètre

Cette Action pourrait être combinée avec d'autres Actions pour construire des URL uniques pour les participants ou extraire des informations nécessaires à l'analyse des données.

Action Lire depuis/Écrire sur un Dispositif

Effet : Lit ou écrit une variable depuis/vers le stockage local du dispositif. Cette Action enregistre des données sur le dispositif du participant plutôt que d'envoyer les données aux serveurs Labvanced.

Paramètres :

• Choisissez de lire depuis ou écrire sur le dispositif local.
• Choisissez la variable à lire ou à écrire.

Cas d'Utilisation : Études Longitudinales/Multi-Sessions

• Avec cette action, les données spécifiques au dispositif peuvent être transférées d'une session à l'autre, à condition que le même participant utilise le même dispositif pour chaque session.
• Par exemple, vous pouvez utiliser cette action pour enregistrer les images présentées à chaque participant lors de la Session 1 et vous assurer que différentes images leur sont présentées lors de la Session 2.
  • Créez un tableau d'images et sélectionnez-en quelques-unes au hasard à présenter dans chaque session.
  • Écrivez sur le Dispositif : le numéro d'index des images présentées lors de la Session 1.
  • Lisez depuis le Dispositif : lors de la Session 2, lisez les index des images de la Session 1 et incluez une action JavaScript qui empêche de sélectionner ces index pour la deuxième session.

Action Lire depuis/Écrire sur une Variable Partagée

Effet : Lit ou écrit dans une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou être privée à chaque individu.

Paramètres :

• Choisissez la variable à synchroniser. Doit être soit scalaire soit un tableau.
• Options Avancées
  • Clé de stockage : choisissez le nom d'une variable pour servir de clé pour accéder à la variable synchronisée.
  • Méthode de Lecture ou d'Écriture :
    • Lire, modifier, puis écrire la variable partagée : lit la variable, effectue une modification, puis envoie la variable à l'étude.
    • Lire uniquement la valeur partagée depuis le serveur : appelle la variable partagée dans l'étude, mais ne fait aucune modification.
    • Écrire uniquement la variable sur le serveur : effectue des modifications sur la variable partagée, mais ne l'affiche pas aux participants.
    • Partager des valeurs entre différents participants (pas seulement entre sessions) : permet aux participants de voir les valeurs de variable synchronisées des autres participants entre les sessions. Cette option est sélectionnée par défaut, mais peut être désélectionnée en désactivant la case à cocher.
• Séquence d'Action :
  • Choisissez ce qui se passe avec la variable partagée/synchronisée dans la liste de toutes les Actions disponibles.

Cas d'Utilisation : Études Longitudinales/Multi-Sessions

• Avec cette action, les données spécifiques au participant peuvent être transférées d'une session à l'autre et peuvent être partagées entre les participants lors des sessions.
• Par exemple, vous pouvez utiliser cette action pour enregistrer un score sur un test et permettre ensuite au participant de comparer son score à la moyenne des scores d'autres participants ayant terminé le test.
• Un autre exemple (similaire à l'action Lire depuis/Écrire sur un Dispositif) est de faire choisir aux participants 5 images qu'ils aiment dans un tableau, d'effectuer une tâche, puis de présenter ces 5 images à nouveau lors d'une session ultérieure. La différence est que cette Action peut être utilisée pour montrer aux autres participants les images qui ont été choisies, ou pour exclure ces images des options disponibles pour un autre participant.

Action Math & Statistiques

Effet : Effectue une opération mathématique sur une certaine variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.

Paramètres :

• Type : Choisissez entre Opérations de Tableau, Algèbre Linéaire et Tests Statistiques
• Opération : Choisissez une opération mathématique (par ex. somme, min, écart-type, etc.)
• Tableau d'Entrée : Choisissez une variable d'entrée (tableau) sur laquelle l'opération est exécutée
• Paramètres : Certaines opérations ont des paramètres supplémentaires.
• Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.

Action Enregistrer les Variables Instantanément

Effet : Crée un instantané de toutes les valeurs de variables et l'envoie au serveur Labvanced.

Paramètres : Aucun

Action Filtre de Moyenne Mobile

Effet : Calcule une moyenne mobile (une moyenne en constante évolution des données) de certaines entrées et stocke le résultat dans une nouvelle variable.

Paramètres :

• Forme du Filtre : Sélectionnez le type de filtre
  • Moyenne Mobile Simple : Calcule une moyenne mobile simple, où tous les échantillons ont le même poids.
  • Moyenne Mobile Pondérée Linéaire : Pèse les échantillons de manière à ce que les poids des échantillons diminuent linéairement.
  • Moyenne Mobile Exponentielle : Pèse les échantillons de manière à ce que les poids des échantillons diminuent exponentiellement.
• Nombre d'Échantillons : Détermine combien d'échantillons sont utilisés par étape.
• Entrée : Choisissez une variable d'entrée (tableau) sur laquelle la moyenne mobile est calculée
• Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.

Action Distribuer la Variable

L'action Distribuer la Variable est essentielle pour les études multi-utilisateurs dans Labvanced. Avec cette action, une valeur de variable peut être partagée entre les participants, permettant essentiellement à l'information (y compris les emplacements des stimuli et tout changement) d'être reflétée sur les écrans des participants.

Après avoir sélectionné cette action, la boîte de dialogue suivante apparaîtra où vous pourrez spécifier quelle valeur de variable est distribuée entre les participants.

L'image ci-dessous montre à quoi ressemble la boîte de dialogue fonctionnelle de l'action Distribuer la Variable lorsque tous les éléments du menu sont remplis. Dans cet exemple, la variable distribuée est une action utilisée comme moyen de créer un chat entre deux participants en distribuant la valeur d'une variable depuis un objet de champ de saisie.

Découvrez cette démo qui intègre la variable distribuée et la fonctionnalité de chat ici : Tâche de Description d'Image avec Add-On de Chat.

Une explication complète des éléments du menu peut être trouvée ci-dessous :

Élément de Menu	Zone de Menu	Options et Description de l'Action Distribuer la Variable
Distribuer la valeur à		Choisissez à quels autres participants la valeur doit être envoyée. Tous les participants : Envoyer cette valeur à tous les participants Participants Sélectionnés : Envoyer la valeur aux participants sélectionnés.
Choisissez la variable cible et la valeur		Variable Cible : Choisissez une variable cible où la valeur sera stockée. Valeur : Déterminez la valeur qui doit être envoyée aux autres participants.
Bloc		Si activé, la Variable Cible ne peut pas être changée tant que la distribution de valeur actuelle n'est pas terminée.
Stratégie de Limite de Taux		La Stratégie de Limite de Taux est un moyen de protéger votre expérience d'une surcharge du serveur et agit comme une stratégie préventive pour contrôler le taux auquel les requêtes (c'est-à-dire les mises à jour via la variable distribuée) sont envoyées au serveur. Les options de stratégie suivantes sont disponibles : Debounce : Lorsque cette action s'exécute plus d'une fois par fenêtre de 100 ms, alors les nouveaux messages serveur seront ‘décalés’ (seul le message le plus récent sera envoyé après un intervalle de 100 ms sans exécution de cette action). Throttle : Lorsque cette action s'exécute plus d'une fois par fenêtre de 100 ms, alors les nouveaux messages seront régulés (c'est-à-dire, après 100 ms passés depuis le dernier message envoyé, seul le message le plus récent sera distribué). Discard : Lorsque cette action s'exécute plus d'une fois par fenêtre de 100 ms, alors les nouveaux messages dans cette fenêtre de 100 ms seront rejetés. Queue : Lorsque cette action s'exécute plus d'une fois par fenêtre de 100 ms, alors les nouvelles valeurs de variable seront mises en file d'attente (jusqu'à une taille de file d'attente maximale de 10 messages).

Actions sur les Tableaux

Action Sélectionner (Lire) dans le Tableau

Effet : Lira une variable d'un tableau et stockera cette valeur dans une variable scalaire.

Paramètres :

• Variable de Tableau : Tableau d'Entrée pour lire la valeur.
• Type d'Index : Détermine quel type d'index est utilisé.
  • Fixe : Utiliser un index fixe pour l'opération de lecture. Dans ce cas, tapez la position à partir de laquelle l'information doit être lue (1 basé).
  • Variable : Utiliser une variable numérique comme index pour l'opération de lecture. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer la position de la lecture.
  • Fin de Tableau : Lire depuis la fin du tableau.
• Variable de Sortie : Sélectionnez une variable scalaire où la valeur lue sera stockée.

Action Ajouter / Supprimer des Entrées de Tableau

Effet : Ajoute et/ou supprime des entrées du tableau.

Paramètres :

• Variable de Tableau : Variable de tableau où l'opération d'ajout ou de suppression doit être exécutée.
• Type d'Index : Détermine quel type d'index est utilisé.
  • Fixe : Utiliser un index fixe pour l'opération d'insertion/suppression. Dans ce cas, tapez la position du tableau où les entrées doivent être insérées/supprimées. (1 basé).
  • Variable : Utiliser une variable numérique comme index pour l'opération d'insertion/suppression. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer où les entrées doivent être insérées/supprimées.
  • Fin de Tableau : Insérer/supprimer depuis la fin du tableau.
• Nombre d'entrées à supprimer : Supprime les entrées du tableau (avant d'insérer de nouvelles entrées) à partir de la position d'index définie. 0 indique qu'aucune valeur ne sera supprimée.
• Variable(s) à Insérer : Sélectionnez une ou plusieurs variable(s) scalaire(s), qui seront ajoutées à la variable de tableau à la position d'index définie.

Action Changer (Remplacer) une Entrée de Tableau

Effet : Remplace / change une valeur au sein d'un tableau.

Paramètres :

• Variable de Tableau : Variable de tableau dans laquelle une valeur doit être modifiée
• Type d'Index : Détermine quel type d'index est utilisé.
  • Fixe : Utiliser un index fixe pour l'opération de remplacement. Dans ce cas, tapez la position du tableau qui doit être changée (1 basé).
  • Variable : Utiliser une variable numérique comme index pour l'opération de remplacement. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer la position de l'opération de remplacement.
  • Fin de Tableau : Remplacer la dernière entrée du tableau.
• Variable d'Entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.

Action Mélanger les Entrées de Tableau

Effet : Mélange les entrées / l'ordre dans un tableau.

Paramètres : Aucun

Opérations sur les Cadres de Données

Action Lire depuis / Écrire dans le Cadre de Données

Effet : Lit des valeurs depuis ou écrit des valeurs dans un cadre de données et les enregistre dans une nouvelle variable de tableau.

Paramètres :

• Variable de Cadre de Données : sélectionnez la variable du cadre de données à lire.
• Lire ou Écrire : Choisissez de lire depuis le cadre de données sélectionné ou d'écrire dans le cadre de données sélectionné.
• Par ligne ou colonne : Choisissez comment les données doivent être lues.
• Type d'Index : Choisissez le type de variable d'index qui sera utilisé pour lire le cadre de données. Peut être fixe, variable ou la dernière ligne.
• Variable d'Index : Choisissez la variable qui sera utilisée comme index pour lire le cadre de données.
• Variable de Sortie : Choisissez la variable où les données lues/écrites seront stockées comme sortie. Doit être une variable de tableau.

Action Mélanger les Entrées du Cadre de Données

Effet : Mélange l'ordre des entrées dans le cadre de données.

Paramètres :

• Sélectionnez le cadre de données à mélanger.
• Sélectionnez si le cadre de données doit être mélangé par lignes ou colonnes.

Actions de Saut

Action Sauter À

Effet : "Saute" le participant à une étape différente dans l'expérience. Cette action peut changer l'ordre des essais et des tâches dans une expérience et peut être utilisée pour créer une logique expérimentale individualisée pour chaque participant.

Paramètres :

• Sauter À : Détermine où sauter dans l'expérience.
  • Prochain Cadre : Saute au prochain cadre. S'il n'y a plus de cadres définis dans un essai, il sautera au premier cadre du prochain essai.
  • Prochain Essai : Saute au prochain essai. S'il n'y a plus d'essais définis, il sautera au premier essai de la prochaine tâche.
  • Prochaine Tâche : Saute à la prochaine tâche. S'il n'y a plus de tâches définies, il sautera à la première tâche du prochain bloc.
  • Prochain Bloc : Saute au prochain bloc. S'il n'y a plus de blocs définis, la session se terminera.
  • Cadre Précédent : Saute au cadre précédent. S'il n'y a pas de cadres précédents, l'action ne sera pas exécutée.
  • Cadre Spécifique : Saute à un cadre spécifique. Les utilisateurs sélectionnent directement le cadre à sauter.
  • Essai Spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro d'essai à sauter.
  • Tâche Spécifique : Saute à la première instance de la tâche spécifiée dans le bloc actuel. Les utilisateurs sélectionnent directement la tâche à sauter.
  • Bloc Spécifique : Saute à la première instance du bloc spécifié. Les utilisateurs sélectionnent directement le bloc à sauter.
• Vérifier les Réponses Requises Avant : Si activé, l'expérience vérifiera si toutes les réponses requises ont déjà été répondues. Sinon, l'action sautant n'est pas exécutée.

Action Accepter/Terminer la Session

Effet : Accepte les données du participant, termine la session d'enregistrement, et affiche le code de crowdsourcing.

Paramètres :

• Enregistrer les données de l'essai avant de terminer la session : Si activé, les données de l'essai les plus récentes seront stockées (envoyées au serveur) avant de quitter l'étude.
• Afficher la page de fin par défaut : Si activé, l'écran de fin par défaut de Labvanced apparaîtra. Si c'est une session de crowdsourcing (un lien de crowdsourcing a été utilisé), le code de compensation sera montré au participant. Si désactivé, l'expérience se terminera après avoir affiché le cadre actuel et ne montrera pas l'écran de fin par défaut avec le code de compensation.

Action Rejeter/Terminer la Session

Effet : Termine la session d'enregistrement, NE marque PAS les données du participant comme complètes, et NE montre PAS l'écran de fin par défaut avec le code de compensation.

Lors de l'utilisation de cette action pour rejeter les données d'un participant, les utilisateurs doivent afficher un message approprié aux participants expliquant la raison pour laquelle ils ne seront pas récompensés pour leur temps.

Paramètres : Aucun

Action Rediriger vers l'URL

Effet : Redirige le participant vers une URL spécifique.

Remarque : L'URL doit inclure le https:// au début pour que cette action fonctionne.

Actions de Contrôle

Actions de Requirement (Si... Alors... Sinon Si) Action

Effet : Évalue une déclaration si-alors et exécute une série d'actions en fonction de celle-ci. Chaque déclaration Si / Sinon-Si se compose de comparaisons imbriquées AND / OR pour évaluer si toutes les conditions sont remplies (la déclaration est vraie) ou pas (la déclaration est fausse). Si la déclaration est vraie, les actions sous "Alors" sont exécutées.

Paramètres :

• Ajouter un Exigence : Ajoutez une nouvelle exigence à une déclaration. Le menu "sélection de valeur" apparaîtra des deux côtés pour effectuer une comparaison logique. Au milieu de la déclaration, vous pouvez choisir comment les deux côtés doivent être comparés (par ex. égal, inférieur à, inégal, etc.).
• Ajouter un Groupe OU : Un seul des exigences de l'intérieur d'un Groupe OU doit être vrai pour que le groupe entier soit vrai. Ajoutez un groupe OU si les sous-actions doivent être exécutées dans plusieurs cas.
• Ajouter un Groupe ET : Toutes les exigences dans un Groupe ET doivent être vraies pour que l'ensemble du groupe soit vrai. Ajoutez un groupe ET si les sous-actions doivent être exécutées uniquement lorsque plusieurs exigences sont remplies.
• Séquence d'Action : Chaque déclaration Si / Sinon-Si a une liste d'actions définies sous "Alors". La séquence d'actions énumère toutes les actions pour une certaine déclaration Si / Sinon-Si. Une nouvelle action peut être ajoutée via l'icône "Ajouter une Action". La séquence d'action n'est exécutée que si les exigences de la déclaration Si / Sinon-si associée sont remplies.
• Ajouter un Cas Sinon-Si : L'Action de Requirement peut consister en plusieurs déclarations Si / Sinon-Si --> Alors séparées. Cependant, une seule déclaration peut être exécutée. Si une déclaration Si / Sinon-Si est évaluée positivement (retourne vrai), les actions dans le bloc Alors sont exécutées et le reste de l'Action de Requirement est ignoré.
• Ajouter un Cas Sinon (vrai / faux) : Si activé, une option par défaut / de secours est ajoutée à l'action de requirement. Si aucune des déclarations Si / Sinon-Si n'est exécutée (retournées vrai), les actions définies dans le cas sinon seront exécutées.

Actions Répétées (Boucle Tant Que) Action

Effet : Exécute de manière répétée une série d'actions, soit immédiatement, soit dans un intervalle défini. Une condition d'arrêt peut être spécifiée de sorte que l'exécution de la boucle sera arrêtée.

Paramètres :

• Type d'Exécution : Choisissez entre exécution immédiate ou exécution chronométrée
  • Exécuter la boucle complète : Cela exécutera la boucle en continu jusqu'à ce que la condition d'arrêt soit remplie.
  • Exécuter tous les ... ms : Cela exécutera la boucle à intervalles définis (par exemple, la boucle s'exécute toutes les 50 ms).
• Définir le nombre de boucles : Lorsque "Exécuter tous les ... ms" est sélectionné, les utilisateurs ont la possibilité d'assigner une valeur entière numérique pour le nombre de fois que la boucle doit être exécutée. Cela remplace le besoin de définir une condition d'arrêt.
• Intervalle d'Exécution : Cela détermine l'intervalle d'exécution.
• Démarrer immédiatement (vrai / faux) : Si activé, cela exécutera la boucle tout de suite. Si désactivé, la boucle sera démarrée au prochain intervalle d'exécution.
• Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de boucles peuvent être démarrées en parallèle. Si désactivé, une seule instance de boucle peut être exécutée à la fois.
• Activer la condition d'arrêt (vrai / faux) : Si activé, une condition d'arrêt pour la boucle peut être spécifiée.
• Condition d'Arrêt : La condition d'arrêt peut être utilisée pour spécifier une expression logique quand l'exécution de la boucle doit être arrêtée. Similaire aux déclarations Si / Sinon-Si, on peut combiner des groupes ET, des groupes OU, et des Exigences pour la comparaison logique.
• Séquence d'Action : La séquence d'actions énumère toutes les actions qui sont exécutées à chaque itération de la boucle. Une nouvelle action peut être ajoutée via l'icône "Ajouter une Action".

Actions Retardées (Callback Temporel) Action

Effet : Exécute une série d'actions après un certain retard

Paramètres :

• Type de Délai : Choisissez entre un délai fixe ou un délai variable
  • Délai Fixe : Les actions seront exécutées après un délai fixe.
  • Délai Variable : Les actions seront exécutées après un délai spécifié dans une variable (numérique).
• Délai : La durée du délai en millisecondes (ms).
• Séquence d'Action : La séquence d'actions énumère toutes les actions qui sont exécutées après le délai spécifié. Une nouvelle action peut être ajoutée via l'icône "Ajouter une Action".

Groupe d'Actions

Les actions peuvent également être organisées en groupes d'actions. Les groupes d'actions vous permettent de regrouper certaines actions ensemble pour une structure visuelle plus facile, mais aussi si vous souhaitez copier, dupliquer ou supprimer plusieurs actions en même temps.

En savoir plus.

Actions API

Si vous devez envoyer ou communiquer des données d'un serveur externe vers Labvanced, alors les ‘Actions API’ et ‘Déclencheurs API’ peuvent être utilisés. Vous avez les actions suivantes disponibles dans cette catégorie :

• Envoyer au Websocket
• Envoyer à OpenAI

Afin que ces actions soient ‘disponibles’ ou utilisables, vous devez entrer une clé API dans l'onglet Paramètres.

Action Envoyer au Websocket

Lors de la sélection de cette action, les options suivantes apparaissent :

L'exemple ci-dessus et la structure complète de l'événement peuvent être accessibles ici : https://www.labvanced.com/page/library/51053 en cliquant sur ‘Inspecter.’

Pour plus d'informations sur l'Accès API, veuillez visiter cette page.

Action Envoyer à OpenAI

L’action ‘Envoyer à OpenAI’ vous permet d’envoyer des informations, comme une valeur d’entrée de chaîne, à OpenAI. Veuillez noter que pour que cette option soit disponible, vous devez indiquer votre clé API dans l'onglet Paramètres sous Fonctionnalités Spéciales.

Les options suivantes apparaîtront lors du clic sur cet événement :

Voici un exemple fonctionnel de ce à quoi ressemble cet événement lorsque toutes les informations nécessaires sont fournies :

Pour une meilleure compréhension de la façon dont vous pouvez utiliser cette fonctionnalité et la voir en action, n'hésitez pas à nous contacter pour une démo en soumettant ce formulaire de contact.

REMARQUE : Référez-vous également à ce guide où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant cette action.

Voici une explication plus approfondie des champs inclus dans l'action 'Envoyer à OpenAI' :

Élément de Menu	Zone de Menu	Options d'Action 'Envoyer à OpenAI'
Type de Modèle		Spécifie le modèle d'IA qui sera utilisé.
Cadre de Données de l'Historique de Chat		Lien vers une variable de cadre de données avec deux colonnes. La première colonne indiquera le ‘rôle’ et la seconde colonne le ‘message de chat.’ Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici. Le cadre de données peut également être manipulé avec des actions de cadre de données. Pour de plus amples références, veuillez consulter les docs d'OpenAI.
Insérer un Message ‘+’		En cliquant sur cela, la boîte de dialogue variable apparaîtra. Vous devrez indiquer quelle valeur de ‘Variable’ est envoyée à OpenAI ainsi que le ‘rôle’ du message associé : système : désigne le système ChatGPT de haut niveau participant : le participant assistant : désigne un sous-rôle spécifique créé au sein du système

Comme OpenAI évolue quotidiennement, veuillez consulter les docs d'OpenAI pour d'autres éclaircissements.

Actions de Code

Dans certains cas, votre expérience peut exiger que vous utilisiez du code personnalisé. Avec ces actions, vous pouvez le faire ! Les options suivantes sont disponibles dans le menu ‘Actions de Code’ :

• Exécuter JavaScript
• Définir CSS Global

Action Exécuter JavaScript

L’action ‘Exécuter JavaScript’ vous permet de programmer des événements spécifiques et de lire/définir des variables Labvanced dans votre étude en saisissant du JavaScript personnalisé qui s'exécutera en tant qu'action lorsqu'il sera déclenché.

Lorsque l'action ‘Exécuter JavaScript’ ci-dessus est sélectionnée, vous verrez une zone (un éditeur de code) où le code JavaScript doit être écrit, ainsi que des instructions sur la façon de l'utiliser :

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/js_editor.webp" alt="L'éditeur de code JavaScript dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

#### Définir l'action CSS globale
Avec l'action « Définir le CSS global », vous pouvez utiliser du code CSS personnalisé pour changer un aspect de l'étude lors d'un déclencheur. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_css.webp" alt="L'action Définir le CSS global dans le menu d'actions Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Le champ suivant s'ouvre après avoir cliqué sur cette action : 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/css_editor.webp" alt="L'éditeur de code CSS dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Un exemple d'utilisation de l'action « Définir le CSS global » serait de changer la couleur de fond de l'étude lorsqu'un participant sélectionne une couleur spécifique dans une question à choix multiples.

### Action Coller
Cette option vous permet de coller une action que vous avez précédemment créée et copié. Elle vous permet de travailler plus rapidement lors de la conception de votre expérience afin que vous n'ayez pas à sélectionner les mêmes éléments encore et encore. Par exemple, si vous avez un événement similaire à un qui existe déjà, vous pouvez simplement le copier, le coller et le modifier, au lieu de le construire depuis le début. 

## Le menu de sélection de valeur 
<img align="left" width="10%" style="padding: 10px;" height="auto" loading ="lazy" src="/content_imgs/learn/guide/task-editor/imgs/events/value_select_icon.webp">Lorsque vous travaillez avec certains événements, vous remarquerez l'apparition d'une icône de stylo. Cela s'appelle le menu de sélection de valeur car il vous permet de sélectionner et d'instruire quel type de valeurs doivent être enregistrées ou suivies. C'est une option très puissante et importante que vous devez utiliser pour la conception et la configuration de votre expérience. 

Cette icône de stylo / menu de sélection de valeur apparaît à divers endroits pour certaines actions dans le système d'événements, telles que l'action Définir / Enregistrer une variable, l'action Définir une propriété d'objet et l'action Exigence (Si... Alors), comme montré ci-dessous.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/value_select_menu_locations.webp" alt="L'emplacement de la sélection de valeur dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 


Cliquer sur l'icône de stylo mène à un menu déroulant où vous spécifiez la valeur qui doit être lue ou écrite. **Le menu déroulant commencera toujours par énumérer une option de valeur spécifique au déclencheur, puis continuera avec les 5 autres catégories (Temps actuel, Valeur constante, Variable, Cadre / Tâche / Option et Opérations), chacune ayant ses propres options.** Celles-ci seront décrites plus en détail ci-dessous. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/value_select_menu.webp" alt="Le menu de sélection de valeur dans Labvanced" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

L'image ci-dessus montre à quoi ressemble le menu de sélection de valeur lorsqu'un déclencheur de souris est utilisé. Comme vous pouvez le voir, le premier élément du menu à gauche commence par une catégorie spécifique au déclencheur, puis passe aux 5 autres catégories (Temps actuel, etc). 

### Options du menu
Le tableau ci-dessous explique davantage les catégories et les options :

| Catégorie | Options | Description |
|:---:|---|---|
| [`Valeur spécifique au déclencheur`](#trigger-specific-values) |  Dépend du type de déclencheur que vous avez précédemment sélectionné pour l'événement. | En fonction du déclencheur que vous avez sélectionné pour un événement, une liste spécifique d'options apparaîtra en haut du menu de sélection de valeur. Veuillez vous référer à la section sur les [valeurs spécifiques au déclencheur](#trigger-specific-values) pour voir la liste complète des options et des descriptions. |
| [`Temps actuel`](#current-time-values) | <ul><li> [Horodatage UNIX](#current-time-unix-timestamp) </li><li> [Temps à partir du début du cadre](#current-time-time-from-frame-onset) </li> </ul> | Mesurer et appeler des valeurs de temps. |
| [`Valeur constante`](#constant-values) | <ul><li> Chaîne </li><li> Numérique </li><li> Booléen </li><li> Catégorique </li><li> Date</li><li> Temps </li><li> Couleur </li> </ul> | Attribuer des valeurs constantes en fonction du type de variable dont vous avez besoin, comme une chaîne ou une valeur numérique. Celles-ci sont parfois utilisées en combinaison avec d'autres options telles que [`arithmétique`](#arithmetic) pour créer des compteurs. | 
| [`Variable`](#variable-values) | <ul> <li> Sélectionner une variable </li><li> Sélectionner une valeur d'un tableau </li><li>  Sélectionner une valeur d'un cadre de données </li></ul> | Précisez ou faites référence à une variable ou sélectionnez une valeur d'un tableau ou d'un cadre de données. |
| [`Cadre / Tâche / Objet`](#frame-task-object-values) | <ul><li> Propriété d'objet </li><li> Cadre </li><li>  Suivi oculaire </li><li>  Appareil </li> </ul> | Vous permet de récupérer les valeurs associées aux propriétés des objets, au cadre, au suivi oculaire (si activé) et à l'appareil (taux de rafraîchissement de l'écran). |
| [`Opérations`](#operations) | <ul><li>Arithmétique </li><li> Opération sur chaîne </li><li>  Opération mathématique </li> </ul> | Utilisez des opérations pour effectuer des modifications spécifiées sur vos variables, telles que la combinaison de valeurs variables, la transformation de chaînes pour qu'elles soient toutes en minuscules ou l'exécution d'opérations mathématiques. |


###  Valeurs de temps actuel
Avec l'option « Temps actuel », vous pouvez enregistrer ou faire référence à des valeurs en rapport avec le temps. 

Les options suivantes sont disponibles : 
* [Horodatage UNIX](#current-time-unix-timestamp)
* [Temps à partir du début du cadre](#current-time-time-from-frame-onset)

#### Temps actuel : Horodatage UNIX
Cette valeur capture un horodatage au format UNIX en millisecondes.  

#### Temps actuel : Temps à partir du début du cadre
Cette valeur capture le temps écoulé depuis le début du cadre. Le plus souvent, cela équivaut au temps de réaction.

### Valeurs constantes
Attribuez des valeurs constantes en fonction du type de variable dont vous avez besoin, comme une chaîne ou une valeur numérique. Celles-ci sont parfois utilisées en combinaison avec d'autres options telles que [`arithmétique`](#arithmetic) pour créer des compteurs. 

Les options suivantes sont disponibles : 
* [Chaîne](#constant-string)
* [Numérique](#constant-numeric)
* [Booléen](#constant-boolean)
* [Catégorique](#constant-categorical)
* [Date](#constant-date)
* [Temps](#constant-time)
* [Couleur](#constant-color)

#### Constante : Chaîne
Assigne une valeur de chaîne / texte.

#### Constante : Numérique
Assigne une valeur numérique / nombre.

#### Constante : Booléen
Assigne une valeur vraie ou fausse.

#### Constante : Catégorique
Assigne une valeur de niveau (principalement pour les facteurs).

#### Constante : Date
Assigne une valeur de date.

#### Constante : Temps
Assigne une valeur de temps.

#### Constante : Couleur
Assigne une valeur de couleur (chaîne hexadécimale).

### Valeurs de variable
Précisez ou faites référence à une variable ou sélectionnez une valeur d'un tableau ou d'un cadre de données.  Les options suivantes sont disponibles :
* [Sélectionner une variable](#select-variable)
* [Sélectionner une valeur d'un tableau](#select-value-from-array)
* [Sélectionner une valeur d'un cadre de données](#select-value-from-data-frame)

#### Sélectionner une variable
Vous permet de sélectionner et de pointer vers une variable. 

#### Sélectionner une valeur d'un tableau
Vous permet de sélectionner une valeur d'un tableau. 

#### Sélectionner une valeur d'un cadre de données
Vous permet de sélectionner une valeur d'un cadre de données que vous avez créé. 

### Valeurs de cadre / tâche / objet
Vous permet de récupérer des valeurs associées aux propriétés des objets, au cadre, au suivi des yeux (si activé) et à l'appareil (taux de rafraîchissement de l'écran). 
* [Propriété d'objet](#object-property)
* [Cadre](#frame)
* [Suivi oculaire](#eye-tracking)
* [Appareil](#device)

#### Propriété d'objet 
Lit une propriété d'objet.

#### Cadre

| Options de valeur de cadre | Description |
| :---: | ---|
| **`Dernière position X de la souris mise en cache`** | La dernière valeur de coordonnée X de la souris du participant. |
| **`Dernière position Y de la souris mise en cache`** | La dernière valeur de coordonnée Y de la souris du participant. | 
| **`Dernier tableau [X,Y] mis en cache`** | La dernière valeur de coordonnée [X,Y] de la souris du participant au format de tableau. | 
| **`Nom du cadre`** | Le nom du cadre. |  

#### Suivi oculaire

| Options de valeur de suivi oculaire | Description |
| :---: | ---|
| **`Dernière coordonnée X mise en cache`** | La dernière valeur de coordonnée X du regard du participant. |
| **`Dernière coordonnée Y mise en cache`** | La dernière valeur de coordonnée Y du regard du participant.  | 
| **`Dernier tableau [X,Y] mis en cache`** | La dernière valeur de coordonnée [X,Y] du regard du participant au format de tableau. | 
| **`Dernier tableau [X,Y,T] mis en cache`** | La dernière valeur de coordonnée [X,Y] du regard du participant, plus la valeur T de capture de la caméra au format de tableau. |  

#### Appareil
* **Taux de rafraîchissement :** La valeur du taux de rafraîchissement de l'appareil du participant. 

### Opérations
Utilisez des opérations pour effectuer des modifications spécifiées sur vos variables, telles que la combinaison de valeurs variables, la transformation de chaînes pour qu'elles soient toutes en minuscules ou l'exécution d'opérations mathématiques. 

Les options suivantes sont disponibles :
* [Arithmétique](#arithmetic)
* [Opération sur chaîne](#string-operation)
* [Opération mathématique](#math-operation)

#### Arithmétique 
Les opérations arithmétiques sont utiles pour de nombreux objectifs différents, y compris la combinaison de chaînes et même la modification des propriétés des objets. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/arithmetic_menu.webp" alt="Le menu d'arithmétique dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 
 
Essentiellement, l'opération arithmétique vous permet d'effectuer des opérations sur plusieurs valeurs. 

Lorsque vous sélectionnez cette option, une icône de stylo supplémentaire (c'est-à-dire le menu de sélection de valeur) apparaîtra, ainsi qu'une liste d'opérations, telles que l'addition.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/arithmetic_selected.webp" alt="L'emplacement de l'option arithmétique dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Les valeurs peuvent être manipulées en utilisant ces 5 opérations différentes : 
* (+) addition
* (-) soustraction
* (/) division
* (*) multiplication
* (%) modulo

L'exemple ci-dessous montre comment utiliser les opérations arithmétiques pour créer une nouvelle variable de chaîne (dans le bouton vert), appelée 'intermediateVar'. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/chat_example_explained.webp" alt="Exemple d'opérations arithmétiques utilisées pour créer une nouvelle variable de chaîne." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

La nouvelle valeur de variable (de 'intermediateVar') est définie en combinant plusieurs opérations arithmétiques avec une combinaison de variables précédemment créées (c'est-à-dire 'userChatName' et 'chatInput'), ainsi que des [valeurs de chaînes constantes,](#constant-8594-string) c'est-à-dire le point-virgule `:` et l'espace de rupture `<br>`. Cette action crée l'effet d'un chat utilisateur pouvant être utilisé dans une étude multijoueur. 

#### Opération sur chaîne

| Options d'opération sur chaîne | Description |
| :---: | ---|
| **`En minuscules`** | Change toutes les lettres d'une variable de chaîne en petites lettres.<br><br> **&#8594; Ex:** (AAABBB) se transforme en (aaabbb) |
| **`En majuscules`** | Change toutes les lettres d'une variable de chaîne en lettres capitales. <br><br> **&#8594; Ex:** (aaabbb) se transforme en (AAABBB) |
| **`En lien`** | Transforme la chaîne d'une variable en une URL qui s'ouvre dans une autre fenêtre |
| **`Supprimer les espaces`** | Supprime tous les espaces entre les lettres d'une variable de chaîne. <br><br> **&#8594; Ex:** (aaa bbbb cccc) se transforme en (aaabbbbccc) |
| **`Élaguer les espaces`** | Supprime les espaces au début d'une variable de chaîne. <br><br> **&#8594; Ex:** (  aaabbbcccc) se transforme en (aaabbbcccc) |
| **`Remplacer la sous-chaîne Regexp`** | Remplace certaines lettres dans une variable de valeur de chaîne. <br><br> **&#8594; Ex:**  (aaabbbccc) remplace _bbb_ par _xxx_ ce qui transforme la valeur en (aaaxxxccc) |


#### Opération mathématique
Effectue une opération mathématique sur une valeur scalaire.

| Options d'opération mathématique | Description |
| :---: | ---|
| **`abs`** | Retourne le nombre absolu d'une valeur. |
| **`sqrt`** | Retourne la racine carrée d'une valeur. | 
| **`arrondir`** | Retourne la valeur arrondie avec 0 à 3 décimales. | 
| **`plancher`** | Retourne la valeur arrondie vers le bas. |  
| **`plafond`** | Retourne la valeur arrondie vers le haut. | 
| **`cos`** | Retourne la valeur du cosinus. | 
| **`sin`** | Retourne la valeur du sinus. | 
| **`tan`** | Retourne la valeur de la tangente. | 

### Valeurs spécifiques au déclencheur

Les valeurs spécifiques au déclencheur se réfèrent aux valeurs qui sont associées au déclencheur défini dans un événement particulier. Par exemple, si votre événement utilise un déclencheur de souris, alors, dans certaines zones où l'action est spécifiée (comme lors de l'utilisation d'une action [`Définir / Enregistrer une variable`](#set-record-variable-action) ou d'une action [`Définir une propriété d'objet`](#set-object-property-action)), vous pouvez faire référence aux valeurs spécifiques au déclencheur de souris dans le [menu de sélection de valeur.](#the-value-select-menu) 

Dans l'exemple ci-dessous, des valeurs spécifiques au déclencheur pour un déclencheur de souris sont utilisées pour enregistrer des valeurs x et y et un tableau [X,Y] en utilisant une action [`Définir / Enregistrer une variable`](#set-record-variable-action). 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/mouse_track_ex.webp" alt="Démonstration de l'utilisation des valeurs spécifiques au déclencheur de souris pour capturer le suivi de la souris." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 


Ci-dessous se trouve un tableau de tous les types de valeurs spécifiques au déclencheur que l'on peut trouver dans Labvanced, suivi d'une explication détaillée de chaque option. 


| Nom| Aperçu des options de valeur |
| :---: | ---|
| [`Déclencheur (Souris)`](#trigger-mouse-values)  | <ul><li> Souris X </li><li> Souris Y </li><li> Tableau [X,Y] Souris </li><li> Nom du stimulus </li><li> Info du stimulus </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li> </ul> <img width=500/>|
| [`Déclencheur (Clavier)`](#trigger-keyboard-values) | <ul><li> ID de la touche </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Barre de boutons)`](#trigger-button-bar-values) | <ul><li> Nom du stimulus </li><li> Info du stimulus </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Entrée sur saisie)`](#trigger-enter-on-input-values)  | <ul><li> ID de la touche </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Défilement)`](#trigger-scroll-values) | <ul><li> Nom du stimulus </li><li> Info du stimulus</li><li> Position de défilement X </li><li> Position de défilement Y </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> | 
| [`Déclencheur (Manette / Joystick)`](#trigger-gamepad-joystick-values) | <ul><li>ID de l'appareil de la manette </li><li> Touches pressées (tableau) </li><li> Touches pressées ou maintenues (tableau) </li><li> Touches relâchées (tableau) </li><li> Axes (tableau) </li><li> Horodatage de la manette (temps Unix) </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Regard Suivi oculaire)`](#trigger-eyetracking-gaze-values) | <ul><li> Coordonnée X </li><li> Coordonnée Y </li><li> Tableau [X,Y] Coordonnée </li><li> Nom du stimulus </li><li> Info du stimulus </li><li> Temps de capture de la caméra T </li><li> Confiance du regard C </li><li> Coordonnée + Temps [X,Y, T] Tableau </li><li> Coordonnée + Temps + Confiance [X,Y, T,C] Tableau </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> | 
| [`Déclencheur (Fixation de suivi oculaire)`](#trigger-eyetracking-fixation-values) | <ul><li> Centroid X de fixation </li><li> Centroid Y de fixation </li><li> Durée de fixation </li><li> Temps de début de fixation </li><li> Temps de fin de fixation </li><li> Dispersion de fixation </li><li> Nom du stimulus </li><li> Info du stimulus </li><li> [X,Y, Durée, Début, Fin, Disp] </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Suivi de la tête)`](#trigger-head-tracking-values) |  <ul><li> Temps de capture de la caméra T </li><li>  Rotation de la tête </li><li>  Inclinaison de la tête </li><li>  Roulis de la tête </li><li>  Position de la tête [X,Y, T] Tableau </li><li>  Position du nez [X,Y, T] Tableau </li><li>  Vecteur du nez [X,Y, Z, T] Tableau </li><li>  Horodatage du déclencheur (temps Unix) </li><li>  Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (À l'initialisation de la tâche)`](#trigger-on-task-initialization-values) |  <ul><li>  Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (À l'initialisation du cadre)`](#trigger-on-frame-init-values) |  <ul><li>  Numéro d'essai </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (au démarrage du cadre)`](#trigger-on-frame-start-values) |  <ul><li>  Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (À la fin du cadre)`](#trigger-on-frame-end-values)  |  <ul><li> Temps total du cadre </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |		
| [`Déclencheur (Valeur de variable changée)`](#trigger-variable-value-changed-values) |  <ul><li> Nouvelle valeur dans la variable </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Déclencheur d'objet multimédia)`](#trigger-media-object-trigger-values) |  <ul><li>  Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Déclencheur Websocket)`](#trigger-websocket-trigger-values) |  <ul><li>  Message </li><li> Données </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Déclencheur OpenAI)`](#trigger-openai-trigger-values) |  <ul><li>  Réponse de Chat GPT </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |
| [`Déclencheur (Événement expérimental global)`](#trigger-global-experiment-event-values) |  <ul><li>  Temps total du cadre </li><li> Raison de l'événement global </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre)  </li></ul> |
| [`Déclencheur (Utilisateur quitte l'expérience)`](#trigger-user-leaves-experiment-values) |  <ul><li>  Nombre restant de participants  </li><li> Horodatage du déclencheur (temps Unix) </li><li> Temps du déclencheur (à partir du début du cadre) </li></ul> |

#### Valeurs du déclencheur (Souris)
Lorsqu'un [déclencheur de souris](#mouse-trigger) est utilisé, les [valeurs spécifiques au déclencheur](#trigger-specific-values) suivantes peuvent être appelées lors de l'utilisation de certaines actions :  

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/mouse_trigger_specific_values.webp" alt="Les options de valeur de déclencheur de souris disponibles" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Options de déclencheur (Souris) | Description |
| :---: | ---|
| **`Souris X`** | Retourne la position X actuelle de la souris dans les coordonnées du cadre. |
| **`Souris Y`**|  Retourne la position Y actuelle de la souris dans les coordonnées du cadre. |
| **`Tableau [X,Y] Souris`** | Les coordonnées de la souris [X,Y] au format de tableau. | 
| **`Nom du stimulus`** | Le nom de l'objet qui a déclenché l'événement (par exemple, quelle image a été cliquée). |
| **`Info du stimulus`** | Les informations du stimulus de l'objet qui a déclenché l'événement. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur s'est produit au format Unix Time avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur s'est produit. |


#### Valeurs du déclencheur (Clavier)
Lorsqu'un [déclencheur de clavier](#keyboard-triggers) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions : 

| Options de déclencheur (Clavier) | Description |
| :---: | ---|
| **`ID de la touche`** | La valeur ID de la touche qui a été pressée comme déclencheur. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur s'est produit au format Unix Time avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur s'est produit. |

#### Valeurs du déclencheur (Barre de boutons)

Lorsqu'un [déclencheur de clic de bouton](#button-click-trigger) est utilisé, les valeurs suivantes spécifiques au déclencheur peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Barre de boutons) | Description |
| :---: | ---|
| **`Nom du stimulus`** | Le nom de l'objet bouton qui a déclenché l'événement. |
| **`Info du stimulus`** | Les informations du stimulus de l'objet bouton qui a déclenché l'événement. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur s'est produit au format Unix Time avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur s'est produit. |

#### Valeurs du déclencheur (Entrée sur saisie)

Lorsqu'un [déclencheur d'entrée sur saisie](#enter-on-input-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Entrée sur saisie) | Description |
| :---: | ---|
| **`ID de la touche`** | La valeur ID de la touche qui a été pressée comme déclencheur. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur s'est produit au format Unix Time avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur s'est produit. |


#### Valeurs du déclencheur (Défilement)

Lorsqu'un [déclencheur de défilement](#scroll-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Défilement) | Description |
| :---: | ---|
| **`Nom du stimulus`** | Le nom de l'objet bouton qui a déclenché l'événement. |
| **`Info du stimulus`** | Les informations du stimulus de l'objet bouton qui a déclenché l'événement. |
| **`Position de défilement X`** | La position de défilement X de la souris lorsque l'événement a été déclenché.  |
| **`Position de défilement Y`** | La position de défilement Y de la souris lorsque l'événement a été déclenché.|
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur de défilement s'est produit au format Unix Time avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur de défilement s'est produit. |

#### Valeurs du déclencheur (Manette / Joystick)

Lorsqu'un [`déclencheur de manette/joystick`](#gamepad-joystick-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

<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="option de menu de déclencheur de manette">
</p>

| Options de déclencheur (Manette / Joystick) | Description |
| :---: | ---|
| **`ID de l'appareil de la manette`** | L'ID ou le nom de la manette qui était connectée. |
| **`Touches pressées (tableau)`** | Les touches qui ont été pressées. |
| **`Touches pressées OU maintenues (tableau)`** | Les touches qui ont été pressées ou maintenues. |
| **`Touches relâchées (tableau)`** | Les touches qui ont été relâchées. |
| **`Axes (tableau)`** | Les valeurs des axes. |
| **`Horodatage de la manette (temps Unix)`** | L'horodatage de la manette au format temps Unix.|
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur se produit au format temps Unix. |
| **`Temps du déclencheur (à partir du début du cadre)`** | L'horodatage en temps Unix de quand le déclencheur se produit par rapport à l'apparition du cadre. |

#### Valeurs du déclencheur (Regard Suivi oculaire)

Lorsqu'un [déclencheur de regard de suivi oculaire](#eyetracking-gaze-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/ET_gaze_trigger_specific_values.webp" alt="Les options de valeur de déclencheur de regard" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Options&nbsp;Déclencheur&nbsp;(Regard&nbsp;Suivi oculaire)  | Description  |
| :---: | --- |
| **`Coordonnée X`** | La valeur de la coordonnée X du regard. |
| **`Coordonnée Y`** | La valeur de la coordonnée Y du regard. |
| **`Tableau de Coordonnée [X,Y]`** | Les coordonnées du regard X,Y au format de tableau. |
| **`Nom du stimulus`** | Le nom du stimulus qui a initié le déclencheur de regard. |
| **`Info du stimulus`** | Les informations du stimulus derrière le stimulus qui a initié le déclencheur de regard.  |
| **`Temps de capture de la caméra T`** |  Le moment exact où la capture a eu lieu. Dans le pipeline de suivi oculaire de Labvanced, une capture de caméra a lieu en premier avant que l'algorithme et le réseau neuronal effectuent des calculs de regard. Ainsi, le `Temps de capture de la caméra T` est un horodatage UNIX de quand la capture initiale a eu lieu. Pour plus d'informations concernant la technologie derrière notre suivi oculaire à base de webcam, veuillez vous référer à notre [page de technologie ET.](/content/technology/fr/labvanced-eye-tracking/)   |
| **`Confiance C du regard`** | Cette valeur varie de 0 à 1 et fait référence à la confiance et à la probabilité qu'il y ait un œil ouvert dans l'image de la capture et sert essentiellement de « détecteur de clignement. » Veuillez vous référer à notre [article publié évalué par des pairs](https://link.springer.com/article/10.3758/s13428-023-02237-8) pour plus de détails.  |
| **`Coord. + Temps [X,Y,T] Tableau`** | Un tableau contenant les coordonnées x/y du regard et l'horodatage de la capture de la caméra (T) comme décrit ci-dessus.  |
| **`Coord. + Temps + Confiance [X,Y, T,C] Tableau`** | Un tableau contenant les coordonnées x/y du regard et l'horodatage de la capture de la caméra (T) et de la confiance du regard (C) comme décrit ci-dessus. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur de regard s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur de regard s'est produit. |

#### Valeurs du déclencheur(Fixation de suivi oculaire)

Lorsqu'un [déclencheur de fixation de suivi oculaire](#eyetracking-fixation-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options&nbsp;Déclencheur&nbsp;(Fixation Suivi Oculaire) | Description |
| :---: | ---|
| **`Centroid X de fixation`** | Le point central de la fixation en tant que valeur X. |
| **`Centroid Y de fixation`** | Le point central de la fixation en tant que valeur Y. |
| **`Durée de fixation`** | La durée de la fixation détectée. |
| **`Temps de début de fixation`** | Le temps de début de la fixation détectée. |
| **`Temps de fin de fixation`** | Le temps de fin de la fixation détectée. |
| **`Dispersion de fixation`** | Fait référence à la dispersion des valeurs de regard au sein d'une fixation détectée. |
| **`Nom du stimulus`** | Le nom de l'objet bouton qui a déclenché l'événement. |
| **`Info du stimulus`** | Les informations du stimulus de l'objet bouton qui a déclenché l'événement. |
| **`[X, Y, Dur, Début, Fin, Disp]`** | Un tableau des suivantes : valeurs x et y du centre de la fixation, la durée de la fixation, le temps de début, le temps de fin, et la valeur de dispersion. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur de fixation s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur de fixation s'est produit. |

#### Valeurs du déclencheur (Suivi de la tête)

Lorsqu'un [déclencheur de suivi de la tête](#headtracking-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options&nbsp;Déclencheur&nbsp;(Suivi de la Tête) | Description |
| :---: | ---|
| **`Temps de capture de la caméra T`** | Quand la caméra capture le cadre, c'est-à-dire un horodatage Unix de quand la capture du cadre a eu lieu. C'est le moment où l'image / le cadre a été capturé avant tout traitement. |
| **`Rotation de la tête`** | Rotation de la tête de gauche à droite, cela est appelé le roulis dans la littérature. |
| **`Inclinaison de la tête`** | Inclinaison de la tête de haut en bas, connue sous le nom de lacet dans la littérature. |
| **`Roulis de la tête`** | Capture le mouvement de la tête se roulant d'un côté à l'autre. |
| **`Position de la tête [X,Y, T] Tableau`** | Ce tableau capture les valeurs numériques associées à la position de la tête, y compris les coordonnées x et y pour le centre de la tête, ainsi que la variable d'horodatage (T). |
| **`Position du nez [X,Y, T] Tableau`** | Ce tableau capture les valeurs numériques associées à la position du nez spécifiquement, y compris les coordonnées x et y de l'emplacement du nez, ainsi que la variable d'horodatage (T) indiquant quand la mesure a eu lieu. |
| **`Vecteur du nez [X,Y, Z, T] Tableau`** | Cette mesure fonctionne en projetant un vecteur à partir de l'extrémité du nez et est utile pour tester si le participant est attentif à l'écran (ce qui est particulièrement important pour les études où le suivi oculaire n'est pas activé). Ainsi, si le nez pointe hors de l'écran (c'est-à-dire que le participant n'est pas attentif à l'expérience), la valeur Z diminue de 1 et se rapproche de 0. |
| **`Horodatage du déclencheur (temps Unix)`** | Point dans le temps pendant l'expérience où le déclencheur lui-même se produit où le suivi de la tête a été détecté et tient compte de quand le déclencheur s'est produit dans le système. Essentiellement, c'est le moment où le traitement de l'image / du cadre est effectué et cette valeur est largement affectée par la carte graphique du participant. En théorie, elle devrait être aussi proche que possible de la valeur T. |
| **`Temps du déclencheur par rapport au début du cadre`** | Cette valeur est le temps où le déclencheur s'est produit par rapport à l'événement d'apparition du cadre. |

#### Valeurs du déclencheur (À l'initialisation de la tâche)

Lorsqu'un [déclencheur d'initialisation de tâche](#task-init-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (À l'initialisation de la tâche) | Description |
| :---: | ---|
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage Unix du déclencheur en millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps en millisecondes à partir du début du cadre lorsque le déclencheur s'est produit. |

#### Valeurs du déclencheur (À l'initialisation du cadre)

Lorsqu'un [déclencheur d'initialisation de cadre](#frame-init-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (À l'initialisation du cadre) | Description |
| :---: | ---|
| **`Numéro d'essai`** | Le numéro d'essai lorsque le déclencheur d'initialisation du cadre s'est produit. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage Unix du déclencheur en millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps en millisecondes à partir du début du cadre lorsque le déclencheur s'est produit. |


#### Valeurs du déclencheur (au démarrage du cadre)

Lorsqu'un [déclencheur de démarrage de cadre](#frame-start-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (au démarrage du cadre) | Description |
| :---: | ---|
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage Unix du déclencheur en millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps en millisecondes à partir du début du cadre lorsque le déclencheur s'est produit. | 


#### Valeurs du déclencheur (À la fin du cadre)

Lorsqu'un [déclencheur de fin de cadre](#frame-end-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (À la fin du cadre) | Description |
| :---: | ---|
| **`Temps total du cadre`** | Le temps total en millisecondes passé sur le cadre. | 
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage Unix du déclencheur en millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps en millisecondes lorsque le déclencheur s'est produit à partir du début du cadre. | 


#### Valeurs du déclencheur (Valeur de variable changée)

Lorsqu'un [déclencheur de valeur de variable changée](#variable-value-changed-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Valeur de variable changée) | Description |
| :---: | ---|
| **`Nouvelle valeur dans la variable`** | Fait référence à la nouvelle valeur d'une variable. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur de changement de variable s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où la valeur de la variable a changé. |


#### Valeurs du déclencheur (Déclencheur d'objet multimédia)

Lorsqu'un [déclencheur d'objet multimédia](#media-object-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Déclencheur d'objet multimédia) | Description |
| :---: | ---|
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur d'objet multimédia s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur d'objet multimédia s'est produit. |


#### Valeurs du déclencheur (Déclencheur Websocket)

Lorsqu'un [déclencheur Websocket](#websocket-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Déclencheur Websocket) | Description |
| :---: | ---|
| **`Message`** | Un message qui peut être utilisé pour décrire et étiqueter, permettant ainsi de (à la réception) filtrer entre différents types de données.  |
| **`Données`** | Une valeur qui peut contenir différents types de données, telles que les choix des participants, les horodatages, les coordonnées x/y de la souris, etc.  |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur Websocket s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur Websocket s'est produit. |


#### Valeurs du déclencheur (Déclencheur OpenAI)

Lorsqu'un [déclencheur OpenAI](#openai-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de déclencheur (OpenAI) | Description |
| :---: | ---|
| **`Réponse de Chat GPT`** | La valeur de la réponse de ChatGPT. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur OpenAI s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur OpenAI s'est produit. |


#### Valeurs du déclencheur (Événement expérimental global)

Lorsqu'un [déclencheur de pause / reprise de l'expérience](#pause-resume-experiment) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options de déclencheur (Événement expérimental global) | Description |
| :---: | ---|
| **`Temps total du cadre`** | Fait référence au Temps total du cadre alloué avant le Déclencheur. |
| **`Raison de l'événement global`** | Une valeur de chaîne qui indique la raison du déclencheur, comme le départ d'un participant de l'étude. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur d'événement global s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur d'événement global s'est produit. |


#### Valeurs du déclencheur (Utilisateur quitte l'expérience)

Lorsqu'un [déclencheur d'utilisateur quittant l'étude multijoueur](#participant-left-multiuser-study) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

| Options&nbsp;Déclencheur&nbsp;(Utilisateur&nbsp;quitte l'expérience) | Description |
| :---: | ---|
| **`Nombre restant de participants `** | Le nombre de participants qui restent dans l'étude. |
| **`Horodatage du déclencheur (temps Unix)`** | L'horodatage de quand le déclencheur Utilisateur quitte l'expérience s'est produit au format temps Unix avec des millisecondes. |
| **`Temps du déclencheur (à partir du début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le déclencheur Utilisateur quitte l'expérience s'est produit. |