Système d'Événements

#### Action Math & Statistics
Effet : Effectue une opération mathématique sur une variable d'entrée (tableau) et sauvegarde le résultat dans une variable de sortie.

Paramètres :
* Type : Choisissez entre les opérations de tableau, l'algèbre linéaire et les 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 instantanément les variables
Effet : Crée une capture d'écran de toutes les valeurs des variables et l'envoie au serveur Labvanced.

Paramètres : Aucun

#### Action Filtre Moyenne Mobile
Effet : Calcule une moyenne mobile (une moyenne en constante mise à jour 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 sorte que les poids des échantillons diminuent linéairement.
    * Moyenne Mobile Exponentielle : Pèse les échantillons de sorte 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 Variable
L'action Distribuer Variable est essentielle pour [les études multi-utilisateurs dans Labvanced.](https://www.labvanced.com/content/technology/fr/multi-user-psychology-studies/) Avec cette action, une valeur de variable peut être partagée entre participants, permettant essentiellement aux informations (y compris les emplacements des stimuli et tout changement) d'être reflétées sur les écrans des participants.

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

En sélectionnant 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 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 d'un objet de champ d'entrée.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_example.webp" alt="La variable Distribuer en cours d'utilisation avec toutes les options du menu définies en exemple." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Découvrez cette démo qui incorpore la variable distribuée et la fonction de boîte de chat ici : [Tâche de Description d'Image avec Module Complémentaire de Chat.](https://www.labvanced.com/page/library/3008)

Une explication complète des éléments de menu de la boîte de dialogue se trouve ci-dessous :

| Élément de Menu | Zone de Menu | Options et Description de l'Action Distribuer Variable |
|:-----:|-----| ---------| 
| **`Distribute value to`** | ![Sélectionner à quels participants la variable distribuée est envoyée](/content_imgs/learn/guide/task-editor/imgs/events/dist_participants.webp) | Choisissez à quels autres participants la valeur doit être envoyée. <ul><li>**Tous les participants :** Envoyer cette valeur à tous les participants</li><li>**Participants Sélectionnés :** Envoyer la valeur aux participants sélectionnés. </li></ul> | 
| **`Choose target variable and value`** | ![Spécification de la variable cible et des valeurs](/content_imgs/learn/guide/task-editor/imgs/events/dist_target.webp) | <ul><li> **Variable Cible :** Choisissez une variable cible où la valeur sera stockée. </li><li>**Valeur :** Déterminez la valeur qui doit être envoyée aux autres participants.</li> </ul>|
| **`Block`** | ![L'option de bloc de la variable distribuée](/content_imgs/learn/guide/task-editor/imgs/events/block_dist_variable.webp) | Si activé, la Variable Cible ne peut être changée jusqu'à ce que la distribution de la valeur actuelle soit terminée. | 
| **`Rate Limit Strategy`**| ![Les options de la stratégie de limite de taux de la variable distribuée](/content_imgs/learn/guide/task-editor/imgs/events/dist_rate_limit.webp) | 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 de précaution pour contrôler la fréquence à laquelle les demandes (c.-à-d. mises à jour via la variable distribuée) sont envoyées au serveur. Les options de stratégie suivantes sont disponibles : <ul><li>**Debounce :** Lorsque cette action s'exécute plus d'une fois par intervalle de 100 ms, alors les nouveaux messages du serveur seront "debounced" (seul le message le plus récent sera envoyé après un intervalle de 100 ms sans aucune exécution de cette action).</li><li>**Throttle :** Lorsque cette action s'exécute plus d'une fois par intervalle de 100 ms, alors les nouveaux messages seront régulés (c.-à.d., après que 100 ms se soient écoulées depuis le dernier message envoyé, seul le message le plus récent sera distribué).</li><li>**Discard :** Lorsque cette action s'exécute plus d'une fois par intervalle de 100 ms, alors les nouveaux messages dans cet intervalle de 100 ms seront supprimés.</li><li>**Queue :** Lorsque cette action s'exécute plus d'une fois par intervalle 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).</li></ul> |

### Actions de Tableau 

#### Action Sélectionner (Lire) depuis le Tableau
Effet : Lira une variable d'un tableau et stocke 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 d'où l'information doit être lue (basée sur 1).
    * 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 du Tableau : Lire depuis la fin du tableau.
* Variable de sortie : Sélectionnez une variable scalaire où la valeur de lecture sera stockée.

#### Action Ajouter / Supprimer des Éléments du Tableau
Effet : Ajoute et/ou supprime des éléments d'un 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 éléments doivent être insérés / supprimés. (basée sur 1).
    * 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 éléments doivent être insérés / supprimés.
    * Fin du Tableau : Insérer / supprimer à partir de la fin du tableau.
* Nombre d'entrées à supprimer : Supprimera les entrées du tableau (avant d'insérer de nouvelles entrées) en commençant à 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) un Éléments du Tableau
Effet : Remplace / change 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 : Utiliser un index fixe pour l'opération de remplacement. Dans ce cas, tapez la position du tableau qui doit être changée (basée sur 1).
    * 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 du Tableau : Remplacer 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 Éléments du Tableau
Effet : Remélange les entrées / l'ordre d'un tableau.

Paramètres : Aucun

### Opérations de Cadre de Données

#### Action Lire depuis / Écrire dans le Cadre de Données
Effet : Lit des valeurs d'un cadre de données ou écrit des valeurs dans un cadre de données et les sauvegarde 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 Éléments 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 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 à sauter.
    * Essai Spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro de l'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é fournies. Si ce n'est pas le cas, l'action de saut ne sera pas exécutée.```
#### Action d'Acceptation/Fins de Session
Effet : Acceptera les données du participant, mettra fin à la session d'enregistrement et affichera 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 (lien de crowdsourcing 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.

#### Action de Rejet/Fin 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 expliquant la raison pour laquelle ils ne seront pas récompensés pour leur temps.

Paramètres : Aucun

#### Action de Redirection vers 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... Autre Si) Action
Effet : Évalue une instruction si-alors et exécute une série d'actions de manière dépendante. Chaque instruction Si / Autre Si consiste en des comparaisons AND / OR imbriquées pour évaluer si toutes les conditions sont remplies (l'instruction est vraie) ou non (l'instruction est fausse). Si l'instruction est vraie, les actions sous "Alors" sont exécutées.

Paramètres :
* Ajouter une Condition : Ajoute une nouvelle condition à une instruction. Le menu "sélection de valeur" apparaîtra des deux côtés pour effectuer une comparaison logique. Au milieu de l'instruction, vous pouvez choisir comment les deux côtés doivent être comparés (par exemple, égal, plus petit que, inégal, etc.).
* Ajouter un Groupe OU : Une seule des conditions d'un Groupe OU doit être vraie 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 conditions d'un Groupe ET doivent être vraies pour que l'ensemble du groupe soit vrai. Ajoutez un groupe ET si les sous-actions ne doivent être exécutées que lorsque plusieurs conditions sont remplies.
* Séquence d'Actions : Chaque instruction Si / Autre Si a une liste d'actions, définies sous "Alors". La séquence d'actions liste toutes les actions pour une certaine instruction Si / Autre 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 la ou les conditions de l'instruction Si / Autre Si associée sont remplies.
* Ajouter un Cas Autre Si : L'Action de Condition peut consister en plusieurs instructions Si / Autre Si --> Alors. Cependant, seule une instruction peut être exécutée. Si une instruction Si / Autre Si est évaluée positivement (retourne vrai), les actions dans le bloc Alors sont exécutées et le reste de l'Action de Condition est ignoré.
* Ajouter un Cas Autre (vrai / faux) : Si activé, une option par défaut / de secours est ajoutée à l'action de condition. Si aucune des instructions Si / Autre Si n'est exécutée (retournée vrai), les actions définies dans le cas autre seront exécutées.

#### Actions Répétées (Boucle While) 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 pour que l'exécution de la boucle soit arrêtée.

Paramètres :
* Type d'Exécution : Choisissez entre une exécution immédiate ou une exécution temporisé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 toutes les ... 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 toutes les ... ms" est sélectionné, les utilisateurs ont la possibilité d'assigner une valeur entière numérique au 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 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é, seule une 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 quand l'exécution de la boucle doit être arrêtée. Similaire aux déclarations Si / Autre Si, on peut combiner des groupes AND, des groupes OR et des Conditions pour la comparaison logique.
* Séquence d'Actions : La séquence d'actions liste 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 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 longueur du délai en millisecondes (ms).
* Séquence d'Actions : La séquence d'actions liste 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 à la fois. 

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

### 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’](/content/learn/fr/guide/task-editor/event-system.html#api-triggers) peuvent être utilisées. Vous avez les actions suivantes disponibles sous cette catégorie : 
* Envoyer PostMessage
* Envoyer vers Websocket
* Envoyer à OpenAI

Pour que ces actions soient 'disponibles' ou utilisables, vous devez entrer une clé API sous l'onglet [`Paramètres`](/content/learn/fr/guide/settings/).

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

#### Action Envoyer PostMessage

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

[En savoir plus.](/content/learn/fr/guide/events/send-postmessage-action.html)

#### Action Envoyer vers Websocket

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_a_menu.webp" alt="L'Action Envoyer vers Websocket dans le menu d'actions de Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_action_m.webp" alt="Options pour l'action Envoyer vers Websocket." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

L'exemple ci-dessus et la structure complète de l'événement peuvent être consultés ici : [https://www.labvanced.com/page/library/51053](https://www.labvanced.com/page/library/51053) en cliquant sur 'Inspecter.'

| Élément de Menu | Description |   
|----------|----------| 
| **Envoyer Vers :**    | Spécifie l'Adresse Websocket qui est listée dans l'onglet [`Paramètres`](/content/learn/fr/guide/settings/) sous `Fonctionnalités Spéciales`.    | 
| **Déclencheur / Message à envoyer :**   | Spécifiez le déclencheur ou le message que vous souhaitez envoyer.    | 
| **Envoyer Variable (optionnel) :**   | Indiquez la variable qui peut également être envoyée dans le cadre de l'action.    | 

**[Pour plus d'informations sur l'accès API, veuillez visiter cette page.](https://www.labvanced.com/content/learn/fr/guide/api-access/)**

#### Action Envoyer à 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 indiquer votre clé API dans l'onglet [`Paramètres`](/content/learn/fr/guide/settings/) sous `Fonctionnalités Spéciales`.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_a_menu.webp" alt="L'Action Envoyer à OpenAI dans le menu d'actions de Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_dialog_action.webp" alt="Options pour l'action Envoyer à OpenAI." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Voici un exemple fonctionnel de la manière dont cet événement apparaît lorsque toutes les informations nécessaires sont fournies : 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_ex_action.webp" alt="Exemple de l'utilisation de l'action Envoyer à OpenAI." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 
```Pour une meilleure compréhension de l'utilisation de cette fonctionnalité et pour la voir en action, n'hésitez pas à nous contacter pour une démonstration en soumettant [ce formulaire de contact](https://www.labvanced.com/?openCallDialog=true). 

**REMARQUE :** Veuillez également vous référer à [ce guide](https://content/learn/fr/walkthroughs/2024-09-chatgpt-study-example/) dans lequel nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant cette action. 

Voici une explication plus détaillée des champs inclus dans l'action 'Envoyer à OpenAI' : 

| Éléments du menu | Zone de menu | Options de l'action 'Envoyer à OpenAI' |
|:-----:|----| ----------| 
| **`Type de modèle`**   |  ![Liste déroulante du type de modèle](/content_imgs/learn/guide/task-editor/imgs/events/ai_model_type.webp)    | <img width=500/> Spécifie le modèle d'IA qui va être utilisé. <br><br>   |
| **`Dataframe de l'historique de chat`**   | ![Champ pour spécifier la variable de dataframe](/content_imgs/learn/guide/task-editor/imgs/events/ai_df.webp)   | Lien vers une variable de dataframe 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 dataframe lié ici. <br><br> Le dataframe peut également être manipulé avec des actions de dataframe. Pour plus de références, veuillez consulter la [documentation d'OpenAI.](https://platform.openai.com/docs/api-reference/chat/create) |
| **`Insérer le message ‘+’ `**   |  ![L'icône d'insertion de message.](/content_imgs/learn/guide/task-editor/imgs/events/ai_roles.webp)    | En cliquant ici, 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é :<ul><li>**système :** fait référence au système ChatGPT de haut niveau </li><li>**utilisateur :** le participant </li><li>**assistant :** fait référence à un sous-rôle spécifique créé dans le système  </li></ul> |

Comme OpenAI évolue quotidiennement, veuillez consulter les [documents d'OpenAI](https://platform.openai.com/docs/api-reference/chat/create) pour de plus amples clarifications.

### 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 dans le menu ‘Actions de Code’ :
* Exécuter JavaScript
* Définir CSS Global

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/code_actions_menu.webp" alt="Les Actions de Code dans le menu d'action de Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

#### 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 comme une action lorsqu'il sera déclenché. 

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

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> 

#### 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 lorsque cela est déclenché. 

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

Le champ suivant s'ouvre en cliquant 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 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 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 Valeurs 
<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 qu'une icône de stylo apparaît. Cela s'appelle le Menu de Sélection de Valeurs car il vous permet de sélectionner et d'instruire quel type de valeurs doivent être enregistrées ou doivent être suivies. C'est une option très puissante et importante que vous êtes assuré d'utiliser pour votre conception et configuration expérimentales. 

Cette icône de stylo / Menu de Sélection de Valeurs apparaît à divers emplacements pour certaines actions dans le système d'événements, comme l'action Définir / Enregistrer Variable, l'action Définir Propriété d'Objet, et l'action Condition (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 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 à lire ou à écrire. **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), 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 Valeurs 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 Valeurs 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 (Heure actuelle, etc.). 

### Options de Menu
Le tableau ci-dessous explique plus en détail les catégories et options :

| Catégorie | Options | Description |
|:---:|---|---|
| [`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, vous aurez une liste spécifique d'options apparaissant en haut du menu de sélection de valeurs parmi lesquelles choisir. Veuillez vous référer à la section sur [Valeurs spécifiques au déclencheur](#trigger-specific-values) pour voir une liste complète des options et descriptions. |
| [`Heure actuelle`](#current-time-values) | <ul><li> [Timestamp UNIX](#current-time-unix-timestamp) </li><li> [Temps depuis le début de la trame](#current-time-time-from-frame-onset) </li> </ul> | Mesurer et appeler des valeurs temporelles. |
| [`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> | Assigner 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 [`Arithmétique`](#arithmetic) pour créer des compteurs. | 
| [`Variable`](#variable-values) | <ul> <li> Sélectionner Variable </li><li> Sélectionner Valeur du Tableau </li><li>  Sélectionner Valeur du Dataframe </li></ul> | Spécifier ou référencer une variable ou sélectionner une valeur d'un tableau ou d'un dataframe. |
| [`Cadre / Tâche / Objet`](#frame-task-object-values) | <ul><li> Propriété de l'objet </li><li> Cadre </li><li>  Suivi oculaire </li><li>  Appareil </li> </ul> | Vous permet de récupérer des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (si activé), et à l'appareil (fréquence de rafraîchissement de l'écran). |
| [`Opérations`](#operations) | <ul><li>Arithmétique </li><li> Opération-chaîne </li><li>  Opération-mathématique </li> </ul> | Utiliser des opérations pour effectuer des modifications spécifiques à vos variables, comme combiner des valeurs de variable, transformer des chaînes de manière à ce qu'elles soient toutes en minuscules, ou effectuer des opérations mathématiques. |


###  Valeurs de Temps Actuelles
Avec l'option ‘Heure actuelle’, vous pouvez enregistrer ou référencer des valeurs par rapport au temps. 

Les options suivantes sont disponibles : 
* [Timestamp UNIX](#current-time-unix-timestamp)
* [Temps depuis le début de la trame](#current-time-time-from-frame-onset)

#### Heure actuelle : Timestamp UNIX
Cette valeur capture un timestamp au format UNIX en millisecondes.  

#### Heure actuelle : Temps depuis le début de la trame
Cette valeur capture le temps écoulé depuis le début de la trame. La plupart du temps, cela équivaut au temps de réaction.

### Valeurs Constantes
Assigner 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 [`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)

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

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

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

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

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

#### Constant : Temps
Assigne une valeur temporelle.

#### Constant : Couleur
Assigne une couleur (valeur hexadécimale).

### Valeurs de Variable
Spécifier ou référencer une variable ou sélectionner une valeur d'un tableau ou d'un dataframe. Les options suivantes sont disponibles :
* [Sélectionner une Variable](#select-variable)
* [Sélectionner une Valeur du Tableau](#select-value-from-array)
* [Sélectionner une Valeur du Dataframe](#select-value-from-data-frame)```markdown

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

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

#### Sélectionner une valeur dans un cadre de données
Vous permet de sélectionner une valeur dans 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 oculaire (si activé) et à l'appareil (fréquence de rafraîchissement de l'écran).
* [Propriété de l'objet](#object-property)
* [Cadre](#frame)
* [Suivi oculaire](#eye-tracking)
* [Appareil](#device)

#### Propriété de l'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 de coordonnées souris [X,Y] mis en cache`** | La dernière valeur de coordonnées [X,Y] de la souris du participant au format 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 de coordonnées [X,Y] mis en cache`** | La dernière valeur de coordonnées [X,Y] du regard du participant au format tableau. |
| **`Dernier tableau de coordonnées + temps [X,Y,T] mis en cache`** | La dernière valeur de coordonnées [X,Y] du regard du participant, plus la valeur T de capture de la caméra, au format tableau. |

#### Appareil
* **Fréquence de rafraîchissement :** La valeur de fréquence 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 de variables, la transformation de chaînes 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 à diverses fins, y compris la combinaison de chaînes et même la modification de propriétés d'objets.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/arithmetic_menu.webp" alt="Le menu 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.

En sélectionnant 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 des 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 la 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,](#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 qui peut être utilisé dans une étude multi-utilisateurs.

#### 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 minuscules.<br><br> **&#8594; Ex:** (AAABBB) se transforme en (aaabbb) |
| **`En majuscules`** | Change toutes les lettres d'une variable de chaîne en lettres majuscules. <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) |
| **`Retirer les espaces`** | Supprime les espaces au début d'une variable de chaîne. <br><br> **&#8594; Ex:** (  aaabbbcccc) se transforme en (aaabbbcccc) |
| **`Remplacer 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`** | Renvoie le nombre absolu d'une valeur. |
| **`sqrt`** | Renvoie la racine carrée d'une valeur. |
| **`round`** | Renvoie la valeur arrondie avec 0 à 3 décimales. |
| **`floor`** | Renvoie la valeur arrondie à l'inférieur. |
| **`ceil`** | Renvoie la valeur arrondie au supérieur. |
| **`cos`** | Renvoie la valeur du cosinus. |
| **`sin`** | Renvoie la valeur du sinus. |
| **`tan`** | Renvoie la valeur de la tangente. |

### Valeurs spécifiques au déclencheur

Les valeurs spécifiques au déclencheur font référence aux valeurs 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 la variable`](#set-record-variable-action) ou d'une action [`Définir la propriété de l'objet`](#set-object-property-action)), vous pouvez faire référence aux valeurs spécifiques au déclencheur de la 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 les valeurs x et y et un tableau [X,Y] en utilisant une action [`Définir / Enregistrer la 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 la façon dont les valeurs de déclencheur spécifiques à la souris sont utilisées pour capter 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 qui peuvent être trouvés dans Labvanced, suivi d'une explication approfondie de chaque option.

| Nom | Options de valeur - Aperçu |
| :---: | ---|
| [`Déclencheur (Souris)`](#trigger-mouse-values)  | <ul><li> Souris X </li><li> Souris Y </li><li> Tableau de souris [X,Y] </li><li> Nom du stimulus </li><li> Infos sur le stimulus </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de 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> Infos sur le stimulus </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps de 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 (Unixtime)  </li><li> Temps de déclencheur (À partir du début du cadre)  </li></ul> |
| [`Déclencheur (Défilement)`](#trigger-scroll-values) | <ul><li> Nom du stimulus </li><li> Infos sur le stimulus</li><li> Position de défilement X </li><li> Position de défilement Y </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps de déclencheur (À partir du début du cadre) </li></ul> |
| [`Déclencheur (Suivi oculaire regard)`](#trigger-eyetracking-gaze-values) | <ul><li> Coordonnée X </li><li> Coordonnée Y </li><li> Tableau de coordonnées [X,Y] </li><li> Nom du stimulus </li><li> Infos sur le stimulus </li><li> Temps T de capture de la caméra </li><li> Confiance de 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 (Unixtime) </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> Heure de début de fixation </li><li> Heure de fin de fixation </li><li> Dispersion de fixation </li><li> Nom du stimulus </li><li> Infos sur le stimulus </li><li> [X,Y,Dur,Début,Fin,Disp] </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps du déclencheur (À partir du début du cadre)  </li></ul> |
| [`Déclencheur (Suivi de tête)`](#trigger-head-tracking-values) |  <ul><li> Temps T de capture de la caméra </li><li>  Rotation de tête </li><li>  Inclinaison de tête </li><li>  Roulement de 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 (Unixtime) </li><li>  Temps de 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 (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de déclencheur (À partir du début du cadre) </li></ul> |
| [`Déclencheur (au début du cadre)`](#trigger-on-frame-start-values) |  <ul><li>  Horodatage du déclencheur (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de déclencheur (À partir du début du cadre) </li></ul> |
| [`Déclencheur (Déclencheur OpenAI)`](#trigger-openai-trigger-values) |  <ul><li>  Réponse Chat GPT </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps de déclencheur (À partir du début du cadre) </li></ul> |
| [`Déclencheur (Message Post reçu)`](#trigger-postmessage-received-values) |  <ul><li> Contenu du message </li><li> Horodatage du déclencheur (Unixtime) </li><li> Temps de déclencheur (À partir du début du cadre) </li></ul> |
| [`Déclencheur (Événement d'expérience 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 (Unixtime) </li><li> Temps de 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 (Unixtime) </li><li> Temps de déclencheur (À partir du début du cadre) </li></ul> |
``````markdown
#### Valeurs de déclenchement (Souris)
Lorsque un [déclenchement de souris](#mouse-trigger) est utilisé, les [valeurs spécifiques au déclenchement](#trigger-specific-values) suivantes peuvent être appelées lors 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 valeurs de déclenchement de souris disponibles" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Options de déclenchement (Souris) | Description |
| :---: | ---|
| **`Mouse X`** | Renvoie la position actuelle de la souris X en coordonnées de cadre. |
| **`Mouse Y`**|  Renvoie la position actuelle de la souris Y en coordonnées de cadre. |
| **`Mouse [X,Y] Array`** | Les coordonnées de souris [X,Y] au format tableau. | 
| **`Stimulus Name`** | Le nom de l'objet qui a déclenché l'événement (par exemple, quelle image a été cliquée). |
| **`Stimulus Info`** | Les informations sur le stimulus de l'objet qui a déclenché l'événement. |
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement a eu lieu. |


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

| Options de déclenchement (Clavier) | Description |
| :---: | ---|
| **`Id of Key`** | La valeur ID de la touche qui a été pressée comme déclencheur. |
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement a eu lieu. |

#### Valeurs de déclenchement (Barre de boutons)

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

| Options de déclenchement (Barre de boutons) | Description |
| :---: | ---|
| **`Stimulus Name`** | Le nom de l'objet bouton qui a déclenché l'événement. |
| **`Stimulus Info`** | Les informations sur le stimulus de l'objet bouton qui a déclenché l'événement. |
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement a eu lieu. |

#### Valeurs de déclenchement (Entrée sur Input)

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

| Options de déclenchement (Entrée sur Input) | Description |
| :---: | ---|
| **`Id of Key`** | La valeur ID de la touche qui a été pressée comme déclencheur. |
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement a eu lieu. |


#### Valeurs de déclenchement (Défilement)

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

| Options de déclenchement (Défilement) | Description |
| :---: | ---|
| **`Stimulus Name`** | Le nom de l'objet bouton qui a déclenché l'événement. |
| **`Stimulus Info`** | Les informations sur le stimulus de l'objet bouton qui a déclenché l'événement. |
| **`Scroll Position X`** | La position de défilement en X de la souris lorsque l'événement a été déclenché.  |
| **`Scroll Position Y`** | La position de défilement en Y de la souris lorsque l'événement a été déclenché.|
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement de défilement a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement de défilement a eu lieu. |

#### Valeurs de déclenchement (Gamepad/Joystick)

Lorsque un [`déclenchement Gamepad/Joystick`](#gamepad-joystick-trigger) est utilisé, les valeurs spécifiques au déclenchement suivantes peuvent être appelées lors 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éclenchement de manette">
</p>

| Options de déclenchement (Gamepad/Joystick) | Description |
| :---: | ---|
| **`Gamepad Device Id`** | L'ID ou le nom du gamepad qui était connecté. |
| **`Pressed Keys (Array)`** | Les touches qui ont été pressées. |
| **`Pressed OR Hold Keys (Array)`** | Les touches qui ont été pressées ou maintenues. |
| **`Released Keys (Array)`** | Les touches qui ont été relâchées. |
| **`Axes (Array)`** | Les valeurs des axes. |
| **`Gamepad Timestamp (Unixtime)`** | L'horodatage du gamepad au format Unix Time.|
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement se produit en Unixtime. |
| **`Trigger Time (From Frame Onset)`** | L'horodatage en Unixtime du moment où le déclenchement se produit par rapport à l'apparition du cadre. |

#### Valeurs de déclenchement (Gaze de suivi oculaire)

Lorsque un [déclenchement de regard de suivi oculaire](#eyetracking-gaze-trigger) est utilisé, les valeurs spécifiques au déclenchement suivantes peuvent être appelées lors 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éclenchement de regard" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Options de déclenchement&nbsp;(Gaze de suivi oculaire)&nbsp; | Description  |
| :---: | --- |
| **`Coordinate X`** | La valeur de la coordonnée X du regard. |
| **`Coordinate Y`** | La valeur de la coordonnée Y du regard. |
| **`Coordinate [X,Y] Array`** | Les coordonnées du regard X,Y au format tableau. |
| **`Stimulus Name`** | Le nom du stimulus qui a initié le déclenchement du regard. |
| **`Stimulus Info`** | Les informations sur le stimulus derrière le stimulus qui a initié le déclenchement du regard.  |
| **`Camera Capture Time T`** |  Le moment exact où la capture a eu lieu. Dans le pipeline de suivi oculaire de Labvanced, une capture de caméra se produit d'abord avant que l'algorithme et le réseau de neurones n'effectuent les calculs de regard. Ainsi, le `Camera Capture Time T` est un horodatage UNIX du moment où la capture initiale a eu lieu. Pour plus d'informations concernant la technologie derrière notre suivi oculaire basé sur webcam, veuillez consulter notre [page sur la technologie ET.](/content/technology/fr/labvanced-eye-tracking/)   |
| **`Gaze Confidence C`** | 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 consulter notre [article publié dans une revue par les pairs](https://link.springer.com/article/10.3758/s13428-023-02237-8) pour plus de détails.  |
| **`Coord. + Time [X,Y,T] Array`** | Un tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de la caméra (T) comme décrit ci-dessus.  |
| **`Coord. + Time + Confidence [X,Y, T,C] Array`** | Un tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de la caméra (T) et la confiance du regard (C) comme décrit ci-dessus. |
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement du regard a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement du regard a eu lieu. |

#### Valeurs de déclenchement (Fixation de suivi oculaire)

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

| Options de déclenchement&nbsp;(Fixation de suivi oculaire) | Description |
| :---: | ---|
| **`Fixation Centroid X`** | Le point central de la fixation en tant que valeur X. |
| **`Fixation Centroid Y`** | Le point central de la fixation en tant que valeur Y. |
| **`Fixation Duration`** | La durée de la fixation détectée. |
| **`Fixation Start Time`** | Le temps de début de la fixation détectée. |
| **`Fixation End Time`** | Le temps de fin de la fixation détectée. |
| **`Fixation Dispersion`** | Fait référence à la dispersion des valeurs de regard dans une fixation détectée. |
| **`Stimulus Name`** | Le nom de l'objet bouton qui a déclenché l'événement. |
| **`Stimulus Info`** | Les informations sur le stimulus de l'objet bouton qui a déclenché l'événement. |
| **`[X, Y, Dur, Start, End, Disp]`** | Un tableau des éléments suivants : valeurs x et y du centroid de la fixation, la durée de la fixation, le temps de début, le temps de fin et la valeur de dispersion. |
| **`Trigger Timestamp (Unixtime)`** | L'horodatage du moment où le déclenchement de fixation a eu lieu au format Unix Time avec millisecondes. |
| **`Trigger Time (From Frame Onset)`** | Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'au moment où le déclenchement de fixation a eu lieu. |
```#### Déclencheur (Suivi de tête) Valeurs

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

| Options de Déclencheur&nbsp;(Suivi&nbsp;de Tête) | Description |
| :---: | ---|
| **`Temps de capture de la caméra T`** | Quand la caméra a capturé le cadre, c'est-à-dire un horodatage UNIX du moment où la capture du cadre a eu lieu. C'est le moment où l'image / le cadre a été capturé avant que tout traitement ait lieu. |
| **`Rotation de la tête`** | La rotation de la tête de gauche à droite, cela est désigné par le terme de tangage dans la littérature. |
| **`Inclinaison de la tête`** | L'inclinaison de la tête de haut en bas, connue sous le nom de tangage dans la littérature. |
| **`Roulement de la tête`** | Capture le mouvement de la tête roulant de côté à côté. |
| **`Position de la tête [X,Y, T] Tableau`** | Ce tableau capture les valeurs numériques associées à la position de la tête, cela inclut 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, cela inclut les coordonnées x et y pour l'emplacement du nez ainsi que la variable d'horodatage (T) du moment où la mesure a eu lieu. |
| **`Vecteur du nez [X,Y, Z, T] Tableau`** | Cette mesure fonctionne en projetant un vecteur depuis l'extrémité du nez et est utile pour vérifier si le participant est attentif à l'écran (cela est particulièrement important pour les études où le suivi oculaire n'est pas activé). Ainsi, si le nez pointe hors é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 (Unixtime)`** | Moment durant l'expérience où le déclencheur lui-même se produit où le suivi de tête a été détecté et tient compte du moment où le déclencheur a eu lieu 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, cela devrait être aussi proche que possible de la valeur T. |
| **`Temps du déclencheur depuis le début du cadre`** | Ceci est la valeur de temps à laquelle le déclencheur a eu lieu par rapport au moment où le début du cadre s'est produit. |

#### Déclencheur (Valeurs d'initialisation de la tâche)

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

| Options de Déclencheur (Initialisation de la Tâche) | Description |
| :---: | ---|
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage UNIX du déclencheur en millisecondes. |
| **`Temps de déclencheur (Depuis le début du cadre)`** | Le temps en millisecondes à partir du moment où le déclencheur s'est produit depuis le début du cadre. |

#### Déclencheur (Valeurs d'initialisation du cadre)

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

| Options de Déclencheur (Initialisation du Cadre) | Description |
| :---: | ---|
| **`NumTrial`** | Le numéro du trial lors duquel le déclencheur d'initialisation du cadre s'est produit. |
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage UNIX du déclencheur en millisecondes. |
| **`Temps de déclencheur (Depuis le début du cadre)`** | Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre. |


#### Déclencheur (Valeurs de début de cadre)

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

| Options de Déclencheur (au Début du Cadre) | Description |
| :---: | ---|
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage UNIX du déclencheur en millisecondes. |
| **`Temps de déclencheur (Depuis le début du cadre)`** | Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre. | 


#### Déclencheur (Valeurs de fin de 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 certaines actions :

| Options de Déclencheur (À la Fin du Cadre) | Description |
| :---: | ---|
| **`Temps total du cadre`** | Le temps total en millisecondes qui a été passé sur le cadre. | 
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage UNIX du déclencheur en millisecondes. |
| **`Temps de déclencheur (Depuis le début du cadre)`** | Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre. | 


#### Déclencheur (Valeurs de changement de valeur de variable)

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

| Options de Déclencheur (Changement de valeur de variable) | Description |
| :---: | ---|
| **`Nouvelle valeur dans la variable`** | Se réfère à la nouvelle valeur d'une variable. |
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage du moment où le déclencheur de changement de variable s'est produit au format Unix Time avec millisecondes. |
| **`Temps de déclencheur (Depuis le début du cadre)`** | Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'au moment où le changement de valeur de variable s'est produit. |


#### Déclencheur (Valeurs de déclencheur d'objet média)

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

| Options de Déclencheur (Déclencheur d'objet média) | Description |
| :---: | ---|
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage de quand le déclencheur d'objet média s'est produit au format Unix Time avec millisecondes. |
| **`Temps de déclencheur (Depuis le 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 média s'est produit. |


#### Déclencheur (Valeurs de 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 certaines actions :

| Options de Déclencheur (Déclencheur Websocket) | Description |
| :---: | ---|
| **`Message`** | Un message qui peut être utilisé pour décrire et étiqueter, ce qui vous permet (du côté de réception) de filtrer différents types de données.  |
| **`Données`** | Une valeur qui peut contenir différents types de données, telles que les choix du participant, les horodatages, les coordonnées x/y de la souris, etc.  |
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage de quand le déclencheur Websocket s'est produit au format Unix Time avec millisecondes. |
| **`Temps de déclencheur (Depuis le 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. |


#### Déclencheur (Valeurs de 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 certaines actions :
| Options de Déclencheur (Déclencheur OpenAI) | Description |
| :---: | ---|
| **`Réponse Chat GPT`** | La valeur de la réponse de ChatGPT. |
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage de quand le déclencheur OpenAI s'est produit au format Unix Time avec millisecondes. |
| **`Temps de déclencheur (Depuis le 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. |


#### Déclencheur (Valeurs de message reçu)

Lorsqu'un [déclencheur de message reçu](#postmessage-received-trigger) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

| Options de Déclencheur (Message Reçu) | Description |
| :---: | ---|
| **`Contenu du message`** | La charge de données du postMessage reçu, telle qu'envoyée par la source externe. |
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage de quand le déclencheur de message reçu s'est produit au format Unix Time avec millisecondes. |
| **`Temps de déclencheur (Depuis le 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. |


#### Déclencheur (Valeurs d'événement expérimental global)

Lorsqu'un [déclencheur de pause / reprise d'expérience](#pause-resume-experiment) est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors 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 qui a été alloué avant le déclencheur. |
| **`Raison de l'événement global`** | Une valeur de chaîne qui indique la raison du déclencheur, telle que le départ du participant de l'étude. |
| **`Horodatage du déclencheur (Unixtime)`** | L'horodatage de quand le déclencheur d'événement global s'est produit au format Unix Time avec millisecondes. |
| **`Temps de déclencheur (Depuis le 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. |


#### Déclencheur (Valeurs sur le départ de l'utilisateur)

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

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