labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
  • Technology
    • Feature Overview
    • Desktop App
    • Phone App
    • Precise Timing
    • Experimental Control
    • Eye Tracking
    • Multi User Studies
    • More ...
      • Questionnaires
      • Artificial Intelligence (AI) Integration
      • Mouse Tracking
      • Data Privacy & Security
      • Text Transcription
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Pricing Overview
    • License Configurator
    • Single License
    • Research Group
    • Departments & Consortia
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Vidéos
Didacticiels
FAQ
Notes de version
Notes de version
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Guide
Vidéos
Didacticiels
FAQ
Notes de version
Notes de version
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Guide
    • COMMENCER

      • Objets
      • Événements
      • Variables
      • Assistant de Tâche
      • Système d'Essai
      • Conception de l'Étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
    • SUJETS EN VEDETTE

      • Randomisation et Équilibre
      • Suivi Oculaire
      • Questionnaires
      • Application de Bureau
      • Études Exemples
      • Recrutement de Participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres Sujets

        • Chronométrage Précis des Stimuli
        • Études Multi Utilisateurs
        • Suivi de la Tête dans Labvanced | Guide
    • ONGLET PRINCIPAL DE L'APPLICATION

      • Aperçu: Onglets Principaux
      • Tableau de Bord
      • Mes Études
      • Études Partagées
      • Mes Fichiers
      • Bibliothèque d'Expériences
      • Mon Compte
      • Ma Licence
    • ONGLETS D'ÉTUDE

      • Aperçu: Onglets Spécifiques à l'Étude
      • Conception de l'Étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
      • Éditeur de Tâches
        • Fonctions Principales et Paramètres
        • Le Système d'Essai
        • Cadres de canevas et de page
        • Objets
        • Tables de Propriétés des Objets
        • Variables
        • Tables des variables système
        • Le Système d'Événements
        • Randomisation des Essais
        • Fonctions de l'Éditeur de Texte
        • Suivi oculaire dans une tâche
        • Suivi de la tête dans une tâche
        • Études Multi-Utilisateurs
      • Paramètres
      • Variables
      • Médias
      • Textes et Traduire
      • Lancer et Participer
      • Gestion des Sujets
      • Vue de Données et Exportation
        • Vue des données et sélection des variables & des tâches (ancienne version)
        • Accéder aux Enregistrements (Version ANCIENNE)
  • Vidéos
    • Aperçu Vidéo
    • Commencer avec Labvanced
    • Créer des Tâches
    • Vidéos d'Éléments
    • Événements et Variables
    • Sujets Avancés
  • Guides
    • Introduction
    • Tâche de Stroop
    • Tâche de Décision Lexicale
    • Tâche de Cueillette de Regard de Posner
    • Paragraphe de Flic d'Agnosie
    • Étude Exemple de Suivi Oculaire
    • Étude de Suivi Oculaire de Nourrissons
    • Étude de Capture Attentionnelle avec Suivi de Souris
    • Présentation Visuelle Séquentielle Rapide
    • Étude ChatGPT
    • Démonstration de Suivi Oculaire: SVGs comme AOIs
    • Démonstration Multi-Utilisateur: Afficher les Curseurs des Sujets
    • Contrôleur de Jeu / Joystick - Configuration de Base
    • Étude Application de Bureau avec Intégration EEG
    • Équilibrage de Groupes entre Sujets et Configuration de Variables
  • FAQ
    • Fonctionnalités
    • Sécurité et Confidentialité des Données
    • Licences
    • Précision de Labvanced
    • Utilisation Programmatique et API
    • Utiliser Labvanced hors ligne
    • Dépannage
    • Questions sur la Création d'Études
  • Notes de Version
  • Documents
  • Salle de Classe

Système d'Événements

Illustration du système d'événements dans Labvanced.

Description

Le Système d'Événements est essentiel pour toute étude. C'est ainsi que vous définissez 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 des objets et des variables.

Le système d'événements se compose de déclencheurs et d'actions. Ici, vous définissez des règles, comme « lorsqu'un événement se produit » (déclencheur) puis « 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).

Vue d'ensemble de la façon dont les déclencheurs et les actions sont utilisés dans Labvanced.

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 + Événement d'Image pour des événements qui doivent se produire à cette image ou en cliquant sur + Événement d'Essai, qui applique l'événement à toutes les images. 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 de l'image et peuvent être séparés/spécifiques pour chaque image ou dupliqués/identiques sur chaque image d'un essai.

Ajouter un événement dans Labvanced

Dans tous les cas, un événement est toujours défini pour tous les essais dans un groupe d'essai pour les images spécifiées. Cependant, la 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 positionnés plus haut dans la liste et seront exécutés en premier. Les événements peuvent également être copiés et supprimés. Lors de la sélection d'un événement existant, les spécificités sont affichées dans le panneau inférieur droit (Propriétés de l'Événement). Pour une meilleure vue d'ensemble, les événements existants peuvent également être ré-ouverts (icône à côté du champ de nom).

Déclencheurs

Le déclencheur définit quand l'événement sera exécuté. Cela pourrait être un clic de souris sur un objet particulier, une certaine entrée au clavier, un changement de variable, le début d'un fichier vidéo, ou bien beaucoup d'autres choses. Tous les déclencheurs et leurs paramètres / 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
  • Déclencheurs de Souris
  • Déclencheurs de Clavier
  • Clics de Bouton
  • Touche Entrée sur Input
  • Déclencheur de Défilement
  • Déclencheur de Gamepad/Joystick
Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur qui peut être activé manuellement par l'utilisateur/le participant en faisant quelque chose comme déplacer leur souris, cliquer sur un élément du clavier, faire défiler, etc.
Déclencheurs de Signaux Physiologiques
  • Regard de Suivi oculaire
  • Fixation de Suivi oculaire
  • Suivi de Tête
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 d'Image
  • Init Tâche
  • Init Image
  • Début de l'Image
  • Fin de l'Image
Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux images, par exemple lorsque le début ou la fin d'une image se produit.
Déclencheur de Changement de Valeur de VariableVariable (Valeur Changée)Un déclencheur pour l'événement se produit lorsqu'il y a un changement de valeur d'une variable spécifique.
Déclencheur d'Objet MultimédiaDéclencheur d'Objet MultimédiaCe déclencheur se produit avec des objets multimédias, par exemple lorsqu'il y a une pause dans un fichier vidéo/audio, un enregistrement terminé, etc.
Déclencheurs API
  • Déclencheur Websocket
  • Déclencheur OpenAI
Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API.
Déclencheurs Globaux
  • Pause / Reprise de l’Expérience
  • Participant a quitté l'Étude Multijoueur
Les déclencheurs globaux se réfèrent à tout changement majeur dans une expérience, comme une pause ou un participant dans une étude multijoueur qui quitte.

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/le participant.

Le menu de déclencheurs d'entrée utilisateur dans Labvanced

Le tableau ci-dessous fournit un aperçu introductif de tous les Déclencheurs d'Entrée Utilisateur disponibles dans Labvanced. Chacun d'eux est décrit plus en détail dans les sections suivantes.

Option de Déclencheur d'Entrée UtilisateurVue d'ensemble
Déclencheur de Souris Tout mouvement de souris peut être utilisé comme un déclencheur pour initier un événement, tel que : faire défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou cibles spécifiques avec un déclencheur. Par exemple, un clic de souris ne sera utilisé comme déclencheur que si une image spécifique est cliquée.
Déclencheur de ClavierToute pression sur une touche du clavier peut être utilisée comme déclencheur pour initier un événement. Vous pouvez spécifier des lettres ou des chiffres de clavier spécifiques comme déclencheurs.
Clics de BoutonLes objets de bouton qui sont créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements.
Touche Entrée sur InputCe déclencheur est couramment utilisé lorsque le participant appuie sur 'Entrée' pendant une expérience, comme moyen de soumettre sa réponse ou son entrée écrite dans les zones de texte.
Déclencheur de DéfilementCe déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier des directions de défilement sur les axes x ou y, ainsi que les éléments au-dessus desquels le défilement se produit pour être utilisés comme déclencheurs d'événements.
Déclencheur de Gamepad/JoystickCe déclencheur vous permet d'utiliser des contrôleurs de gamepad et de joystick dans votre conception expérimentale comme un dispositif d'entrée pour enregistrer des données.

Déclencheur de Souris

L'option « Déclencheur de Souris » est un déclencheur d'événement très populaire car il initie un événement basé sur toute interaction de souris, telle que : déplacer la souris vers le haut / vers le bas, cliquer, survoler un objet spécifique, quitter un objet spécifique ou tout mouvement en général !

L'option 'menu de déclencheur de souris' dans le menu des déclencheurs d'entrée dans Labvanced.

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 » :

Exemple de l'option de déclencheur de souris utilisée dans Labvanced.

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

Éléments du MenuZone de MenuOptions et Spécifications du Déclencheur de Souris
Action

liste déroulante :
Actions de souris disponibles pour définir le comportement du déclencheurLes options suivantes de déclencheurs de souris sont disponibles dans la liste déroulante :
  • Clique: Déclenché par un clic de souris
  • Pression: Déclenché par une pression de souris
  • Relâchement: Déclenché par un relâchement de souris
  • Survol: Déclenché en survolant un objet
  • Quitter: Déclenché en quittant un objet
  • Déplacement: Déclenché par tout mouvement de souris
Bouton

liste déroulante :
Explication de la configuration du bouton de souris
  • Gauche: Déclenché par le bouton gauche de la souris
  • Droit: Déclenché par le bouton droit de la souris
Cibles

options :
Zoom sur la zone cible de la souris

Dans l'exemple ci-dessus, 'Image_1' est la cible du clic du 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 :
  • Déclencheur sur Fond d'Image : le déclencheur de souris peut être activé sans cliquer sur un objet ou un élément.
  • Tout Élément : le déclencheur de souris peut être activé en cliquant sur n'importe quel élément sur l'image.
  • Ajouter des Cibles : sélectionnez l'élément(s) spécifique(s) qui doivent être cliqués pour activer le déclencheur.
  • Remarque : Après avoir sélectionné le déclencheur de souris dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs de souris spécifiques au déclencheur 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 entrée du clavier peut être utilisée comme un déclencheur. Cela inclut : appuyer, maintenir ou relâcher une touche.

L'option de déclencheur de clavier dans Labvanced

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

Exemple de l'utilisation du déclencheur de clavier.

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

Éléments du MenuZone de MenuOptions du Déclencheur de Clavier
Action

liste déroulante :
Liste déroulante des actions de clé Ce sont les options des actions de clavier disponibles :
  • Pression de Touche : Déclenché par une pression de touche (la touche est enfoncée)
  • Pression OU Maintien de Touche : Déclenche lorsque la touche est soit pressée soit maintenue
  • Relâchement de Touche : Déclenché par le relâchement de la touche
Remarque : Une touche doit être relâchée avant de pouvoir « tirer » à nouveau comme déclencheur.
Touches

quelle touche déclenche l'événement
Zoom sur les options de touches.Quelle touche est utilisée comme déclencheur est spécifiée en sélectionnant les options ici en cliquant sur +Ajouter :
  • Flèches : les quatre Flèches
  • Nombres : Nombres de 0-9
  • Lettres : Toutes les lettres de l'alphabet anglais
  • Spécial : Touches Spéciales (Entrée, Espace, Contrôle, Tabulation, Maj)
  • Touches F : F1 à F10
  • toute touche : n'importe laquelle de ces touches est acceptable
Vous pouvez ajouter plusieurs déclencheurs de clavier en cliquant à nouveau sur le bouton +Ajouter :
Options SupplémentairesOptions supplémentaires pour les déclencheurs de clavier L'option activer les boutons du pavé numérique permet aux touches du pavé numérique d'être utilisées comme déclencheurs dans l'expérience.

Pour l'option autorise la propagation de l'événement, si plusieurs événements ont le même déclencheur de clavier, alors tous se déclenchent sans cela. Seul le premier se déclenchera et l'exécution de l'événement s'arrêtera après le premier événement terminé.
  • Remarque : Après avoir sélectionné le déclencheur de clavier dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs 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.

Le menu de clic de bouton dans Labvanced

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

Options disponibles pour le déclencheur de clic de bouton

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

Éléments du MenuZone de MenuOptions du Déclencheur de Clic de Bouton
Cible :

+Définir Cible
Le bouton 'Définir Cible.' Sélection d'un élément de bouton comme cible
Bouton:
option
Zone de sélection des options de bouton.Spécifiez quel bouton spécifique sur l'image
  • Remarque : Après avoir sélectionné le Déclencheur de Clic de Bouton dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs de clic de bouton spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Déclencheur Touche Entrée sur Input

Déclenche lorsqu : La touche Entrée/Retour est pressée sur le clavier alors 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 Touche Entrée sur Input dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur Touche Entrée sur Input dans 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 la souris est utilisée sur un élément spécifique.

Paramètres :

  • Choisir 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 auquel le déclencheur de défilement s'applique.

Remarque : Pour du texte long, dans le panneau 'Propriétés de l'Objet' sous la section 'Style', les options Overflow-X et/ou Overflow-Y doivent avoir scroll comme option sélectionnée.

  • Remarque : Après avoir sélectionné le Déclencheur de Défilement dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs de défilement spécifiques au déclencheur dans 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 contrôleurs de gamepad et de 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.

option de menu de déclencheur de manette de jeu

Lors de la sélection de ce déclencheur, la boîte de dialogue suivante apparaîtra.

minuterie des options de déclencheur de manette de jeu

Après avoir connecté votre manette, vous pouvez spécifier quelles touches spécifiques 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, 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 existe une certaine variation entre les manettes de jeu dans la façon dont l'attribution des ID de touches fonctionne.

déclencheur de manette de jeu, configuration des touches pour les commandes

En conséquence 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 :

flux de données en direct des déclencheurs de manettes de jeu

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 en détail.

Éléments du MenuZone de MenuOptions du Déclencheur de Gamepad / Joystick
Écouter les boutonsDéfinir le déclencheur pour écouter les boutonsI.) Spécifier que le déclencheur est lié au bouton et s'il est sur la touche pressée, pressée ou relâchée, ou relâchée.

II.) Spécifier si 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 les bouton(s) de votre manette.
Écouter les axesDéfinir le déclencheur pour écouter les changements d'axesSi des mouvements d'axes sont nécessaires, 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.
État de connexionÉtat de connexion de la manetteIndique si un appareil est connecté ou non.
Flux de données en directFlux de données en directAprès avoir connecté le dispositif et appuyé sur une touche ou déplacé un axe, les données en direct s'afficheront 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 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 dans 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 a été activé pour la tâche.

Déclencheur de Regard de Suivi Oculaire

Déclenche lorsqu :

  • De manière générale, ce déclencheur s'applique lorsque le suivi oculaire a été activé.
  • Déclencher uniquement lorsque l'on regarde des éléments spécifiques

Paramètres :

  • Si vous avez sélectionné de déclencher uniquement sur des éléments spécifiques, ajoutez ces éléments comme cibles.

  • Remarque : Après avoir sélectionné le déclencheur de Regard de Suivi Oculaire dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs de regard spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Déclencheur de Fixation de Suivi Oculaire

Ce déclencheur est encore en phase BETA.

  • Remarque : Après avoir sélectionné le déclencheur de clavier dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs de fixation spécifiques au déclencheur dans 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 les valeurs spécifiques au déclencheur de Suivi de Tête dans diverses actions avec le menu de sélection de valeur.

Déclencheurs d'Essai et d'Image

Déclencheur Init Tâche

Déclenche lorsqu :

  • La première image du premier essai d'une tâche. Sera exécuté une seule fois par tâche, bien qu'il soit affiché dans l'onglet Événements pour toutes les instances de cette image.

Ce Déclencheur fonctionne bien avec les actions Mélanger et Lire À Partir de. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les cadres de données au début de la tâche et attribuer 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 les valeurs spécifiques au déclencheur Init Tâche dans diverses actions avec le menu de sélection de valeur.

Déclencheur Init Image

Déclenche lorsqu :

  • L'initialisation de l'image, avant qu'elle ne devienne visible pour le participant.

Ce déclencheur fonctionne bien avec les actions Mélanger, Lire À Partir de, et Dessiner Nombre Aléatoire. Avec ces combinaisons, ces actions peuvent être complétées avant que l'image apparaisse, laissant une voie claire pour que d'autres actions commencent au début de l'image.

Remarque : Ne pas utiliser le déclencheur Init Image 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 Image se produit entre les essais, donc il n'y a pas de comptage totalement précis de l'essai ou de la condition qui est sur le point d'être affichée.

Paramètres : Aucun

  • Remarque : Après avoir sélectionné le déclencheur Init Image dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur Init Image dans diverses actions avec le menu de sélection de valeur.

Remarque sur les Déclencheurs Init Tâche et Init Image : Parce que les Déclencheurs Init Tâche et Init Image se produisent avant que la tâche ou l'image ne commence, les variables créées pendant ce temps seront réinitialisées lorsque la tâche/image commence réellement. Un avertissement apparaîtra lors de l'utilisation de cet événement :

avertissement init image

N'oubliez pas de décocher la case "Réinitialiser au Début de l'Essai" dans la fenêtre des propriétés des variables si vous ne souhaitez pas que les valeurs des variables soient réinitialisées.

Déclencheur Début d'Image

Déclenche lors :

  • Début de l'image

Paramètres : Aucun

  • Remarque : Après avoir sélectionné le déclencheur Début d'Image dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur Début d'Image dans diverses actions avec le menu de sélection de valeur.

Déclencheur Fin d'Image

Déclenche lors :

  • Fin de l'image (après que l'image ne soit plus visible)

Paramètres : Aucun

  • Remarque : Après avoir sélectionné le déclencheur Fin d'Image dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur Fin d'Image dans diverses actions avec le menu de sélection de valeur.

Déclencheur de Changement de Valeur de Variable

Changement de Valeur de Variable

Déclenche lors :

  • La valeur d'une variable change de sa valeur initiale

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 l'action correspondante immédiatement.

  • Remarque : Après avoir sélectionné le déclencheur Changement de Valeur de Variable dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur 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

Anciennement connus sous le nom de déclencheurs distincts "Contrôler l'Audio/Vidéo" et "Contrôler l'Objet".

Déclenche lors :

  • Début, pause ou arrêt d'un fichier vidéo ou audio
  • Fin de Téléchargement de Fichier, Fichier Sélectionné, Enregistrement Terminé d'un objet d'enregistrement
  • Fin de Snapshot ou Téléchargement Complet d'un objet de snapshot de caméra

Paramètres :

  • Cible : Sélectionnez un élément objet qui existe sur l'image

  • 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 a cessé
      • Téléchargement Complet : Déclenche lorsque le téléchargement de fichier est complet
    • Options d'objet de Téléchargement de Fichier :
      • Fichier Sélectionné : Déclenche lorsque un fichier est sélectionné
      • Téléchargement Complet : Déclenche lorsque le téléchargement de fichier est complet
    • Options d'objet de Snapshot de Caméra :
      • Snapshot Terminé : Déclenche lorsque la caméra a réussi à prendre un instantané
      • Téléchargement Complet : Déclenche lorsque le snapshot est terminé de se télécharger
  • 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 référencer les 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 « Actions API » peuvent être utilisés. Les suivants peuvent être utilisés comme déclencheurs :

  • Déclencheur Websocket
  • Déclencheur OpenAI

Le menu de déclencheur API dans Labvanced.

Déclencheur Websocket

Le Déclencheur Websocket est utilisé lorsqu'un message provenant du websocket/API sera reçu et traité comme déclencheur pour l'Action.

L'option de déclencheur Websocket.

Lors de votre clic sur cette option, les éléments suivants apparaissent.

Le menu de dialog du déclencheur Websocket.

  • Accepter/Reçoit de : Détecte automatiquement l'adresse IP de l'hôte local. Peut être changé manuellement dans l'onglet Paramètres sous Fonctionnalités Spéciales.
  • 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 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 les valeurs spécifiques au déclencheur WebSocket dans diverses actions avec le menu de sélection de valeur.

Déclencheur OpenAI

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

Le menu Déclencheur OpenAI dans Labvanced.

Sélectionner cette option entraînera l'affichage des paramètres suivants :

Les options du menu de déclencheur OpenAI.

REMARQUE : Consultez é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é 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 désignera le ‘rôle’ et la deuxième colonne le ‘message de chat.’ Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici.

Un exemple du déclencheur OpenAI dans Labvanced.

Si vous utilisez également l'‘Action Envoyer à OpenAI’, alors vous devez utiliser le même cadre de données là 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 les valeurs spécifiques au déclencheur OpenAI dans 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 qui est '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 Multijoueur

Le menu des déclencheurs globaux dans Labvanced.

Déclencheur 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 pause ou la reprise de l'expérience.

L'option d'utiliser une pause dans l'expérience comme déclencheur.

Lors de la sélection de ce déclencheur, la vue suivante apparaît où vous pouvez préciser la nature du déclencheur, qu'il doit être exécuté si l'expérience est mise en pause ou continue / reprise :

Menu de dialogue pour ce déclencheur globalOptions disponibles dans le menu de déclencheurs globaux

  • Expérience Mise en Pause : Le participant met en pause (sort de l'écran complet) l'étude.

  • Expérience Reprise : Participant reprend l'étude. Ce déclencheur fonctionne bien pour les études de suivi oculaire. Il peut être utilisé pour renvoyer le participant à un essai ou une image précédente s'il a quitté son Repose-menton Virtuel.

  • Remarque : Après avoir sélectionné le déclencheur Pause/Resume de l'expérience dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Participant a quitté l'Étude Multijoueur

Si un participant quitte une étude multi-utilisateur, cela peut également être utilisé comme 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 les autres participants de continuer l'étude.

L'option Participant a quitté l'Étude Multijoueur comme déclencheur dans Labvanced

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

Boîte de dialogue du déclencheur participant a quitté l'étude multijoueur.

  • Remarque : Après avoir sélectionné le déclencheur Participant a quitté l'Étude Multijoueur dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur 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'objet, enregistrer des données, lire et écrire des données vers/depuis des tableaux, ou sauter au prochain essai ou tâche. Souvent, il y a plusieurs actions par événement. En utilisant "ControlActions", on peut utiliser des opérations logiques (instructions If-Else), des boucles, des fonctions de rappel, ainsi que imbriquer des actions les unes dans les autres (par exemple, une boucle while dans une instruction if). Ainsi, le système d'événements peut être considéré comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme les appelles de fonction, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit que presque toute logique expérimentale peut être mise en œuvre sans avoir à 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
  • Définir Propriété d'Objet
  • Contrôler Objet Multimédia
  • Copier Objet
  • PourChaque Objet
Les actions d'objet se réfèrent à toute manipulation qui se produira sur un objet existant au sein de la tâche.
Actions de Variable
  • Définir / Enregistrer Variable
  • Copier dans le Presse-papiers
  • Dessiner Nombre Aléatoire
  • Obtenir Paramètre URL
  • Lire À Partir de / Écrire Vers Dispositif
  • Lire À Partir de / Écrire Vers Variable Partagée
  • Math & Statistiques
  • Enregistrer Variables Instantanément
  • Filtre de Moyenne Mobile
  • Disperser Variable
Toute action qui lit ou enregistre une valeur variable.
Actions de Tableau
  • Sélectionner Dans le Tableau (Lire)
  • Ajouter / Retirer Entrées de Tableau
  • Changer l'Entrée du Tableau (Remplacer)
  • Mélanger les Entrées du Tableau
Les opérations sur les tableaux impliquent de sélectionner, ajouter, retirer, changer et mélanger des tableaux et leurs entrées.
Opérations sur Cadres de Données
  • Lire À Partir de / Écrire Vers Cadre de Données
  • Mélanger les Entrées du 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
  • Sauter Vers
  • Accepter / Terminer Session
  • Rejeter / Terminer Session
  • Rediriger vers URL
Vous permet de naviguer dans l'expérience en sautant vers une section spécifique, ainsi que d'accepter et de rejeter des sections de participants.
Actions de Contrôle
  • Actions de Condition (If…Then)
  • Actions Répétées (Boucle While)
  • Actions Retardées (Temps de Callback)
  • Groupe d'Actions
Les actions de contrôle sont utilisées pour exécuter des séquences spécifiques d'événements, comme une logique if/then, une boucle (comme jouer un son répété ou faire clignoter une image), ainsi que pour établir un délai pour le moment où une action se produit.
Actions API
  • Envoyer au Websocket
  • Envoyer à OpenAI
Se réfère à des actions spécifiques à l'API pour envoyer des données à une API.
Actions de Code
  • Exécuter JavaScript
  • Définir CSS Global
Les actions de code vous permettent de travailler avec JavaScript ou CSS.
Action CollerAction CollerVous permet de coller une action que vous avez précédemment copiée.
Les actions sur les objets font référence à toute manipulation qui se produira sur un objet qui existe dans la tâche. Il y a plusieurs options d'actions sur les objets :
  • Définir la propriété de l'objet
  • Contrôler l'objet multimédia
  • Copier l'objet
  • Pour chaque objet

L'option Actions sur les Objets dans Labvanced.

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 bon vous semble en spécifiant l'objet en question, la propriété à changer et la nouvelle valeur.

Dans l'exemple ci-dessous, l'action changera deux propriétés de l'image cible en définissant la « visibilité » sur « 1 » et sa « hauteur » sur « 400 », tout en enregistrant le moment où ce changement s'est produit sur l'écran en stockant la valeur dans la variable numérique appelée « Object_Prop_Change_Time ».

Exemple d'une Action sur un Objet dans Labvanced.

Voici un aperçu complet des champs auxquels vous serez confronté lors de l'utilisation de l'action « Définir la propriété de l'objet » :

Élément de MenuZone de MenuOptions de Déclenchement pour Définir la Propriété de l'Objet
Cible

liste déroulante de sélection de l'objet :
Menu des Propriétés de l'Objet où l'objet est spécifié. La première liste déroulante affichera les objets que vous avez dans cette frame pour que vous puissiez choisir. Cela indique sur quel objet spécifique l'action sera effectuée.
Cible

liste déroulante de sélection de la propriété :
Menu des Propriétés de l'Objet où la propriété est spécifiée.La deuxième liste déroulante indique quelle propriété de l'objet doit être changée. Pour une explication complète des options disponibles et de leurs paramètres, veuillez consulter le Tableau des Propriétés des Objets.
Menu de Sélection de ValeurLe menu de sélection de valeur où la nouvelle valeur est spécifiéeDé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é’Le bouton pour ajouter plus de propriétés.Plusieurs propriétés peuvent être ajoutées et modifiées sous l'action en cliquant sur cette icône.
Case à cocher - Enregistrer l'heure à laquelle ce changement est reflété à l'écran (mesuré en millisecondes depuis le début de la frame).La case à cocher pour enregistrer la valeur horaire des changements de propriété de l'objet.Lorsqu'une propriété est changée, il faut un court laps de temps (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'écran.

Remarque : Lorsque vous sélectionnez 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, car le ‘type de données.'

Action Contrôler l'Objet Multimédia

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

Effet : Change la lecture d'éléments vidéo/audio ou change l'état des éléments 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 :
      • Démarrer la Lecture : Commence à lire le fichier vidéo/audio
      • Arrêter la Lecture : Arrête le fichier vidéo/audio
      • Mettre en Pause la Lecture : Met en pause le fichier vidéo/audio
      • JumpToTime : vous permet de spécifier un temps en millisecondes pour sauter dans le fichier audio/vidéo
      • Couper : désactive le son de l'objet
      • Rétablir : restaure le son de l'objet
    • Options pour 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 de l'enregistrement (audio).
      • Démarrer la Lecture : Commence à lire le fichier enregistré
      • Arrêter la Lecture : Arrête de lire le fichier enregistré
      • Mettre en Pause l'Enregistrement : Met en pause l'enregistrement de l'objet
      • Reprendre l'Enregistrement : Reprend l'enregistrement de l'objet
    • Options pour 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 Fichier : permet au participant de choisir le fichier souhaité
    • Options pour Objet de Photo par Caméra :
      • Démarrer la Caméra : active la caméra du participant
      • Arrêter la Caméra : désactive la caméra du participant
      • Démarrer le Téléchargement : commence à télécharger la photo vers l'expérience
      • Prendre Photo : prend une photo en utilisant la caméra du participant

Action Copier l'Objet

Effet : Copie un objet, remplaçant le besoin de plusieurs objets séparés et d'événements en double.

Paramètres :

  • Source : Choisissez l'objet sur la frame à copier.
  • Nombre 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.
  • 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 arrivera aux copies. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à toutes les copies.

Action Pour Chaque 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 des objets à cibler. Pour plusieurs objets sur une frame 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.

Emplacement des actions sur les variables dans le système d'événements

Le tableau ci-dessous fournit une vue d'ensemble introductive de toutes les options d'actions sur les variables disponibles dans Labvanced. Chacune d'entre elles est décrite plus en détail dans les sections à venir.

Option d'Action sur les VariablesDescription
Définir / Enregistrer la VariableÉcrit ou définit une valeur de variable
Copier dans le Presse-PapiersCopie une valeur de variable dans le presse-papiers interne de l'ordinateur.
Tirer un Nombre AléatoireTire un ou plusieurs nombres aléatoires et les enregistre dans une variable
Obtenir un Paramètre d'URLEnregistre une valeur à partir de l'URL unique du participant
Lire depuis / Écrire dans un Dispositif Lit ou écrit une variable depuis/vers le stockage local du dispositif. Cette action enregistre des données sur le dispositif du participant au lieu d'envoyer les données aux serveurs de Labvanced.
Lire depuis / Écrire dans une Variable PartagéeLit ou écrit une variable qui est partagée à travers les sessions d'une étude. La variable peut être partagée avec tous les participants ou privée à chaque individu.
Math & StatistiquesEffectue une opération mathématique sur une variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.
Enregistrer Instanément les VariablesCrée un instantané de toutes les valeurs des variables et envoie cela au serveur de Labvanced.
Filtre de Moyenne MobileCalcule une moyenne mobile (une moyenne en constante mise à jour des données) d'une certaine entrée et stocke le résultat dans une nouvelle variable.
Distribuer VariableEnverra 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.

Emplacement de l'action de définir/enregistrer la variable dans le système d'événements

En cliquant sur cette action, le menu de dialogue suivant apparaîtra où vous pourrez spécifier quelle variable doit être enregistrée et la valeur d'intérêt :

Options de définir/enregistrer la variable dans le système d'événements

Élément de MenuZone de MenuDescription
SélectionnerSélectionner quels participants le distribue variable est envoyéEn cliquant sur sélectionner, vous indiquez quelle variable doit stocker la valeur. À partir de là, vous pouvez également créer une nouvelle variable.
Icône de StyloSélectionner quels participants le distribue variable est envoyé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 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 valeur pour faire augmenter la valeur de la variable de 1 (basé sur le déclencheur défini à l'étape précédente).

Création d'une variable compteur dans Labvanced

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 variable 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 la souris que le système fournit et à laquelle vous pouvez vous référer lors de l'enregistrement des valeurs.

Création de variables pour le suivi de la souris et la mesure des coordonnées dans Labvanced

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 en utilisant « si/alors » et « boucles while » basées sur des valeurs de variable.

Action Copier dans le Presse-Papiers

Effet : Copie une valeur de variable dans le presse-papiers interne de l'ordinateur.

Action Tirer un Nombre Aléatoire

Effet : Tire un ou plusieurs nombres aléatoires et les enregistre dans une variable.

Paramètres :

  • Type : Choisissez entre des valeurs continues et discrètes
  • Distribution : Choisissez entre distribution gaussienne et uniforme
  • Tirages Multiples (boolean true/false) : Choisissez de tirer une fois ou plusieurs fois.
  • Nb de Tirages : Sélectionnez le nombre de tirages
  • Min : Définissez la valeur minimale pour la distribution uniforme
  • Max : Définissez la valeur maximale pour la distribution uniforme
  • Moyenne : Définissez la valeur moyenne pour la distribution gaussienne
  • Écart-Type : Définissez l'écart type pour la distribution gaussienne
  • Enregistrer dans une Variable : Sélectionnez une variable où les valeurs seront stockées.

Action Obtenir un Paramètre d'URL

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

Paramètres :

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

Action Lire depuis/Écrire dans un Dispositif

Effet : Lit ou écrit une variable depuis/vers le stockage local du dispositif. Cette action enregistre des données sur le dispositif du participant au lieu d'envoyer les données aux serveurs de Labvanced.

Paramètres :

  • Choisissez de lire depuis ou écrire dans le dispositif local.
  • Choisissez la variable à lire ou à écrire.

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

  • Avec cette action, les données spécifiques au dispositif peuvent être transférées d'une session à l'autre, à condition que le même participant utilise le même dispositif pour chaque session.
  • Par exemple, vous pouvez utiliser cette action pour enregistrer quelles images ont été présentées à chaque participant dans la Session 1 et s'assurer que des images différentes leur sont présentées dans la Session 2.
    • Créez un tableau d'images et sélectionnez-en quelques-unes au hasard à présenter dans chaque session.
    • Écrire dans le Dispositif : le numéro d'index des images présentées dans la Session 1.
    • Lire depuis le Dispositif : 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 dans une Variable Partagée

Effet : Lit ou écrit une variable qui est partagée à travers les sessions d'une étude. La variable peut être partagée avec tous les participants ou être privée à chaque individu.

Paramètres :

  • Choisissez la variable à synchroniser. Doit être soit scalaire soit un tableau.
  • Options Avancées
    • Clé de stockage : choisissez le nom d'une variable pour servir de clé pour accéder à la variable synchronisée.
    • Méthode de Lecture ou d'Écriture :
      • Lire, modifier, puis écrire la variable partagée : lit la variable, fait une modification, puis envoie la variable à l'étude.
      • Lire uniquement la valeur partagée depuis le serveur : appelle la variable qui est partagée dans l'étude, mais ne fait aucune modification.
      • Écrire uniquement la variable sur le serveur : apporte des modifications à la variable partagée, mais ne l'affiche pas aux participants.
      • Partager les valeurs entre différents participants (non seulement entre les sessions) : permet aux participants de voir les valeurs de variable synchronisées des autres participants à travers les sessions. Cette option est sélectionnée par défaut, mais peut être désélectionnée en cliquant sur la case à cocher.
  • Séquence d'Action :
    • Choisissez ce qui arrive à la variable partagée/synchronisée depuis 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 peuvent être partagées entre participants au cours des sessions.
  • Par exemple, vous pouvez utiliser cette action pour enregistrer un score dans 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 un Dispositif) consiste à faire choisir aux participants 5 images qu'ils aiment dans un tableau, à effectuer une tâche, puis à 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 d'un autre participant.

Action Math & Statistiques

Effet : Effectue une opération mathématique sur une variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.

Paramètres :

  • Type : Choisissez entre Opérations de Tableau, Algèbre Linéaire et Tests Statistiques
  • Opération : Choisissez une opération mathématique (par ex. somme, min, écart-type, etc.)
  • Tableau d'Entrée : Choisissez une variable d'entrée (Tableau) sur laquelle l'opération est exécutée
  • Paramètres : Certaines opérations ont des paramètres supplémentaires.
  • Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.

Action Enregistrer Instantanément les Variables

Effet : Crée un instantané de toutes les valeurs des variables et l'envoie au serveur de Labvanced.

Paramètres : Aucun

Action Filtre de Moyenne Mobile

Effet : Calcule une moyenne mobile (une moyenne qui se met à jour constamment des données) d'une certaine entrée et stocke le résultat dans une nouvelle variable.

Paramètres :

  • Forme du Filtre : Sélectionnez le type de filtre
    • Moyenne Mobile Simple : Calcule une moyenne mobile simple, où tous les échantillons ont le même poids.
    • Moyenne Mobile Pondérée Linéaire : Pèse les échantillons de sorte que les poids des échantillons diminuent de manière linéaire.
    • Moyenne Mobile Exponentielle : Pèse les échantillons de sorte que les poids des échantillons diminuent de manière exponentielle.
  • Nombre d'Échantillons : Détermine combien d'échantillons sont utilisés par étape.
  • Entrée : Choisissez une variable d'entrée (Tableau) sur laquelle la moyenne mobile est calculée
  • Sortie : Sélectionnez une variable de sortie où le résultat sera stocké.

Action 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 participants, permettant essentiellement à l'information (y compris les emplacements des stimuli et tout changement) d'être reflétée sur les écrans des participants.

L'Action Distribuer Variable dans le menu d'action Labvanced.

En sélectionnant cette action, la boîte de dialogue suivante apparaîtra où vous pourrez spécifier quelle valeur de variable est distribuée entre les participants.

L'image ci-dessous montre à quoi ressemble une boîte de dialogue fonctionnelle de l'Action Distribuer Variable lorsque tous les éléments du menu sont remplis. Dans cet exemple, la variable distribuée est une action qui est utilisée comme moyen de créer un chat entre deux participants en distribuant la valeur d'une variable d'un objet champ d'entrée.

La Variable Distribuée étant utilisée avec toutes les options de menu définies en exemple.

Découvrez cette démo qui intègre la fonction de distribution de variable et de chat ici : Tâche de Description d'Image avec Module de Chat.

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

Élément de MenuZone de MenuOptions et Description de l'Action Distribuer Variable
Distribuer la valeur àSélectionner quels participants le distribue variable est envoyéChoisissez à quels autres participants la valeur doit être envoyée.
  • Tous les participants : Envoyer cette valeur à tous les participants
  • Participants Sélectionnés : Envoyer la valeur à des participants sélectionnés.
Choisir la variable cible et la valeurSpécifiant la variable cible et les valeurs
  • Variable Cible : Choisissez une variable cible où la valeur sera stockée.
  • Valeur : Déterminez la valeur qui doit être envoyée aux autres participants.
BloquerL'option de blocage de la variable distribuéeSi activé, la Variable Cible ne peut pas être changée tant que la distribution de valeur actuelle n'est pas terminée.
Stratégie de Limitation de TauxLes options de la stratégie de limitation de taux de la variable distribuéeLa Stratégie de Limitation de Taux est une manière de protéger votre expérience contre les débordements du serveur et agit comme une stratégie préventive pour contrôler le taux auquel les demandes (c'est-à-dire, les mises à jour via la variable distribuée) sont envoyées au serveur. Les options de stratégie suivantes sont disponibles :
  • Débouncer : Lorsque cette action s'exécute plus d'une fois par fenêtre temporelle de 100 ms, alors de nouveaux messages serveur seront ‘débrayés’ (seul le message le plus récent sera envoyé après un intervalle de 100 ms sans aucune exécution de cette action).
  • Throttle : Lorsque cette action s'exécute plus d'une fois par fenêtre temporelle de 100 ms, alors de nouveaux messages seront réduits (par exemple, après que 100 ms se soit écoulé depuis le dernier message envoyé, seul le message le plus récent sera distribué).
  • Rejeté : Lorsque cette action s'exécute plus d'une fois par fenêtre temporelle de 100 ms, alors de nouveaux messages dans cette fenêtre de 100 ms seront rejetés.
  • Mettre en Queue : Lorsque cette action s'exécute plus d'une fois par fenêtre temporelle de 100 ms, alors de nouvelles valeurs de variable seront mises en queue (jusqu'à une taille de queue maximale de 10 messages).

Actions sur les Tableaux

Action Sélectionner (Lire) depuis un 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 dans la position d'où l'information doit être lue (basé sur 1).
    • Variable : Utilisez une variable numérique comme index pour l'opération de lecture. Dans ce cas, sélectionnez une variable scalaire numérique pour déterminer la position de la lecture.
    • Fin du Tableau : Lire depuis la fin du tableau.
  • Variable de Sortie : Sélectionnez une variable scalaire où la valeur lue sera stockée.

Action Ajouter / Supprimer des Éléments d'un 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, tapez dans la position du tableau où les entrées doivent être insérées/supprimées. (basé sur 1).
    • Variable : Utilisez une variable numérique comme index pour l'opération d'insertion/suppression. Dans ce cas, sélectionnez une variable scalaire numérique 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 : Supprimera 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 variables 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/changer une valeur dans un tableau.

Paramètres :

  • Variable de Tableau : Variable de tableau dans laquelle une valeur doit être modifiée
  • Type d'Index : Détermine quel type d'index est utilisé.
    • Fixe : Utilisez un index fixe pour l'opération de remplacement. Dans ce cas, tapez dans la position du tableau qui doit être changée (basé sur 1).
    • Variable : Utilisez une variable numérique comme index pour l'opération de remplacement. Dans ce cas, sélectionnez une variable scalaire numérique pour déterminer la position de l'opération de remplacement.
    • Fin du Tableau : Remplacez la dernière entrée dans le tableau.
  • Variable d'Entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.

Action Mélanger les Éléments du Tableau

Effet : Remanie l'ordre des entrées dans un tableau.

Paramètres : Aucun

Opérations sur les Cadres de Données

Action Lire depuis / Écrire dans un Cadre de Données

Effet : Lit des valeurs depuis ou écrit des valeurs dans un cadre de données et les enregistre dans une nouvelle variable de tableau.

Paramètres :

  • Variable de Cadre de Données : sélectionnez la variable du cadre de données à lire.
  • Lire ou Écrire : Choisissez de lire depuis le cadre de données sélectionné ou d’écrire dans le cadre de données sélectionné.
  • Par ligne ou colonne : Choisissez comment les données doivent être lues.
  • Type d'Index : Choisissez le type de variable d'index qui sera utilisé pour lire le cadre de données. Peut être fixe, variable ou la dernière ligne.
  • Variable d'Index : Choisissez la variable qui sera utilisée comme index pour lire le cadre de données.
  • Variable de Sortie : Choisissez la variable où les données lues/écrites seront stockées en tant que sortie. Doit être une variable de tableau.

Action Mélanger les Éléments du Cadre de Données

Effet : Mélange l'ordre des entrées dans le cadre de données.

Paramètres :

  • Sélectionnez le cadre de données à mélanger.
  • Sélectionnez si le cadre de données doit être mélangé par lignes ou par colonnes.

Actions de Saut

Action Sauter À

Effet : "Saute" le participant à une étape différente de l'expérience. Cette action peut changer l'ordre des essais et des tâches dans une expérience et peut être utilisée pour créer une logique expérimentale individualisée pour chaque participant.

Paramètres :

  • Sauter À : Détermine où sauter dans l'expérience.
    • Prochaine Frame : Saute à la prochaine frame. S'il n'y a plus de frames définies dans un essai, il sautera à la première frame 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.
    • Frame Précédente : Saute à la frame précédente. S'il n'y a pas de frames précédentes, l'action ne sera pas exécutée.
    • Frame Spécifique : Saute à une frame spécifique. Les utilisateurs sélectionnent directement la frame à laquelle sauter.
    • Essai Spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro de l'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 Obligatoires Avant : Si activé, l'expérience vérifiera si toutes les réponses requises ont déjà été données. Sinon, l'action de saut n'est pas exécutée.

Action Accepter/Terminer la Session

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

Paramètres :

  • Enregistrer les données de l'essai avant de terminer la session : Si activé, les données du dernier essai seront stockées (envoyées au serveur) avant de quitter l'étude.
  • Afficher la page de fin par défaut : Si activé, l'écran de fin par défaut de Labvanced apparaîtra. Si c'est une session de crowdsourcing (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 montré la frame actuelle 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 devraient 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 pour que cette action fonctionne.

Actions de Contrôle

Actions de Conditions (Si... Alors... Sinon Si)

Effet : Évalue une déclaration si-alors et exécute une série d'actions de manière dépendante. Chaque déclaration Si/Sinon-Si consiste en des comparaisons AND / OR imbriquées pour évaluer si toutes les conditions sont remplies (la déclaration est vraie) ou non (la déclaration est fausse). Si la déclaration est vraie, les actions sous "Alors" sont exécutées.

Paramètres :

  • Ajouter une Condition : Ajouter une nouvelle condition à une déclaration. Le menu "sélection de valeur" apparaîtra des deux côtés pour faire une comparaison logique. Au milieu de la déclaration, vous pouvez choisir comment les deux côtés doivent être comparés (par exemple, égal, inférieur à, inégal, etc.).
  • Ajouter un Groupe OU : Seule une des conditions au sein d'un Groupe OU doit être vraie 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 dans un Groupe ET doivent être vraies pour que le groupe entier soit vrai. Ajoutez un groupe ET si les sous-actions ne doivent être exécutées que lorsque plusieurs conditions sont remplies.
  • Séquence d'Action : Chaque déclaration Si / Sinon-Si a une liste d'actions, qui sont définies sous "Alors". La séquence d'actions liste toutes les actions pour une certaine déclaration Si / Sinon-Si. Une nouvelle action peut être ajoutée via l'icône "Ajouter Action". La séquence d'actions ne sera exécutée que si les conditions de la déclaration Si / Sinon-Si associée sont remplies.
  • Ajouter un Cas Sinon-Si : L'Action de Condition peut consister en plusieurs déclarations If / Else-If distinctes. Cependant, une seule déclaration peut être exécutée. Si une déclaration 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 Sinon (vrai/faux) : Si activé, une option par défaut/d'exception est ajoutée à l'action de condition. Si aucune des déclarations If / Else-If n'est exécutée (retournée vraie), les actions définies dans le cas sinon seront exécutées.

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 spécifiée pour que l'exécution de la boucle s'arrête.

Paramètres :

  • Type d'Exécution : Choisissez entre l'exécution immédiate ou l'exécution chronométrée
    • Exécuter l'ensemble de la boucle : Cette option exécutera la boucle continuellement jusqu'à ce que la condition d'arrêt soit remplie.
    • Exécuter toutes les ... ms : Cette option exécutera la boucle avec un intervalle défini (par exemple, la boucle est exécutée toutes les 50 ms).
  • Définir le nombre de boucles : Lorsque "Exécuter toutes les ... ms" est sélectionné, les utilisateurs ont la possibilité d'assigner une valeur numérique entière pour le nombre de fois que la boucle devrait ê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 tout de suite. Si désactivé, la boucle sera démarrée lors du prochain intervalle d'exécution.
  • Autoriser plusieurs démarrages (vrai/faux) : Si activé, plusieurs instances de boucle peuvent être démarrées en parallèle. Si désactivé, seule une instance de boucle peut être exécutée à la fois.
  • Activer la condition d'arrêt (vrai/faux) : Si activé, une condition d'arrêt pour la boucle peut être spécifiée.
  • Condition d'Arrêt : La condition d'arrêt peut être utilisée pour spécifier une expression logique pour déterminer quand l'exécution de la boucle doit être arrêtée. Semblable aux déclarations If / Else-If, on peut combiner des groupes AND, des groupes OR et des Conditions 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 Action".

Actions Retardées (Callback de Temps)

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

Paramètres :

  • Type de Retard : Choisissez entre un retard fixe ou un retard variable
    • Retard Fixe : Les actions seront exécutées après un retard fixe.
    • Retard Variable : Les actions seront exécutées après un retard spécifié dans une variable (numérique).
  • Retard : La durée du retard en millisecondes (ms).
  • Séquence d'Action : La séquence d'actions liste toutes les actions qui sont exécutées après le retard spécifié. Une nouvelle action peut être ajoutée via l'icône "Ajouter Action".

Groupe d'Action

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 :

ajouter un groupe d'actions

groupes d'actions dans la fenêtre des événements

Actions API

Si vous avez besoin d'envoyer ou de communiquer des données d'un serveur externe à Labvanced, alors les ‘Actions API’ et les ‘Déclencheurs API’ peuvent être utilisés. Vous disposez des actions suivantes disponibles dans cette catégorie :

  • Envoyer au Websocket
  • Envoyer à OpenAI

Pour que ces actions soient ‘disponibles’ ou utilisables, vous devez saisir une clé API dans l'onglet des Paramètres.

L'Action API dans le menu d'action Labvanced.

Action Envoyer au Websocket

L'Action Envoyer au Websocket dans le menu d'action Labvanced.

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

Options pour l'action Envoyer au Websocket.

L'exemple ci-dessus et la structure entière de l'événement peuvent être consultés ici : https://www.labvanced.com/page/library/51053 en cliquant sur ‘Inspecter.’

Élément de MenuDescription
Envoyer À :Spécifiez l'adresse Websocket qui est listée dans l'onglet Paramètres sous Fonctionnalités Spéciales.
Déclencheur / message à envoyer :Spécifiez le déclencheur ou le message que vous souhaitez envoyer.
Envoyer Variable (optionnel) :Indiquez la variable qui peut également être envoyée dans le cadre de l'action.

Pour plus d'informations sur l'accès API, veuillez visiter cette page.

Action Envoyer à OpenAI

L’action ‘Envoyer à OpenAI’ vous permet d’envoyer des informations, telles qu’une valeur d’entrée sous forme de chaîne, à OpenAI. Veuillez noter que pour que cette option soit disponible, vous devez indiquer votre clé API dans l'onglet Paramètres sous Fonctionnalités Spéciales.

L'Action Envoyer à OpenAI dans le menu d'action Labvanced.

Les options suivantes apparaîtront en cliquant sur cet événement :

Options pour l'action Envoyer à OpenAI.

Voici un exemple fonctionnel de à quoi ressemble cet événement lorsque toutes les informations nécessaires sont fournies :

Exemple de l'action Envoyer à OpenAI étant utilisée.

Pour une meilleure compréhension de la manière dont vous pouvez utiliser cette fonctionnalité et la voir en action, n'hésitez pas à nous contacter pour une démo en soumettant ce formulaire de contact.

NOTE : Référez-vous également à cette présentation 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 à OpenAI' :

Élément de MenuZone de MenuOptions de l'Action 'Envoyer à OpenAI'
Type de ModèleListe déroulante de type de modèle Spécifie le modèle d'IA qui sera utilisé.

Cadre de Données de l'Historique de ChatChamp pour spécifier la variable du cadre de donnéesLien vers une variable cadre de données avec deux colonnes. La première colonne dénote le ‘rôle’ et la seconde colonne le ‘message de chat.’ Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici.

Le cadre de données peut également être manipulé avec des actions de cadre de données. Pour plus de références, veuillez consulter les docs d'OpenAI.
Insérer Message ‘+’ L'icône d'insérer un 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é :
  • système : fait référence au système ChatGPT de haut niveau
  • utilisateur : le participant
  • assistant : fait référence à un sous-rôle spécifique créé au sein du système

Alors qu'OpenAI évolue quotidiennement, veuillez consulter la documentation 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

Les Actions de Code dans le menu d'actions Labvanced.

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é en tant qu'action lorsqu'il sera déclenché.

L'Action Exécuter JavaScript dans le menu d'actions Labvanced.

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 :

L'éditeur de code JavaScript dans Labvanced.

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 en fonction d'un déclencheur.

L'Action Définir CSS global dans le menu d'actions Labvanced.

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

L'éditeur de code CSS dans Labvanced.

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 multiple.

Action Coller

Cette option vous permet de coller une action que vous avez précédemment créée et copiée. Elle vous permet de travailler plus rapidement lors de la conception de votre expérience afin de ne pas avoir à sélectionner plusieurs fois les mêmes éléments. Par exemple, si vous avez un événement similaire à un déjà existant, vous pouvez simplement le copier, le coller et le modifier, au lieu de le construire depuis le début.

Le Menu de Sélection de Valeurs

Lorsque vous travaillez avec certains événements, vous remarquerez qu'une icône de stylo apparaît. Cela s'appelle le Menu de Sélection de Valeurs car il vous permet de sélectionner et d'instruire quel type de valeurs doivent être enregistrées ou suivies. C'est une option très puissante et importante que vous êtes sûr d'utiliser pour votre conception et configuration expérimentales.

Cette icône de stylo / Menu de Sélection de Valeurs apparaît à divers endroits pour certaines actions dans le système d'événements, comme l'action Définir / Enregistrer Variable, l'action Définir Propriété d'Objet, et l'action Exigence (Si... Alors), comme indiqué ci-dessous.

L'emplacement de la sélection de valeur dans Labvanced.

Cliquer sur l'icône du stylo ouvre un menu déroulant dans lequel 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.

Le Menu de Sélection de Valeurs dans Labvanced

L'image ci-dessus montre à quoi ressemble le Menu de Sélection de Valeurs lorsque l'un des Déclencheurs 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égorieOptionsDescription
Valeur spécifique au déclencheurDépend du type de déclencheur que vous avez préalablement sélectionné pour l'événement.En fonction du déclencheur que vous avez sélectionné pour un événement, vous aurez une liste spécifique d'options qui apparaîtra en haut du menu de sélection de valeurs à choisir. Veuillez vous référer à la section sur Valeurs spécifiques au déclencheur pour voir une liste complète des options et descriptions.
Heure actuelle
  • Horodatage UNIX
  • Temps depuis le début du cadre
Mesurez et appelez des valeurs temporelles.
Valeur constante
  • Chaîne
  • Numérique
  • Booléen
  • Categorical
  • Date
  • Temps
  • Couleur
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
  • Sélectionner Variable
  • Sélectionner Valeur dans Tableau
  • Sélectionner Valeur dans Data Frame
Spécifiez ou référez-vous à une variable ou sélectionnez une valeur dans un tableau ou un cadre de données.
Cadre / Tâche / Objet
  • Propriété d'Objet
  • Cadre
  • Suivi Oculaire
  • Appareil
Vous permet de récupérer des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (si activé), et à l'appareil (fréquence de rafraîchissement de l'écran).
Opérations
  • Arithmétique
  • Opération sur chaîne
  • Opération Mathématique
Utilisez des opérations pour effectuer des changements spécifiés sur vos variables, comme combiner les valeurs de variables, transformer des chaînes pour qu'elles soient toutes en minuscules, ou effectuer des opérations mathématiques.

Valeurs de Temps Actuel

Avec l'option « Heure actuelle », vous pouvez enregistrer ou vous référer à des valeurs concernant le temps.

Les options suivantes sont disponibles :

  • Horodatage UNIX
  • Temps depuis le début du cadre

Temps Actuel : Horodatage UNIX

Cette valeur capture un horodatage au 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 :

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

Constante : Chaîne

Attribue une valeur chaîne / texte.

Constante : Numérique

Attribue une valeur numérique / nombre.

Constante : Booléen

Attribue une valeur vraie ou fausse.

Constante : Catégorique

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

Constante : Date

Attribue une valeur de date.

Constante : Temps

Attribue une valeur de temps.

Constante : Couleur

Attribue une couleur (valeur hexadécimale).

Valeurs des Variables

Spécifiez ou référez-vous à une variable ou sélectionnez une valeur dans un tableau ou un cadre de données. Les options suivantes sont disponibles :

  • Sélectionner Variable
  • Sélectionner Valeur dans Tableau
  • Sélectionner Valeur dans Data Frame

Sélectionner Variable

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

Sélectionner Valeur dans Tableau

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

Sélectionner Valeur dans Data Frame

Vous permet de sélectionner une valeur dans 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 oculaire (si activé), et à l'appareil (fréquence de rafraîchissement de l'écran).

  • Propriété d'Objet
  • Cadre
  • Suivi Oculaire
  • Appareil

Propriété d'Objet

Lit une propriété d'objet.

Cadre

Options de Valeurs de CadreDescription
Dernière Position X de Souris mise en cacheLa dernière valeur de coordonnée X de la souris du participant.
Dernière Position Y de Souris mise en cacheLa dernière valeur de coordonnée Y de la souris du participant.
Dernier [X,Y] Tableau de Souris mis en cacheLa dernière valeur de coordonnées [X,Y] de la souris du participant au format tableau.
Nom de CadreLe nom du cadre.

Suivi Oculaire

Options de Valeurs de Suivi OculaireDescription
Dernière Coordonnée X mise en cacheLa dernière valeur de coordonnée X du regard du participant.
Dernière Coordonnée Y mise en cacheLa dernière valeur de coordonnée Y du regard du participant.
Dernière [X,Y] Coordonnée mise en cacheLa dernière valeur de coordonnées [X,Y] du regard du participant au format tableau.
Dernière Coordonnée + Temps [X,Y,T] TableauLa dernière valeur de coordonnées [X,Y] du regard du participant, plus la valeur de temps de Capture Camera 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, tels que combiner des valeurs de variables, transformer des chaînes pour qu'elles soient toutes en minuscules, ou effectuer des opérations mathématiques.

Les options suivantes sont disponibles :

  • Arithmétique
  • Opération sur Chaîne
  • Opération Mathématique

Arithmétique

Les opérations arithmétiques sont utiles à de nombreux objectifs différents, notamment la combinaison de chaînes et même la modification des propriétés d'objet.

Le menu Arithmétique dans Labvanced.

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

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

L'emplacement de l'option Arithmétique dans Labvanced.

Les valeurs peuvent être manipulées en utilisant ces 5 opérations différentes :

  • (+) addition
  • (-) soustraction
  • (/) division
  • (*) multiplication
  • (%) modulo

L'exemple ci-dessous montre comment utiliser des opérations arithmétiques pour créer une nouvelle variable de chaîne (dans le bouton vert), appelée 'intermediateVar'.

Exemple d'opérations arithmétiques utilisées pour créer une nouvelle variable de chaîne.

La nouvelle valeur de variable (de 'intermediateVar') est définie en utilisant plusieurs opérations arithmétiques avec une combinaison de variables précédemment 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 vide <br>. Cette action crée l'effet d'un chat utilisateur qui peut être utilisé dans une étude multi-utilisateurs.

Opération sur Chaîne

Options d'Opération sur ChaîneDescription
En minusculesChange toutes les lettres d'une variable de chaîne en petites lettres.

→ Ex : (AAABBB) se transforme en (aaabbb)
En MajusculesChange toutes les lettres d'une variable de chaîne en lettres majuscules.

→ Ex : (aaabbb) se transforme en (AAABBB)
En LienTransforme la chaîne dans une variable en une URL qui s'ouvre dans une autre fenêtre
Supprimer les EspacesSupprime tout espace entre les lettres d'une variable de chaîne.

→ Ex : (aaa bbbb cccc) se transforme en (aaabbbbccc)
Retirer les EspacesSupprime les espaces au début d'une variable de chaîne.

→ Ex : ( aaabbbcccc) se transforme en (aaabbbcccc)
Remplacer Sous-chaîne RegexpRemplace 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ématiqueDescription
absRenvoie le nombre absolu d'une valeur.
sqrtRenvoie la racine carrée d'une valeur.
roundRenvoie la valeur arrondie avec 0 à 3 décimales.
floorRenvoie la valeur arrondie à l'entier le plus bas.
ceilRenvoie la valeur arrondie à l'entier le plus élevé.
cosRenvoie la valeur du cosinus.
sinRenvoie la valeur du sinus.
tanRenvoie la valeur de la tangente.

Valeurs Spécifiques au Déclencheur

Les valeurs spécifiques au déclencheur font référence à 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, 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 souris dans le menu de sélection de valeurs.

Dans l'exemple ci-dessous, des valeurs spécifiques au déclencheur souris sont utilisées pour enregistrer des valeurs x et y ainsi qu'un tableau [X,Y] en utilisant une action Définir / Enregistrer Variable.

Démonstration de l'utilisation des valeurs spécifiques au déclencheur souris pour capturer le suivi des souris.

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.

NomOptions de Valeur - Vue d'ensemble
Déclencheur (Souris)
  • Souris X
  • Souris Y
  • Tableau [X,Y] de Souris
  • Nom du Stimulus
  • Info du Stimulus
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Clavier)
  • Id de la Touche
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre) li>
Déclencheur (Barre de Boutons)
  • Nom du Stimulus
  • Info du Stimulus
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Entrée sur Input)
  • Id de la Touche
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Défilement)
  • Nom du Stimulus
  • Info du Stimulus
  • Position de Défilement X
  • Position de Défilement Y
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Manette / Joystick)
  • Id de l'Appareil Manette
  • Touches enfoncées (Tableau)
  • Touches enfoncées ou maintenues (Tableau)
  • Touches relâchées (Tableau)
  • Axes (Tableau)
  • Horodatage de la Manette (Temps Unix)
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Suivi Oculaire)
  • Coordonnée X
  • Coordonnée Y
  • Tableau [X,Y] de Coordonnée
  • Nom du Stimulus
  • Info du Stimulus
  • Temps de Capture Camera T
  • Confiance du Regard C
  • Coord. + Temps [X,Y, T] Tableau
  • Coord. + Temps + Confiance [X,Y, T,C] Tableau
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Fixation de Suivi Oculaire)
  • Centroid X de Fixation
  • Centroid Y de Fixation
  • Durée de Fixation
  • Temps de Début de Fixation
  • Temps de Fin de Fixation
  • Dispersion de Fixation
  • Nom du Stimulus
  • Info du Stimulus
  • [X,Y, Dur, Début, Fin, Disp]
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Suivi de Tête)
  • Temps de Capture Camera T
  • Rotation de la Tête
  • Inclinaison de la Tête
  • Roulement de la Tête
  • Position de la Tête [X,Y, T] Tableau
  • Position du Nez [X,Y, T] Tableau
  • Vecteur de Nez [X,Y, Z, T] Tableau
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur depuis le Début du Cadre
Déclencheur (Lors de l'Initialisation de la Tâche)
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Lors de l'Initialisation du Cadre)
  • Numéro de l'Essai
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (au Début du Cadre)
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (À la Fin du Cadre)
  • Temps Total du Cadre
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Valeur de Variable Changée)
  • Nouvelle Valeur dans la Variable
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Objet Média)
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Déclencheur Websocket)
  • Message
  • Données
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Déclencheur OpenAI)
  • Réponse de Chat GPT
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (Événement d'Expérience Globale)
  • Temps Total du Cadre
  • Raison de l'Événement Global
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)
Déclencheur (L'utilisateur quitte l'expérience)
  • Nombre de Participants Restants
  • Horodatage du Déclencheur (Temps Unix)
  • Temps du Déclencheur (Depuis le début du cadre)

Déclencheur (Souris) Valeurs

Lorsque l'on utilise un déclencheur de souris, les valeurs spécifiques au déclencheur peuvent être appelées lors de l'utilisation de certaines actions :

Les options de valeurs de déclencheur souris disponibles

Options de Déclencheur (Souris)Description
Souris XRenvoie la position actuelle de la souris X en coordonnées du cadre.
Souris YRenvoie la position actuelle de la souris Y en coordonnées du cadre.
Tableau [X,Y] de SourisLes coordonnées [X,Y] de la souris au format tableau.
Nom du StimulusLe nom de l'objet qui a déclenché l'événement (par exemple, quelle image a été cliquée).
Info du StimulusLes informations de stimulus de l'objet qui a déclenché l'événement.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur.

Déclencheur (Clavier) Valeurs

Lorsque l'on utilise un déclencheur de clavier, 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 ToucheLa valeur ID de la touche qui a été enfoncée comme déclencheur.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur.

Déclencheur (Barre de Boutons) Valeurs

Lorsque l'on utilise un déclencheur de clic de bouton, 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 StimulusLe nom de l'objet bouton qui a déclenché l'événement.
Info du StimulusLes informations de stimulus de l'objet bouton qui a déclenché l'événement.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur.

Déclencheur (Entrée sur Input) Valeurs

Lorsque l'on utilise un déclencheur d'entrée sur input, 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 ToucheLa valeur ID de la touche qui a été enfoncée comme déclencheur.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur.

Déclencheur (Défilement) Valeurs

Lorsque l'on utilise un déclencheur de défilement, 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 StimulusLe nom de l'objet bouton qui a déclenché l'événement.
Info du StimulusLes informations de stimulus de l'objet bouton qui a déclenché l'événement.
Position de Défilement XLa position de défilement en X de la souris lorsque l'événement a été déclenché.
Position de Défilement YLa position de défilement en Y de la souris lorsque l'événement a été déclenché.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur de défilement au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur de défilement.

Déclencheur (Manette / Joystick) Valeurs

Lorsque l'on utilise un déclencheur de manette/joystick, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

option de menu de déclencheur de manette

Options de Déclencheur (Manette / Joystick)Description
Id de l'Appareil ManetteL'ID ou le nom de la manette qui était connectée.
Touches enfoncées (Tableau)Les touches qui ont été enfoncées.
Touches enfoncées OU maintenues (Tableau)Les touches qui ont été enfoncées ou maintenues.
Touches relâchées (Tableau)Les touches qui ont été relâchées.
Axes (Tableau)Les valeurs des axes.
Horodatage de la Manette (Temps Unix)L'horodatage de la manette au format Temps Unix.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur au format Temps Unix.
Temps du Déclencheur (Depuis le début du cadre)L'horodatage au format Temps Unix de l'occurrence du déclencheur par rapport au début du cadre.

Déclencheur (Suivi Oculaire) Valeurs

Lorsque l'on utilise un déclencheur de suivi oculaire, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Les options de valeurs de déclencheur de regard

Options de Déclencheur (Suivi Oculaire) Description
Coordonnée XLa valeur de la coordonnée X du regard.
Coordonnée YLa valeur de la coordonnée Y du regard.
Tableau [X,Y] de CoordonnéeLes coordonnées du regard X,Y au format tableau.
Nom du StimulusLe nom du stimulus qui a initié le déclencheur de regard.
Info du StimulusLes informations de stimulus concernant le stimulus qui a initié le déclencheur de regard.
Temps de Capture Camera TLe temps exact où la capture a eu lieu. Dans le pipeline de suivi oculaire Labvanced, une capture par caméra se produit d'abord avant que l'algorithme et le réseau neuronal effectuent des calculs de regard. Ainsi, le Temps de Capture Camera T est un horodatage UNIX du moment où la capture initiale a eu lieu. Pour plus d'informations concernant la technologie derrière notre suivi oculaire basé sur webcam, veuillez vous référer à notre page de technologie ET.
Confiance du Regard CCette 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 instantanée et sert essentiellement de « détecteur de clignement ». Veuillez vous référer à notre article publié et évalué par les pairs pour plus de détails.
Coord. + Temps [X,Y,T] TableauUn 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] TableauUn 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 (Temps Unix)L'horodatage de l'occurrence du déclencheur du regard au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur de regard.

Déclencheur(Suivi Oculaire) Valeurs

Lorsque l'on utilise un déclencheur de fixation de suivi oculaire, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Fixation de Suivi Oculaire)Description
Centroid X de FixationLe point central de la fixation en valeur X.
Centroid Y de FixationLe point central de la fixation en valeur Y.
Durée de FixationLa durée de la fixation détectée.
Temps de Début de FixationLe temps de début de la fixation détectée.
Temps de Fin de FixationLe temps de fin de la fixation détectée.
Dispersion de FixationFait référence à la dispersion des valeurs de regard au sein d'une fixation détectée.
Nom du StimulusLe nom de l'objet bouton qui a déclenché l'événement.
Info du StimulusLes informations de 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 (Temps Unix)L'horodatage de l'occurrence du déclencheur de fixation au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur de fixation.

Déclencheur (Suivi de Tête) Valeurs

Lorsque l'on utilise un déclencheur de suivi de tête, 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 Camera TQuand la caméra a capturé le cadre, c'est-à-dire un horodatage UNIX du moment où la capture de cadre a eu lieu. C'est le temps auquel l'image / cadre a été capturé avant tout traitement.
Rotation de la TêteRotation de la tête de gauche à droite, cela est désigné comme le tangage dans la littérature.
Inclinaison de la TêteInclinaison de la tête de haut en bas, connu comme l'inclinaison de la tête dans la littérature.
Roulement de la TêteCapture le mouvement de la tête roulant de côté à côté.
Position de la Tête [X,Y, T] TableauCe tableau capture les valeurs numériques associées à la position de la tête, cela inclut les coordonnées x et y pour le centre de la tête ainsi que la variable d'horodatage (T).
Position du Nez [X,Y, T] TableauCe tableau capture les valeurs numériques associées à la position spécifiquement du nez, cela inclut les coordonnées x et y pour l'endroit où se situe le nez ainsi que la variable d'horodatage (T) du moment où la mesure a eu lieu.
Vecteur de Nez [X,Y, Z, T] TableauCette mesure fonctionne en projetant un vecteur depuis la pointe du nez et est utile pour tester si le participant fait attention à 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'est pas attentif à l'expérience), la valeur Z diminue de 1 et se rapproche de 0.
Horodatage du Déclencheur (Temps Unix)Moment durant l'expérience où le déclencheur se produit où le suivi de tête a été détecté et compte pour le moment où le déclencheur a eu lieu dans le système. Essentiellement, c'est le moment où le traitement de l'image / du cadre est 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 du CadreC'est la valeur temps de quand le déclencheur s'est produit par rapport à quand le début du cadre s'est produit.

Déclencheur (Lors de l'Initialisation de la Tâche) Valeurs

Lorsque l'on utilise un déclencheur d'initialisation de tâche, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Lors de l'Initialisation de la Tâche)Description
Horodatage du Déclencheur (Temps Unix)L'horodatage UNIX du déclencheur en millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre.

Déclencheur (Lors de l'Initialisation du Cadre) Valeurs

Lorsque l'on utilise un déclencheur d'initialisation du cadre, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Lors de l'Initialisation du Cadre)Description
Numéro de l'EssaiLe Numéro de l'Essai lorsque le Déclencheur d'Initialisation du Cadre s'est produit.
Horodatage du Déclencheur (Temps Unix)L'horodatage UNIX du déclencheur en millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre.

Déclencheur (au Début du Cadre) Valeurs

Lorsque l'on utilise un déclencheur de début de cadre, 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 (Temps Unix)L'horodatage UNIX du déclencheur en millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre.

Déclencheur (À la Fin du Cadre) Valeurs

Lorsque l'on utilise un déclencheur de fin de cadre, 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 CadreLe temps total en millisecondes passé sur le cadre.
Horodatage du Déclencheur (Temps Unix)L'horodatage du déclencheur en millisecondes au format Temps Unix.
Temps du Déclencheur (Depuis le début du cadre)Le temps en millisecondes de quand le déclencheur s'est produit depuis le début du cadre.

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

Lorsque l'on utilise un Déclencheur de Valeur de Variable Changée, 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 VariableFait référence à la nouvelle valeur d'une variable.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur de changement de variable au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du changement de valeur de la variable.

Déclencheur (Objet Média) Valeurs

Lorsque l'on utilise un Déclencheur d'Objet Média, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Objet Média)Description
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur d'objet média au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur d'objet média.

Déclencheur (Déclencheur Websocket) Valeurs

Lorsque l'on utilise un Déclencheur Websocket, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Websocket)Description
MessageUn message qui peut être utilisé pour décrire et étiqueter, ce qui vous permet (à la fin de la réception) de filtrer entre différents types de données.
DonnéesUne valeur qui peut contenir différents types de données, telles que les choix des participants, des horodatages, des coordonnées x/y de la souris, etc.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur Websocket au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur Websocket.

Déclencheur (Déclencheur OpenAI) Valeurs

Lorsque l'on utilise un Déclencheur OpenAI, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (OpenAI)Description
Réponse Chat GPTLa valeur de la réponse de ChatGPT.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur OpenAI au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur OpenAI.

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

Lorsque l'on utilise un Déclencheur de Pause / Reprise d'Expérience, 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 d'Expérience Globale)Description
Temps Total du CadreFait référence au Temps Total du Cadre qui a été alloué avant le Déclencheur.
Raison de l'Événement GlobalUne valeur chaîne qui déclare la raison du déclencheur, telle que le départ d'un participant de l'étude.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur d'Événement Global au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur d'Événement Global.

Déclencheur (L'utilisateur quitte l'expérience) Valeurs

Lorsque l'on utilise un Déclencheur de Participant A quitté l'Étude Multiutilisateurs, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (L'utilisateur quitte l'expérience)Description
Nombre de Participants RestantsLe nombre de participants restants dans l'étude.
Horodatage du Déclencheur (Temps Unix)L'horodatage de l'occurrence du déclencheur L'utilisateur quitte l'expérience au format Temps Unix avec millisecondes.
Temps du Déclencheur (Depuis le début du cadre)Le temps écoulé en millisecondes mesuré depuis le début du cadre jusqu'à l'occurrence du déclencheur L'utilisateur quitte l'expérience.
Prev
Objets
Next
Variables