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 des déclencheurs
• Pour la liste complète des actions
• Pour plus d'informations sur le menu Sélectionner une valeur pour définir des 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 "lorsque cela se produit" (déclencheur) puis "faites cela" (action). Par exemple : si un participant clique sur une image spécifique (déclencheur) alors montrez une autre image aléatoire (action).

Pour une introduction sur le fonctionnement des événements dans Labvanced, veuillez consulter cette vidéo rapide :

Création d'Événements - Aperçu

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 en cliquant sur + Frame Event pour les événements qui doivent se produire sur cette image ou en cliquant sur + Trial Event qui applique l'événement à toutes les images. Tous les événements existants sont affichés dans une vue en liste dans le panneau latéral droit. Les événements sont définis au niveau de l'image et peuvent être séparés/spécifiques pour chaque image ou dupliqués/identiques sur chaque image à travers un essai.

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

Sélection d'un Déclencheur

Lorsque vous créez un nouvel événement, la sélection de déclencheur s'ouvre sous forme de grille de tuiles. Les types de déclencheurs sont organisés par catégorie (Entrée Utilisateur, Signal Physiologique, Essai et Image, Variable, Objet Média, API, et Global). Une boîte de recherche en haut vous permet de filtrer les types de déclencheurs par nom. Cliquez sur une tuile pour la définir comme le déclencheur de l'événement.

Une fois qu'un déclencheur est sélectionné, l'événement affiche une barre compacte avec le nom et l'icône du déclencheur actuel. Pour passer à un autre déclencheur, cliquez sur le bouton Change trigger (icône de crayon) pour rouvrir la grille de tuiles.

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 sont 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 en bas à droite (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 certaine entrée de clavier, un changement de variable, le début d'un fichier vidéo, ou bien d'autres choses. Tous les déclencheurs et leurs paramètres sont expliqués dans la liste suivante :

Catégorie de Déclencheur	Options de Déclencheur	Description
User Input Triggers	Déclencheurs de souris Déclencheurs de clavier Clics de bouton Entrée sur Input Déclencheur de défilement Déclencheur de manette/joystick	Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur pouvant être activé manuellement par l'utilisateur/participant en faisant quelque chose comme déplacer sa souris, cliquer sur un élément du clavier, défiler, etc.
Physiological Signal Triggers	Suivi oculaire Gaze Suivi oculaire Fixation Suivi de tête	Les déclencheurs de signal physiologique 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.
Trial and Frame Triggers	Initialisation de Tâche Initialisation de l'Image Début de l'Image Fin de l'Image	Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux images, comme lorsque le début ou la fin d'une image se produit.
Variable Value Changed Trigger	Variable (Valeur Changée)	Un déclencheur pour l'événement se produit lorsqu'il y a un changement de la valeur d'une variable spécifique.
Media Object Trigger	Déclencheur d'Objet Média	Ce déclencheur se produit par rapport aux objets médias, comme lorsqu'il y a une pause dans un fichier vidéo ou audio, une enregistrement terminé, etc.
API Triggers	Déclencheur Websocket Déclencheur Open AI MessagePost Reçu	Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API.
Global Triggers	Pause / Reprendre l'Expérience Participant A quitté l'Étude Multiutilisateur	Les déclencheurs globaux se réfèrent à tout changement majeur dans une expérience, comme lorsqu'elle est mise sur pause ou qu'un participant dans une étude multiutilisateur part.

Déclencheurs d'Entrée Utilisateur

Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur pouvant ê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 à venir.

Option de Déclencheur d'Entrée Utilisateur	Aperçu
Mouse Trigger	Tout mouvement de souris peut être utilisé comme déclencheur pour initier un événement, tel que : faire défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou cibles spécifiques avec un déclencheur. Par exemple, un clic de souris sera utilisé comme déclencheur uniquement si une image spécifique est cliquée.
Keyboard Trigger	Toute pression de touche peut être utilisée comme déclencheur pour initier un événement. Vous pouvez spécifier des lettres ou des chiffres de clavier spécifiques comme déclencheurs.
Button-Clicks	Les objets de bouton créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements.
Enter on Input	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 ses entrées dans les zones de texte.
Scroll Trigger	Ce déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier des directions de défilement x ou y, ainsi que sur quels éléments le défilement se produit pour être utilisés comme déclencheurs d'événements.
Gamepad/ Joystick Trigger	Ce déclencheur vous permet d'utiliser des manettes et des contrôleurs joystick dans votre conception expérimentale comme appareil 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 avec la souris, telle que : déplacer la souris vers le haut/bas, cliquer, survoler un objet spécifique, quitter un objet spécifique ou tout mouvement !

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ément de menu	Zone de menu	Options et spécifications des déclencheurs de souris
Action liste déroulante :		Les options de déclencheur de souris suivantes sont disponibles dans la liste déroulante : Click : Déclenché par clic de souris PressDown : Déclenché par appui sur la souris PressUp : Déclenché par relâchement de la souris Hover : Déclenché en passant la souris sur un objet Leave : Déclenché en sortant d'un objet Move : Déclenché par tout mouvement de souris
Button liste déroulante :		Left : Déclenché par le bouton gauche de la souris Right : Déclenché par le bouton droit de la souris
Targets options :	Dans l'exemple ci-dessus, 'Image_1' est la cible du clic de bouton qui déclenchera l'événement. Des cibles multiples peuvent être ajoutées en cliquant sur l'option ‘+Add Target’ en bas.	Lors de la spécification d'une cible, les options suivantes sont disponibles : Déclencher sur l'arrière-plan du cadre : le déclenchement de la souris peut être activé sans cliquer sur un objet ou un élément. Tout élément : le déclenchement de la souris peut être activé en cliquant sur n'importe quel élément du cadre. Ajouter des cibles : sélectionnez l'élément ou 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 à travers diverses actions avec le menu de sélection de valeur.

Déclencheurs de Clavier

L'option 'Déclencheur de Clavier' est une autre façon populaire d'avoir un événement déclencheur. Essentiellement, toute entrée du clavier peut être utilisée comme déclencheur. Cela inclut : appuyer, maintenir ou relâcher une touche.

Dans l'exemple ci-dessous, le déclencheur est défini sur une pression de touche qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont enfoncées :

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

Élément de menu	Zone de menu	Options de Déclencheur de Clavier
Action liste déroulante :		Ce sont les options d'action du clavier disponibles : PressKey : Déclenché par pression de touche (la touche est enfoncée) Press OU Maintenir la Touche : Déclenche lorsque la touche est enfoncée ou maintenue ReleaseKey : Déclenché par relâchement de la touche Note : Une touche doit être relâchée avant de pouvoir 'déclencher' à nouveau comme déclencheur.
Keys quelle touche déclenche l'événement		Quelle touche est utilisée comme déclencheur est spécifiée en sélectionnant les options ici en cliquant sur +Add: Flèches : les quatre touches fléchées Nombres : Nombres de 0 à 9 Lettres : Toutes les lettres de l'alphabet anglais Spécial : Touches spéciales (Entrée, Espace, Contrôle, Tab, Shift) Touche F : F1 à F10 toute touche : n'importe laquelle de ces touches est acceptable Vous pouvez ajouter plusieurs déclencheurs de clavier en cliquant à nouveau sur le bouton +Add:
Options Supplémentaires		L'option activer les boutons du pavé numérique permet d'utiliser les touches du pavé numérique comme déclencheurs au sein de l'expérience. Pour l'option permettre la propagation des événements, 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 spécifiques au déclencheur de clavier à travers diverses actions avec le menu de sélection de valeur.

Déclencheur de Clic sur Bouton

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

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

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

Élément de menu	Zone de menu	Options de Déclencheur de Clic sur Bouton
Cible : +Set Target		Sélection d'un élément de bouton comme cible
Button: option		Spécifiez quel bouton spécifique sur le cadre

• Note : Après avoir sélectionné le déclencheur de Clic sur Bouton 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 de clic sur bouton à travers diverses actions avec le menu de sélection de valeur.

Déclencheur Entrée sur Input

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

Paramètres :

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

• Note : Après avoir sélectionné le déclencheur Entrée sur Input dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques à Entrée sur Input à travers diverses actions avec le 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 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éfinissez l'élément cible auquel le déclencheur de défilement s'appliquera.

Note : Pour du texte long, dans le panneau 'Propriétés de l'objet' sous la section 'Style', les options Overflow-X et/ou Overflow-Y doivent avoir scroll 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 à travers diverses actions avec le menu de sélection de valeur.

Déclencheur de Manette/ Joystick

Le Gamepad/ Joystick Trigger vous permet d'utiliser des manettes et des joysticks dans votre conception expérimentale comme dispositif d'entrée pour enregistrer des données. Note : n'oubliez pas d'activer cette option dans l'onglet Settings.

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 ont été activés pour la tâche.

Déclencheur de Regard de Suivi Oculaire

Déclencheurs sur :

• Globalement, ce déclencheur s'appliquera lorsque le suivi oculaire a été activé.
• Déclenche uniquement lorsqu'on regarde 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 à travers diverses actions avec le menu de sélection de valeur.

En savoir plus : Consultez la page dédiée au Déclencheur de Regard de Suivi Oculaire pour activer le suivi oculaire, enregistrer des données de regard et des exemples pratiques.

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 à travers diverses actions avec le menu de sélection de valeur.

En savoir plus : Consultez la page dédiée au Déclencheur de Fixation de Suivi Oculaire pour activer la Détection de Fixation, enregistrer des données de fixation et des exemples pratiques.

Déclencheur de Suivi de Tête

Déclencheurs sur :

• Changements d'orientation de tête ou de mouvement de 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 à travers diverses actions avec le menu de sélection de valeur.

### Déclencheurs de Trial et Frame

#### Déclencheur d'Initialisation de Tâche
Déclenche lorsque : 
* 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 s'accorde bien avec les actions Mélanger et Lire À Partir. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les cadres 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 d'initialisation de tâche dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [les valeurs d'initialisation de tâche spécifiques au déclencheur](#trigger-on-task-initialization-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


#### Déclencheur d'Initialisation de Frame
Déclenche lorsque :
* L'initialisation de la frame, avant qu'elle ne devienne visible pour le participant. 

Ce déclencheur s'accorde bien avec les actions Mélanger, Lire À Partir et Tirer un Nombre Aléatoire. Avec ces combinaisons, ces actions peuvent être complétées avant l'apparition de la frame, laissant un chemin clair pour que d'autres actions commencent lorsque la frame commence. 

**Note :** Ne pas utiliser le déclencheur d'initialisation de frame 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 d'initialisation de frame se produit entre les essais, donc il n'y a pas un compte entièrement 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 d'initialisation de frame dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [les valeurs d'initialisation de frame spécifiques au déclencheur](#trigger-on-frame-init-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


**Note sur les Déclencheurs d'Initialisation de Tâche et de Frame :** Étant donné que les déclencheurs d'initialisation de tâche et de frame se produisent avant le début de la tâche ou de la frame, les variables créées pendant ce temps se réinitialiseront lorsque la tâche/frame commencera réellement. Un avertissement apparaîtra lors de l'utilisation de cet événement :

![avertissement d'initialisation de frame](/content_imgs/learn/guide/task-editor/frame-init-var-reset.webp)

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 variable si vous ne souhaitez pas que les valeurs des variables soient réinitialisées. 

#### Déclencheur de Début de Frame
Déclenche lorsque :
* Début de la frame 

Paramètres : Aucun

* **Note :** Après avoir sélectionné le déclencheur de début de frame dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [les valeurs de début de frame spécifiques au déclencheur](#trigger-on-frame-start-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


#### Déclencheur de Fin de Frame
Déclenche lorsque :
* Fin de la frame (après que la frame ne soit plus visible)

Paramètres : Aucun

* **Note :** Après avoir sélectionné le déclencheur de fin de frame dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [les valeurs de fin de frame spécifiques au déclencheur](#trigger-on-frame-end-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


### Déclencheur de Valeur de Variable Changée

#### Valeur de Variable Changée 
Déclenche lorsque :
* La valeur d'une variable change par rapport à sa valeur de départ

Paramètres :
* Variables : Sélectionnez une ou plusieurs variables dont 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 de valeur de variable changée dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [les valeurs de variable changée spécifiques au déclencheur](#trigger-variable-value-changed-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


### Déclencheurs d'Objet Média

#### Déclencheur d'Objet Média

Autrefois connu sous le nom de "Déclencheur de Contrôle Audio/Video" et "Déclencheurs de Contrôle d'Objet" séparés.

Déclenche lorsque :
* Démarrage, pause ou arrêt d'un fichier vidéo ou audio
* Téléchargement de Fichier Terminé, Fichier Sélectionné, Enregistrement Fait d'un objet d'enregistrement 
* Instantané Terminé ou Téléchargement Complet d'un objet d'instantané de caméra

Paramètres :
* Cible : Sélectionnez un élément d'objet qui existe sur la frame
* Exécuter Sur : Sélectionnez le sous-type de déclencheur
    * Options d'Objet Audio ou Vidéo :
        * Lecture Démarrée : Déclenche lorsque l'élément commence à jouer
        * Lecture Arrêtée : Déclenche lorsque l'élément est en pause
        * Lecture Terminée : Déclenche lorsque l'élément cesse 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 du 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 d'Instantané de Caméra :
        * 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é de télécharger 

* **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 référencer [les valeurs d'objet média spécifiques au déclencheur](#trigger-media-object-trigger-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


### Déclencheurs d'API

Si vous devez envoyer ou communiquer des données d'un serveur externe vers Labvanced, alors les ‘Déclencheurs d'API’ et [‘Actions d'API’](/content/learn/fr/guide/task-editor/event-system.html#api-actions) peuvent être utilisés. Les suivants peuvent servir de déclencheurs :
* Déclencheur Websocket
* Déclencheur OpenAI
* Message Post Reçu

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


#### 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 de l'Action.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_trigger.webp" alt="L'option de menu de déclencheur Websocket." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_dialog.webp" alt="Le menu de dialogue du déclencheur Websocket." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

* **Accepter/Reçu de :** Auto-detecte l'adresse IP de l'hôte local. Peut être changé manuellement dans l'onglet [`Settings`](/content/learn/fr/guide/settings/) sous `Special Features`. 
* **Déclencheur/message :** saisissez le message qui servira de déclencheur. Tapez 'any' pour accepter plus d'un message comme déclencheur.

Pour un exemple de la façon dont les Déclencheurs / Actions d'API sont utilisés, veuillez consulter cette démo [https://www.labvanced.com/page/library/51053](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 à l'API, veuillez visiter cette page.](https://www.labvanced.com/content/learn/fr/guide/api-access/)** 

* **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 référencer [les valeurs spécifiques au déclencheur WebSocket](#trigger-websocket-trigger-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


#### Déclencheur OpenAI

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

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

La sélection de cette option affichera les paramètres suivants : 

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

**NOTE :** Référez-vous également à [ce guide]( /content/learn/fr/walkthroughs/2024-09-chatgpt-study-example/) 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 cadre de données qui a été assigné s'appelle ‘df’ et le résultat du ‘Déclencheur OpenAI’ sera ajouté à ce cadre de données. Ce cadre de données doit avoir deux colonnes. La première colonne indiquera le 'rôle' et la deuxième colonne le 'message de chat.' Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_trigger_example.webp" alt="Un exemple du déclencheur OpenAI dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Si vous utilisez également l'[‘Action Envoyer à OpenAI’,](#send-to-openai-action) alors vous devez utiliser le même cadre de données ici que vous l'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 référencer [les valeurs spécifiques au déclencheur OpenAI](#trigger-openai-trigger-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


#### Déclencheur Message Post Reçu

Le `PostMessage Received` déclenche lorsque l'expérience en cours reçoit un message entrant d'une source externe via l'API postMessage du navigateur. Il est utile pour connecter une expérience à une page parente, une application personnalisée, ou un site Web externe intégré qui envoie des données dans l'étude.

[Apprenez-en plus.](/content/learn/fr/guide/events/postmessage-received-trigger.html)

* **Note :** Après avoir sélectionné le déclencheur Message Post Reçu dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [les valeurs spécifiques au déclencheur Message Post Reçu](#trigger-postmessage-received-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu)

### 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' tel que la pause de l'expérience ou un participant quittant une étude multi-utilisateurs ! Les options suivantes sont listées comme Déclencheurs Globaux :
* Mettre en pause / Reprendre l'expérience
* Participant a quitté l'étude multi-utilisateurs

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

#### 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 mise en pause ou la reprise de l'expérience. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/pause_trigger.webp" alt="L'option d'utiliser une pause dans l'expérience comme déclencheur." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

 <p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_dialog.webp" alt="Menu de dialogue pour ce déclencheur global" width="50%">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_options.webp" alt="Options disponibles dans le menu des déclencheurs globaux" width="50%">
</p>

* **Expérience en pause :** Le participant met en pause (sort de l'écran plein) l'étude.
* **Expérience reprise :** 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 support de menton virtuel.

* **Remarque :** 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 référencer [valeurs spécifiques au déclencheur](#trigger-global-experiment-event-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus.webp" alt="L'option Participant a quitté l'étude multi-utilisateurs comme déclencheur dans Labvanced" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus_dialog.webp" alt="La boîte de dialogue déclencheur participant a quitté l'étude multi-utilisateurs." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

* **Remarque :** Après avoir sélectionné le déclencheur Participant a quitté l'étude multi-utilisateurs dans le système d'événements, vous avez la possibilité d'utiliser et de référencer [valeurs spécifiques au déclencheur](#trigger-user-leaves-experiment-values) à travers diverses actions avec le [menu de sélection de valeur.](#the-value-select-menu) 


## 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'objet, enregistrer des données, lire et écrire des données depuis / vers des tableaux, ou passer à l'essai ou à la tâche suivante. 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 le fait d'imbriquer des actions les unes dans les autres (par exemple, une boucle while dans une instruction if). Par conséquent, le système d'événements peut être vu comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme des appels de fonction, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit que presque n'importe quelle logique expérimentale peut être mise en œuvre sans avoir recours à certaines structures programmatiques / syntaxiques.

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

| Catégorie d'Action <img width=200/>  | Options d'Action  <img width=500/>| Description <img width=400/> | 
| :----: | -- | ----- | 
| [`Object Actions`](#object-actions)| <ul><li> [Définir Propriété d'Objet](#set-object-property-action) </li> <li> [Contrôler Objet Multimédia](#control-media-object-action) </li> <li> [Copier Objet](#copy-object-action) </li> <li> [PourChaque Objet](#foreach-object-action) </li> </ul> | Les actions d'objet font référence à toute manipulation qui se produira sur un objet existant dans la tâche. |
| [`Variable Actions`](#variable-actions) | <ul><li> [Définir / Enregistrer Variable](#set-record-variable-action) </li> <li> [Copier dans le Presse-papiers](#copy-to-clipboard-action) </li> <li>[Tirer un Numéro Aléatoire](#draw-random-number-action) </li> <li> [Obtenir Paramètre d'URL](#get-url-parameter-action) </li> <li> [Lire depuis / Écrire sur Appareil](#read-from-write-to-device-action) </li> <li> [Lire depuis / Écrire sur Variable Partagée](#read-from-write-to-shared-variable-action) </li> <li> [Mathématiques & Statistiques](#math-statistics-action) </li> <li>[Enregistrer Variables Instantanément](#record-variables-instantly-action) </li> <li>[Filtre Moyenne Mobile](#moving-average-filter-action) </li> <li> [Distribuer Variable](#distribute-variable-action) </li> </ul> |  Toute action qui lit ou enregistre une valeur de variable. |
| [`Array Actions`](#array-actions) | <ul><li> [Sélectionner Depuis Tableau (Lire)](#select-read-from-array-action) </li> <li> [Ajouter / Supprimer Éléments de Tableau](#add-remove-array-entries-action) </li> <li> [Changer Éléments de Tableau (Remplacer)](#change-replace-array-entry-action) </li> <li> [Mélanger Éléments de Tableau](#shuffle-array-entries-action)  </li> </ul> | Les opérations sur les tableaux impliquent de sélectionner, ajouter, supprimer, changer et mélanger les tableaux et leurs entrées. | 
| [`Data Frame Operations`](#data-frame-operations) | <ul><li> [Lire depuis / Écrire sur Data Frame](#read-from-write-to-data-frame-action) </li> <li> [Mélanger Éléments de Data Frame](#shuffle-data-frame-entries-action)  </li> </ul> | Ces actions sont pertinentes si vous travaillez avec des fichiers .csv (data frames) dans votre expérience. |
| [`Jump Actions`](#jump-actions) | <ul><li> [Aller à](#jump-to-action) </li> <li> [Accepter / Terminer Session](#accept-end-session-action) </li> <li> [Rejeter / Terminer Session](#reject-end-session-action) </li> <li>[Rediriger vers URL](#redirect-to-url-action)</li></ul> | Vous permet de naviguer dans l'expérience en sautant à une section spécifique, ainsi que d'accepter et de rejeter des sections de participants. | 
| [`Control Actions`](#control-actions) | <ul><li>  [Actions de Condition (Si…Alors)](#requirement-actions-if-then-else-if-action) </li><li> [Actions Répétées (Boucle While)](#repeated-actions-while-loop-action) </li><li> [Actions Retardées (Callback Temps)](#delayed-actions-time-callback-action) </li><li> [Groupe d'Actions](#action-group) </li></ul> | Les actions de contrôle sont utilisées pour exécuter des séquences spécifiques d'événements, comme la logique si/alors, les boucles (comme jouer un son répété ou faire clignoter une image), ainsi que pour mettre en place un délai quant à quand une action se produit. | 
| [`API Actions`](#api-actions) | <ul><li> [Envoyer PostMessage](#send-postmessage-action) </li><li> [Envoyer à Websocket](#send-to-websocket-action) </li><li> [Envoyer à OpenAI](#send-to-openai-action) </li></ul> | Fait référence à des actions spécifiques à l'API pour envoyer des données à une API. |
| [`Code Actions`](#code-actions) | <ul><li> [Exécuter JavaScript](#run-javascript-action) </li> <li> [Définir CSS Global](#set-global-css-action) </li></ul> |  Les actions de code vous permettent de travailler avec JavaScript ou CSS. 
| [`Paste Action`](#paste-action) | 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 Objet :
* Définir Propriété d'Objet
* Contrôler Objet Multimédia
* Copier Objet
* PourChaque Objet 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/object_actions_menu.webp" alt="L'option Actions sur les Objets dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

[En savoir plus.](/content/learn/fr/guide/events/set-object-property-action.html) 


#### Action de Contrôler Objet Multimédia

Auparavant les actions distinctes "Contrôler Audio/Video" et "Contrôler Objet".

Effet : Change la lecture d'éléments vidéo/audio ou change l'état des éléments d'upload/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 Lecture : Commence à jouer le fichier vidéo / audio
        * Arrêter Lecture : Arrête le fichier vidéo / audio
        * Mettre en Pause Lecture : Met en pause le fichier vidéo / audio
        * SauterÀTemps : vous permet de spécifier un temps en millisecondes à atteindre dans le fichier audio/vidéo
        * Couper le son : désactive le son de l'objet
        * Rétablir le son : restaure le son de l'objet
    * Options d'Objet Audio, Vidéo ou Enregistrement d'Écran :
        * Démarrer Enregistrement : Commence un nouvel enregistrement (audio)
        * Arrêter Enregistrement : Arrête l'enregistrement (audio)
        * Démarrer Upload : Commence à uploader le fichier
        * Effacer Enregistrement : Supprime les données d'enregistrement (audio).
        * Démarrer Lecture : Commence à jouer le fichier enregistré
        * Arrêter Lecture : Arrête de jouer le fichier enregistré
        * Mettre en Pause Enregistrement : met en pause l'enregistrement de l'objet
        * Reprendre Enregistrement : reprend l'enregistrement de l'objet
    * Options d'Objet d'Upload de Fichier :
        * Démarrer Upload : commence le processus d'upload pour le fichier sélectionné
        * Effacer Fichier : Supprime le fichier sélectionné
        * Choisir Fichier : permet au participant de choisir le fichier souhaité
    * Options d'Objet de Capture de Caméra :
        * Démarrer Caméra : allume la caméra du participant
        * Arrêter Caméra : éteint la caméra du participant
        * Démarrer Upload : commence à uploader la capture à l'expérience
        * Prendre Capture : prend une photo en utilisant la caméra du participant 

Action Copier d'objet

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

Paramètres :

• Source : Choisissez l'objet sur la scène à copier.
• Nombre de copies : Entrez le nombre de copies à faire 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 un suffixe incrémental : Ajoute une balise numérique à la fin du nom du nouvel élément pour différencier les copies.
• Séquence d'action : Vous permet de choisir (dans la liste habituelle d'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 :

• Filtre : Choisissez le type d'élément à cibler.
• Autoriser le filtre de nom supplémentaire : Tapez le nom de l'objet(s) à cibler. Pour plusieurs objets sur une scène où certains ont des noms identiques, cela fonctionne bien.
• Séquence d'action : Vous permet de choisir (dans la liste habituelle d'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 de Variable

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

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

Option d'Action de Variable	Description
Set / Record Variable	Écrire ou définir une valeur de variable
Copy to Clipboard	Copier une valeur de variable dans le presse-papiers interne de l’ordinateur.
Draw Random Number	Tire un ou plusieurs nombre(s) aléatoire(s) et les enregistre dans une variable
Get URL Parameter	Enregistrer une valeur à partir de l'URL unique du participant
Read from / Write to Device	Lit ou écrit une variable dans ou depuis le stockage local de l'appareil. Cette action enregistre des données sur l'appareil du participant plutôt que de les envoyer aux serveurs de Labvanced.
Read from / Write to Shared Variable	Lit ou écrit dans une variable partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou être privée pour chaque individu.
Math & Statistics	Effectue une opération mathématique sur une variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.
Record Variables Instantly	Crée un instantané de toutes les valeurs de variables et l'envoie au serveur Labvanced.
Moving Average Filter	Calcule une moyenne mobile (une moyenne constamment mise à jour des données) sur certaines entrées et stocke le résultat dans une nouvelle variable.
Distribute Variable	Enverra une valeur à d'autres participants. La valeur est stockée dans une variable.

Action Définir / Enregistrer Variable

L’Action ‘Définir / Enregistrer Variable’ est amené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.

En cliquant 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 du Menu	Zone du Menu	Description
Select		En cliquant sur sélectionner, vous indiquez quelle variable doit stocker la valeur. À partir d'ici, 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 qui est utilisé pour définir et spécifier les valeurs exactes qui doivent ê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 faire augmenter la valeur de la variable de 1 (en fonction du 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 lors d'une étude. L'image ci-dessous montre comment trois actions sont utilisées pour rendre possible l'enregistrement de la valeur de variable. La variable (à gauche) est créée manuellement tandis que la valeur à droite 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 Set / Record Variable est également couramment utilisée dans le contexte de Control Actions où vous pouvez spécifier des conditions à l'aide de 'si/alors' et de 'boucles while' basées sur des valeurs de variable.

Action Copier dans le Presse-papiers

Effet : Copier 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 : Choisir entre des valeurs continues et discrètes
• Distribution : Choisir entre distribution gaussienne et uniforme
• Tirages Multiples (booléen vrai/faux) : Choisir de tirer une fois ou plusieurs fois.
• Nr de Tirages : Sélectionner le nombre de tirages
• Min : Définir la valeur minimale pour la distribution uniforme
• Max : Définir la valeur maximale pour la distribution uniforme
• Moyenne : Définir la valeur moyenne pour la distribution gaussienne
• Écart-Type : Définir l'écart-type pour la distribution gaussienne
• Enregistrer dans Variable : Sélectionner une variable où les valeurs sont stockées.

Action Obtenir un Paramètre d'URL

Effet : Enregistre une valeur à partir de l'URL unique du participant.

Paramètres :

• Nom du paramètre : saisissez le nom du paramètre souhaité
• Enregistrer dans 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 URLs uniques pour les participants ou extraire des informations nécessaires à l'analyse des données.

Action Lire depuis/Écrire vers un Dispositif

Effet : Lit ou écrit une variable dans ou depuis le stockage local de l'appareil. Cette action enregistre des données sur l'appareil du participant plutôt que de les envoyer aux serveurs de Labvanced.

Paramètres :

• Choisir de lire ou d'écrire sur le dispositif local.
• Choisir la variable à lire ou écrire.

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

• Avec cette action, les données spécifiques à l'appareil peuvent être transférées d'une session à l'autre, à condition que le même participant utilise le même appareil pour chaque session.
• Par exemple, vous pouvez utiliser cette action pour enregistrer quelles images ont été présentées à chaque participant dans la Session 1 et vous assurer que différentes images leur sont présentées dans la Session 2.
  • Créer un tableau d'images et en sélectionner aléatoirement quelques-unes à présenter dans chaque session.
  • Écrire sur le Dispositif : le numéro d'index des images présentées dans la Session 1.
  • Lire depuis le Dispositif : dans la Session 2, lire les index des images de la Session 1 et inclure une action JavaScript qui empêche ces index d'être sélectionnés pour la deuxième session.

Action Lire depuis/Écrire vers 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 un changement, puis envoie la variable à l'étude.
    • Lire uniquement la valeur partagée depuis le serveur : appelle la variable qui est partagée au sein de l'étude, mais ne fait aucun changement.
    • Écrire uniquement la variable sur le serveur : effectue des changements à la variable partagée, mais ne l'affiche pas aux participants.
    • Partager des valeurs entre différents participants (pas seulement entre les 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 cliquant sur la case à cocher.
• Séquence d'action :
  • Choisissez ce qui arrive à la variable partagée/synchronisée dans la liste de toutes les actions disponibles.

Use Case: Études longitudinales/multi-sessions

• Avec cette action, les données spécifiques aux participants peuvent être reportées de session en session et partagées entre les participants au cours des sessions.
• Par exemple, vous pouvez utiliser cette action pour enregistrer un score à un test, puis permettre au participant de comparer son score à la moyenne des scores des autres participants qui ont complété le test.
• Un autre exemple (similaire à l'action Lire depuis/Écrire vers un appareil) consiste à faire choisir aux participants 5 images qu'ils aiment dans un ensemble, à effectuer une tâche, puis à présenter de nouveau ces 5 images dans 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 variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.

Paramètres :

• Type : Choisissez entre les opérations sur tableaux, l'algèbre linéaire et les tests statistiques
• Opération : Choisissez une opération mathématique (par exemple 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 une capture instantanée de toutes les valeurs des variables et l'envoie au serveur Labvanced.

Paramètres : Aucun

Action Filtre de moyenne mobile

Effet : Calcule une moyenne mobile (une moyenne mise à jour en permanence des données) d'une certaine entrée et enregistre 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 sorte que les poids des échantillons diminuent linéairement.
  • Moyenne mobile exponentielle : Pèse les échantillons de sorte que les poids des échantillons diminuent de manière exponentielle.
• 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 aux informations (y compris les emplacements des stimuli et tout changement) d'être reflétées sur les écrans des participants. Consultez Action Distribuer la variable pour un tutoriel dédié de cette action à part entière.

Lors de la sélection de 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 une 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 à distribuer est une action utilisée comme moyen de créer un chat entre deux participants en distribuant la valeur d'une variable d'un objet champ d'entrée.

Découvrez cette démo qui incorpore la variable à distribuer et la fonctionnalité de boîte de chat ici : Tâche de description d'image avec add-on de chat.

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

Élément du menu	Zone de menu	Options et description de l'action Distribuer la variable
Distribute value to		Choisissez les autres participants à qui la valeur doit être envoyée. Tous les participants : Envoyez cette valeur à tous les participants Participants sélectionnés : Envoyez la valeur aux participants sélectionnés.
Choose target variable and value		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.
Block		Si activée, la variable cible ne peut pas être modifiée jusqu'à ce que la distribution actuelle de valeurs soit terminée.
Rate Limit Strategy		La stratégie de limite de taux est un moyen de protéger votre expérience contre une surcharge du serveur et agit comme une stratégie préventive pour contrôler le taux d'envoi des requêtes (c'est-à-dire les mises à jour via la variable distribuée) 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 temps de 100 ms, les nouveaux messages du serveur seront "débouncés" (seul le message le plus récent sera envoyé après un intervalle de 100 ms sans aucune exécution de cette action). Throttle : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, les nouveaux messages seront limités (c'est-à-dire qu'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 temps de 100 ms, les nouveaux messages dans cette fenêtre de 100 ms seront ignorés. Queue : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, les nouvelles valeurs de variable seront mises en file d'attente (jusqu'à une taille maximale de file d'attente de 10 messages).

Actions sur les tableaux

Action Sélectionner (Lire) dans le tableau

Effet : Lira une variable dans 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 : Utilisez 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 : Utilisez 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 du tableau : Lire à partir de 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 du tableau

Effet : Ajoute et/ou supprime des entrées d'un tableau.

Paramètres :

• Variable de tableau : Variable de tableau où l'opération ajouter ou supprimer doit être exécutée.
• Type d'index : Détermine quel type d'index est utilisé.
  • Fixe : Utilisez un index fixe pour l'opération d'insertion/suppression. Dans ce cas, tapez la position dans le tableau où les entrées doivent être insérées/supprimées. (1 basé).
  • Variable : Utilisez 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 du tableau : Insérez/supprimez à partir de la fin du tableau.
• Nombre d'entrées à supprimer : Supprimera les entrées du tableau (avant l'insertion 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) l'entrée du tableau

Effet : Remplace/changer une valeur dans 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 : Utilisez un index fixe pour l'opération de remplacement. Dans ce cas, tapez dans la position du tableau qui doit être changée (1 basé).
  • Variable : Utilisez 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 du tableau : Remplacez la dernière entrée dans le tableau.
• Variable d'entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.

Action Mélanger les entrées du 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 vers un cadre de données

Effet : Lit des valeurs à partir d'un cadre de données 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 en tant que 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

Sauter à l'action

Effet : "Saute" le participant à une étape différente de 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 cadre suivant. 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 vers lequel sauter.
  • Essai spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro d'essai vers lequel 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 à laquelle sauter.
  • Bloc spécifique : Saute à la première instance du bloc spécifié. Les utilisateurs sélectionnent directement le bloc vers lequel 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 de saut n'est pas exécutée.

Accepter/Terminer l'action de session

Effet : Acceptera les données du participant, terminera la session d'enregistrement et affichera le code de crowdsourcing.

Paramètres :

• Enregistrer les données d'essai avant de terminer la session : Si activé, les données d'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 affiché 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.

Rejeter/Terminer l'action de 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 qui explique la raison pour laquelle ils ne seront pas récompensés pour leur temps.

Paramètres : Aucun

Rediriger vers l'action 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 condition (Si... Alors... Sinon Si)

Effet : Évalue une affirmation si-alors et exécute une série d'actions de manière dépendante. Chaque déclaration Si/ Sinon Si se compose de comparaisons imbriquées AND / OR pour évaluer si toutes les exigences sont satisfaites (la déclaration est vraie) ou non (la déclaration est fausse). Si la déclaration est vraie, les actions sous "Alors" sont exécutées. Voir Action de condition pour une explication détaillée de cette action à part entière, y compris un exemple de Role_Id détaillé.

Paramètres :

• Ajouter une exigence : Ajouter une nouvelle exigence à une déclaration. Le menu "sélectionner la 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 exemple, égal, plus petit que, différent, etc.).
• Ajouter un groupe OU : Un seul des exigences dans un groupe OU doit être vrai pour que l'ensemble du groupe 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 satisfaites.
• Séquence d'actions : Chaque déclaration Si / Sinon Si a une liste d'actions, qui sont 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'actions ne sera exécutée que si l'exigence du (des) déclaration(s) Si / Sinon Si associées sont remplies.
• Ajouter un cas Sinon Si : L'action de condition peut consister en plusieurs déclarations Si / Sinon Si --> Alors distinctes. Cependant, une seule déclaration peut être exécutée. Si une déclaration Si / Sinon Si est évaluée positivement (renvoie vrai), les actions dans le bloc Alors sont exécutées et le reste de l'action de condition est ignoré.
• Ajouter un cas Sinon (vrai / faux) : Si activé, une option par défaut / de secours est ajoutée à l'action de condition. Si aucune des déclarations Si / Sinon Si n'est exécutée (renvoyée vrai), les actions définies dans le cas sinon seront exécutées.

Actions répétées (Boucle While)

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 afin que l'exécution de la boucle soit 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 de manière continue jusqu'à ce que la condition d'arrêt soit remplie.
  • Exécuter chaque ... ms : Cela exécutera la boucle avec un intervalle défini (par exemple, la boucle est exécutée toutes les 50 ms).
• Définir le nombre de boucles : Lorsque "Exécuter chaque ... 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.
• Commencer immédiatement (vrai / faux) : Si activé, cela exécutera la boucle immédiatement. Si désactivé, la boucle sera démarrée lors du prochain intervalle d'exécution.
• Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de boucle 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 pour savoir 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'actions : 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 (Temps Callback)

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

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'actions : 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 aussi ê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 à la fois.

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 PostMessage
• Envoyer à Websocket
• Envoyer à OpenAI

Pour que ces actions soient ‘disponibles’ ou utilisables, vous devez entrer une clé API dans l’onglet Settings.

Envoyer l'action PostMessage

L'action Send PostMessage envoie un message d'une expérience Labvanced en cours vers une cible externe, telle qu'une page web parente ou un cadre intégré, en utilisant l'API postMessage du navigateur.

En savoir plus.

Envoyer à l'action Websocket

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

L'exemple ci-dessus et la structure d'événement complète 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.

Envoyer à l'action OpenAI

L'action ‘Envoyer à OpenAI’ vous permet d'envoyer des informations, telles qu'une valeur d'entrée sous forme de chaîne, à OpenAI. Veuillez noter que pour que cette option soit disponible, vous devez lister votre clé API dans l'onglet Settings sous Special Features.

Les options suivantes s'afficheront après avoir cliqué sur cet événement :

Voici un exemple fonctionnel de ce à quoi cet événement ressemble 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.

NOTE : Consultez é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 sous l'action 'Envoyer à OpenAI' :

Élément de menu	Zone de menu	Options de l'action 'Envoyer à OpenAI'
Model Type		Spécifie le modèle d'IA qui va être utilisé.
Chat History Dataframe		Lien vers une variable de cadre de données avec 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 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 plus d'informations, veuillez consulter les docs d'OpenAI.
Insert Message ‘+’		En cliquant dessus, la boîte de dialogue des variables apparaîtra. Vous devrez indiquer quelle valeur de 'Variable' est envoyée à OpenAI ainsi que le 'rôle' du message associé : system : se réfère au système général de ChatGPT user : le participant assistant : se réfère à un sous-rôle spécifique créé au sein du système

Comme OpenAI évolue jour après jour, veuillez consulter les docs d'OpenAI pour plus de précisions.

Actions de Code

Dans certains cas, votre expérience peut nécessiter l'utilisation de code personnalisé. Avec ces actions, vous pouvez faire exactement cela ! Les options suivantes sont disponibles sous 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 son utilisation :

Action Définir CSS Global

Avec l'action 'Définir CSS Global', vous pouvez utiliser du code CSS personnalisé pour changer un aspect de l'étude lors d'un déclencheur.

Le champ suivant s'ouvre lorsque vous cliquez sur cette action :

Un exemple d'utilisation de l'action 'Définir 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 multiple.

Action Coller

Cette option vous permet de coller une action que vous avez précédemment créée et copiée. Elle vous permet de travailler plus rapidement lors de la conception de votre expérience afin de ne pas avoir à sélectionner sans cesse les mêmes éléments. Par exemple, si vous avez un événement qui est 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

Lorsque vous travaillez avec certains événements, une icône de stylo apparaîtra. 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 serez amené à 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 Variable, l'action Définir Propriété d'Objet, et l'action Exigence (Si... Alors), comme montré ci-dessous.

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 lister une option de valeur spécifique au déclencheur, puis continuera avec les 5 autres catégories (Heure Actuelle, Valeur Constante, Variable, Cadre / Tâche / Option, et Opérations), qui ont toutes leurs propres options. Celles-ci seront décrites plus bas.

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 de menu à gauche commence par une catégorie spécifique au déclencheur, puis passe aux 5 autres catégories (Heure Actuelle, etc).

Options de Menu

Le tableau ci-dessous explique davantage les catégories et options :

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
• Temps écoulé depuis le début du cadre

Temps Actuel : Horodatage UNIX

Cette valeur capture un horodatage au format UNIX en millisecondes.

Temps Actuel : Temps Écoulé Depuis le Début du Cadre

Cette valeur capture la durée écoulée depuis le début du cadre. La plupart du temps, cela correspond au temps de réaction.

Valeurs constantes

Attribuez des valeurs constantes en fonction du type de variable dont vous avez besoin, comme chaîne ou numérique. Celles-ci sont parfois utilisées en combinaison avec d'autres options comme Arithmetic pour créer des compteurs.

Les options suivantes sont disponibles :

• Chaîne
• Numérique
• Booléen
• Catégorique
• Date
• Temps
• Couleur

Constante : Chaîne

Attribue une valeur de chaîne / texte.

Constante : Numérique

Attribue une valeur numérique / nombre.

Constante : Booléen

Attribue une valeur de vrai ou faux.

Constante : Catégorique

Attribue une valeur de niveau (principalement pour les facteurs).

Constante : Date

Attribue une valeur de date.

Constante : Temps

Attribue une valeur de temps.

Constante : Couleur

Attribue une valeur de couleur (chaîne hexadécimale).

Valeurs des variables

Spécifiez ou faites référence à une variable ou sélectionnez une valeur dans un tableau ou une trame de données. Les options suivantes sont disponibles :

• Sélectionner Variable
• Sélectionner Valeur dans le Tableau
• Sélectionner Valeur dans la Trame de Données

Sélectionner Variable

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

Sélectionner Valeur dans le Tableau

Vous permet de sélectionner une valeur dans un tableau.

Sélectionner Valeur dans la Trame de Données

Vous permet de sélectionner une valeur dans une trame de données que vous avez créée.

Valeurs des Cadres / Tâches / Objets

Vous permet d'obtenir des valeurs associées aux propriétés des objets, au cadre, au suivi des yeux (si activé), et au dispositif (taux de rafraîchissement de l'écran).

• Propriété de l'objet
• Cadre
• Suivi des Yeux
• Dispositif

Propriété de l'objet

Lit une propriété d'objet.

Cadre

Suivi des Yeux

Dispositif

• Taux de Rafraîchissement : La valeur du taux de rafraîchissement du dispositif du participant.

Opérations

Utilisez des opérations pour effectuer des changements spécifiés sur vos variables, tels que la combinaison de valeurs de 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 :

• Aritmétique
• Opération-Chaîne
• Opération-Mathématique

Aritmétique

Les opérations arithmétiques sont utiles à de nombreux fins, y compris la combinaison de chaînes et même la modification des propriétés des objets.

Essentiellement, l'opération arithmétique vous permet de réaliser des opérations sur plusieurs valeurs.

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

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 des opérations arithmétiques afin de créer une nouvelle variable de chaîne (dans le bouton vert), appelée 'intermediateVar'.

La nouvelle valeur de variable (de 'intermediateVar') est définie en utilisant plusieurs opérations arithmétiques avec une combinaison de variables créées précédemment (c'est-à-dire 'userChatName' et 'chatInput'), ainsi que des valeurs de chaîne constantes, c'est-à-dire le point-virgule : et l'espace de séparation <br>. Cette action crée l'effet d'un chat utilisateur qui peut être utilisé dans une étude multi-utilisateurs.

Opération-Chaîne

Opération-Mathématique

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

Valeurs spécifiques au déclencheur

Les valeurs spécifiques au déclencheur se réfèrent à des 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, sous certaines zones où l'action est spécifiée (telles que lors de l'utilisation d'une Set / Record Variable action ou d'une Set Object Property action), vous pouvez faire référence à des valeurs spécifiques au déclencheur de souris dans le menu de sélection de valeur.

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 Set / Record Variable action.

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 approfondie de chaque option.

Nom	Options de Valeur - Vue d'ensemble
Trigger (Mouse)	Coordonnée X de la souris Coordonnée Y de la souris Tableau [X,Y] de la souris Nom de Stimulus Informations sur le Stimulus Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Keyboard)	Id de la Touche Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Button Bar)	Nom de Stimulus Informations sur le Stimulus Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Enter On Input)	Id de la Touche Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Scroll)	Nom de Stimulus Informations sur le Stimulus Position de Défilement X Position de Défilement Y Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Gamepad/ Joystick)	Id de l'Appareil de Jeu Touches Pressées (tableau) Touches Pressées ou Maintenues (tableau) Touches Relâchées (tableau) Axes (tableau) Horodatage du Jeu (Unixtime) Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Eyetracking Gaze)	Coordonnée X Coordonnée Y Tableau [X,Y] de Coordonnée Nom de Stimulus Informations sur le Stimulus Temps de Capture de Caméra T Confiance du Regard C Coord. + Temps [X,Y,T] Tableau Coord. + Temps + Confiance [X,Y,T,C] Tableau Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Eyetracking Fixation)	Centroid de Fixation X Centroid de Fixation Y Durée de Fixation Temps de Début de Fixation Temps de Fin de Fixation Dispersion de Fixation Nom de Stimulus Informations sur le Stimulus [X,Y, Dur, Début, Fin, Disp] Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Head Tracking)	Temps de Capture de Caméra T Données de Facemesh Rotation de la Tête Inclinaison de la Tête Roulement de la Tête Position de la Tête [X,Y,T] Tableau Position du Nez [X,Y,T] Tableau Vecteur du Nez [X,Y,Z,T] Tableau Horodatage du Déclencheur (Unixtime) Temps du Déclencheur à partir du Début du Cadre
Trigger (On Task Initialization)	Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (On Frame Init)	Numéro d'Essai Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (on Frame Start)	Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (On Frame End)	Temps Total du Cadre Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Variable Value Changed)	Nouvelle Valeur dans la Variable Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Media Object Trigger)	Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Websocket Trigger)	Message Données Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (OpenAI Trigger)	Réponse Chat GPT Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (PostMessage Received)	Contenu du Message Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (Global Experiment Event)	Temps Total du Cadre Raison de l'Événement Global Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)
Trigger (User Leaves Experiment)	Nombre Restant de Participants Horodatage du Déclencheur (Unixtime) Temps du Déclencheur (À partir du Début du Cadre)

Valeurs de Déclencheur (Souris)

Lorsqu'un déclencheur de souris est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

Valeurs de Déclencheur (Clavier)

Lorsqu'un déclencheur de clavier est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

Valeurs de Déclencheur (Barre de Boutons)

Lorsqu'un déclencheur de clic sur bouton est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

Valeurs de Déclencheur (Entrée sur Saisie)

Lorsqu'un déclencheur d'entrée sur saisie est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

Valeurs de Déclencheur (Défilement)

Lorsqu'un déclencheur de défilement est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

Valeurs de Déclencheur (Manette/Joystick)

Lorsqu'un Gamepad/Joystick trigger est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

Valeurs de Déclencheur (Gaze de Suivi Oculaire)

Lorsqu'un déclencheur de regard de suivi oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

En savoir plus : Consultez la page dédiée au Déclencheur de Regard de Suivi Oculaire pour activer le suivi oculaire, enregistrer des données de regard et des exemples pratiques.

Valeurs de Déclencheur (Fixation de Suivi Oculaire)

Lorsqu'un déclencheur de fixation de suivi oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'exécution de certaines actions :

En savoir plus : Consultez la page dédiée Eyetracking Fixation Trigger pour activer la Détection de Fixation, enregistrer des données de fixation et voir des exemples pratiques.

Valeurs du Déclencheur (Suivi de Tête)

Lorsqu’un déclencheur de suivi de tête est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Initialisation de la Tâche)

Lorsqu’un déclencheur d’initiation de tâche est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Initialisation de la Trame)

Lorsqu’un déclencheur d'initialisation de trame est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Début de la Trame)

Lorsqu’un déclencheur de début de trame est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Fin de la Trame)

Lorsqu’un déclencheur de fin de trame est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Valeur de Variable Changée)

Lorsqu’un déclencheur de valeur de variable changée est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Déclencheur d'Objet Média)

Lorsqu’un déclencheur d'objet média est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Déclencheur Websocket)

Lorsqu’un déclencheur WebSocket est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Déclencheur OpenAI)

Lorsqu’un déclencheur OpenAI est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Message Post Reçu)

Lorsqu’un déclencheur de message post reçu est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Événement d'Expérience Global)

Lorsqu’un déclencheur de pause / reprise d'expérience est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Valeurs du Déclencheur (Utilisateurs quittent l'Expérience)

Lorsqu’un déclencheur de départ de participant d'étude multi-utilisateurs est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :