Système d'événements
Description
Le système d'événements est essentiel pour toute étude. C’est ainsi que vous configurez les valeurs à enregistrer, faites progresser l'expérience et créez des tâches. Les utilisateurs peuvent créer un système d'événements pour exécuter toutes les fonctionnalités, logiques et interactions dans une tâche. Un événement agit souvent comme un médiateur entre les objets et les variables.
Le système d'événements est composé de déclencheurs et d'actions. Ici, vous définissez des règles, comme "quand cela se produit" (déclencheur), alors "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 - Vue d'ensemble
Les événements sont gérés dans l'éditeur de tâches sous l'onglet "Événements" dans le coin supérieur droit. De nouveaux événements peuvent être créés en cliquant sur + Frame Event pour les événements qui devraient se produire sur ce frame ou en cliquant sur + Trial Event ce qui applique l'événement à tous les frames. Tous les événements existants sont affichés dans une vue en liste sur le panneau de droite. Les événements sont définis au niveau d'un frame et peuvent être séparés/spécifiques pour chaque frame ou dupliqués/identiques sur chaque frame au cours d'un essai.
Quoi qu'il en soit, un événement est toujours défini pour tous les essais au sein d'un groupe d'essais pour le(s) frame(s) spécifié(s). Cependant, une logique personnalisée permet aux utilisateurs d'exécuter des événements uniquement dans certains essais, conditions ou dans d'autres circonstances.
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 en haut de 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 détails sont affichés dans le panneau inférieur droit (Propriétés de l'événement). Pour une meilleure vue d'ensemble, les événements existants peuvent également être réouverts (icône à côté du champ de nom).
Déclencheurs
Le déclencheur définit quand l'événement sera exécuté. Cela peut être un clic de souris sur un objet particulier, une saisie de clavier spécifique, un changement de variable, le début d'un fichier vidéo ou beaucoup d'autres choses. Tous les déclencheurs et leurs paramètres / options sont expliqués dans la liste suivante :
| Catégorie de déclencheur | Options de déclenchement | Description |
|---|---|---|
Déclencheurs d'entrée utilisateur | Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur qui peut être activé manuellement par l'utilisateur/participant en faisant quelque chose comme déplacer sa souris, cliquer sur un élément du clavier, faire défiler, etc. | |
Déclencheurs de signaux physiologiques | Les déclencheurs de signaux physiologiques se produisent lorsqu'il y a une entrée physiologique spécifiée, comme regarder un élément spécifique ou des changements dans les mouvements de la tête. | |
Déclencheurs d'essai et de frame | Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux frames, par exemple quand une frame commence ou se termine. | |
Déclencheur de changement de valeur de variable | Variable (Valeur changée) | Un déclencheur pour l'événement se produit lorsqu'il y a un changement dans la valeur d'une variable spécifique. |
Déclencheur d'objet multimédia | Déclencheur d'objet multimédia | Ce déclencheur se produit par rapport aux objets multimédias, comme lorsqu'il y a une pause dans un fichier vidéo/audio, un enregistrement terminé, etc. |
Déclencheurs API | Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API. | |
Déclencheurs globaux | Les déclencheurs globaux se réfèrent à tout changement majeur dans une expérience, comme être mis en pause ou qu'un participant dans une étude multiutilisateur parte. |
Déclencheurs d'entrée utilisateur
Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur qui peut être activé manuellement par l'utilisateur/participant.
Le tableau ci-dessous fournit un aperçu introductif de tous les déclencheurs d'entrée utilisateur disponibles dans Labvanced. Chacun d'eux est décrit en détail dans les sections à venir.
| Option de déclencheur d'entrée utilisateur | Vue d'ensemble |
|---|---|
Déclencheur de souris | Tout mouvement de souris peut être utilisé comme déclencheur pour initier un événement, tel que : faire défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou cibles spécifiques à un déclencheur. Par exemple, un clic de souris sera utilisé comme déclencheur uniquement si une image spécifique est cliquée. |
Déclencheur de clavier | Toute pression sur le clavier peut être utilisée comme déclencheur pour initier un événement. Vous pouvez spécifier des lettres ou des chiffres de clavier spécifiques comme déclencheurs. |
Clics de boutons | Les objets bouton créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements. |
Entrée sur entrée | Ce déclencheur est couramment utilisé lorsqu'un participant appuie sur 'Entrée' pendant une expérience, comme moyen de soumettre sa réponse écrite ou son entrée dans des zones de champ de texte. |
Déclencheur de défilement | Ce déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier les directions de défilement x ou y, ainsi que les éléments sur lesquels le défilement se produit pour être utilisés comme déclencheurs d'événements. |
Déclencheur de manette/joystick | Ce déclencheur vous permet d'utiliser des manettes de jeu et des contrôleurs joystick dans votre conception expérimentale comme dispositif d'entrée pour enregistrer des données. |
Déclencheur de souris
L'option 'Déclencheur de souris' est un déclencheur d'événement très populaire car il initie un événement basé sur toute interaction avec la souris, comme : déplacer la souris vers le haut / bas, cliquer, survoler un objet spécifique, quitter un objet spécifique ou tout mouvement !
L'exemple ci-dessous montre un 'Déclencheur de souris' qui se produira lorsqu'un 'Clic' est effectué par le clic gauche de la souris sur l'objet 'Cible' appelé 'Image_1' :
Voici un aperçu complet des options dont vous disposez lorsque vous travaillez avec les déclencheurs de souris :
| Élément de menu | Zone de menu | Options et spécifications du déclencheur de souris |
|---|---|---|
Action liste déroulante : |  | Les options de déclencheur de souris suivantes sont disponibles dans la liste déroulante :
|
Button liste déroulante : |  |
|
Cibles options : |  Dans l'exemple ci-dessus, 'Image_1' est la cible du clic du bouton qui déclenchera l'événement. Différentes cibles peuvent être ajoutées en cliquant sur l'option ‘+Ajouter Cible’ 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 faire référence aux valeurs de souris spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheurs de clavier
L'option 'Déclencheur de clavier' est une autre manière 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 sur le clavier qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont pressées :
Voici un aperçu complet des touches et options dont vous disposez lorsque vous travaillez avec des déclencheurs de clavier :
| Élément de menu | Zone de menu | Options de déclencheur de clavier |
|---|---|---|
Action liste déroulante : |  |
|
Touches quelle touche déclenche l'événement |  | La touche utilisée comme déclencheur est spécifiée en sélectionnant les options ici en cliquant sur +Ajouter :
+Ajouter : |
| Options supplémentaires |  | L'option activer les boutons du pavé numérique permet d'utiliser les touches du pavé numérique comme déclencheurs dans l'expérience. Pour l'option autorise la propagation des événements, si plusieurs événements ont le même déclencheur de clavier, alors tous se déclenchent. Seul le premier se déclenchera et l'exécution de l'événement s'arrêtera après la fin du premier événement. |
- 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 faire référence aux valeurs de clavier spécifiques au déclencheur dans 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 comme partie d'un événement où cliquer sur le bouton agit comme un déclencheur pour une action.
Cliquer sur ce déclencheur affiche le menu suivant où vous pouvez spécifier quel bouton spécifique agira comme le déclencheur :
Voici un aperçu des éléments présentés :
| Élément de menu | Zone de menu | Options de déclencheur de clic de bouton |
|---|---|---|
Cible : +Définir la cible |  | |
Bouton: option |  | Spécifier quel bouton spécifique sur la frame |
- 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 faire référence aux valeurs de clic de bouton spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheur d'entrée sur Entrée
Déclencheur sur : La touche Entrée/Retour est pressée sur le clavier tandis qu'un élément spécifique est actif.
Paramètres :
Ajouter des cibles : Ajouter un élément d'entrée à l'événement.
Remarque : Après avoir sélectionné le déclencheur d'entrée sur Entrée 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 d'entrée sur Entrée dans diverses actions avec le menu de sélection de valeur.
Déclencheur de défilement
Déclencheur sur : La barre de défilement, le défilement sur le trackpad ou la molette de la souris est utilisé sur un élément spécifique.
Paramètres :
- Choisissez si le défilement est sur l'axe Y ou l'axe X (défilement vertical ou horizontal).
Cible : Définir l'élément cible sur lequel le déclencheur de défilement s'appliquera.
Remarque : Pour le texte long, dans le panneau 'Propriétés de l'objet' sous la section 'Style', les options Overflow-X et/ou Overflow-Y doivent avoir scroll comme option sélectionnée.
- 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 faire référence aux valeurs de défilement spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheur de manette/joystick
Le Déclencheur de manette/joystick vous permet d'utiliser des manettes de jeu et des contrôleurs joystick dans votre conception expérimentale comme un dispositif d'entrée pour enregistrer des données. Remarque : n'oubliez pas d'activer cette option sous l'onglet Paramètres de l'étude dans la colonne ‘Fonctionnalités de l'expérience’.
Lors de la sélection de ce déclencheur, la boîte de dialogue suivante apparaîtra.
Après avoir connecté votre manette, vous pouvez spécifier quelles touches précises doivent être utilisées comme déclencheurs. En appuyant sur la touche particulière, le système affichera son ID.
Dans l'exemple ci-dessous, 2 fait référence à la touche ◎ et 3 fait référence à la touche ▵. Remarque : Il est important de dire qu'il y a quelques variations entre les manettes concernant le fonctionnement de l'attribution des ID de touches.
En appuyant sur une touche, les données en direct apparaîtront également dans la seconde moitié de cette boîte de dialogue de déclencheur où vous pouvez voir comment les valeurs changent en temps réel en fonction de ce que vous pressez ou relâchez :
Consultez ce guide pour plus de détails et un exemple d'une étude qui utilise ce déclencheur.
Le tableau ci-dessous explique ces options plus en détail.
| Élément de menu | Zone de menu | Options de déclencheur de manette / joystick |
|---|---|---|
Écouter les boutons |  | I.) Spécifiez que le déclencheur est lié aux boutons et s'il doit être sur la pression de la touche, sur la pression ou le relâchement de la touche, ou sur le relâchement de la touche. II.) Spécifiez si le déclencheur est pour un bouton quelconque ou un bouton spécifique. Si l'option spécifique est sélectionnée, vous serez invité à presser le(s) bouton(s) sur votre manette. |
Écouter les axes |  | Si des mouvements d'axes sont requis, alors vous pouvez spécifier que le déclencheur se produira chaque fois que le seuil change d'une valeur spécifique. La valeur par défaut est 0,01. |
| Statut de la connexion |  | Indique si un dispositif est connecté ou non. |
| Flux de données en direct |  | Après avoir connecté le dispositif et pressé une touche ou déplacé un axe, les données en direct seront affichées où toute entrée que vous faites sur votre dispositif sera affichée ici. Cela est utile pour les tests lors de la configuration de votre étude et pour déterminer quelles touches ou axes vous souhaitez utiliser. |
Remarque : Après avoir sélectionné le déclencheur de manette / joystick dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence à ses valeurs spécifiques aux déclencheurs dans diverses actions avec le menu de sélection de valeurs
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 suivi oculaire regard
Déclencheur sur :
- Globalement, ce déclencheur s'applique lorsque le suivi oculaire a été activé.
- Déclencher uniquement en regardant des éléments spécifiques
Paramètres :
Si vous avez choisi de ne déclencher que sur des éléments spécifiques, ajoutez ces éléments comme cibles.
Remarque : Après avoir sélectionné le déclencheur de suivi oculaire regard dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de regard spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheur de suivi oculaire fixation
Ce déclencheur est toujours 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 faire référence aux valeurs de fixation spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheur de suivi de la tête
Déclencheur sur :
Changements dans l'orientation de la tête ou le mouvement de la tête.
Remarque : Après avoir sélectionné le déclencheur de suivi de la tête dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de suivi de tête spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheurs d'essai et de frame
Déclencheur Init de tâche
Déclencheur sur :
- Le premier frame du premier essai d'une tâche. Ne sera exécuté qu'une seule fois par tâche, malgré son affichage dans l'onglet Événements pour toutes les instances de ce frame.
Ce déclencheur se marie bien avec les actions Shuffle et Read From. Avec ces combinaisons, vous pouvez mélanger les entrées du tableau ou les frames de données au début de la tâche et assigner des sujets à des ensembles de stimuli sans avoir à créer plusieurs événements pour lire les stimuli ou les données.
Paramètres : Aucun
- Remarque : Après avoir sélectionné le déclencheur Init de tâche 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 Init de tâche dans diverses actions avec le menu de sélection de valeur.
Déclencheur Init de frame
Déclencheur sur :
- L'initialisation du frame, avant qu'il ne devienne visible pour le participant.
Ce déclencheur se marie bien avec les actions Shuffle, Read From et Draw Random Number. Avec ces combinaisons, ces actions peuvent être complétées avant que le frame n'apparaisse, laissant un chemin clair pour d'autres actions à commencer lorsque le frame commence.
Remarque : N'utilisez pas le déclencheur Init de frame avec des événements qui enregistrent une variable ou qui impliquent des variables système telles que le numéro d'essai ou le numéro de condition. Cela parce que le déclencheur Init de frame se produit entre les essais, donc il n'y a pas de compte exact du numéro d'essai ou de condition sur le point d'être affiché.
Paramètres : Aucun
- Remarque : Après avoir sélectionné le déclencheur Init de frame 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 Init de frame dans diverses actions avec le menu de sélection de valeur.
Remarque sur les déclencheurs Init de tâche et de frame : Parce que les déclencheurs Init de tâche et de frame se produisent avant que la tâche ou le frame commence, les variables créées pendant ce temps seront réinitialisées lorsque la tâche/frame 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 variable si vous ne souhaitez pas que les valeurs des variables soient réinitialisées.
Déclencheur de début de frame
Déclencheur sur :
- Début du frame
Paramètres : Aucun
- Remarque : Après avoir sélectionné le déclencheur de début de frame dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur de début de frame dans diverses actions avec le menu de sélection de valeur.
Déclencheur de fin de frame
Déclencheur sur :
- Fin du frame (après que le frame ne soit plus visible)
Paramètres : Aucun
- Remarque : Après avoir sélectionné le déclencheur de fin de frame dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur de fin de frame 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éclencheur sur :
- La valeur d'une variable change par rapport à sa valeur de départ
Paramètres :
Variables : Sélectionnez une ou plusieurs variables dont vous souhaitez "écouter" les changements. Tout changement dans la valeur de ces variables déclenchera immédiatement l'Action correspondante.
Remarque : 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 faire référence aux 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 les déclencheurs séparés "Contrôler Audio/vidéo" et "Contrôler Objet".
Déclencheur sur :
- Début, pause ou arrêt d'un fichier vidéo ou audio
- Fin d'upload de fichier, Fichier sélectionné, Enregistrement terminé d'un objet d'enregistrement
- Instantané terminé ou Importation complète d'un objet d'instantané de caméra
Paramètres :
Cible : Sélectionnez un élément d'objet qui existe sur le frame
Exécuter sur : Sélectionnez le sous-type de déclencheur
- Options d'objet audio ou vidéo :
- Lecture commencé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 s'est arrêté
- Importation complète : Déclenche lorsque l'importation de fichier est complète
- Options d'objet d'importation de fichier :
- Fichier sélectionné : Déclenche lorsque un fichier est sélectionné
- Importation complète : Déclenche lorsque l'importation de fichier est complète
- Options d'objet d'instantané de caméra :
- Instantané terminé : Déclenche lorsque la caméra a réussi à prendre un instantané
- Importation complète : Déclenche lorsque l'instantané est terminé d'importer
- Options d'objet audio ou vidéo :
Remarque : 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 faire référence aux valeurs d'objet multimédia spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheurs API
Si vous devez envoyer ou communiquer des données depuis un serveur externe vers Labvanced, alors les 'Déclencheurs API' et les ‘Actions API’ peuvent être utilisés. Les suivants peuvent être utilisés comme déclencheurs :
- Déclencheur Websocket
- Déclencheur OpenAI
Déclencheur Websocket
Le déclencheur Websocket est utilisé lorsqu'un message provenant du websocket/API doit être reçu et traité comme le déclencheur de l'action.
En cliquant sur cette option, les éléments suivants apparaissent.
- Accepter/Recevoir de : Détecte automatiquement l'adresse IP de l'hôte local. Peut être modifiée manuellement dans l'onglet 'Paramètres de l'étude' sous la colonne ‘Fonctionnalités de l'expérience’.
- Déclencheur/message : saisissez le message qui servira de déclencheur. Tapez 'any' pour accepter plus d'un message comme déclencheur.
Pour un exemple de la façon dont les Déclencheurs / Actions API sont utilisés, 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 à l'API, veuillez visiter cette page.
- Remarque : Après avoir sélectionné le déclencheur WebSocket dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs 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 basée sur les informations entrantes d'OpenAI.
La sélection de cette option affichera les paramètres suivants :
REMARQUE : Référez-vous également à ce guide 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 là aussi comme vous l'avez indiqué ici.
- Remarque : Après avoir sélectionné le déclencheur OpenAI dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs OpenAI spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheurs globaux
Les déclencheurs globaux se produisent lorsque des changements majeurs se produisent dans l'expérience, c'est-à-dire quelque chose qui est 'Global', comme mettre l'expérience en pause ou qu'un participant quitte une étude multi-utilisateurs ! Les options suivantes sont répertoriées comme déclencheurs globaux :
- Mettre en pause / Reprendre l'expérience
- Participant a quitté l'étude multiutilisateur
Déclencheur Mettre en pause/ Reprendre l'expérience
Le déclencheur ‘Mettre en pause / Reprendre l'expérience’ est une option qui vous permet d'exécuter un événement basé sur la mise en pause ou la reprise de l'expérience.
Lors de la sélection de 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 reprise :
Expérience mise en pause : Le participant met en pause (sort du mode plein écran) l'étude.
Expérience reprise : Le participant reprend l'étude. Ce déclencheur fonctionne bien pour les études de suivi oculaire. Il peut être utilisé pour renvoyer le participant à un essai ou un cadre précédent s'il a quitté son support de menton virtuel.
Remarque : Après avoir sélectionné le déclencheur Mettre en pause/ Reprendre l'expérience dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Déclencheur Participant a quitté l'étude multiutilisateur
Si un participant quitte une étude multiutilisateur, cela peut également être utilisé comme un déclencheur pour un événement. Si un participant quitte une étude multiutilisateur, cela affecte l'expérience à un niveau global car cela empêche les autres participants de continuer l'étude.
En sélectionnant ce déclencheur, vous pouvez spécifier quel type d'action se produira si un participant quitte une étude multiutilisateur.
- Remarque : Après avoir sélectionné le déclencheur Participant a quitté l'étude multiutilisateur dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.
Actions
Les actions définissent ce qui doit se passer lorsque l'événement est exécuté. Elles peuvent être utilisées pour changer des variables et des propriétés d'objets, enregistrer des données, lire et écrire des données à partir de tableaux ou 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 des actions imbriquées les unes dans les autres (par exemple, une boucle while dans une instruction if). Ainsi, le système d'événements peut être considéré 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 implémentée sans utiliser certaines structures programmatiques / syntaxiques.
Le tableau ci-dessous fournit un aperçu introductif des actions disponibles dans Labvanced :
| Catégorie d'action | Options d'action | Description |
|---|---|---|
Actions d'objet | Les actions d'objet se réfèrent à toute manipulation qui se produira sur un objet qui existe au sein de la tâche. | |
Actions de variable |
| Toute action qui lit ou enregistre une valeur de variable. |
Actions de tableau | Les opérations de tableau impliquent la sélection, l'ajout, le retrait, le changement et le mélange des tableaux et de leurs entrées. | |
Opérations de cadre de données | Ces actions sont pertinentes si vous travaillez avec des fichiers .csv (cadres de données) dans votre expérience. | |
Actions de saut | Vous permet de naviguer dans l'expérience en sautant à une section spécifique, ainsi que d'accepter et de rejeter les sections des participants. | |
Actions de contrôle | 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 avant qu'une action ne se produise. | |
Actions API | Se réfère aux actions spécifiques à l'API pour envoyer des données à une API. | |
Actions de code | Les actions de code vous permettent de travailler avec JavaScript ou CSS. | |
Action Coller | Action Coller | Vous permet de coller une action que vous avez copiée précédemment. |
Actions sur les objets
Les actions sur les objets font référence à toute manipulation qui se produira sur un objet existant dans la tâche. Il existe plusieurs options d'action sur les objets :
- Définir une propriété d'objet
- Contrôler un objet multimédia
- Copier un objet
- PourChaque objet
Action Définir une propriété d'objet
Avec l'action « Définir une propriété d'objet », vous pouvez changer l'apparence d'un objet comme vous le souhaitez en spécifiant l'objet en question, la propriété à modifier et la nouvelle valeur.
Dans l'exemple ci-dessous, l'action va changer deux propriétés de l'image cible en définissant la « visibilité » à « 1 » et sa « hauteur » à « 400 », tout en enregistrant le temps auquel ce changement s'est produit à l'écran en stockant la valeur dans la variable numérique appelée « Object_Prop_Change_Time ».
Voici un aperçu complet des champs que vous rencontrez lorsque vous travaillez avec l'action « Définir une propriété d'objet » :
| Élément du menu | Zone de menu | Options de déclenchement pour définir une propriété d'objet |
|---|---|---|
Cible liste déroulante de sélection d'objet : |  | |
Cible liste déroulante de sélection de propriété : |  | La deuxième liste déroulante indique quelle propriété d'objet doit être modifiée. Pour une explication complète des options disponibles et de leurs paramètres, veuillez consulter le Tableau des propriétés d'objet. |
Menu de sélection de valeur |  | Définissez la nouvelle valeur, c'est-à-dire quelle devrait être la valeur de la nouvelle propriété de l'objet à la suite de l'action utilisant le Menu de sélection de valeur. |
‘+ Ajouter propriété’ |  | Plusieurs propriétés peuvent être ajoutées et modifiées sous l'action en cliquant sur cette icône. |
| Checkbox - Enregistrer le temps lorsque ce changement est reflété à l'écran (mesuré en millisecondes à partir du début de la trame). |  | Lorsque une propriété est modifiée, un court laps de temps sera nécessaire (environ ~10ms) pour que les changements soient visibles. Avec cette option, vous pouvez enregistrer plus précisément le moment où la propriété modifiée est réellement visible lors du prochain rafraîchissement de l'affichage. Remarque : Après avoir sélectionné cette option, une boîte de dialogue apparaîtra vous demandant d'indiquer (ou de créer une nouvelle variable) où cette valeur capturée doit être stockée. La variable doit être numérique en tant que 'type de donnée.' |
Action Contrôler un objet multimédia
Auparavant, les actions distinctes "Contrôler Audio/Vidéo" et "Contrôler 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 multimédia
- Effet : Sélectionnez une sous-action
- Options pour objet audio ou vidéo :
- Commencer la lecture : Commence à jouer le fichier vidéo/audio
- Arrêter la lecture : Arrête le fichier vidéo/audio
- Mettre en pause la lecture : Met en pause le fichier vidéo/audio
- JumpToTime : vous permet de spécifier un temps en millisecondes auquel sauter dans le fichier audio/vidéo
- Muet : désactive le son de l'objet
- Réactiver : restaure le son de l'objet
- Options pour objet audio, vidéo ou d'enregistrement écran :
- Commencer l'enregistrement : Démarre un nouvel enregistrement (audio)
- Arrêter l'enregistrement : Arrête l'enregistrement (audio)
- Commencer le téléchargement : Commence le téléchargement du fichier
- Effacer l'enregistrement : Supprime les données d'enregistrement (audio).
- Commencer la lecture : Commence à jouer le fichier enregistré
- Arrêter la lecture : Arrête la lecture du 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 pour objet de téléchargement de fichier :
- Commencer le téléchargement : commence le processus de téléchargement pour le fichier sélectionné
- Effacer le fichier : Supprime le fichier sélectionné
- Choisir un fichier : permet au participant de choisir le fichier souhaité
- Options pour objet de capture d'image :
- Démarrer la caméra : active la caméra du participant
- Arrêter la caméra : désactive la caméra du participant
- Commencer le téléchargement : commence à télécharger la capture à l'expérience
- Prendre une capture : prend une photo à l'aide de la caméra du participant
- Options pour objet audio ou vidéo :
Action Copier un objet
Effet : Copie un objet, remplaçant ainsi la nécessité de plusieurs objets séparés et d'événements dupliqués.
Paramètres :
- Source : Choisissez l'objet sur la trame à copier.
- Nb de copies : Saisissez le nombre de copies à faire de l'objet source.
- Définir un nouveau nom d'élément : Choisissez parmi plusieurs paramètres pour déterminer les noms des copies.
- Assigner un nom avec un suffixe incrémenté : Ajoute une étiquette numérique à la fin du nouveau nom d'élément pour différencier les copies.
- Séquence d'action : Vous permet de choisir (dans la liste habituelle d'actions) ce qui arrivera aux copies. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à toutes les copies.
Action PourChaque objet
Effet : Applique une action à plusieurs objets du même type.
Paramètres :
- Filtrer : Choisissez le type d'élément à cibler.
- Autoriser le filtre de nom supplémentaire : Tapez le nom de l'objet (des objets) à cibler. Pour plusieurs objets sur une trame où certains ont des noms identiques, cela fonctionne bien.
- Séquence d'action : Vous permet de choisir (dans la liste habituelle d'actions) ce qui arrivera aux éléments sélectionnés. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à tous les éléments répondant aux critères spécifiés ci-dessus.
Actions sur les variables
Les actions sur les variables sont utilisées pour définir ou créer des valeurs de variables, enregistrer et définir des valeurs, y compris des valeurs à travers les sessions.
Le tableau ci-dessous fournit un aperçu introductif de toutes les options d'action sur les variables disponibles dans Labvanced. Chacune d'elles est décrite plus en détail dans les sections suivantes.
| Option d'action sur la variable | Description |
|---|---|
Définir / Enregistrer la variable | Écrire ou définir une valeur de variable |
Copier dans le presse-papiers | Copier une valeur de variable dans le presse-papiers interne de l'ordinateur. |
Tirer un nombre aléatoire | Tire un ou plusieurs nombres aléatoires et les enregistre dans une variable |
Obtenir le paramètre URL | Enregistre une valeur à partir de l'URL unique du participant |
Lire depuis / Écrire dans l'appareil | 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 de Labvanced. |
Lire depuis / Écrire dans une variable partagée | Lit ou écrit une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou privée à chaque individu. |
Mathématiques & Statistiques | Effectue une opération mathématique sur une variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie. |
Enregistrer les variables instantanément | Crée un instantané de toutes les valeurs de variables et les envoie au serveur Labvanced. |
Filtre de moyenne mobile | Calcule une moyenne mobile (une moyenne mis à jour en permanence des données) sur certaines entrées et stocke le résultat dans une nouvelle variable. |
Distribuer la variable | Enverra une valeur à d'autres participants. La valeur est stockée dans une variable. |
Action Définir / Enregistrer la variable
L'Action « Définir / Enregistrer la variable » est destinée à être utilisée dans chaque expérience dans Labvanced, car c'est ainsi que les valeurs et les mesures comportementales sont stockées et enregistrées.
Lors de l'activation de cette action, le menu de dialogue suivant apparaîtra où vous pourrez spécifier quelle variable doit être enregistrée et la valeur d'intérêt :
| Élément du menu | Zone de menu | Description |
|---|---|---|
Sélectionner |  | En cliquant sur sélectionner, vous indiquez quelle variable doit stocker la valeur. De là, vous pouvez également créer une nouvelle variable. |
| Icône de stylo | | L'icône du stylo symbolise le menu de sélection de valeur qui est utilisé pour définir et spécifier les valeurs exactes qui doivent être assignées à la variable sélectionnée (comme spécifié dans le bouton vert à gauche du signe égal (=)). |
Dans l'exemple ci-dessous, nous avons créé une nouvelle variable appelée counter et utilisé une option arithmétique du menu de sélection de valeurs pour faire augmenter la valeur de la variable de 1 (en fonction du déclencheur défini à l'étape précédente).
L'image ci-dessous enregistre les coordonnées X,Y de la souris afin de capturer le suivi de la souris pendant une étude. L'image ci-dessous montre comment trois actions sont utilisées pour rendre l'enregistrement des valeurs de variables possible. La variable (à gauche) est créée manuellement tandis que la valeur du côté droit du signe égal (=) est une valeur spécifique au déclencheur de souris que le système fournit et à laquelle vous pouvez vous référer lors de l'enregistrement des valeurs.
Remarque : L’Action Définir / Enregistrer la variable est également couramment utilisée dans le contexte des Actions de Contrôle où vous pouvez spécifier des conditions à l'aide de 'si / alors' et 'boucles pendant' basées sur des valeurs de variables.
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 : Choisir entre des valeurs continues et discrètes
- Distribution : Choisir entre une distribution gaussienne et uniforme
- Tirages multiples (booléen vrai/faux) : Choisissez de tirer une fois ou plusieurs fois.
- Nr de tirages : Sélectionnez le nombre de tirages
- Min : Définir la valeur minimale pour la distribution uniforme
- Max : Définir la valeur maximale pour la distribution uniforme
- Moyenne : Définir la valeur moyenne pour la distribution gaussienne
- Écart-type : Définir l'écart-type pour la distribution gaussienne
- Enregistrer dans la variable : Sélectionner une variable où la ou les valeurs sont stockées.
Action Obtenir le paramètre URL
Effet : Enregistre une valeur à partir de l'URL unique du participant
Paramètres :
- Nom du paramètre : saisissez le nom du paramètre souhaité
- Enregistrer dans une variable : sélectionnez la variable dans laquelle enregistrer la valeur du paramètre
Cette action pourrait être combinée avec d'autres actions pour construire des URL uniques pour les participants ou extraire des informations nécessaires à l'analyse des données.
Action Lire depuis/Écrire dans 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 de Labvanced.
Paramètres :
- Choisissez de lire à partir ou d'écrire dans 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 lors de la session 1 et vous assurer que des images différentes leur sont présentées lors de la session 2.
- Créez un tableau d'images et sélectionnez au hasard quelques-unes à présenter à chaque session.
- Écrire sur l'appareil : le numéro d'index des images présentées lors de la session 1.
- Lire depuis l'appareil : lors de la session 2, lisez les index des images de la session 1 et incluez une action JavaScript qui empêche ces index d'être sélectionnés pour la deuxième session.
Action Lire depuis/Écrire dans une variable partagée
Effet : Lit ou écrit une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou 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 lecture ou d'écriture :
- Lire, modifier, puis écrire la variable partagée : lit la variable, effectue un changement, puis envoie la variable à l'étude.
- Lire uniquement la valeur partagée depuis le serveur : appelle la variable qui est partagée au sein de l'étude, mais ne fait aucun changement.
- Écrire uniquement la variable sur le serveur : effectue des changements à la variable partagée, mais ne l'affiche pas aux participants.
- Partager des valeurs entre différents participants (pas seulement entre les sessions) : permet aux participants de voir les valeurs de variable synchronisées des uns et des autres 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 à la variable partagée/synchronisée dans la liste de toutes les actions disponibles.
Cas d'utilisation : Études longitudinales/multi-sessions
- Avec cette action, les données spécifiques aux participants peuvent être transférées d'une session à l'autre et partagées entre les participants lors des sessions.
- Par exemple, vous pouvez utiliser cette action pour enregistrer un score à un test, puis permettre au participant de comparer son score à la moyenne des scores des autres participants ayant complété le test.
- Un autre exemple (similaire à l'action Lire depuis/Écrire dans l'appareil) est de faire sélectionner aux participants 5 images qu'ils aiment dans un tableau, de réaliser une tâche, puis de présenter à nouveau ces 5 images lors d'une session ultérieure. La différence est que cette action peut être utilisée pour montrer aux autres participants les images qui ont été choisies ou pour exclure ces images des options disponibles d'un autre participant.
Action Mathématiques & 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 les tableaux, algèbre linéaire et tests statistiques
- Opération : Choisissez une opération mathématique (ex : somme, min, écart-type, etc.)
- Tableau d'entrée : Choisissez une variable d'entrée (tableau) sur laquelle l'opération est exécutée
- Paramètres : Certaines opérations ont des paramètres supplémentaires.
- Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.
Action Enregistrer les variables instantanément
Effet : Crée un instantané de toutes les valeurs de variables et envoie cela au serveur Labvanced.
Paramètres : Aucun
Action Filtre de moyenne mobile
Effet : Calcule une moyenne mobile (une moyenne mise à jour en permanence des données) sur certaines entrées et stocke le résultat dans une nouvelle variable.
Paramètres :
- Forme du filtre : Sélectionnez le type de filtre
- Moyenne mobile simple : Calcule une moyenne mobile simple, où tous les échantillons ont le même poids.
- Moyenne mobile pondérée linéaire : Pèse les échantillons de manière à ce que les poids des échantillons diminuent linéairement.
- Moyenne mobile exponentielle : Pèse les échantillons de manière à ce que les poids des échantillons diminuent de façon exponentielle.
- Nombre d'échantillons : Détermine combien d'échantillons sont utilisés par étape.
- Entrée : Choisissez une variable d'entrée (tableau) sur laquelle la moyenne mobile est calculée
- Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.
Action Distribuer la variable
L'action Distribuer 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 de stimuli et tout changement) d'être reflétées sur les écrans des participants.
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 la 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 qui est utilisée comme moyen de créer un chat entre deux participants en distribuant la valeur d'une variable d'un objet de champ de saisie.
Consultez 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 ajout de chat.
Une explication complète des éléments du menu de dialogue peut être trouvée ci-dessous :
| Élément du menu | Zone de menu | Options et description de l'action Distribuer la variable |
|---|---|---|
Distribuer la valeur à |  | Choisissez à quels autres participants la valeur doit être envoyée.
|
Choisissez la variable cible et la valeur |  |
|
Bloc |  | Si activé, la variable cible ne peut pas être modifiée jusqu'à ce que la distribution de valeur actuelle soit terminée. |
Stratégie de limite de taux |  | La stratégie de limite de taux est un moyen 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, mises à jour via la variable distribuée) sont envoyées au serveur. Les options de stratégie suivantes sont disponibles :
|
Actions sur les tableaux
Action Sélectionner (Lire) depuis le tableau
Effet : Lira une variable d'un tableau et stockera cette valeur dans une variable scalaire.
Paramètres :
- Variable de tableau : tableau d'entrée pour lire la valeur.
- Type d'index : détermine quel type d'index est utilisé.
- Fixe : Utilisez un index fixe pour l'opération de lecture. Dans ce cas, tapez la position à partir de laquelle l'information doit être lue (base 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.
Action Ajouter / Supprimer des entrées du tableau
Effet : Ajoute et/ou supprime des entrées d'un tableau.
Paramètres :
- Variable de tableau : variable de tableau où l'opération 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, entrez la position du tableau où les entrées doivent être insérées / supprimées. (base 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 depuis la fin du tableau.
- Nb d'entrées à supprimer : Supprime les entrées du tableau (avant d'insérer de nouvelles entrées) à partir de la position d'index définie. 0 indique qu'aucune valeur ne sera supprimée.
- Variable(s) à insérer : Sélectionnez une ou plusieurs variable(s) scalaire(s), qui seront ajoutées à la variable de tableau à la position d'index définie.
Action Changer (Remplacer) une entrée du tableau
Effet : Remplace / change une valeur au sein d'un tableau.
Paramètres :
- Variable de tableau : variable de tableau dans laquelle une valeur doit être modifiée
- Type d'index : détermine quel type d'index est utilisé.
- Fixe : Utilisez un index fixe pour l'opération de remplacement. Dans ce cas, entrez la position du tableau qui doit être changée (base 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 : Remplace la dernière entrée dans le tableau.
- Variable d'entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.
Action Mélanger les entrées du tableau
Effet : Remélange les entrées / l'ordre dans un tableau.
Paramètres : Aucun
Opérations sur les cadres de données
Action Lire depuis / Écrire dans le cadre de données
Effet : Lit des valeurs depuis ou écrit des valeurs dans un cadre de données et les sauvegarde dans une nouvelle variable 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 sortie. Doit être une variable tableau.
Action Mélanger les entrées du cadre de données
Effet : Mélange l'ordre des entrées dans le cadre de données.
Paramètres :
- Sélectionnez le cadre de données à mélanger.
- Sélectionnez si le cadre de données doit être mélangé par lignes ou colonnes.
Actions de saut
Action Sauter à
Effet : "Saute" le participant à une autre étape dans l'expérience. Cette action peut changer l'ordre des essais et des tâches dans une expérience et peut être utilisée pour créer une logique expérimentale individualisée pour chaque participant.
Paramètres :
- Sauter à : Détermine où sauter dans l'expérience.
- Trame suivante : Saute à la trame suivante. S'il n'y a plus de trames définies dans un essai, il sautera à la première trame du prochain essai.
- Essai suivant : Saute à l'essai suivant. 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 prochaine tâche. 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 bloc suivant. S'il n'y a plus de blocs définis, la session se terminera.
- Trame précédente : Saute à la trame précédente. S'il n'y a pas de trames précédentes, l'action ne sera pas exécutée.
- Trame spécifique : Saute à une trame spécifique. Les utilisateurs sélectionnent directement la trame à laquelle sauter.
- Essai spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro d'essai à sauter.
- Tâche spécifique : Saute à la première instance de la tâche spécifiée dans le bloc actuel. Les utilisateurs sélectionnent directement la tâche à laquelle sauter.
- Bloc spécifique : Saute à la première instance du bloc spécifié. Les utilisateurs sélectionnent directement le bloc auquel sauter.
- Vérifier si les réponses requises ont été données avant : Si activé, l'expérience vérifiera si toutes les réponses requises ont déjà été fournies. Sinon, l'action de saut ne sera pas exécutée.
Action Accepter/Fin de session
Effet : Accepte les données du participant, termine la session d'enregistrement et affiche le code de crowdsourcing.
Paramètres :
- Enregistrer les données de l'essai avant de terminer la session : Si activé, les données de l'essai le plus récent seront stockées (envoyées au serveur) avant de quitter l'étude.
- Afficher la page de fin par défaut : Si activé, l'écran de fin par défaut de Labvanced apparaîtra. Si c'est une session de crowdsourcing (un lien de crowdsourcing a été utilisé), le code de compensation sera affiché au participant. Si désactivé, l'expérience se terminera après avoir affiché la trame actuelle et ne montrera pas l'écran de fin par défaut avec le code de compensation.
Action Rejeter/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 qui explique la raison pour laquelle ils ne seront pas récompensés pour leur temps.
Paramètres : Aucun
Action Rediriger vers l'URL
Effet : Redirige le participant vers une URL spécifique.
Remarque : L'URL doit inclure le https:// au début afin que cette action fonctionne.
Actions de contrôle
Actions de conditions (Si... Alors... Sinon si)
Effet : Évalue une instruction si-alors et exécute une série d'actions en fonction. Chaque instruction If / Else-If se compose de comparaisons imbriquées AND / OR 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 : Ajouter une nouvelle condition à une instruction. Le menu de "sélection de valeur" apparaîtra de chaque côté pour effectuer une comparaison logique. Au milieu de l'instruction, vous pouvez choisir comment les deux côtés doivent être comparés (ex: égal, plus petit que, inégal, etc.).
- Ajouter un groupe OU : Un seul des éléments dans un groupe OU doit être vrai pour que le groupe entier soit vrai. Ajoutez un groupe OU si les sous-actions doivent être exécutées dans plusieurs cas.
- Ajouter un groupe ET : Toutes les conditions à l'intérieur d'un groupe ET doivent être vraies pour que le groupe entier soit vrai. Ajoutez un groupe ET si les sous-actions doivent être exécutées uniquement lorsque plusieurs conditions sont remplies.
- Séquence d'action : Chaque instruction If / Else-If a une liste d'actions, qui sont définies sous "Alors". La séquence d'action liste toutes les actions pour une instruction If / Else-If donnée. Une nouvelle action peut être ajoutée via l'icône "Ajouter une action". La séquence d'action sera exécutée uniquement si les conditions de l'instruction If / Else-if associée sont remplies.
- Ajouter un cas Else-If : L'action de condition peut consister en plusieurs instructions séparées If / Else-If --> Alors. Cependant, une seule instruction peut être exécutée. Si une instruction If / Else-If est évaluée positivement (renvoie vrai), les actions dans le bloc Alors sont exécutées et le reste de l'action de condition est ignoré.
- Ajouter un cas Else (vrai / faux) : Si activé, une option par défaut / de secours est ajoutée à l'action de condition. Si aucune des instructions If / Else-If n'est exécutée (renvoie vrai), les actions définies dans le cas else seront exécutées.
Action d'Actions répétées (Boucle While)
Effet : Exécute plusieurs fois une série d'actions, soit immédiatement, soit dans un intervalle défini. Une condition d'arrêt peut être précisée de sorte que l'exécution de la boucle soit arrêtée.
Paramètres :
- Type d'exécution : Choisissez entre l'exécution immédiate ou l'exécution minutée
- Exécuter la boucle complète : Cela exécutera la boucle en continu jusqu'à ce que la condition d'arrêt soit remplie.
- Exécuter tous les ... ms : Cela exécutera la boucle 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 tous les ... ms" est sélectionné, les utilisateurs ont la possibilité d'assigner une valeur entière numérique pour le nombre de fois que la boucle doit être exécutée. Cela remplace la nécessité de définir une condition d'arrêt.
- Intervalle d'exécution : Cela détermine l'intervalle d'exécution.
- Commencer immédiatement (vrai / faux) : Si activé, cela exécutera la boucle immédiatement. Si désactivé, la boucle sera commencée au prochain intervalle d'exécution.
- Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de boucle peuvent être démarrées en parallèle. Si désactivé, une seule instance de boucle peut être exécutée à la fois.
- Activer la condition d'arrêt (vrai / faux) : Si activé, une condition d'arrêt pour la boucle peut être spécifiée.
- Condition d'arrêt : La condition d'arrêt peut être utilisée pour spécifier une expression logique pour quand l'exécution de la boucle doit être arrêtée. Semblable aux instructions If / Else-If, une peut combiner des groupes AND, des groupes OR, et des exigences pour la comparaison logique.
- Séquence d'action : La séquence d'action 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".
Action d'Actions retardées (Callback de temps)
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'action : La séquence d'action liste toutes les actions qui sont exécutées après le délai de temps 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. Pour ajouter un groupe d'actions, vous pouvez trouver l'option sous Actions personnalisées :
Actions API
Si vous devez envoyer ou communiquer des données d'un serveur externe à Labvanced, alors les « Actions API » et ‘Déclencheurs API’ peuvent être utilisés. Vous avez les actions suivantes disponibles dans cette catégorie :
- Envoyer vers Websocket
- Envoyer vers OpenAI
Pour que ces actions soient ‘disponibles’ ou utilisables, vous devez entrer une clé API dans les Paramètres de l'étude sous la colonne ‘Fonctionnalités de l'expérience’. Une fois la clé API fournie là, ces actions ne seront plus grisées dans le menu.
Action Envoyer vers Websocket
Lorsque vous sélectionnez 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ément du menu | Description |
|---|---|
| Envoyer vers: | Spécifiez l'adresse Websocket qui est listée dans les ‘Paramètres de l'étude’ sous la colonne ‘Fonctionnalités de l'expérience’. |
| Déclencheur / message à envoyer: | Spécifiez le déclencheur ou le message que vous souhaitez envoyer. |
| Envoyer la variable (facultatif) : | 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.
Action Envoyer vers OpenAI
L'action « Envoyer vers 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 de l'étude » sous la colonne ‘Fonctionnalités de l'expérience’.
Les options suivantes apparaîtront en cliquant sur cet événement :
Voici un exemple fonctionnel de la façon dont cet événement apparaît lorsque toutes les informations nécessaires sont fournies :
Pour mieux comprendre comment vous pouvez utiliser cette fonctionnalité et la voir en action, n'hésitez pas à nous contacter pour une démonstration en soumettant ce formulaire de contact.
REMARQUE : Référez-vous également à ce didacticiel où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant cette action.
Voici une explication plus approfondie des champs inclus dans l'action 'Envoyer vers OpenAI' :
| Élément du menu | Zone de menu | Options de l'action 'Envoyer vers OpenAI' |
|---|---|---|
Type de modèle |  | Remarque : pour spécifier la version de ChatGPT, veuillez consulter les ‘Paramètres de l'étude’ sous la colonne ‘Fonctionnalités de l'expérience’. |
Cadre de données d'historique de chat |  | Lien vers une variable de cadre de données avec deux colonnes. La première colonne indiquera le ‘rôle’ et la seconde colonne le ‘message de chat.’ Les valeurs de l'action seront automatiquement ajoutées au cadre de données lié ici. Le cadre de données peut également être manipulé avec des actions sur cadre de données. Pour plus de références, veuillez consulter la documentation d'OpenAI. |
Insérer 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é :
|
Actions de Code
Dans certains cas, votre expérience peut nécessiter l'utilisation de code personnalisé. Avec ces actions, vous pouvez le faire ! Les options suivantes sont disponibles dans le menu « Actions de Code » :
- Exécuter JavaScript
- Définir CSS global
Action Exécuter JavaScript
L'action « Exécuter JavaScript » vous permet de programmer des événements spécifiques et de lire/définir des variables Labvanced dans votre étude en saisissant du JavaScript personnalisé qui sera exécuté lorsque l'action sera déclenchée.
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 :
Action Définir CSS Global
Avec l'action « Définir CSS Global », vous pouvez utiliser du code CSS personnalisé pour modifier un aspect de l'étude lors d'un déclenchement.
Le champ suivant s'ouvre lors de ce clic 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 à partir d'une question à choix multiples.
Action Coller
Cette option vous permet de coller une Action que vous avez préalablement créée et copiée. Cela vous permet de travailler plus rapidement lors de la conception de votre expérience afin que vous n'ayez pas à sélectionner les mêmes éléments encore et encore. Par exemple, si vous avez un événement similaire à un qui existe déjà, vous pouvez simplement le copier, le coller et le modifier, au lieu de le construire depuis le début.
Le Menu de Sélection de Valeur
En travaillant 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'instruire quel type de valeurs doivent être enregistrées ou doivent être suivies. C'est une option très puissante et importante que vous serez amené à utiliser pour la conception et la configuration de votre expérience.
Cette icône de stylo / Menu de Sélection de Valeur apparaît à divers endroits pour certaines actions dans le système d'événements, telles que l'action Définir / Enregistrer Variable, l'action Définir Propriété d'Objet et l'action Condition (Si... Alors), comme indiqué 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 autres 5 catégories (Heure Actuelle, Valeur Constante, Variable, Cadre / Tâche / Option et Opérations), qui ont toutes leurs propres options. Celles-ci seront décrites plus 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 à gauche commence par une catégorie spécifique au déclencheur, puis passe aux autres 5 catégories (Heure Actuelle, etc).
Options du Menu
Le tableau ci-dessous explique davantage les catégories et options :
| Catégorie | Options | Description |
|---|---|---|
Valeur spécifique au déclencheur | 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 affichées 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 de descriptions. |
Heure Actuelle | Mesurer et appeler des valeurs de temps. | |
Valeur Constante |
| Attribuer 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 pour créer des compteurs. |
Variable |
| Spécifiez ou faites référence à une variable ou sélectionnez une valeur d'un tableau ou d'un cadre de données. |
Cadre / Tâche / Objet |
| Vous permet de récupérer des valeurs associées aux propriétés d'objet, au cadre, au suivi des yeux (s'il est activé) et à l'appareil (fréquence de rafraîchissement de l'écran). |
Opérations |
| 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 Heure Actuelle
Avec l'option « Heure Actuelle », vous pouvez enregistrer ou faire référence à des valeurs concernant le temps.
Les options suivantes sont disponibles :
Heure Actuelle : Horodatage UNIX
Cette valeur capture un horodatage 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
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 telles que Arithmétique 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
Attribue une valeur de date.
Constante : Heure
Attribue une valeur de temps.
Constante : Couleur
Attribue 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 d'un tableau ou d'un cadre de données. Les options suivantes sont disponibles :
Sélectionner Variable
Vous permet de sélectionner et de pointer vers une Variable.
Sélectionner Valeur d'un Tableau
Vous permet de sélectionner une valeur d'un tableau.
Sélectionner Valeur d'un Cadre de Données
Vous permet de sélectionner une valeur d'un cadre de données que vous avez créé.
Valeurs Cadre / Tâche / Objet
Vous permet de récupérer des valeurs associées aux propriétés d'objet, au cadre, au suivi des yeux (s'il est activé) et à l'appareil (fréquence de rafraîchissement de l'écran).
Propriété d'Objet
Lit une propriété d'objet.
Cadre
| Options de Valeur de Cadre | Description |
|---|---|
Dernière position X de souris mise en cache | La dernière valeur de coordonnée X de la souris du participant. |
Dernière position Y de souris mise en cache | La dernière valeur de coordonnée Y de la souris du participant. |
Dernier tableau [X,Y] de souris mis en cache | La dernière valeur de coordonnée [X,Y] de la souris du participant au format tableau. |
Nom du Cadre | Le nom du cadre. |
Suivi des Yeux
| Options de Valeur de Suivi des Yeux | Description |
|---|---|
Dernière coordonnées X mises en cache | La dernière valeur de coordonnée X du regard du participant. |
Dernière coordonnées Y mises 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 de capture de caméra T 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 changements spécifiés sur vos variables, telles que la combinaison de valeurs de variables, la transformation de chaînes afin qu'elles soient toutes 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 à diverses fins, y compris la combinaison de chaînes et même la modification des propriétés d'objet.
Essentiellement, l'opération arithmétique vous permet d'effectuer des opérations sur plusieurs valeurs.
Lors de la sélection de cette option, une icône supplémentaire de stylo (c'est-à-dire Menu de Sélection de Valeur) apparaîtra, ainsi qu'une liste d'opérations, telles que l'addition.
Les valeurs peuvent être manipulées à l'aide de ces 5 opérations différentes :
- (+) addition
- (-) soustraction
- (/) division
- (*) multiplication
- (%) modulo
L'exemple ci-dessous montre comment utiliser les opérations arithmétiques pour créer une nouvelle variable de chaîne (dans le bouton vert), appelée 'intermediateVar'.
La valeur de la nouvelle variable (de 'intermediateVar') est définie en utilisant plusieurs opérations arithmétiques en combinaison avec des variables préalablement créées (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-S Chaîne
| Options d'Opération-S Chaîne | Description |
|---|---|
En Minuscules | Change toutes les lettres dans une variable de chaîne en minuscules. → Ex : (AAABBB) se transforme en (aaabbb) |
En Majuscules | Change toutes les lettres dans une variable de chaîne en majuscules. → Ex : (aaabbb) se transforme en (AAABBB) |
En Lien | Transforme la chaîne dans une variable en une URL qui s'ouvre dans une autre fenêtre |
Supprimer les Espaces | Supprime les espaces entre les lettres dans une variable de chaîne. → Ex : (aaa bbbb cccc) se transforme en (aaabbbbccc) |
Élaguer les Espaces | Supprime les espaces au début d'une variable de chaîne. → Ex : ( aaabbbcccc) se transforme en (aaabbbcccc) |
Remplacer sous-chaîne Regexp | Remplace certaines lettres dans une variable de valeur 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 avec 0 à 3 décimales. |
floor | Retourne la valeur plancher. |
ceil | Retourne la valeur plafond. |
cos | Retourne la valeur du cosinus. |
sin | Retourne la valeur du sinus. |
tan | Retourne la valeur de la tangente. |
Valeurs Spécifiques au Déclencheur
Les valeurs spécifiques au déclencheur font référence aux valeurs qui sont associées au déclencheur défini dans un événement particulier. Par exemple, si votre événement utilise un déclencheur de souris, alors, dans certaines zones où l'action est spécifiée (comme lors de l'utilisation d'une action Définir / Enregistrer Variable ou d'une action Définir Propriété d'Objet), vous pouvez référencer des valeurs spécifiques au déclencheur de souris dans le menu de sélection de valeur.
Dans l'exemple ci-dessous, des valeurs spécifiques au déclencheur pour un déclencheur de souris sont utilisées pour enregistrer des valeurs x et y et un tableau [X,Y] à l'aide d'une action Définir / Enregistrer Variable.
Voici un tableau de tous les types de valeurs spécifiques au déclencheur que l'on peut trouver dans Labvanced, suivi d'une explication détaillée de chaque option.
| Nom | Options de Valeur - Aperçu |
|---|---|
Déclencheur (Souris) |
|
Déclencheur (Clavier) |
|
Déclencheur (Barre de Boutons) |
|
Déclencheur (Entrée sur Input) |
|
Déclencheur (Défilement) |
|
Déclencheur (Gamepad / Joystick) |
|
Déclencheur (Regard de Suivi des Yeux) |
|
Déclencheur (Fixation de Suivi des Yeux) |
|
Déclencheur (Suivi de Tête) |
|
Déclencheur (À l'Initialisation de la Tâche) |
|
Déclencheur (À l'Initialisation de la Trame) |
|
Déclencheur (au Début de la Trame) |
|
Déclencheur (À la Fin de la Trame) |
|
Déclencheur (Valeur de Variable Changer) |
|
Déclencheur (Déclencheur d'Objet Multimédia) |
|
Déclencheur (Déclencheur Websocket) |
|
Déclencheur (Déclencheur OpenAI) |
|
Déclencheur (Événement Global d'Expérience) |
|
Déclencheur (L'utilisateur Quitte l'Expérience) |
|
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 Déclencheur (Souris) | Description |
|---|---|
Souris X | Retourne la position actuelle de la souris X en coordonnées du cadre. |
Souris Y | Retourne la position actuelle de la souris Y en coordonnées du cadre. |
Tableau de souris [X,Y] | Les coordonnées de la souris [X,Y] au format tableau. |
Nom du Stimulus | Le nom de l'objet qui a déclenché l'événement (par exemple, quelle image a été cliquée). |
Info du Stimulus | Les informations du stimulus de l'objet qui a déclenché l'événement. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où 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 Déclencheur (Clavier) | Description |
|---|---|
Id de la Touche | La valeur ID de la touche qui a été pressée comme déclencheur. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur s'est produit. |
Déclencheur (Barre de Boutons) Valeurs
Lorsqu'un déclencheur de clic de bouton est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Barre de Boutons) | Description |
|---|---|
Nom du Stimulus | Le nom de l'objet bouton qui a déclenché l'événement. |
Info du Stimulus | Les informations du stimulus de l'objet bouton qui a déclenché l'événement. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où 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 Déclencheur (Entrée sur Input) | Description |
|---|---|
Id de la Touche | La valeur ID de la touche qui a été pressée comme déclencheur. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où 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 Déclencheur (Défilement) | Description |
|---|---|
Nom du Stimulus | Le nom de l'objet bouton qui a déclenché l'événement. |
Info du Stimulus | Les informations du stimulus de l'objet bouton qui a déclenché l'événement. |
Position de Défilement X | La position de défilement en X de la souris lorsque l'événement a été déclenché. |
Position de Défilement Y | La position de défilement en Y de la souris lorsque l'événement a été déclenché. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur de défilement s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur de défilement s'est produit. |
Déclencheur (Gamepad / Joystick) Valeurs
Lorsqu'un déclencheur Gamepad/Joystick est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Gamepad / Joystick) | Description |
|---|---|
Id de l'Appareil Gamepad | L'ID ou le nom du gamepad qui a été connecté. |
Touches Pressées (Tableau) | Les touches qui ont été pressées. |
Touches Pressées ou Maintenues (Tableau) | Les touches qui ont été pressées ou maintenues. |
Touches Relâchées (Tableau) | Les touches qui ont été relâchées. |
Axes (Tableau) | Les valeurs des axes. |
Horodatage du Gamepad (Unixtime) | L'horodatage du gamepad au format Unix. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur se produit au format Unix. |
Temps du Déclencheur (Depuis le début de la trame) | L'horodatage au format Unix du moment où le déclencheur se produit en relation avec le début de la trame. |
Déclencheur (Regard de Suivi des Yeux) Valeurs
Lorsqu'un déclencheur de regard de suivi des yeux est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Regard de Suivi des Yeux) | Description |
|---|---|
Coordonnée X | La valeur de la coordonnée X du regard. |
Coordonnée Y | La valeur de la coordonnée Y du regard. |
Tableau de Coordonnées [X,Y] | Les coordonnées de regard X,Y au format tableau. |
Nom du Stimulus | Le nom du stimulus qui a initié le déclencheur de regard. |
Info du Stimulus | Les informations du stimulus derrière le stimulus qui a initié le déclencheur de regard. |
Temps de Capture de Caméra T | Le moment exact où la capture a eu lieu. Dans le pipeline de suivi des yeux Labvanced, une capture de caméra a lieu d'abord avant que l'algorithme et le réseau de neurones effectuent des calculs de regard. Ainsi, le Temps de Capture de Caméra T est un horodatage UNIX de quand la capture initiale s'est produite. Pour plus d'informations sur la technologie derrière notre suivi des yeux basé sur webcam, veuillez vous référer à notre page de technologie ET. |
Confiance du Regard 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 capturée et sert essentiellement de « détecteur de clignotement ». Veuillez vous référer à notre article examiné par des pairs publié pour plus de détails. |
Coord. + Temps [X,Y,T] Tableau | Un tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de caméra (T) comme décrit ci-dessus. |
Coord. + Temps + Confiance [X,Y, T,C] Tableau | Un tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de caméra (T) et la confiance du regard (C) comme décrit ci-dessus. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur de regard s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur de regard s'est produit. |
Déclencheur (Fixation de Suivi des Yeux) Valeurs
Lorsqu'un déclencheur de fixation de suivi des yeux est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Fixation de Suivi des Yeux) | Description |
|---|---|
Centroid de Fixation X | Le point central de la fixation en tant que valeur X. |
Centroid de Fixation Y | Le point central de la fixation en tant que valeur Y. |
Durée de Fixation | La durée de la fixation détectée. |
Temps de Début de Fixation | Le temps de début de la fixation détectée. |
Temps de Fin de Fixation | Le temps de fin de la fixation détectée. |
Dispersion de Fixation | Fait référence à la dispersion des valeurs de regard au sein d'une fixation détectée. |
Nom du Stimulus | Le nom de l'objet bouton qui a déclenché l'événement. |
Info du Stimulus | Les informations du stimulus de l'objet bouton qui a déclenché l'événement. |
[X, Y, Dur, Début, Fin, Disp] | Un tableau des é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. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur de fixation s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur de fixation s'est produit. |
Déclencheur (Suivi de Tête) Valeurs
Lorsqu'un déclencheur de suivi de tête est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Suivi de Tête) | Description |
|---|---|
Temps de Capture de Caméra T | Lorsque la caméra a capturé le cadre, c'est-à-dire un horodatage unix de quand la capture du cadre a eu lieu. C'est le moment où l'image / le cadre a été capturé avant que tout traitement ne soit effectué. |
Rotation de Tête | Rotation de la tête de gauche à droite, cela est référé à comme le lacet dans la littérature. |
Inclinaison de Tête | Inclinaison de la tête de haut en bas, connue comme l'inclinaison de tête dans la littérature. |
Roulement de Tête | Captures le mouvement de la tête se roulant d'un côté à l'autre. |
Position de 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 de 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) de quand la mesure a eu lieu. |
Vecteur de Nez [X,Y, Z, T] Tableau | Cette mesure fonctionne en projetant un vecteur depuis l'extrémité du nez et est utile pour tester si le participant prête attention à l'écran (cela est particulièrement important pour les études où le suivi des yeux n'est pas activé). Ainsi, si le nez pointe hors écran (c'est-à-dire que le participant n'assiste pas à l'expérience), la valeur Z diminue de 1 et se rapproche de 0. |
Horodatage du Déclencheur (Unixtime) | Moment pendant 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 de quand le déclencheur s'est produit dans le système. Essentiellement, c'est le moment où l'image / le cadre est traité et cette valeur est largement affectée par la carte graphique du participant. En théorie, elle devrait être aussi proche que possible de la valeur T. |
Temps du Déclencheur depuis le Début de la Trame | C'est la valeur temporelle du moment où le déclencheur s'est produit par rapport au moment où le début de la trame a eu lieu. |
Déclencheur (À l'Initialisation de la Tâche) Valeurs
Lorsqu'un Déclencheur d'Init de Tâche est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (À l'Initialisation de la Tâche) | Description |
|---|---|
Horodatage du Déclencheur (Unixtime) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps en millisecondes du moment où le déclencheur se produit depuis le début de la trame. |
Déclencheur (À l'Initialisation de la Trame) Valeurs
Lorsqu'un Déclencheur d'Init de Trame est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (À l'Initialisation de la Trame) | Description |
|---|---|
Numéro d'Essai | Le Numéro d'Essai lorsque le Déclencheur d'Init de Trame s'est produit. |
Horodatage du Déclencheur (Unixtime) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début de la trame. |
Déclencheur (au Début de la Trame) Valeurs
Lorsqu'un Déclencheur de Début de Trame est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (au Début de la Trame) | Description |
|---|---|
Horodatage du Déclencheur (Unixtime) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début de la trame. |
Déclencheur (À la Fin de la Trame) Valeurs
Lorsqu'un Déclencheur de Fin de Trame est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (À la Fin de la Trame) | Description |
|---|---|
Temps Total de la Trame | Le temps total en millisecondes qui a été passé sur la trame. |
Horodatage du Déclencheur (Unixtime) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début de la trame. |
Déclencheur (Valeur de Variable Changer) Valeurs
Lorsqu'un Déclencheur de Changement de Valeur de Variable est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Valeur de Variable Changer) | Description |
|---|---|
Nouvelle Valeur dans la Variable | Fait référence à 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 de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le changement de valeur de variable s'est produit. |
Déclencheur (Déclencheur d'Objet Multimédia) Valeurs
Lorsqu'un Déclencheur d'Objet Multimédia est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Déclencheur d'Objet Multimédia) | Description |
|---|---|
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur d'objet multimédia s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur d'objet multimédia s'est produit. |
Déclencheur (Déclencheur Websocket) Valeurs
Lorsqu'un Déclencheur Websocket est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options Déclencheur (Déclencheur Websocket) | Description |
|---|---|
Message | Un message qui peut être utilisé pour décrire et étiqueter qui vous permet (du côté de la réception) de filtrer entre différents types de données. |
Données | Une valeur qui peut contenir différents types de données, comme les choix du participant, les horodatages, les coordonnées X/Y de la souris, etc. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur Websocket s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur Websocket s'est produit. |
Déclencheur (Déclencheur OpenAI) Valeurs
Lorsqu'un Déclencheur OpenAI est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options 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 du moment où le déclencheur OpenAI s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur OpenAI s'est produit. |
Déclencheur (Événement Global d'Expérience) Valeurs
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 l'utilisation de certaines actions :
| Options Déclencheur (Événement Global d'Expérience) | Description |
|---|---|
Temps Total de la Trame | Fait référence au Temps Total de la Trame 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, comme le départ d'un participant de l'étude. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur d'Événement Global a eu lieu au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur d'Événement Global a eu lieu. |
Déclencheur (L'utilisateur Quitte l'Expérience) Valeurs
Lorsqu'un Déclencheur de Participant A quitté l'Étude Multiutilisateurs est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
| Options (L'utilisateur Quitte l'Expérience) | Description |
|---|---|
Nombre de Participants Restants | Le nombre de participants restant dans l'étude. |
Horodatage du Déclencheur (Unixtime) | L'horodatage du moment où le déclencheur « L'utilisateur quitte l'expérience » s'est produit au format de temps Unix avec millisecondes. |
Temps du Déclencheur (Depuis le début de la trame) | Le temps écoulé en millisecondes mesuré depuis le début de la trame jusqu'au moment où le déclencheur « L'utilisateur quitte l'expérience » s'est produit. |