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 d'une tâche. Un événement agit souvent comme 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 de sélection de 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 'quand 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, ce qui applique l'événement à toutes les images. Tous les événements existants sont affichés dans une vue en liste sur le panneau latéral droit. Les événements sont définis au niveau des images et peuvent être séparés/spécifiques pour chaque image ou dupliqués/identiques sur chaque image à travers un essai.
De cette manière, un événement est toujours défini pour tous les essais au sein d'un groupe d'essais pour les images spécifiées. Cependant, une logique personnalisée permet aux utilisateurs d'exécuter des événements uniquement dans certains essais, conditions ou circonstances.
Sélection d'un déclencheur
Lorsque vous créez un nouvel événement, la sélection de déclencheurs 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 multimédia, API et Global). Une boîte de recherche en haut vous permet de filtrer les types de déclencheurs par nom. Cliquez sur n'importe quelle tuile pour la définir comme 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 du déclencheur actuel et l'icône. Pour passer à un déclencheur différent, 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 inférieur droit (Propriétés de l'événement). Pour une meilleure vue d'ensemble, les événements existants peuvent également être rouvert (icône à côté du champ de nom).
Déclencheurs
Le déclencheur définit quand l'événement sera exécuté. Cela pourrait être un clic de souris sur un objet particulier, une saisie de clavier particulière, un changement d'une variable, le début d'un fichier vidéo, ou beaucoup d'autres choses. Tous les déclencheurs et leurs réglages / paramètres sont expliqués dans la liste suivante :
| Catégorie de déclencheur | Options de déclencheur | Description |
|---|---|---|
User Input Triggers | 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 de clavier, défiler, etc. | |
Physiological Signal Triggers | Les déclencheurs de signaux physiologiques se produisent lorsqu'il y a une entrée physiologique spécifiée, comme le fait de regarder un élément spécifique ou des changements de mouvements de tête. | |
Trial and Frame Triggers | 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 est atteinte. | |
Variable Value Changed Trigger | Variable (Valeur changée) | Un déclencheur pour l'événement se produit lorsqu'il y a un changement dans la valeur d'une variable spécifique. |
Media Object Trigger | Déclencheur d'objet multimédia | Ce déclencheur se produit par rapport aux objets multimédia, comme lorsqu'il y a une pause dans un fichier vidéo/audio, une enregistrement est terminé, etc. |
API Triggers | Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API. | |
Global Triggers | Les déclencheurs globaux se réfèrent à tout changement majeur dans une expérience, comme le fait qu'elle soit mise en pause ou qu'un participant d'une étude multiutilisateur quitte. |
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 : 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 seulement si une image spécifique est cliquée. |
Keyboard Trigger | Toute pression de touche du clavier 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é lorsque un participant appuie sur 'Entrée' pendant une expérience, en tant que moyen de soumettre sa réponse écrite ou son entrée dans des zones de champ de texte. |
Scroll Trigger | Ce déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier les directions de défilement en x ou y, ainsi que sur quels éléments le défilement se produit pour être utilisé comme déclencheurs d'événements. |
Gamepad/ Joystick Trigger | Ce déclencheur vous permet d'utiliser des contrôleurs de jeu et des joysticks dans votre conception expérimentale comme un dispositif d'entrée pour enregistrer des données. |
Déclencheur de souris
L'option 'Déclencheur de souris' est un déclencheur d'événement très populaire car elle initie un événement basé sur toute interaction de souris, telle que : déplacer la souris vers le haut / vers le bas, cliquer, survoler un objet spécifique, quitter un objet spécifique, ou tout autre mouvement !
L'exemple ci-dessous montre un 'Déclencheur de souris' qui se produira lorsqu'un 'Cliquez' est effectué par le clic gauche de la souris sur l'objet 'Cible' appelé 'Image_1' :
Voici un aperçu complet des options disponibles lors de l'utilisation 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 :
|
Button liste déroulante : |  |
|
Targets options : |  Dans l'exemple ci-dessus, 'Image_1' est la cible du clic de bouton qui déclenchera l'événement. Plusieurs cibles peuvent être ajoutées en cliquant sur l'option ‘+Add Target’ en bas. |
|
- Remarque : 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 référencer les 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 de déclencher un événement. Essentiellement, toute saisie 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 pour être une pression de clavier qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont pressées :
Voici un aperçu complet des touches et options disponibles lors de l'utilisation des déclencheurs de clavier :
| Élément de menu | Zone de menu | Options de déclencheur de clavier |
|---|---|---|
Action liste déroulante : |  |
|
Keys quelle touche déclenche l'événement |  | Quelle touche est utilisée comme déclencheur est spécifié en sélectionnant les options ici en cliquant sur +Add:
+Add: |
| Options supplémentaires |  | L'option activer les touches du pavé numérique permet d'utiliser les touches du pavé numérique comme déclencheurs dans l'expérience. Pour l'option autoriser la propagation des événements, si plusieurs événements ont le même déclencheur de clavier, alors tous se déclenchent/enclenchent sans cela. Uniquement le premier se déclenchera et l'exécution de l'événement s'arrêtera après le premier événement terminé. |
- Remarque : 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 référencer les valeurs spécifiques au déclencheur de clavier à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de clic de bouton
Si vous avez un objet bouton ou de navigation placé dans l'éditeur, vous pouvez les utiliser 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 déclencheur :
Voici un aperçu des éléments présentés :
| Élément de menu | Zone de menu | Options de déclencheur de clic de bouton |
|---|---|---|
Cible : +Set Target |  | |
Button: option |  | Spécifiez quel bouton spécifique sur le cadre |
- Remarque : Après avoir sélectionné le déclencheur de clic de bouton dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur de clic de bouton à travers diverses actions avec le menu de sélection de valeur.
Déclencheur Entrée sur saisie
Déclencheurs sur : La touche Entrée/Renvoi est pressée sur le clavier lorsqu'un élément spécifique est actif.
Paramètres :
Ajouter des cibles : Ajouter un élément de saisie à l'événement.
Remarque : Après avoir sélectionné le déclencheur Entrée sur saisie dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques Entrée sur saisie à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de défilement
Déclencheurs sur : La barre de défilement, défilement sur le pavé tactile, ou molette de défilement de la souris 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.
Remarque : Pour du texte long, dans le panneau 'Propriétés de l'objet' sous la section 'Style', les options Overflow-Xet/ou Overflow-Y doivent avoir scroll comme option sélectionnée.
- Remarque : 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 référencer les valeurs spécifiques au déclencheur de défilement à 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 contrôleurs de manette et de joystick dans votre design expérimental comme dispositif d'entrée pour enregistrer des données. Remarque : n'oubliez pas d'activer cette option sous l'onglet Settings.
Déclencheurs de signaux physiologiques
Ces déclencheurs ne s'appliqueront que si le suivi oculaire et/ou le suivi de la tête a été activé pour la tâche.
Déclencheur de regard de suivi oculaire
Déclencheurs sur :
- Dans l'ensemble, 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 choisi de déclencher uniquement sur des éléments spécifiques, ajoutez ces éléments comme cibles.
Remarque : 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 référencer les 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 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.
- Remarque : 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 référencer les valeurs spécifiques à la fixation à travers diverses actions avec le menu de sélection de valeur.
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 des exemples pratiques.
Déclencheur de suivi de tête
Déclenche lorsque :
Changements dans l'orientation de la tête ou le mouvement de la tête.
Note : Après avoir sélectionné le déclencheur de suivi de tête dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur de suivi de tête dans diverses actions avec le menu de sélection de valeur.
Déclencheurs d'essai et de trame
Déclencheur d'initialisation de tâche
Déclenche lorsque :
- Le premier cadre du premier essai d'une tâche. Ne sera exécuté qu'une seule fois par tâche, bien qu'il soit affiché dans l'onglet Événements pour toutes les instances de ce cadre.
Ce déclencheur s'associe bien aux actions Mélanger et Lire depuis. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les trames 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 des stimuli ou des 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 spécifiques au déclencheur d'initialisation de tâche dans diverses actions avec le menu de sélection de valeur.
Déclencheur d'initialisation de trame
Déclenche lorsque :
- L'initialisation de la trame, avant qu'elle ne devienne visible pour le participant.
Ce déclencheur s'associe bien aux actions Mélanger, Lire depuis et Tirer un nombre aléatoire. Avec ces combinaisons, ces actions peuvent être complétées avant l'apparition de la trame, laissant un chemin clair pour que d'autres actions commencent lorsque la trame démarre.
Note : Ne pas utiliser le déclencheur d'initialisation de trame 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 trame se produit entre les essais, donc il n'y a pas un compte pleinement exact de l'essai ou de la condition sur le point d'être affiché.
Paramètres : Aucun
- Note : Après avoir sélectionné le déclencheur d'initialisation de trame 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 d'initialisation de trame dans diverses actions avec le menu de sélection de valeur.
Note sur les déclencheurs d'initialisation de tâche et de trame : Étant donné que les déclencheurs d'initialisation de tâche et de trame se produisent avant le début de la tâche ou de la trame, les variables créées durant ce temps seront réinitialisées lorsque la tâche/la trame commencera réellement. Un avertissement apparaîtra lors de l'utilisation de cet événement :
N'oubliez pas de décocher la case "Réinitialiser au début de l'essai" dans la fenêtre des propriétés de la variable si vous ne souhaitez pas que les valeurs des variables soient réinitialisées.
Déclencheur de début de trame
Déclenche lorsque :
- Début de la trame
Paramètres : Aucun
- Note : Après avoir sélectionné le déclencheur de début de trame 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 de début de trame dans diverses actions avec le menu de sélection de valeur.
Déclencheur de fin de trame
Déclenche lorsque :
- Fin de la trame (après que la trame n'est plus visible)
Paramètres : Aucun
- Note : Après avoir sélectionné le déclencheur de fin de trame 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 de fin de trame dans diverses actions avec le menu de sélection de valeur.
Déclencheur de changement de valeur de variable
Changement de valeur de variable
Déclenche lorsque :
- La valeur d'une variable change de sa valeur initiale
Paramètres :
Variables : Sélectionnez une ou plusieurs variables sur lesquelles vous souhaitez "écouter" les changements. Tout changement dans la valeur de ces variables déclenchera immédiatement l'Action correspondante.
Note : Après avoir sélectionné le déclencheur de changement de valeur de variable 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 de changement de valeur de variable dans diverses actions avec le menu de sélection de valeur.
Déclencheurs d'objet multimédia
Déclencheur d'objet multimédia
Auparavant connu sous le nom de "Contrôle Audio/Video Trigger" et "Contrôle d'Objet".
Déclenche lorsque :
- Début, pause ou arrêt d'un fichier vidéo ou audio
- Téléchargement de fichier terminé, Fichier sélectionné, Enregistrement terminé 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 trame
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 d'enregistrement d'écran :
- Enregistrement terminé : Déclenche lorsque l'enregistrement audio a été arrêté
- Téléchargement complet : Déclenche lorsque le téléchargement du fichier est complet
- 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 complet
- 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
- Options d'objet audio ou vidéo :
Note : Après avoir sélectionné le déclencheur d'objet multimédia 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 d'objet multimédia dans diverses actions avec le menu de sélection de valeur.
Déclencheurs API
Si vous devez envoyer ou communiquer des données d'un serveur externe vers Labvanced, alors les "Déclencheurs API" et les "Actions API" peuvent être utilisés. Les suivants peuvent être utilisés comme déclencheurs :
- Déclencheur WebSocket
- Déclencheur OpenAI
- MessagePost reçu
Déclencheur WebSocket
Le déclencheur WebSocket est utilisé lorsqu'un message du websocket/API sera reçu et traité comme le déclencheur pour l'Action.
En cliquant sur cette option, les éléments suivants apparaissent.
- Accepter/Reçoit de : Détecte automatiquement l'adresse IP de l'hôte local. Peut être changé manuellement dans l'onglet
SettingssousSpecial 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 d'utilisation des Déclencheurs / Actions API, veuillez consulter cette démo https://www.labvanced.com/page/library/51053 en cliquant sur l'option 'Inspecter' dans la boîte de dialogue.
Pour plus d'informations sur l'accès API, veuillez visiter cette page.
- Note : Après avoir sélectionné le déclencheur WebSocket dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur WebSocket dans diverses actions avec le menu de sélection de valeur.
Déclencheur OpenAI
Le "Déclencheur OpenAI" peut être utilisé pour initier une action en fonction des informations entrantes d'OpenAI.
Sélectionner cette option affichera les paramètres suivants :
NOTE : Consultez également ce tutoriel où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant ce déclencheur.
Dans l'exemple ci-dessous, le cadre de données qui a été assigné est appelé '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.
Si vous utilisez également l'action 'Envoyer à OpenAI', alors vous devez utiliser le même cadre de données ici que vous avez indiqué ici.
- Note : Après avoir sélectionné le déclencheur OpenAI dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur OpenAI dans diverses actions avec le menu de sélection de valeur.
#### Déclencheur de message PostMessage reçu
Le déclencheur `PostMessage Received` se 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.
[En savoir plus.](/content/learn/fr/guide/events/postmessage-received-trigger.html)
* **Remarque :** Après avoir sélectionné le déclencheur PostMessage reçu 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 PostMessage reçu](#trigger-postmessage-received-values) dans diverses actions avec le [menu de sélection de valeurs.](#the-value-select-menu)
### Déclencheurs globaux
Les déclencheurs globaux se produisent chaque fois qu'un changement majeur se produit au sein de l'expérience, c'est-à-dire quelque chose qui est "global" comme la pause de l'expérience ou un participant quittant une étude multi-utilisateurs ! Les options suivantes sont listées comme déclencheurs globaux :
* Pause / Reprise de 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>
#### Pause/Reprise de l'expérience
Le déclencheur "Pause / Reprise de l'expérience" est une option qui vous permet d'exécuter un événement en fonction de la pause ou de 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 spécifier davantage la nature du déclencheur, s'il doit être exécuté lorsque l'expérience est mise en pause ou poursuivie / reprise :
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_dialog.webp" alt="Boîte 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 mise en pause :** Participant met en pause (sort du mode plein écran) l'étude.
* **Expérience poursuivie :** 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 un cadre précédent s'il a quitté son repose-menton virtuel.
* **Remarque :** Après avoir sélectionné le déclencheur Pause/Reprise de l'expérience dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux [valeurs spécifiques au déclencheur](#trigger-global-experiment-event-values) dans diverses actions avec le [menu de sélection de valeurs.](#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 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="Boîte de dialogue du 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 faire référence aux [valeurs spécifiques au déclencheur](#trigger-user-leaves-experiment-values) dans diverses actions avec le [menu de sélection de valeurs.](#the-value-select-menu)
## Actions
Les actions définissent ce qui doit se produire 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 à partir de 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 imbriquer des actions les unes dans les autres (par exemple, une boucle while dans une instruction if). Ainsi, le système d'événements peut être vu comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme des invocations de fonction, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit que presque toute logique expérimentale peut être mise en œuvre sans utiliser 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 la propriété de l'objet](#set-object-property-action) </li> <li> [Contrôler l'objet média](#control-media-object-action) </li> <li> [Copier l'objet](#copy-object-action) </li> <li> [Pour chaque objet](#foreach-object-action) </li> </ul> | Les actions d'objet se réfèrent à toute manipulation qui se produira sur un objet existant dans la tâche. |
| [`Variable Actions`](#variable-actions) | <ul><li> [Définir / Enregistrer la variable](#set-record-variable-action) </li> <li> [Copier dans le presse-papiers](#copy-to-clipboard-action) </li> <li>[Tirer un nombre aléatoire](#draw-random-number-action) </li> <li> [Obtenir le paramètre URL](#get-url-parameter-action) </li> <li> [Lire depuis / Écrire sur un appareil](#read-from-write-to-device-action) </li> <li> [Lire depuis / Écrire sur une variable partagée](#read-from-write-to-shared-variable-action) </li> <li> [Math & Statistiques](#math-statistics-action) </li> <li>[Enregistrer des variables instantanément](#record-variables-instantly-action) </li> <li>[Filtre de moyenne mobile](#moving-average-filter-action) </li> <li> [Distribuer la variable](#distribute-variable-action) </li> </ul> | Toute action qui lit ou enregistre une valeur de variable. |
| [`Array Actions`](#array-actions) | <ul><li> [Sélectionner dans un tableau (Lire)](#select-read-from-array-action) </li> <li> [Ajouter / Supprimer des entrées de tableau](#add-remove-array-entries-action) </li> <li> [Modifier une entrée de tableau (Remplacer)](#change-replace-array-entry-action) </li> <li> [Mélanger les entrées de tableau](#shuffle-array-entries-action) </li> </ul> | Les opérations sur les tableaux impliquent la sélection, l'ajout, la suppression, la modification et le mélange des tableaux et de leurs entrées. |
| [`Data Frame Operations`](#data-frame-operations) | <ul><li> [Lire depuis / Écrire dans le Data Frame](#read-from-write-to-data-frame-action) </li> <li> [Mélanger les entrées du 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> [Passer à](#jump-to-action) </li> <li> [Accepter / Mettre fin à la session](#accept-end-session-action) </li> <li> [Rejeter / Mettre fin à la session](#reject-end-session-action) </li> <li>[Rediriger vers l'URL](#redirect-to-url-action)</li></ul> | Permet de naviguer dans l'expérience en passant à une section spécifique, ainsi que d'accepter et de rejeter les sections des 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 (Fonction de rappel temporelle)](#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 if/then, les boucles (comme jouer un son répété ou faire clignoter une image), ainsi que pour configurer un délai sur le moment où une action se produit. |
| [`API Actions`](#api-actions) | <ul><li> [Envoyer PostMessage](#send-postmessage-action) </li><li> [Envoyer au Websocket](#send-to-websocket-action) </li><li> [Envoyer à OpenAI](#send-to-openai-action) </li></ul> | Fait référence aux 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 collage | Vous permet de coller une action que vous avez copiée précédemment. |
### Actions d'objet
Les actions d'objet se réfèrent à toute manipulation qui se produira sur un objet existant dans la tâche. Il existe plusieurs options d'actions d'objet :
* Définir la propriété de l'objet
* Contrôler l'objet média
* Copier l'objet
* Pour chaque objet
<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/object_actions_menu.webp" alt="L'option Actions d'Objet dans Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>
#### Action de définition de propriété d'objet
Avec l'action 'Définir la propriété de l'objet', vous pouvez changer l'apparence d'un objet comme vous le souhaitez en spécifiant l'objet en question, la propriété à changer et la nouvelle valeur.
[En savoir plus.](/content/learn/fr/guide/events/set-object-property-action.html)
#### Action de contrôle de l'objet média
Auparavant les actions séparées "Contrôler Audio/Vidéo" et "Contrôler l'Objet".
Effet : Change la lecture des éléments vidéo/audio ou change l'état des éléments de téléchargement/enregistrement.
Paramètres :
* Cible : Sélectionnez un objet média
* Effet : Sélectionnez une sous-action
* Options d'objets audio ou vidéo :
* Démarrer la lecture : Commence à lire le fichier vidéo / audio
* Arrêter la lecture : Arrête le fichier vidéo / audio
* Mettre en pause la lecture : Met en pause le fichier vidéo / audio
* JumpToTime : permet de spécifier un temps en millisecondes à sauter dans le fichier audio/vidéo
* Couper le son : désactive le son de l'objet
* Réactiver le son : restaure le son de l'objet
* Options d'objets Audio, Vidéo ou Enregistrement d'Écran :
* Démarrer l'enregistrement : Commence un nouvel enregistrement (audio)
* Arrêter l'enregistrement : Arrête l'enregistrement (audio)
* Démarrer le téléchargement : Commence le téléchargement du fichier
* Effacer l'enregistrement : Supprime les données d'enregistrement (audio).
* Démarrer la lecture : Commence à lire le fichier enregistré
* Arrêter la lecture : Arrête de lire le fichier enregistré
* Mettre en pause l'enregistrement : met en pause l'enregistrement de l'objet
* Reprendre l'enregistrement : reprend l'enregistrement de l'objet
* Options d'objets de téléchargement de fichiers :
* Démarrer le téléchargement : démarre le processus de téléchargement pour le fichier sélectionné
* Effacer le fichier : Supprime le fichier sélectionné
* Choisir un fichier : permet au participant de choisir le fichier souhaité
* Options d'objets de prise de photo avec la caméra :
* Démarrer la caméra : active la caméra du participant
* Arrêter la caméra : désactive la caméra du participant
* Démarrer le téléchargement : commence à télécharger la photo à l'expérience
* Prendre une photo : prend une photo en utilisant la caméra du participant
Action Copier Objet
Effet : Copie un objet, remplaçant le besoin de plusieurs objets distincts et d'événements dupliqués.
Paramètres :
- Source : Choisissez l'objet sur le cadre à copier.
- Nombre de copies : Saisissez le nombre de copies à faire de l'objet source.
- Définir le 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 (à partir de la liste habituelle des actions) ce qui arrivera aux copies. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à toutes les copies.
Action PourChaque Objet
Effet : Applique une action à plusieurs objets du même type.
Paramètres :
- Filtre : Choisissez le type d'élément à cibler.
- Autoriser un filtre de nom supplémentaire : Saisissez le nom de l'objet (des) à cibler. Pour plusieurs objets sur un cadre où certains ont des noms identiques, cela fonctionne bien.
- Séquence d'action : Vous permet de choisir (à partir de la liste habituelle des actions) ce qui arrivera aux éléments sélectionnés. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à tous les éléments répondant aux critères spécifiés ci-dessus.
Actions de Variables
Les actions de variables sont utilisées pour définir ou créer des valeurs de variables, enregistrer et définir des valeurs, y compris des valeurs à travers des sessions.
Le tableau ci-dessous fournit un aperçu introductif de toutes les options d'Action de Variable disponibles dans Labvanced. Chacune d'elles est décrite plus 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 nombres aléatoires et les enregistre dans une variable |
Get URL Parameter | Sauvegarde une valeur de l'URL unique du participant |
Read from / Write to Device | Lit ou écrit une variable depuis/vers le stockage local de l'appareil. Cette Action enregistre des données sur l'appareil du participant au lieu d'envoyer les données aux serveurs Labvanced. |
Read from / Write to Shared Variable | Lit ou écrit dans une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou être privée à chaque individu. |
Math & 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 les envoie au serveur Labvanced. |
Moving Average Filter | Calcule une moyenne mobile (une moyenne en constante mise à jour des données) d'une entrée 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
Avec l’action Set / Record Variable, vous pouvez écrire une valeur dans une variable, sélectionner ou créer la variable cible et définir la valeur via le menu de sélection de valeurs. C'est le mécanisme central derrière l'enregistrement de mesures comportementales et la conduite de logique basée sur des variables dans Labvanced.
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 nombres aléatoires et les enregistre dans une variable.
Paramètres :
- Type : Choisissez entre des valeurs continues et discrètes.
- Distribution : Choisissez entre une distribution gaussienne et uniforme.
- Tirages Multiples (booléen vrai/faux) : Choisissez de tirer une fois ou plusieurs fois.
- Nb de Tirages : Sélectionnez le nombre de tirages.
- Min : Définissez la valeur minimale pour la distribution uniforme.
- Max : Définissez la valeur maximale pour la distribution uniforme.
- Moyenne : Définissez la valeur moyenne pour la distribution gaussienne.
- Écart Type : Définissez l'écart type pour la distribution gaussienne.
- Enregistrer dans la Variable : Sélectionnez une variable où la (les) valeur(s) seront stockées.
Action Obtenir Paramètre URL
Effet : Enregistre une valeur de l'URL unique du participant.
Paramètres :
- Nom du paramètre : saisissez le nom du paramètre souhaité.
- Enregistrer dans la Variable : sélectionnez la variable dans laquelle enregistrer la valeur du paramètre.
Cette Action pourrait être combinée avec d'autres Actions pour construire des URL uniques pour les participants ou extraire des informations nécessaires à l'analyse de données.
Action Lire depuis/Écrire vers l'Appareil
Effet : Lit ou écrit une variable depuis/vers le stockage local de l'appareil. Cette Action enregistre des données sur l'appareil du participant au lieu d'envoyer les données aux serveurs Labvanced.
Paramètres :
- Choisissez de lire ou d'écrire sur l'appareil local.
- Choisissez 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 quelques-unes au hasard à présenter dans chaque session.
- Écrire sur l'Appareil : le numéro d'index des images présentées dans la Session 1.
- Lire depuis l'Appareil : 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é d'accès à la variable synchronisée.
- Méthode de Lire ou Écrire :
- 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 dans l'étude, mais ne fait aucun changement.
- Écrire uniquement la variable sur le serveur : effectue des changements sur la variable partagée, mais ne l'affiche pas aux participants.
- Partager les valeurs entre différents participants (pas seulement entre les sessions) : permet aux participants de voir les valeurs des variables 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 se passe avec la variable partagée/synchronisée à partir de la liste de toutes les Actions disponibles.
Cas d'Utilisation : Études Longitudinales/Multi-Sessions
- Avec cette action, des données spécifiques aux participants peuvent être transférées d'une session à l'autre et peuvent être partagées entre participants au cours des sessions.
- Par exemple, vous pouvez utiliser cette action pour enregistrer un score sur un test, puis permettre au participant de comparer son score à la moyenne des autres participants qui ont complété le test.
- Un autre exemple (similaire à l'action Lire depuis/Écrire vers l'Appareil) est de faire choisir aux participants 5 images qu'ils aiment à partir d'un tableau, d'effectuer une tâche, puis de présenter ces 5 images à nouveau dans une session ultérieure. La différence est que cette Action peut être utilisée pour montrer aux autres participants les images choisies, ou pour exclure ces images des options disponibles d'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 Opérations sur des Tableaux, Algèbre Linéaire et Tests Statistiques.
- Opération : Choisissez une opération mathématique (par ex. somme, min, écart-type, etc.).
- Tableau d'Entrée : Choisissez une variable d'entrée (Tableau) sur laquelle l'opération est exécutée.
- Paramètres : Certaines opérations ont des paramètres supplémentaires.
- Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.
Enregistrer des variables instantanément Action
Effet : Crée une capture d'écran de toutes les valeurs des variables et envoie ceci au serveur Labvanced.
Paramètres : Aucun
Filtre de moyenne mobile Action
Effet : Calcule une moyenne mobile (une moyenne mise à jour en permanence des données) d'une certaine entrée 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 de manière linéaire.
- 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 de distribution de variable
L'action de distribution de 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 à des informations (y compris les emplacements des stimuli et toute modification) d'être reflétées sur les écrans des participants. Consultez Action de distribution de variable pour une présentation dédiée de cette action à part entière.
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 de distribution de 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.
Découvrez cette démonstration qui incorpore la variable distribuée et la fonctionnalité de boîte de chat ici : Image Description Task with Chat Add-On.
Une explication complète des éléments du menu de dialogue se trouve ci-dessous :
| Élément du menu | Zone de menu | Options et description de l'action de distribution de variable |
|---|---|---|
Distribute value to |  | Choisissez à quels autres participants la valeur doit être envoyée.
|
Choose target variable and value |  |
|
Block |  | Si activé, la variable cible ne peut pas être changée tant que la distribution de la valeur actuelle n'est pas terminée. |
Rate Limit Strategy |  | La stratégie de limite de taux est une façon de protéger votre expérience contre l'engorgement du serveur et agit comme une stratégie préventive pour contrôler le taux auquel les demandes (c'est-à-dire les mises à jour via la variable distribuée) sont envoyées au serveur. Les options de stratégie suivantes sont disponibles :
|
Actions de tableau
Sélectionner (Lire) à partir de l'action du tableau
Effet : Lira une variable à partir d'un tableau et stockera cette valeur dans une variable scalaire.
Paramètres :
- Variable de tableau : Tableau d'entrée pour lire la valeur.
- Type d'index : Détermine quel type d'index est utilisé.
- Fixe : Utilisez un index fixe pour l'opération de lecture. Dans ce cas, tapez la position à partir de laquelle l'information doit être lue (basée sur 1).
- 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.
Ajouter / Supprimer des entrées de tableau Action
Effet : Ajoute et/ou supprime des entrées 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 : Utilisez un index fixe pour l'opération d'insertion / suppression. Dans ce cas, tapez dans la position du tableau où les entrées doivent être insérées / supprimées. (basée sur 1).
- 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érer / supprimer à partir de la fin du tableau.
- Nb 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.
Changer (Remplacer) l'entrée du tableau Action
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 : Utilisez un index fixe pour l'opération de remplacement. Dans ce cas, tapez dans la position du tableau qui doit être changée (basée sur 1).
- 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 du tableau.
- Variable d'entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.
Mélanger les entrées du tableau Action
Effet : Remélange les entrées / l'ordre dans un tableau.
Paramètres : Aucun
Opérations sur le cadre de données
Lire à partir de / Écrire dans l'action du cadre de données
Effet : Lit des valeurs 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 à partir du 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 sortie. Doit être une variable de tableau.
Mélanger les entrées du cadre de données Action
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 par 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.
- Cadre suivant : 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.
- Essai suivant : Saute au prochain essai. S'il n'y a plus d'essais définis, il sautera au premier essai de la prochaine tâche.
- Tâche suivante : Saute à la tâche suivante. S'il n'y a plus de tâches définies, il sautera à la première tâche du prochain bloc.
- Bloc suivant : 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 où 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é répondues. Sinon, l'action de saut n'est pas exécutée.
Accept/End Session Action
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 des essais avant de finir la session : Si activé, les données du dernier essai 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.
Reject/End Session Action
Effet : Met fin à 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.
Lorsque vous utilisez cette action pour rejeter les données d'un participant, les utilisateurs doivent afficher un message approprié aux participants qui explique pourquoi ils ne seront pas récompensés pour leur temps.
Paramètres : Aucun
Redirect to URL Action
Effet : Redirige le participant vers une URL spécifique.
Note : L'URL doit inclure le https:// au début pour que cette action fonctionne.
Control Actions
Requirement Actions (If... Then... Else If) Action
Effet : Évalue une déclaration if-then et exécute une série d'actions de manière dépendante. Chaque déclaration If / Else-If se compose de comparaisons AND / OR imbriquées 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 "Then" sont exécutées. Voir Requirement Action pour un guide dédié de cette action à part, y compris un exemple de Role_Id.
Paramètres :
- Ajouter une exigence : Ajouter une nouvelle exigence à une déclaration. Le menu "value-select" 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, inégal, etc.).
- Ajouter un groupe OR : Un seul des tous les exigences au sein d'un groupe OR doit être vrai pour que le groupe entier soit vrai. Ajoutez un groupe OR si les sous-actions doivent être exécutées dans plusieurs cas.
- Ajouter un groupe AND : Toutes les exigences au sein d'un groupe AND doivent être vraies pour que le groupe entier soit vrai. Ajoutez un groupe AND si les sous-actions doivent être exécutées uniquement lorsque plusieurs exigences sont satisfaites.
- Séquence d'actions : Chaque déclaration If / Else-If a une liste d'actions, qui sont définies sous "Then". La séquence d'actions énumère toutes les actions d'une certaine déclaration If / Else-If. 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 les exigences de la déclaration If / Else-if associée sont remplies.
- Ajouter un cas Else-If : L'Action de Requirement peut consister en plusieurs déclarations If / Else-If --> Then séparées. Cependant, une seule déclaration peut être exécutée. Si une déclaration If / Else-If est évaluée positivement (retourne vrai), les actions dans le bloc Then sont exécutées et le reste de l'Action de Requirement est sauté.
- Ajouter un cas Else (vrai / faux) : Si activé, une option par défaut / de secours est ajoutée à l'action d'exigence. Si aucune des déclarations If / Else-If n'est exécutée (retournée vraie), les actions définies dans le cas else seront exécutées.
Repeated Actions (While Loop) 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 exécution immédiate ou exécution chronométrée.
- Exécuter la boucle complète : Cela exécutera la boucle en continu jusqu'à ce que la condition d'arrêt soit remplie.
- Exécuter 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 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 débutera lors du prochain intervalle d'exécution.
- Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de boucles peuvent être démarrées en parallèle. Si désactivé, une seule instance de boucle peut être exécutée à la fois.
- Activer la condition d'arrêt (vrai / faux) : Si activé, une condition d'arrêt pour la boucle peut être spécifiée.
- Condition d'arrêt : La condition d'arrêt peut être utilisée pour spécifier une expression logique pour quand l'exécution de la boucle doit être arrêtée. Semblable aux déclarations If / Else-If, on peut combiner des groupes AND, des groupes OR 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".
Delayed Actions (Time Callback) 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 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".
Action Group
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.
API Actions
Si vous avez besoin d'envoyer ou de communiquer des données d'un serveur externe vers Labvanced, alors les ‘API Actions’ et ‘API Triggers’ peuvent être utilisés. Vous disposez des actions suivantes disponibles sous 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.
Send PostMessage Action
L'action Send 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.
Send to Websocket Action
Lors de la sélection de cette action, les options suivantes apparaissent :
L'exemple ci-dessus et la structure complète de l'événement peuvent être consultés ici : https://www.labvanced.com/page/library/51053 en cliquant sur 'Inspecter'.
| Éléments de menu | Description |
|---|---|
| Envoyer à : | Spécifie l'adresse Websocket qui est listée dans l'onglet Settings sous Special Features. |
| 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 comme partie de l'action. |
Pour plus d'informations sur l'accès à l'API, veuillez visiter cette page.
Send to OpenAI Action
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 apparaîtront en cliquant sur cet événement :
Voici un exemple fonctionnel de ce à quoi ressemble cet événement lorsque toutes les informations nécessaires sont fournies :
Pour une meilleure compréhension de la manière dont vous pouvez utiliser cette fonctionnalité et la voir en action, n'hésitez pas à nous contacter pour une démo en soumettant ce formulaire de contact.
REMARQUE : Consultez également ce guide où nous construisons une étude étape par étape, en intégrant ChatGPT dans une étude et en 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 |  | |
Chat History Dataframe |  | Lien vers une variable de cadre de données avec deux colonnes. La première colonne indiquera le ‘rôle’ et la seconde colonne le ‘message de chat’. Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici. Le cadre de données peut également être manipulé avec des actions de cadre de données. Pour plus de références, 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é :
|
Étant donné qu'OpenAI évolue quotidiennement, veuillez consulter les docs d'OpenAI pour des clarifications supplémentaires.
Actions de Code
Dans certains cas, votre expérience peut nécessiter d'utiliser du code personnalisé. Avec ces actions, vous pouvez le faire ! 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 comme une action lorsqu'il sera déclenché.
Lorsque l'action ‘Exécuter JavaScript’ ci-dessus est sélectionnée, vous verrez une zone (un éditeur de code) où le code JavaScript doit être écrit, ainsi que des instructions sur la manière de l'utiliser :
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éclenchement.
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 multiples.
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 Valeur
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 Valeur car il vous permet de sélectionner et d'indiquer quels types de valeurs doivent être enregistrées ou doivent être suivies. C’est une option très puissante et importante que vous êtes amené à utiliser pour votre conception et mise en place expérimentales.
Cette icône de stylo / Menu de Sélection de Valeur apparaît à divers emplacements 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 à 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.
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 sur la 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 :
| Catégorie | Options | Description |
|---|---|---|
Trigger-specific | 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 qui apparaîtra en haut du menu de sélection de valeur à choisir. Veuillez vous référer à la section sur Valeurs spécifiques au déclencheur pour voir une liste complète d'options et leurs descriptions. |
Current Time | Mesurer et appeler des valeurs temporelles. | |
Constant Value |
| 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. |
Variable |
| Spécifiez ou référez-vous à une variable ou sélectionnez une valeur d'un tableau ou d'un cadre de données. |
Frame / Task / Object |
| Vous permet de récupérer des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (s'il est activé), et au dispositif (fréquence de rafraîchissement de l'écran). |
Operations |
| Utilisez des opérations pour effectuer des changements spécifiés sur vos variables comme combiner des valeurs de variables, transformer des chaînes pour qu'elles soient toutes en minuscules, ou exécuter des opérations mathématiques. |
Valeurs de Temps Actuel
Avec l'option ‘Temps Actuel’, vous pouvez enregistrer ou vous référer à des valeurs concernant le temps.
Les options suivantes sont disponibles :
Temps Actuel : Horodatage UNIX
Cette valeur capture un horodatage au format UNIX en millisecondes.
Temps Actuel : Temps Depuis le Début de la Trame
Cette valeur capture le temps écoulé depuis le début de la trame. Le plus souvent, cela équivaut au temps de réaction.
Valeurs Constantes
Attribuez des valeurs constantes en fonction du type de variable dont vous avez besoin, comme 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 :
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
Affecte une valeur de date.
Constante : Heure
Affecte une valeur de temps.
Constante : Couleur
Affecte une valeur de couleur (chaîne hexadécimale).
Valeurs de Variable
Spécifiez ou faites référence à une variable ou sélectionnez une valeur dans un tableau ou un cadre de données. Les options suivantes sont disponibles :
- Sélectionner une Variable
- Sélectionner une Valeur dans le Tableau
- Sélectionner une Valeur dans un Cadre de Données
Sélectionner une Variable
Vous permet de sélectionner et pointer vers une Variable.
Sélectionner une Valeur dans le 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 Cadres / Tâches / Objets
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 (taux de rafraîchissement de l'écran).
Propriété d'Objet
Lit une propriété d'objet.
Cadre
| Options de Valeur de Cadre | Description |
|---|---|
Last cached Mouse X Position | La dernière valeur de coordonnée X de la souris du participant. |
Last cached Mouse Y Position | La dernière valeur de coordonnée Y de la souris du participant. |
Last cached Mouse [X,Y] Array | La dernière valeur de coordonnée [X,Y] de la souris du participant au format tableau. |
Frame Name | Le nom du cadre. |
Suivi Oculaire
| Options de Valeur de Suivi Oculaire | Description |
|---|---|
Last cached Coordinate X | La dernière valeur de coordonnée X du regard du participant. |
Last cached Coordinate Y | La dernière valeur de coordonnée Y du regard du participant. |
Last cached Coordinate [X,Y] Array | La dernière valeur de coordonnée [X,Y] du regard du participant au format tableau. |
Last cached Coordinate + Time [X,Y,T] Array | La dernière valeur de coordonnée [X,Y] du regard du participant, plus la valeur de T de capture de la caméra au format tableau. |
Appareil
- Taux de Rafraîchissement : La valeur de taux de rafraîchissement de l'appareil du participant.
Opérations
Utilisez des opérations pour effectuer des modifications spécifiques sur vos variables telles que la combinaison de valeurs de variable, la transformation de chaînes en minuscules, ou l'exécution d'opérations mathématiques.
Les options suivantes sont disponibles :
Arithmétique
Les opérations arithmétiques sont utiles à de nombreuses fins différentes, y compris la combinaison de chaînes et même la modification de propriétés d'objet.
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.
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'.
La nouvelle valeur de variable (de 'intermediateVar') est définie en utilisant plusieurs opérations arithmétiques combinées 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 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 |
|---|---|
To Lowercase | Change toutes les lettres d'une variable de chaîne en lettres minuscules. → Ex : (AAABBB) se transforme en (aaabbb) |
To Uppercase | Change toutes les lettres d'une variable de chaîne en lettres majuscules. → Ex : (aaabbb) se transforme en (AAABBB) |
To Link | Transforme la chaîne d'une variable en une URL qui s'ouvre dans une autre fenêtre |
Remove Whitespaces | Supprime tous les espaces entre les lettres dans une variable de chaîne. → Ex : (aaa bbbb cccc) se transforme en (aaabbbbccc) |
Trim Whitespaces | Supprime les espaces au début d'une variable de chaîne. → Ex : ( aaabbbcccc) se transforme en (aaabbbcccc) |
Replace Substring Regexp | Remplace certaines lettres dans une variable de valeur de chaîne. → Ex : (aaabbbccc) remplace bbb par xxx ce qui transforme la valeur en (aaaxxxccc) |
Opération Mathématique
Effectue une opération mathématique sur une valeur scalaire.
| Options d'Opération Mathématique | Description |
|---|---|
abs | Retourne le nombre absolu d'une valeur. |
sqrt | Retourne la racine carrée d'une valeur. |
round | Retourne la valeur arrondie entre 0 et 3 décimales. |
floor | Retourne la valeur arrondie vers le bas. |
ceil | Retourne la valeur arrondie vers le haut. |
cos | Retourne la valeur du cosinus. |
sin | Retourne la valeur du sinus. |
tan | Retourne la valeur de la tangente. |
Valeurs Spécifiques de Déclencheur
Les valeurs spécifiques au déclencheur font référence aux valeurs qui sont associées au déclencheur défini au sein d'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 Set / Record Variable ou d'une action Set Object Property), vous pouvez faire référence aux 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 les valeurs x et y et un tableau [X,Y] en utilisant une action Set / Record Variable.
Voici un tableau de tous les types de valeurs spécifiques au déclencheur qui peuvent être trouvées dans Labvanced, suivi d'une explication détaillée de chaque option.
| Nom | Options de Valeur - Aperçu |
|---|---|
Trigger (Mouse) |
|
Trigger (Keyboard) |
|
Trigger (Button Bar) |
|
Trigger (Enter On Input) |
|
Trigger (Scroll) |
|
Trigger (Gamepad/ Joystick) |
|
Trigger (Eyetracking Gaze) |
|
Trigger (Eyetracking Fixation) |
|
Trigger (Head Tracking) |
|
Trigger (On Task Initialization) |
|
Trigger (On Frame Init) |
|
Trigger (on Frame Start) |
|
Trigger (On Frame End) |
|
Trigger (Variable Value Changed) |
|
Trigger (Media Object Trigger) |
|
Trigger (Websocket Trigger) |
|
Trigger (OpenAI Trigger) |
|
Trigger (PostMessage Received) |
|
Trigger (Global Experiment Event) |
|
Trigger (User Leaves Experiment) |
|
Déclencheur (Souris) Valeurs
Lorsqu'un déclencheur de souris est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de Déclencheur (Souris) | Description |
|---|---|
Mouse X | Retourne la position X actuelle de la souris en coordonnées de cadre. |
Mouse Y | Retourne la position Y actuelle de la souris en coordonnées de cadre. |
Mouse [X,Y] Array | Les coordonnées de la souris [X,Y] au format de 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 de quand le déclencheur s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur s'est produit. |
Déclencheur (Clavier) Valeurs
Lorsqu'un déclencheur de clavier est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de Déclencheur (Clavier) | Description |
|---|---|
Id of Key | La valeur ID de la touche qui a été pressée comme déclencheur. |
Trigger Timestamp (Unixtime) | L'horodatage de quand le déclencheur s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur s'est produit. |
Déclencheur (Barre de Boutons) Valeurs
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'utilisation de certaines actions :
| Options de Déclencheur (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 de quand le déclencheur s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur s'est produit. |
Déclencheur (Entrée sur Input) Valeurs
Lorsqu'un déclencheur d'Entrée sur Input est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de Déclencheur (Entrée sur Input) | Description |
|---|---|
Id of Key | La valeur ID de la touche qui a été pressée comme déclencheur. |
Trigger Timestamp (Unixtime) | L'horodatage de quand le déclencheur s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur s'est produit. |
Déclencheur (Défilement) Valeurs
Lorsqu'un déclencheur de défilement est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de Déclencheur (Défilement) | Description |
|---|---|
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 de quand le déclencheur de défilement s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur de défilement s'est produit. |
Déclencheur (Gamepad/ Joystick) Valeurs
Lorsqu'un Gamepad/Joystick trigger est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de Déclencheur (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 en Unixtime. |
Trigger Timestamp (Unixtime) | Horodatage de quand le déclencheur se produit en Unixtime. |
Trigger Time (From Frame Onset) | Horodatage en Unixtime de quand le déclencheur se produit par rapport au début du cadre. |
Déclencheur (Gaze de Suivi Oculaire) Valeurs
Lorsqu'un déclencheur de gaze de suivi oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options de Déclencheur (Gaze de Suivi Oculaire) | 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 de regard X,Y au format tableau. |
Stimulus Name | Le nom du stimulus qui a initié le déclencheur de regard. |
Stimulus Info | Les informations sur le stimulus derrière le stimulus qui a initié le déclencheur de regard. |
Camera Capture Time T | Le moment exact où la capture d'image a eu lieu. Dans le pipeline de suivi oculaire Labvanced, une capture d'image de la caméra se produit d'abord avant que l'algorithme et le réseau neuronal n'effectuent les calculs de regard. Ainsi, le Camera Capture Time T est un horodatage UNIX du moment où la première capture d'image se produit. Pour plus d'informations concernant la technologie derrière notre suivi oculaire basé sur webcam, veuillez consulter notre page de technologie ET. |
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 la capture d'image, servant essentiellement de 'détecteur de clignement.' Veuillez consulter notre article évalué par des pairs publié 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 de quand le déclencheur de regard s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur de regard s'est produit. |
En savoir plus : Consultez la page dédiée au Déclencheur de Gaze de Suivi Oculaire pour activer le suivi oculaire, enregistrer des données de regard et des exemples pratiques.
Déclencheur (Fixation de Suivi Oculaire) Valeurs
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'utilisation de certaines actions :
| Options de Déclencheur (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 : les 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 de quand le déclencheur de fixation s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début de cadre jusqu'à quand le déclencheur de fixation s'est produit. |
En savoir plus : Consultez la page dédiée à Eyetracking Fixation Trigger pour activer la détection de fixation, enregistrer les données de fixation et voir des exemples pratiques.
Valeurs du Déclencheur (Suivi de la Tête)
Lorsqu'un déclencheur de suivi de la tête est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (Suivi de la Tête) | Description |
|---|---|
Camera Capture Time T | Lorsque la caméra a capturé l'image, c'est-à-dire un timestamp Unix du moment où la capture de l'image a eu lieu. C'est le moment où l'image / le cadre a été capturé avant tout traitement. |
Facemesh Dataframe | Un cadre de données contenant les 468 points de repère faciaux détectés par le modèle de maillage facial. Chaque ligne représente un point de repère avec ses coordonnées x, y et z dans l'espace de cadre normalisé. Utilisez cette valeur pour accéder à la géométrie faciale détaillée par image, comme les points de repère des lèvres, des yeux ou de la mâchoire. |
Head Turn | Rotation de la tête de gauche à droite, ce qui est appelé le tangage dans la littérature. |
Head Tilt | Inclinaison de la tête de haut en bas, connue sous le nom de tangage de tête dans la littérature. |
Head Roll | Capture le mouvement de roulis de la tête de côté à côté. |
Head Position [X,Y, T] Array | Ce tableau capture les valeurs numériques associées à la position de la tête, y compris les coordonnées x- et y pour le centre de la tête ainsi que la variable de temps (T). |
Nose Position [X,Y, T] Array | Ce tableau capture les valeurs numériques associées à la position spécifique du nez, y compris les coordonnées x- et y pour l'emplacement du nez ainsi que la variable de temps (T) du moment où la mesure a eu lieu. |
Nose Vector [X,Y, Z, T] Array | Cette mesure fonctionne en projetant un vecteur à partir de l'extrémité du nez et est utile pour tester si le participant fait attention à l'écran (cela est particulièrement important pour les études où le suivi oculaire n'est pas activé). Ainsi, si le nez est dirigé hors de l'écran (c'est-à-dire que le participant ne fait pas attention à l'expérience), la valeur Z diminue de 1 et s'approche de 0. |
Trigger Timestamp (Unixtime) | Point temporel durant l'expérience où le déclencheur lui-même se produit lorsque le suivi de la tête a été détecté et prend en compte le 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. |
Trigger Time from Frame Onset | C'est la valeur temporelle lorsque le déclencheur s'est produit par rapport à quand le début du cadre a eu lieu. |
Valeurs du Déclencheur (Initialisation de la Tâche)
Lorsqu'un déclencheur d'initialisation de tâche est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (Initialisation de la Tâche) | Description |
|---|---|
Trigger Timestamp (Unixtime) | Le timestamp Unix du déclencheur en millisecondes. |
Trigger Time (From Frame Onset) | Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre. |
Valeurs du Déclencheur (Initialisation du Cadre)
Lorsqu'un déclencheur d'initialisation de cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (Initialisation du Cadre) | Description |
|---|---|
TrialNr | Le numéro d'essai lorsque le déclencheur d'initialisation du cadre s'est produit. |
Trigger Timestamp (Unixtime) | Le timestamp Unix du déclencheur en millisecondes. |
Trigger Time (From Frame Onset) | Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre. |
Valeurs du Déclencheur (Début du Cadre)
Lorsqu'un déclencheur de début de cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (Début du Cadre) | Description |
|---|---|
Trigger Timestamp (Unixtime) | Le timestamp Unix du déclencheur en millisecondes. |
Trigger Time (From Frame Onset) | Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre. |
Valeurs du Déclencheur (Fin du Cadre)
Lorsqu'un déclencheur de fin de cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (Fin du Cadre) | Description |
|---|---|
Total Frame Time | Le temps total en millisecondes passé sur le cadre. |
Trigger Timestamp (Unixtime) | Le timestamp Unix du déclencheur en millisecondes. |
Trigger Time (From Frame Onset) | Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre. |
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 :
| Options du Déclencheur (Valeur de Variable Changée) | Description |
|---|---|
New Value in Variable | Fait référence à la nouvelle valeur d'une variable. |
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur de changement de variable s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le changement de valeur de variable a eu lieu. |
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 :
| Options du Déclencheur (Déclencheur d'Objet Média) | Description |
|---|---|
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur d'objet média s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur d'objet média s'est produit. |
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 :
| Options du 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é récepteur) de filtrer entre différents types de données. |
Data | Une valeur qui peut contenir différents types de données, tels que les choix des participants, les timestamps, les coordonnées x/y de la souris, etc. |
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur Websocket s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur WebSocket s'est produit. |
Valeurs du Déclencheur (Déclencheur OpenAI)
Lorsqu'un déclencheur OpenAI est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (Déclencheur OpenAI) | Description |
|---|---|
Chat GPT Answer | La valeur de la réponse de ChatGPT. |
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur OpenAI s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur OpenAI s'est produit. |
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 :
| Options du Déclencheur (Message Post Reçu) | Description |
|---|---|
Message Content | La charge utile de données du postMessage reçu, telle que envoyée par la source externe. |
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur de message post reçu s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur s'est produit. |
Valeurs du Déclencheur (Événement Expérimental 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 :
| Options du Déclencheur (Événement Expérimental Global) | Description |
|---|---|
Total Frame Time | Fait référence au temps total de cadre alloué avant le déclencheur. |
Reason for Global Event | Une valeur de chaîne qui énonce la raison du déclencheur, telle que le départ d'un participant de l'étude. |
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur d'événement global s'est produit au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur d'événement global s'est produit. |
Valeurs du Déclencheur (L'Utilisateur Quitte l'Expérience)
Lorsqu'un déclencheur de départ de participant de l'étude multi-utilisateur est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :
| Options du Déclencheur (L'Utilisateur Quitte l'Expérience) | Description |
|---|---|
Remaining Number of Participants | Le nombre de participants restant dans l'étude. |
Trigger Timestamp (Unixtime) | Le timestamp du moment où le déclencheur de départ de l'utilisateur a eu lieu au format Unix Time avec millisecondes. |
Trigger Time (From Frame Onset) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur de départ de l'utilisateur s'est produit. |