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, la logique et les 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 se compose 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 image différente et aléatoire (action).
Création d'événements - Aperçu
Les événements sont gérés dans l'Éditeur de Tâche sous l'onglet "Événements" dans le coin supérieur droit. De nouveaux événements peuvent être créés en cliquant sur + Événement de Cadre
pour des événements qui devraient se produire sur ce cadre ou en cliquant sur + Événement d'Essai
qui applique l'événement à tous les cadres. Tous les événements existants sont affichés dans une vue en liste dans le panneau latéral droit. Les événements sont définis au niveau d'un cadre et peuvent être séparés/spécifiques pour chaque cadre ou dupliqués/identiques sur chaque cadre au cours d'un essai.
Dans tous les cas, un événement est toujours défini pour tous les essais dans un groupe d'essai pour le(s) cadre(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 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. En sélectionnant 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 rouverts (icône à côté du champ de nom).
Déclencheurs
Le déclencheur définit quand l'événement sera exécuté. Cela pourrait être un clic de souris sur un objet particulier, une certaine entrée au clavier, un changement de variable, le début d'un fichier vidéo, ou bien d'autres choses. Tous les déclencheurs et leurs paramètres sont expliqués dans la liste suivante :
Catégorie de Déclencheur | Options de Déclencheur | Description |
---|---|---|
Déclencheurs d'Entrée Utilisateur | Les déclencheurs d'entrée utilisateur font référence à 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 de clavier, 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 Cadre | Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux cadres, comme quand un cadre commence ou se termine. | |
Déclencheur de Valeur de Variable Changée | Variable (Valeur Changée) | Un déclencheur pour l'événement se produit lorsqu'il y a un changement dans la valeur d'une variable spécifique. |
Déclencheur d'Objet Média | Déclencheur d'Objet Média | Ce déclencheur se produit par rapport aux objets multimédias, comme lorsqu'il y a une pause dans un fichier vidéo/audio, 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 font référence à tout changement majeur dans une expérience, comme lorsqu'elle est mise en pause ou lorsqu'un participant quitte une étude multiutilisateur. |
Déclencheurs d'Entrée Utilisateur
Les déclencheurs d'entrée utilisateur font référence à 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'entre eux est décrit plus en détail dans les sections à venir.
Option de Déclencheur d'Entrée Utilisateur | Aperçu |
---|---|
Déclencheur de Souris | Tout mouvement de souris peut être utilisé comme un déclencheur pour initier un événement, comme : défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou des 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 une touche du clavier peut être utilisée comme un déclencheur pour initier un événement. Vous pouvez spécifier des lettres ou des chiffres spécifiques du clavier en tant que déclencheurs. |
Clics de Bouton | Les objets de bouton créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements. |
Entrée sur Input | Ce déclencheur est couramment utilisé lorsque 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 texte. |
Déclencheur de défilement | Ce déclencheur se produit lorsque le participant défile. Vous pouvez spécifier les directions de défilement x ou y, ainsi que sur quels éléments se produit le défilement pour être utilisé comme déclencheurs d'événements. |
Déclencheur de Gamepad/Joystick | Ce déclencheur vous permet d'utiliser des manettes de jeu et des contrôleurs de joystick dans votre conception expérimentale comme appareil d'entrée pour enregistrer des données. |
Déclencheur de Souris
L’option 'Déclencheur de Souris' est un déclencheur d'événement très populaire car elle initie un événement basé sur toute interaction de 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 de souris 'Gauche' sur l'objet 'Cible' appelé 'Image_1' :
Voici un aperçu complet des options que vous avez lors de l'utilisation des déclencheurs de souris :
Élément de Menu | Zone de Menu | Options et Spécifications de Déclencheur de Souris |
---|---|---|
Action liste déroulante : | Les options suivantes de déclencheur de souris sont disponibles dans la liste déroulante :
| |
Bouton liste déroulante : |
| |
Cibles options : | Dans l'exemple ci-dessus, 'Image_1' est la cible du clic de bouton qui déclenchera l'événement. Plusieurs cibles peuvent être ajoutées en cliquant sur l'option ‘+Ajouter Cible’ en bas. | Lors de la spécification d'une cible, les options suivantes sont disponibles :
|
- 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 valeurs spécifiques au déclencheur de souris à 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 entrée provenant du clavier peut être utilisée comme un déclencheur. Cela inclut : presser, maintenir ou relâcher une touche.
Dans l'exemple ci-dessous, le déclencheur est configuré pour être une pression sur une touche du clavier qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont pressées :
Voici un aperçu complet des touches et des options que vous avez 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 : | Voici les options d'action de clavier disponibles :
| |
Touches quelle touche déclenche l'événement | Quelle touche est utilisée comme déclencheur est spécifiée en sélectionnant les options ici en cliquant sur +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 d'événements, si plusieurs événements ont le même déclencheur de clavier, alors tous se déclenchent sans cela. Seulement le premier se déclenchera et l'exécution de l'événement s'arrêtera après que le premier événement soit terminé. |
- 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 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 un événement où le clic sur le bouton agit comme un déclencheur pour une action.
En cliquant sur ce déclencheur, le menu suivant s'affiche 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 Cible | Sélection d'un élément bouton comme cible | |
Bouton: 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 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 Input
Déclenche lorsqu: La touche Entrée/Retour est enfoncée sur le clavier alors qu'un élément spécifique est actif.
Paramètres:
Ajouter Cibles: Ajouter un élément d'entrée à l'Événement.
Remarque : Après avoir sélectionné le déclencheur Entrée sur Input dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur Entrée sur Input à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de Défilement
Déclenche lorsqu: La barre de défilement, le défilement sur le pavé tactile, ou la molette de défilement de la souris est utilisée sur un élément spécifique.
Paramètres:
- Choisissez si le défilement est sur l'axe Y ou l'axe X (défilement vertical ou horizontal).
Cible: Définissez l'élément cible auquel s'appliquera le déclencheur de défilement.
Remarque: Pour un long texte, 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 référencer valeurs spécifiques au déclencheur de défilement à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de Gamepad/Joystick
Le Déclencheur de Gamepad/Joystick
vous permet d'utiliser des manettes de jeu et des contrôleurs de joystick dans votre conception expérimentale comme appareil d'entrée pour enregistrer des données. Remarque : n'oubliez pas d'activer cette option sous l'onglet de Paramètres de l'Étude dans la colonne ‘Fonctionnalités de l'Expérience’.
Après avoir sélectionné ce déclencheur, la boîte de dialogue suivante apparaîtra.
Après avoir connecté votre gamepad, vous pouvez spécifier quelles touches spécifiques devraient être utilisées comme déclencheurs. Lors de l'appui sur la touche particulière, le système affichera son ID.
Dans l'exemple ci-dessous, le 2
fait référence à la touche ◎ et le 3
fait référence à la touche ▵. Remarque : Il est important de dire qu'il y a une certaine variation entre les manettes de jeu dans la façon dont l'attribution des ID de touche fonctionne.
En raison de l'appui 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 appuyez 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 Gamepad / Joystick |
---|---|---|
Écouter les boutons | I.) Spécifiez que le déclencheur est lié au bouton et s'il doit se produire lors de l'appui d'une touche, de la pression ou du relâchement d'une touche, ou du relâchement d'une touche. II.) Spécifiez que le déclencheur est pour n'importe quel bouton ou un bouton spécifique. Si l'option spécifique est sélectionnée, vous serez invité à appuyer sur le ou les boutons de votre manette. | |
Écouter les axes | Si des mouvements d'axes sont nécessaires, 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. | |
État de connexion | Indique si un appareil est connecté ou non. | |
Flux de données en direct | Après avoir connecté l'appareil et appuyé sur une touche ou déplacé un axe, les données en direct seront affichées où toute entrée que vous faites sur votre appareil sera affichée ici. Cela est utile pour tester lors de la configuration de votre étude et déterminer quelles touches ou axes vous souhaitez utiliser. |
Remarque : Après avoir sélectionné le déclencheur de Gamepad / Joystick dans le système d'événements, vous avez la possibilité d'utiliser et de référencer ses valeurs spécifiques au déclencheur à travers diverses actions avec le menu de sélection de valeur.
Déclencheurs de Signaux Physiologiques
Ces déclencheurs ne s'appliqueront que si le suivi oculaire et/ou le suivi de tête ont été activés pour la tâche.
Déclencheur de Regarde Suivi Oculaire
Déclenche lorsqu:
- En général, ce déclencheur s'appliquera lorsque le suivi oculaire a été activé.
- Déclenche uniquement lors de la visualisation d'é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 Regarde Suivi Oculaire dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur de regard à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de Fixation Suivi Oculaire
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 référencer valeurs spécifiques au déclencheur de fixation à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de Suivi de Tête
Déclenche lorsqu:
Changements dans l'orientation de la tête ou mouvement de la tête.
Remarque : 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 valeurs spécifiques au déclencheur de suivi de tête à travers diverses actions avec le menu de sélection de valeur.
Déclencheurs d'Essai et de Cadre
Déclencheur Init Tâche
Déclenche lorsqu:
- Le premier cadre du premier essai d'une tâche. S'exécutera uniquement une fois par tâche, bien qu'il soit affiché dans l'onglet Événements pour toutes les instances de ce cadre.
Ce déclencheur se marie bien avec les actions Randomiser et Lire Depuis. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les cadres de données lorsque la tâche commence 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 Tâche dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur Init Tâche à travers diverses actions avec le menu de sélection de valeur.
Déclencheur Init Cadre
Déclenche lorsqu:
- L'initialisation du cadre, avant qu'il ne devienne visible pour le participant.
Ce déclencheur se marie bien avec les actions Randomiser, Lire Depuis, et Tirer Nombre Aléatoire. Avec ces combinaisons, ces actions peuvent être complétées avant que le cadre apparaisse, laissant un chemin clair pour que d'autres actions commencent alors que le cadre commence.
Remarque : Ne pas utiliser le déclencheur Init Cadre avec des événements qui enregistrent une variable ou qui impliquent des variables système telles que le Numéro d'Essai ou le Numéro de Condition. Cela est dû au fait que le déclencheur Init Cadre se produit entre les essais, donc il n'y a pas un décompte entièrement précis de l'essai ou de la condition sur le point d'être affiché.
Paramètres: Aucun
- Remarque : Après avoir sélectionné le déclencheur Init Cadre dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur Init Cadre à travers diverses actions avec le menu de sélection de valeur.
Remarque sur les déclencheurs Init Tâche et Cadre : Comme les déclencheurs Init Tâche et Cadre se produisent avant que la tâche ou le cadre ne commence, les variables créées pendant ce temps seront réinitialisées lorsque la tâche/cadre 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 de la variable soient réinitialisées.
Déclencheur Début Cadre
Déclenche Lors:
- Début du cadre
Paramètres: Aucun
- Remarque : Après avoir sélectionné le déclencheur Début Cadre dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur Début Cadre à travers diverses actions avec le menu de sélection de valeur.
Déclencheur Fin Cadre
Déclenche Lors:
- Fin du cadre (après que le cadre ne soit plus visible)
Paramètres: Aucun
- Remarque : Après avoir sélectionné le déclencheur Fin Cadre dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur Fin Cadre à travers diverses actions avec le menu de sélection de valeur.
Déclencheur de Valeur de Variable Changée
Valeur de Variable Changée
Déclenche Lors:
- La valeur d'une variable change de sa valeur de départ
Paramètres:
Variables: Sélectionnez une ou plusieurs variables où 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 Valeur de Variable Changée dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur de Valeur de Variable Changée à travers diverses actions avec le menu de sélection de valeur.
Déclencheurs d'Objet Média
Déclencheur d'Objet Média
Anciennement connu sous les déclencheurs séparés "Contrôler Audio/Video" et "Contrôler Objet".
Déclenche Lors:
- Début, pause ou arrêt d'un fichier vidéo ou audio
- Fichier Téléchargé Terminé, Fichier Sélectionné, Enregistrement Fini 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 objet qui existe sur le cadre
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 mis sur pause
- Lecture Terminée: Déclenche lorsque l'élément arrête de jouer
- Options d'Objet Vidéo, Audio, ou d'Enregistrement d'Écran :
- Enregistrement Terminé: Déclenche lorsque l'enregistrement audio a cessé
- Téléchargement Complet: Déclenche lorsque le téléchargement du fichier est terminé
- Options d'Objet de Téléchargement de Fichier :
- Fichier Sélectionné: Déclenche lorsque un fichier est sélectionné
- Téléchargement Complet: Déclenche lorsque le téléchargement du fichier est terminé
- Options d'Objet d'Instantané de Caméra :
- Instantané Terminé: Déclenche lorsque la caméra a réussi à prendre un instantané
- Téléchargement Complet: Déclenche lorsque l'instantané est terminé de téléchargement
- Options d'Objet Audio ou Vidéo :
Remarque : Après avoir sélectionné le déclencheur d'Objet Média dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur d'Objet Média à travers 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 ‘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 du websocket/API sera reçu et traité comme le déclencheur de l'Action.
En cliquant sur cette option, les éléments suivants apparaissent.
- Accepter/Recevoir depuis : Détecte automatiquement l'adresse IP de l'hôte local. Peut être modifié 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 'tout' pour accepter plus d'un message comme déclencheur.
Pour un exemple de la façon dont les Déclencheurs/API Actions 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 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 référencer valeurs spécifiques au déclencheur WebSocket à travers 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 : Consultez également ce walkthrough où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant ce déclencheur.
Dans l'exemple ci-dessous, le cadre de données qui a été assigné s'appelle ‘df’ et le résultat du ‘Déclencheur OpenAI’ sera ajouté à ce cadre de données. Ce cadre de données doit avoir deux colonnes. La première colonne indiquera le ‘rôle’ et la deuxième colonne le ‘message de chat’. Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici.
Si vous utilisez également l'‘Action Envoyer à OpenAI’, alors vous devez utiliser le même cadre de données là-bas que celui que vous 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 référencer valeurs spécifiques au déclencheur OpenAI à travers diverses actions avec le menu de sélection de valeur.
Déclencheurs Globaux
Les Déclencheurs Globaux se produisent chaque fois qu'un changement majeur se produit dans l'expérience, c'est-à-dire quelque chose de 'Global' comme mettre l'expérience en pause ou un participant quittant une étude multi-utilisateur ! Les options suivantes sont répertoriées comme Déclencheurs Globaux :
- Pause / Reprise de l'Expérience
- Participant a quitté l'Étude Multi-utilisateur
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 basé sur la mise en pause ou la reprise de l'expérience.
En sélectionnant ce déclencheur, la vue suivante apparaît où vous pouvez spécifier la nature du déclencheur, s'il doit être exécuté lors de la mise en pause ou de la reprise de l'expérience :
Expérience Mise en Pause : Le participant met en pause (quitte le 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 ramener 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 référencer valeurs spécifiques au déclencheur à travers diverses actions avec le menu de sélection de valeur.
Participant a quitté l'Étude Multiutilisateur
Si un participant quitte une étude multi-utilisateur, cela peut également être utilisé comme un déclencheur pour un événement. Si un participant quitte une étude multi-utilisateur, cela affecte l'expérience à un niveau global car cela empêche d'autres participants de poursuivre l'étude.
En sélectionnant ce déclencheur, vous pouvez spécifier quel type d'action se produira si un participant quitte une étude multi-utilisateur.
- 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 référencer valeurs spécifiques au déclencheur à travers 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'objet, enregistrer des données, lire et écrire des données vers/depuis des tableaux, ou passer à l'essai ou à la tâche suivante. Souvent, il y a plusieurs actions par événement. En utilisant "Actions de Contrôle", 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 considéré comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme les invocations de fonctions, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit que presque toute logique expérimentale peut être mise en œuvre sans avoir recours à certaines structures programmatiques/syntaxiques.
Le tableau ci-dessous fournit un aperçu introductif des actions disponibles dans Labvanced :
Catégorie d'Action | 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 dans 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, la suppression, 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 des sections de 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 si/alors, les boucles (comme jouer un son répété ou faire clignoter une image), ainsi que pour établir un délai pour quand une action se produit. | |
Actions API | Fait référence 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 précédemment copiée. |
Actions sur les Objets
Les actions sur les objets font référence à toute manipulation qui se produira sur un objet existant dans la tâche. Il existe plusieurs options d'action sur les objets :
- Définir la Propriété de l'Objet
- Contrôler l'Objet Média
- Copier l'Objet
- PourChaque Objet
Action Définir la Propriété de l'Objet
Avec l'action « Définir la Propriété de l'Objet », vous pouvez changer l'apparence d'un objet comme vous le souhaitez en spécifiant l'objet en question, la propriété à modifier, et la nouvelle valeur.
Dans l'exemple ci-dessous, l'action va modifier deux propriétés de l'image cible en réglant 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. »
Ci-dessous se trouve un aperçu complet des champs que vous rencontrez lorsque vous travaillez avec l'action « Définir la Propriété de l'Objet » :
Élément de Menu | Zone de Menu | Options de Déclenchement pour Définir la Propriété de l'Objet |
---|---|---|
Cible liste déroulante de sélection d'objet : | La première liste déroulante affichera les objets que vous avez dans ce cadre pour que vous puissiez choisir. Cela indique sur quel objet spécifique l'action sera exécutée. | |
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 et de leurs paramètres disponibles, veuillez voir le Tableau des Propriétés d'Objet. | |
Menu de Sélection de Valeur | Définissez la nouvelle valeur, c'est-à-dire quelle doit ê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. | |
Case à cocher - Enregistrer le temps lorsque ce changement est reflété à l'écran (mesuré en millisecondes depuis le début du cadre). | Lorsqu'une propriété est modifiée, cela prendra un court moment (environ ~10ms) pour que les changements soient visibles. Avec cette option, vous pouvez enregistrer plus précisément le temps où la propriété modifiée est réellement visible lors du prochain rafraîchissement de l'affichage. Remarque : Lors de la sélection de cette option, une boîte de dialogue apparaîtra vous incitant à indiquer (ou à créer une nouvelle variable) où cette valeur capturée doit être stockée. La variable doit être numérique comme 'type de données.' |
Action de Contrôle d'Objet Média
Auparavant les actions « Contrôler Audio/Vidéo » et « Contrôler Objet » séparées.
Effet : Modifie la lecture d'é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'Objet Audio ou Vidéo :
- Démarrer la Lecture : Commence à jouer le fichier vidéo / audio
- Arrêter la Lecture : Arrête le fichier vidéo / audio
- Mettre en Pause la Lecture : Met en pause le fichier vidéo / audio
- JumpToTime : permet de spécifier un temps en millisecondes vers lequel avancer dans le fichier audio/vidéo
- Couper le Son : désactive le son de l'objet
- Rétablir le Son : restaure le son de l'objet
- Options d'Objet Audio, Vidéo, ou Enregistrement d'Écran :
- Démarrer l'Enregistrement : Commence un nouvel enregistrement (audio)
- Arrêter l'Enregistrement : Arrête l'enregistrement (audio)
- Démarrer le Téléchargement : Commence le téléchargement du fichier
- Effacer l'Enregistrement : Supprime les données d'enregistrement (audio).
- Démarrer la Lecture : Commence à jouer le fichier enregistré
- Arrêter la Lecture : Arrête de jouer le fichier enregistré
- Mettre en Pause l'Enregistrement : met l'enregistrement de l'objet en pause
- Reprendre l'Enregistrement : reprend l'enregistrement de l'objet
- Options d'Objet de Téléchargement de Fichier :
- Démarrer le Téléchargement : commence le processus de téléchargement pour le fichier sélectionné
- Effacer le Fichier : Supprime le fichier sélectionné
- Choisir un Fichier : permet au participant de choisir le fichier souhaité
- Options d'Objet de Capture d'Image avec 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 capture d'écran vers l'expérience
- Prendre une Capture d'Écran : prend une photo avec la caméra du participant
- Options d'Objet Audio ou Vidéo :
Action Copier l'Objet
Effet : Copie un objet, remplaçant le besoin de plusieurs objets séparés et d'événements dupliqués.
Paramètres :
- Source : Choisissez l'objet sur le cadre à copier.
- Nombre de copies : Entrez le nombre de copies à faire de l'objet source.
- Définir un nouveau nom d'élément : Choisissez parmi plusieurs paramètres pour déterminer les noms des copies.
- Attribuer un nom avec un suffixe incrémental : Ajoute une é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 va se passer pour les 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 : Tapez le nom de l'objet(s) à cibler. Pour plusieurs objets sur un cadre où certains ont des noms identiques, cela fonctionne bien.
- Séquence d'Action : Vous permet de choisir (dans la liste habituelle d'actions) ce qui va se passer pour les é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 les sessions.
Le tableau ci-dessous fournit un aperçu introductif de toutes les options d'Action de Variables disponibles dans Labvanced. Chacune d'elles est décrite plus en détail dans les sections à venir.
Option d'Action de Variable | Description |
---|---|
Définir / Enregistrer 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 nombre(s) aléatoire(s) et les sauve dans une variable |
Obtenir le Paramètre URL | Sauvegarder une valeur de l'URL unique du participant |
Lire depuis / Écrire vers l'Appareil | Lit ou écrit une variable à partir du stockage de l'appareil local. Cette Action enregistre des données sur l'appareil du participant au lieu d'envoyer les données aux serveurs Labvanced. |
Lire depuis / Écrire vers une Variable Partagée | Lit ou écrit dans une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou privée à chaque individu. |
Math & Statistiques | Effectue une opération mathématique sur une certaine variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie. |
Enregistrer Variables Instantanément | Crée une image instantanée de toutes les valeurs de variables et envoie cela au serveur Labvanced. |
Filtre de Moyenne Mobile | Calcule une moyenne mobile (une moyenne qui se met à jour constamment des données) de certaines entrées et stocke le résultat dans une nouvelle variable. |
Distribuer Variable | Enverra une valeur à d'autres participants. La valeur est stockée dans une variable. |
Action Définir / Enregistrer Variable
L’Action « Définir / Enregistrer Variable » est sur le point d'ê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 du clic sur cette action, le menu de dialogue suivant apparaîtra où vous pouvez spécifier quelle variable doit être enregistrée et la valeur d'intérêt :
Élément de Menu | Zone de Menu | Description |
---|---|---|
Sélectionner | Lors de la sélection, vous indiquez quelle variable doit stocker la valeur. À partir de là, vous pouvez également créer une nouvelle variable. | |
Icône de Stylo | L'icône de stylo symbolise le menu de sélection de valeur qui est utilisé pour définir et spécifier les valeurs exactes qui doivent être attribuées à la variable sélectionnée (comme spécifié dans le bouton vert à gauche du signe égal (=)). |
Dans l'exemple ci-dessous, nous avons créé une nouvelle variable appelée counter
et utilisé une option arithmétique du menu de sélection de valeur pour faire augmenter la valeur de la variable de 1 (basé sur le déclencheur défini dans l'étape précédente).
L'image ci-dessous enregistre les coordonnées X,Y de la souris afin de capturer le suivi de la souris pendant une étude. L'image ci-dessous montre comment trois actions sont utilisées pour rendre possible l'enregistrement de la valeur de variable. 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 la souris que le système fournit et à laquelle vous pouvez vous référer lors de l'enregistrement des valeurs.
Remarque : L’Action Définir / Enregistrer Variable
est également couramment utilisée dans le contexte des Actions de Contrôle
où vous pouvez spécifier des conditions en utilisant « si / alors » et « tant que » en fonction des valeurs des variables.
Action Copier dans le Presse-Papiers
Effet : Copier une valeur de variable dans le presse-papiers interne de l'ordinateur.
Action Tirer un Nombre Aléatoire
Effet : Tire un ou plusieurs nombre(s) aléatoire(s) et les sauvegarde dans une variable.
Paramètres :
- Type : Choisir entre valeurs continues et discrètes
- Distribution : Choisissez entre distribution gaussienne et uniforme
- Tirages Multiples (boolean vrai/faux) : Choisissez de tirer une seule 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
- Sauvegarder dans la Variable : Sélectionnez une variable où les valeurs seront stockées.
Action Obtenir le 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é
- Sauvegarder dans la Variable : sélectionnez la variable dans laquelle sauvegarder 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 Appareil
Effet : Lit ou écrit une variable à partir du stockage de l'appareil local. 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 depuis ou d'écrire vers 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-en aléatoirement quelques-unes à présenter lors de chaque session.
- Écrire sur l'Appareil : le numéro d'indice des images présentées dans la Session 1.
- Lire depuis l'Appareil : dans 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 vers 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 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 à servir de clé pour accéder à la variable synchronisée.
- Méthode de Lecture ou d'Écriture :
- Lire, modifier, puis écrire la variable partagée : lit la variable, effectue un changement, puis envoie la variable à l'étude.
- Lire uniquement la valeur partagée du 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 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 de variable synchronisées des autres participants au cours des sessions. Cette option est sélectionnée par défaut, mais peut être désélectionnée en cliquant sur la case à cocher.
- Séquence d'Action :
- Choisissez ce qui arrive à la variable partagée/synchronisée à partir de la liste de toutes les Actions disponibles.
Cas d'utilisation : Études Longitudinales/Multi-Sessions
- Avec cette action, les données spécifiques au participant peuvent être transférées d'une session à l'autre et peuvent être partagées entre participants entre les sessions.
- Par exemple, vous pouvez utiliser cette action pour enregistrer un score à un test et ensuite permettre au participant de comparer son score à la moyenne des scores des autres participants qui ont terminé le test.
- Un autre exemple (similaire à l'Action Lire depuis/Écrire vers Appareil) est de faire choisir aux participants 5 images qu'ils aiment dans un tableau, d'effectuer une tâche, puis de présenter ces 5 images à nouveau dans une session ultérieure. La différence est que cette Action peut être utilisée pour montrer aux autres participants les images qui ont été choisies, ou pour exclure ces images des options disponibles pour un autre participant.
Action Math & Statistiques
Effet : Effectue une opération mathématique sur une certaine variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.
Paramètres :
- Type : Choisissez entre Opérations de Tableau, Algèbre Linéaire, et Tests Statistiques
- Opération : Choisissez une opération mathématique (par exemple, somme, min, stdev, 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 incluent des paramètres supplémentaires.
- Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.
Action Enregistrer Variables Instantanément
Effet : Crée une image instantanée 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 qui se met à jour constamment des données) de certaines entrées et stocke le résultat dans une nouvelle variable.
Paramètres :
- Forme du Filtre : Sélectionnez le type de filtre
- Moyenne Mobile Simple : Calcule une moyenne mobile simple, où tous les échantillons ont le même poids.
- Moyenne Mobile Linéaire Pondérée : Pèse les échantillons de sorte que les poids des échantillons diminuent linéairement.
- Moyenne Mobile Exponentielle : Pèse les échantillons de sorte que les poids des échantillons diminuent exponentiellement.
- Nombre d'Échantillons : Détermine combien d'échantillons sont utilisés par étape.
- Entrée : Choisissez une variable d'entrée (tableau) sur laquelle la moyenne mobile est calculée.
- Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.
Action Distribuer Variable
L'action Distribuer Variable est essentielle pour les études multi-utilisateurs dans Labvanced. 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 tout changement) d'être reflétées sur les écrans des participants.
Lors de la sélection de cette action, la boîte de dialogue suivante apparaîtra où vous pouvez spécifier quelle valeur de variable est distribuée entre les participants.
L'image ci-dessous montre à quoi ressemble une boîte de dialogue de l'Action Distribuer Variable fonctionnelle 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émo qui incorpore la variable distribuée et la fonction 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 de Menu | Zone de Menu | Options et Description de l'Action Distribuer Variable |
---|---|---|
Distribuer la valeur à | Choisissez à quels autres participants la valeur doit être envoyée.
| |
Choisir la variable cible et la valeur |
| |
Bloquer | Si activé, la Variable Cible ne peut pas être changée tant que la distribution actuelle de la valeur n'est pas terminée. | |
Stratégie de Limitation de Taux | La Stratégie de Limitation de Taux est un moyen de protéger votre expérience contre un débordement 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 distribution de variable) sont envoyées au serveur. Les options stratégiques suivantes sont disponibles :
|
Actions de Tableau
Sélectionner (Lire) depuis l'Action de Tableau
Effet : Sera lire une variable d'un tableau et stocker cette valeur dans une variable scalaire.
Paramètres :
- Variable de Tableau : Tableau d'Entrée pour lire la valeur.
- Type d'Index : Détermine quel type d'index est utilisé.
- Fixe : Utiliser un index fixe pour l'opération de lecture. Dans ce cas, tapez la position d'où l'information doit être lue (basée sur 1).
- Variable : 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 de Tableau : Lire depuis la fin du tableau.
- Variable de Sortie : Sélectionnez une variable scalaire où la valeur lue sera stockée.
Action Ajouter / Retirer des Entrées de Tableau
Effet : Ajoute et/ou retire 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 : Utiliser 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 de Tableau : Insérer / supprimer depuis la fin du tableau.
- Nb d'entrées à supprimer : Supprime les entrées de 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) scalaires, qui seront ajoutées à la variable de tableau à la position d'index définie.
Action Changer (Remplacer) une Entrée de Tableau
Effet : Remplace / change une valeur au sein d'un tableau.
Paramètres :
- Variable de Tableau : Variable de tableau dans laquelle une valeur doit être modifiée
- Type d'Index : Détermine quel type d'index est utilisé.
- Fixe : Utiliser un index fixe pour l'opération de remplacement. Dans ce cas, tapez 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 de Tableau : Remplacer la dernière entrée dans le tableau.
- Variable d'Entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.
Action Mélanger les Entrées de Tableau
Effet : Va mélanger les entrées / l'ordre au sein d'un tableau.
Paramètres : Aucuns
Opérations de Cadre de Données
Action Lire depuis / Écrire vers Cadre de Données
Effet : Lit des valeurs ou écrit des valeurs dans un cadre de données et les enregistre dans une nouvelle variable de tableau.
Paramètres :
- Variable de cadre de données : sélectionnez la variable du cadre de données à lire.
- Lire ou Écrire : Choisissez de lire depuis le cadre de données sélectionné ou écrire vers le cadre de données sélectionné.
- Par ligne ou colonne : Choisissez comment les données doivent être lues.
- Type d'Index : Choisissez le type de variable d'index qui sera utilisé pour lire le cadre de données. Peut être fixe, variable, ou la dernière ligne.
- Variable d'Index : Choisissez la variable qui sera utilisée comme index pour lire le cadre de données.
- Variable de Sortie : Choisissez la variable où les données lues/écrites seront stockées comme sortie. Doit être une variable de tableau.
Action Mélanger les Entrées de 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 par colonnes.
Actions de Saut
Action Sauter À
Effet : "Saute" le participant à une autre étape de l'expérience. Cette action peut changer l'ordre des essais et des tâches dans une expérience et peut être utilisée pour créer une logique expérimentale individualisée pour chaque participant.
Paramètres :
- Sauter À : Détermine où sauter dans l'expérience.
- Prochain Cadre : Saute au prochain cadre. S'il n'y a plus de cadres définis dans un essai, il sautera au premier cadre du prochain essai.
- Prochain Essai : Saute au prochain essai. S'il n'y a plus d'essais définis, il sautera au premier essai de la prochaine tâche.
- Prochaine Tâche : Saute à la prochaine tâche. S'il n'y a plus de tâches définies, il sautera à la première tâche du prochain bloc.
- Prochain Bloc : Saute au prochain bloc. S'il n'y a plus de blocs définis, la session se terminera.
- Cadre Précédent : Saute au cadre précédent. S'il n'y a pas de cadres précédents, l'action ne sera pas exécutée.
- Cadre Spécifique : Saute à un cadre spécifique. Les utilisateurs sélectionnent directement le cadre à laquelle sauter.
- Essai Spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro d'essai auquel 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 les Réponses Requises Avant : Si activé, l'expérience vérifiera si toutes les réponses requises ont déjà été répondues. Si ce n'est pas le cas, l'action de saut ne sera pas exécutée.
Action Accepter/Terminer la Session
Effet : Accepte les données du participant, termine la session d'enregistrement et montre le code de crowdsourcing.
Paramètres :
- Enregistrer les données d'essai avant de terminer la session : Si activé, les données d'essai les plus récentes seront stockées (envoyées au serveur) avant de quitter l'étude.
- Afficher la page de fin par défaut : Si activé, l'écran de fin par défaut de Labvanced apparaîtra. Si c'est une session de crowdsourcing (le 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 montré le cadre actuel et ne montrera pas l'écran de fin par défaut avec le code de compensation.
Action Rejeter/Terminer la Session
Effet : Termine la session d'enregistrement, ne marque PAS les données du participant comme complètes et ne montre PAS l'écran de fin par défaut avec le code de compensation.
Lors de l'utilisation de cette action pour rejeter les données d'un participant, les utilisateurs doivent afficher un message approprié aux participants qui explique la raison pour laquelle ils ne seront pas récompensés pour leur temps.
Paramètres : Aucun
Action Rediriger vers URL
Effet : Redirige le participant vers une URL spécifique.
Remarque : L'URL doit inclure le https:// au début pour que cette action fonctionne.
Actions de Contrôle
Action Exigence (If... Then... Else If)
Effet : Évalue une instruction si-alors et exécute une série d'actions de manière dépendante. Chaque instruction If / Else-If se compose de comparaisons AND / OR imbriquées pour évaluer si toutes les exigences sont satisfaites (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 Exigence : Ajouter une nouvelle exigence à une instruction. Le menu de « sélection de valeur » apparaîtra des deux côtés pour effectuer une comparaison logique. Au milieu de l'instruction, vous pouvez choisir comment les deux côtés doivent être comparés (par exemple, égal, plus petit que, inégal, etc.).
- Ajouter un Groupe OU : Un seul des exigences dans un Groupe OU doit être vrai pour que l'ensemble du groupe soit vrai. Ajoutez un groupe OU si les sous-actions doivent être exécutées dans plusieurs cas.
- Ajouter un Groupe ET : Toutes les exigences dans un Groupe ET doivent être vraies pour que l'ensemble du groupe soit vrai. Ajoutez un groupe ET si les sous-actions doivent être exécutées uniquement lorsque plusieurs exigences sont satisfaites.
- Séquence d'Action : Chaque instruction If / Else-If a une liste d'actions, qui sont définies sous « Alors ». La séquence d'actions liste toutes les actions pour une certaine instruction If / Else-If. Une nouvelle action peut être ajoutée via l'icône « Ajouter une Action ». La séquence d'actions sera exécutée uniquement si les exigence(s) de l'instruction associée If / Else-if sont remplies.
- Ajouter un Cas Else-If : L'Action d'Exigence peut se composer de plusieurs instructions distinctes If / Else-If --> Alors. Cependant, seule une 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 d'Exigence est ignoré.
- Ajouter un Cas Else (vrai / faux) : Si activé, une option par défaut / de repli est ajoutée à l'action d'exigence. Si aucune des instructions If / Else-If n'est exécutée (renvoyée vraie), les actions définies dans le cas else seront exécutées.
Action Répétée (Boucle Tant Que)
Effet : Exécute de manière répétée une série d'actions, soit immédiatement, soit dans un intervalle défini. Une condition d'arrêt peut être spécifiée afin que l'exécution de la boucle soit arrêtée.
Paramètres :
- Type d'Exécution : Choisissez entre exécution immédiate ou exécution chronométrée
- Exécuter toute la boucle : 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 à des intervalles définis (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 l'option d'attribuer 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.
- Démarrer immédiatement (vrai / faux) : Si activé, cela exécutera la boucle immédiatement. Si désactivé, la boucle commencera lors du prochain intervalle d'exécution.
- Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de boucle peuvent être démarrées en parallèle. Si désactivé, une seule instance de boucle peut être exécutée à la fois.
- Activer la condition d'arrêt (vrai / faux) : Si activé, une condition d'arrêt pour la boucle peut être spécifiée.
- Condition d'Arrêt : La condition d'arrêt peut être utilisée pour spécifier une expression logique concernant quand l'exécution de la boucle doit s'arrêter. Similaire aux instructions If / Else-If, on peut combiner des groupes AND, des groupes OR, et des Exigences pour la comparaison logique.
- Séquence d'Action : La séquence d'actions liste toutes les actions qui sont exécutées à chaque itération de la boucle. Une nouvelle action peut être ajoutée via l'icône « Ajouter une Action ».
Action Retardée (Retour d'Appel 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 durée du délai en millisecondes (ms).
- Séquence d'Action : La séquence d'actions liste toutes les actions qui sont exécutées après le délai spécifié. Une nouvelle action peut être ajoutée via l'icône « Ajouter une Action ».
Groupe d'Actions
Les actions peuvent également être organisées en groupes d'actions. Les groupes d'actions vous permettent de regrouper certaines actions 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 les « Déclencheurs API » peuvent être utilisés. Vous avez les actions suivantes disponibles sous 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à-bas, ces actions ne seront plus grises dans le menu.
Action Envoyer vers Websocket
Lors de la sélection de cette action, les options suivantes apparaissent :
L'exemple ci-dessus et la structure complète de l'événement peuvent être consultés ici : https://www.labvanced.com/page/library/51053 en cliquant sur « Inspecter. »
Élément de Menu | Description |
---|---|
Envoyer vers : | Spécifie l'Adresse Websocket qui est listée dans 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 Variable (optionnel) : | Indiquez la variable qui peut également être envoyée comme partie 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 de chaîne, à OpenAI. Veuillez noter que pour que cette option soit disponible, vous devez lister votre clé API dans l'onglet des « Paramètres de l'Étude » sous la colonne « Fonctionnalités de l'Expérience ».
Les options suivantes apparaîtront lors du clic sur cet événement :
Voici un exemple fonctionnel de ce à quoi ressemble cet événement lorsque toutes les informations nécessaires sont fournies :
Pour une meilleure compréhension de la façon dont vous pouvez utiliser cette fonction et la voir en action, n'hésitez pas à nous contacter pour une démo en soumettant ce formulaire de contact.
REMARQUE : Référez-vous également à ce guide où nous développons une étude étape par étape, en intégrant ChatGPT dans une étude et en utilisant cette action.
Voici une explication approfondie des champs inclus dans l'action « Envoyer vers OpenAI » :
Élément de Menu | Zone de Menu | Options de l'Action 'Envoyer vers OpenAI' |
---|---|---|
Type de Modèle | Spécifie le modèle AI qui sera utilisé. Remarque : pour spécifier la version ChatGPT, veuillez consulter les ‘Paramètres de l'Étude’ sous la colonne « Fonctionnalités de l'Expérience ». | |
Cadre de Données de l'Historique de Chat | Lien vers une variable de cadre de données avec deux colonnes. La première colonne indiquera le « rôle » et la seconde colonne le « message de chat. » Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici. Le cadre de données peut également être manipulé avec des actions de cadre de données. Pour référence ultérieure, veuillez consulter les docs d'OpenAI. | |
Insérer Message ‘+’ | En cliquant dessus, la boîte de dialogue variable apparaîtra. Vous devrez indiquer quelle valeur de ‘Variable’ est envoyée à OpenAI ainsi que le ‘rôle’ du message associé :
| |
Comme OpenAI évolue quotidiennement, veuillez consulter les documents d'OpenAI pour plus de clarifications. |
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 entrant 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 un espace (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 changer un aspect de l'étude lorsqu'un déclencheur se produit.
Le champ suivant s'ouvre en cliquant sur cette action :
Un exemple d'utilisation de l'action ‘Définir CSS Global’ serait de changer la couleur d'arrière-plan 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 que vous n'ayez pas à continuer à 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 desde 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. C'est ce qu'on appelle le Menu de Sélection de Valeur car il vous permet de sélectionner et d'instruire quel type de valeurs doivent être enregistrées ou suivies. C'est une option très puissante et importante que vous serez amené à utiliser pour votre conception et votre configuration expérimentales.
Cette icône de stylo / Menu de Sélection de Valeur apparaît à plusieurs endroits pour certaines actions dans le système d'événements, telles que l'action Définir / Enregistrer la Variable , l'action Définir Propriété de l'Objet, et l'action Exigence (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 vers les 5 autres catégories (Heure Actuelle, Valeur Constante, Variable, Cadre / Tâche / Option, et Opérations), toutes ayant leurs propres options. Celles-ci seront décrites plus loin 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 du menu à gauche commence par une catégorie spécifique au déclencheur puis passe aux 5 autres catégories (Heure Actuelle, etc).
Options de Menu
Le tableau ci-dessous explique 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 qui apparaissent en haut du menu de sélection de valeur. Veuillez vous référer à la section sur les valeurs spécifiques au déclencheur pour voir une liste complète des options et des descriptions. |
Heure Actuelle | Mesurer et appeler sur les valeurs de temps. | |
Valeur Constante |
| 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 Arithmétique pour créer des compteurs. |
Variable |
| Spécifiez ou référez à une variable ou sélectionnez une valeur depuis un tableau ou un cadre de données. |
Cadre / Tâche / Objet |
| Vous permet d'extraire des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (si activé), et au dispositif (taux 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 variable, transformer des chaînes en minuscules, ou exécuter des opérations mathématiques. |
Valeurs de Temps Actuel
Avec l'option ‘Temps Actuel’, vous pouvez enregistrer ou référencer des valeurs en rapport avec le temps.
Les options suivantes sont disponibles :
Temps Actuel : Horodatage UNIX
Cette valeur capture un horodatage en format UNIX en millisecondes.
Temps Actuel : Temps Depuis le Début du Cadre
Cette valeur capture le temps écoulé depuis le début du cadre. Le plus souvent, cela équivaut au temps de réaction.
Valeurs Constantes
Attribuez des valeurs constantes en fonction du type de variable dont vous avez besoin, comme 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.
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 (surtout pour les facteurs).
Constante : Date
Attribue une valeur de date.
Constante : Temps
Attribue une valeur de temps.
Constante : Couleur
Attribue une valeur de couleur (chaîne hexadécimale).
Valeurs de Variable
Spécifiez ou référez à une variable ou sélectionnez une valeur à partir d'un tableau ou d'un cadre de données. Les options suivantes sont disponibles :
- Sélectionner Variable
- Sélectionner Valeur depuis le Tableau
- Sélectionner Valeur depuis le Cadre de Données
Sélectionner Variable
Vous permet de sélectionner et de pointer vers une variable.
Sélectionner Valeur depuis le Tableau
Vous permet de sélectionner une valeur depuis un tableau.
Sélectionner Valeur depuis le Cadre de Données
Vous permet de sélectionner une valeur depuis un cadre de données que vous avez créé.
Valeurs de Cadre / Tâche / Objet
Vous permet d'extraire des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (si activé), et au dispositif (taux de rafraîchissement de l'écran).
Propriété de l'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 la coordonnée X de la souris du participant. |
Dernière Position Y de Souris mise en cache | La dernière valeur de la coordonnée Y de la souris du participant. |
Dernier tableau [X,Y] de Souris mis en cache | La dernière valeur de la coordonnée [X,Y] de la souris du participant au format tableau. |
Nom du Cadre | Le nom du cadre. |
Suivi Oculaire
Options de Valeur de Suivi Oculaire | Description |
---|---|
Dernière Coordonnée X mise en cache | La dernière valeur de la coordonnée X du regard du participant. |
Dernière Coordonnée Y mise en cache | La dernière valeur de la coordonnée Y du regard du participant. |
Dernier tableau [X,Y] de Coordonnées mises en cache | La dernière valeur de la coordonnée [X,Y] du regard du participant au format tableau. |
Dernier tableau [X,Y,T] de Coordonnées mise en cache | La dernière valeur de la coordonnée [X,Y] du regard du participant, plus la valeur de temps de capture de l'appareil photo au format tableau. |
Dispositif
- Taux de Rafraîchissement : La valeur du taux de rafraîchissement de l'appareil du participant.
Opérations
Utilisez des opérations pour effectuer des changements spécifiés sur vos variables comme combiner des valeurs de variable, transformer des chaînes pour qu'elles soient toutes en minuscules, ou exécuter des 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 de stylo supplémentaire (c'est-à-dire le Menu de Sélection de Valeur) apparaîtra, ainsi qu'une liste d'opérations, telle que l'addition.
Les valeurs peuvent être manipulées en utilisant ces 5 opérations différentes :
- (+) addition
- (-) soustraction
- (/) division
- (*) multiplication
- (%) modulo
L'exemple ci-dessous montre comment utiliser des opérations arithmétiques afin de créer une nouvelle variable de chaîne (dans le bouton vert), appelée 'intermediateVar'.
La nouvelle valeur de variable (de 'intermediateVar') est définie en utilisant plusieurs opérations arithmétiques avec une combinaison de variables 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 brisé <br>
. Cette action crée l'effet d'un chat utilisateur qui peut être utilisé dans une étude multi-utilisateur.
Opération sur Chaîne
Options d'Opération sur Chaîne | Description |
---|---|
En Minuscules | Transforme toutes les lettres d'une variable de chaîne en minuscules. → Ex: (AAABBB) se transforme en (aaabbb) |
En Majuscules | Transforme toutes les lettres d'une variable de chaîne en lettres 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 tous les espaces entre les lettres d'une variable de chaîne. → Ex: (aaa bbbb cccc) se transforme en (aaabbbbccc) |
Raccourcir 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 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. |
arrondir | Retourne la valeur arrondie avec 0 à 3 décimales. |
plancher | Retourne la valeur arrondie à l'entier inférieur. |
plafonner | Retourne la valeur arrondie à l'entier supérieur. |
cos | Retourne la valeur cosinus. |
sin | Retourne la valeur sinus. |
tan | Retourne la valeur tangente. |
Valeurs Spécifiques au Déclencheur
Les valeurs spécifiques au déclencheur se réfèrent à des valeurs qui sont associées au déclencheur défini dans un événement particulier. Par exemple, si votre événement utilise un déclencheur de souris, alors, sous certains domaines où l'action est spécifiée (comme en utilisant une action Définir / Enregistrer Variable
ou une action Définir Propriété de l'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, les valeurs spécifiques au déclencheur pour un déclencheur de souris sont utilisées pour enregistrer les valeurs x- et y-values et un tableau [X,Y] en utilisant une action Définir / Enregistrer 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 approfondie de chaque option.
Nom | Aperçu des Options de Valeur |
---|---|
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 (Suivi Oculaire Fixation) |
|
Déclencheur (Suivi Oculaire Fixation) |
|
Déclencheur (Suivi de Tête) |
|
Déclencheur (À l'Initialisation de la Tâche) |
|
Déclencheur (À l'Init du Cadre) |
|
Déclencheur (au Début du Cadre) |
|
Déclencheur (À la Fin du Cadre) |
|
Déclencheur (Valeur de Variable Changée) |
|
Déclencheur (Déclencheur d'Objet Media) |
|
Déclencheur (Déclencheur Websocket) |
|
Déclencheur (Déclencheur OpenAI) |
|
Déclencheur (Événement Global d'Expérience) |
|
Déclencheur (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 de Déclencheur (Souris) | Description |
---|---|
Souris X | Retourne la position actuelle de la souris X dans les coordonnées du cadre. |
Souris Y | Retourne la position actuelle de la souris Y dans les coordonnées du cadre. |
Tableau [X,Y] de Souris | Les coordonnées 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 sur le Stimulus | Les informations sur le stimulus de l'objet qui a déclenché l'événement. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur se produise. |
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 de la Touche | La valeur ID de la touche qui a été pressée comme déclencheur. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur se produise. |
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 |
---|---|
Nom du Stimulus | Le nom de l'objet bouton qui a déclenché l'événement. |
Info sur le Stimulus | Les informations sur le stimulus de l'objet bouton qui a déclenché l'événement. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur se produise. |
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 de la Touche | La valeur ID de la touche qui a été pressée comme déclencheur. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur se produise. |
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 |
---|---|
Nom du Stimulus | Le nom de l'objet bouton qui a déclenché l'événement. |
Info sur le Stimulus | Les informations sur le 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 (Unix) | L'horodatage du moment où le déclencheur de défilement s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur de défilement se produise. |
Déclencheur (Gamepad/ Joystick) Valeurs
Lorsqu'un déclencheur de Gamepad/Joystick
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 |
---|---|
ID du Dispositif Gamepad | L'ID ou le nom du gamepad qui était connecté. |
Touches Appuyées (Tableau) | Les touches qui ont été pressées. |
Touches Appuyé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 (Unix) | L'horodatage du gamepad en heure Unix. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur se produit en heure Unix. |
Temps du Déclencheur (Depuis le Début du Cadre) | Horodatage en Unix du moment où le déclencheur se produit en relation avec le début du cadre. |
Déclencheur (Suivi Oculaire Gaze) Valeurs
Lorsqu'un déclencheur de suivi oculaire de regard 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 (Suivi Oculaire Gaze) | 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 du regard X,Y au format tableau. |
Nom du Stimulus | Le nom du stimulus qui a initié le déclencheur de regard. |
Info sur le Stimulus | Les informations sur le stimulus derrière le stimulus qui a initié le déclencheur de regard. |
Temps de Capture de la Caméra T | Le moment exact où la capture d'image a eu lieu. Dans le pipeline de suivi oculaire de Labvanced, une capture d'image par la caméra se produit d'abord avant que l'algorithme et le réseau de neurones effectuent des calculs de gaze. Ainsi, le Temps de Capture de la Caméra T est un horodatage UNIX du moment où la capture initiale s'est produite. Pour plus d'informations concernant la technologie derrière notre suivi oculaire basé sur webcam, veuillez consulter notre page de technologie de suivi oculaire. |
Confiance de Gaze C | Cette valeur varie de 0 à 1 et désigne la confiance et la probabilité qu'il y ait un œil ouvert dans l'image capturée et sert essentiellement de ‘détecteur de clignement.’ Veuillez vous référer à notre article publié sous évaluation par les pairs 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 la caméra (T) comme décrit ci-dessus. |
Coord. + Temps + Confiance [X,Y, T,C] Tableau | Un tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de la caméra (T) et la confiance du regard (C) comme décrit ci-dessus. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur de regard s'est produit en format Heure unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur de regard se produise. |
Déclencheur (Suivi Oculaire Fixation) Valeurs
Lorsqu'un déclencheur de suivi oculaire de fixation 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 (Suivi Oculaire Fixation) | Description |
---|---|
Centroid X de Fixation | Le point central de la fixation en tant que valeur X. |
Centroid Y de Fixation | Le point central de la fixation en tant que valeur Y. |
Durée de la Fixation | La durée de la fixation détectée. |
Temps de Début de la Fixation | Le temps de début de la fixation détectée. |
Temps de Fin de la Fixation | Le temps de fin de la fixation détectée. |
Dispersion de la Fixation | Se réfère à la dispersion des valeurs de regard à l'intérieur d'une fixation détectée. |
Nom du Stimulus | Le nom de l'objet bouton qui a déclenché l'événement. |
Info sur le Stimulus | Les informations sur le stimulus de l'objet bouton qui a déclenché l'événement. |
[X, Y, Dur, Start, End, Disp] | Un tableau des éléments suivants : valeurs x- et y du centroid de la fixation, la durée de la fixation, le temps de début, le temps de fin, et la valeur de dispersion. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur de fixation s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur de fixation se produise. |
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 de Déclencheur (Suivi de Tête) | Description |
---|---|
Temps de Capture de la Caméra T | Lors de la capture de l'image, c'est-à-dire un horodatage unix du moment où la capture du cadre a eu lieu. C'est le moment où l'image / le cadre a été capturé avant tout traitement. |
Rotation de la Tête | Rotation de la tête de gauche à droite, connue sous le nom de lacet dans la littérature. |
Inclinaison de la Tête | Inclinaison de la tête de haut en bas, connue sous le nom de tangage dans la littérature. |
Roulis de la Tête | Capture le mouvement de la tête se roulant d'un côté à l'autre. |
Position de la Tête [X,Y, T] Tableau | Ce tableau capture les valeurs numériques associées à la position de la tête, y compris les coordonnées x- et y pour le centre de la tête ainsi que la variable horodatage (T). |
Position du Nez [X,Y, T] Tableau | Ce tableau capture les valeurs numériques associées à la position du nez spécifiquement, y compris les coordonnées x- et y pour l'emplacement du nez ainsi que la variable horodatage (T) du moment où la mesure a eu lieu. |
Vecteur du Nez [X,Y, Z, T] Tableau | Cette mesure fonctionne en projetant un vecteur depuis l'extrémité du nez et est utile pour tester si le participant est attentif à l'écran (ce qui est particulièrement important pour les études où le suivi oculaire n'est pas activé). Ainsi, si le nez pointe hors écran (c'est-à-dire que le participant n'attend pas l'expérience), la valeur Z diminue de 1 et se rapproche de 0. |
Horodatage du Déclencheur (Unix) | Point temporel pendant l'expérience où le déclencheur lui-même se produit où le suivi de la tête a été détecté et prend en compte quand le déclencheur s'est produit dans le système. En théorie, il devrait être aussi proche que possible de la valeur T. |
Temps du Déclencheur depuis le Début du Cadre | C'est la valeur temporelle du moment où le déclencheur s'est produit par rapport au moment où le début du cadre 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 de Déclencheur (À l'Initialisation de la Tâche) | Description |
---|---|
Horodatage du Déclencheur (Unix) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre. |
Déclencheur (À l'Init du Cadre) Valeurs
Lorsqu'un Déclencheur d'Init de Cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
Options de Déclencheur (À l'Init du Cadre) | Description |
---|---|
Numéro d'Essai | Le Numéro d'Essai du moment où le Déclencheur d'Init du Cadre s'est produit. |
Horodatage du Déclencheur (Unix) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre. |
Déclencheur (au Début du Cadre) Valeurs
Lorsqu'un Déclencheur de Début du Cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
Options de Déclencheur (au Début du Cadre) | Description |
---|---|
Horodatage du Déclencheur (Unix) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre. |
Déclencheur (À la Fin du Cadre) Valeurs
Lorsqu'un Déclencheur de Fin du Cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
Options de Déclencheur (À la Fin du Cadre) | Description |
---|---|
Temps Total du Cadre | Le temps total en millisecondes passé sur le cadre. |
Horodatage du Déclencheur (Unix) | L'horodatage Unix du déclencheur en millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre. |
Déclencheur (Valeur de Variable Changée) Valeurs
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 l'utilisation de certaines actions :
Options de Déclencheur (Valeur de Variable Changée) | Description |
---|---|
Nouvelle Valeur dans la Variable | Se réfère à la nouvelle valeur d'une variable. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur de changement de variable s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le changement de valeur de variable se produise. |
Déclencheur (Déclencheur d'Objet Media) Valeurs
Lorsqu'un Déclencheur d'Objet Media est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :
Options de Déclencheur (Déclencheur d'Objet Media) | Description |
---|---|
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur d'objet media s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur d'objet media se produise. |
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 de Déclencheur (Déclencheur Websocket) | Description |
---|---|
Message | Un message qui peut être utilisé pour décrire et étiqueter permettant à l'utilisateur (côté récepteur) de filtrer différents types de données. |
Données | Une valeur qui peut contenir différents types de données, tels que les choix des participants, les horodatages, les coordonnées x/y de la souris, etc. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur Websocket s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur Websocket se produise. |
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 de Déclencheur (Déclencheur OpenAI) | Description |
---|---|
Réponse Chat GPT | La valeur de la réponse de ChatGPT. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur OpenAI s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur OpenAI se produise. |
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 de Déclencheur (Événement Global d'Expérience) | Description |
---|---|
Temps Total du Cadre | Se réfère au Temps Total du Cadre qui a été alloué avant le Déclencheur. |
Raison de l'Événement Global | Une valeur de chaîne qui énonce la raison du déclencheur, telle que le participant quittant l'étude. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur d'Événement Global s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur d'Événement Global se produise. |
Déclencheur (Utilisateur Quitte l'Expérience) Valeurs
Lorsqu'un Déclencheur d'Utilisateur Quitte l'Étude Multi-utilisateurs 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 (Utilisateur Quitte l'Expérience) | Description |
---|---|
Nombre Restant de Participants | Le nombre de participants qui restent dans l'étude. |
Horodatage du Déclencheur (Unix) | L'horodatage du moment où le déclencheur Utilisateur Quitte l'Expérience s'est produit en format Heure Unix avec millisecondes. |
Temps du Déclencheur (Depuis le Début du Cadre) | Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'à ce que le déclencheur Utilisateur Quitte l'Expérience se produise. |