labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Behavioral Psychology
      • Personality & Social Psychology
      • Cognitive & Neuro Psychology
      • Developmental & Educational Psychology
      • Clinical & Health Psychology
      • Sports & Movement Psychology
      • Marketing & Consumer Psychology
    • 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
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Public Experiment Library
    • Labvanced Sample Studies
  • 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
Tutoriels
FAQ
Notes de version
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
Guide
Vidéos
Tutoriels
FAQ
Notes de version
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • Guide
    • DÉMARREZ

      • 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 & Équilibre
      • Suivi oculaire
      • Application de bureau
      • Études d'exemple
      • Recrutement de participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres sujets

        • Temps de stimuli précis
        • Études multi-utilisateurs
        • Suivi de la Tête dans Labvanced | Guide
    • ONGLETS PRINCIPAUX DE L'APPLICATION

      • Vue d'ensemble : Onglets principaux
      • Tableau de bord
      • Mes études
      • Études partagées
      • Mes fichiers
      • Bibliothèque d'expériences
      • Mon compte
      • Ma licence
    • ONGLETS D'ÉTUDE

      • Vue d'ensemble : Onglets spécifiques à l'étude
      • Conception de l'étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
      • Éditeur de tâche
        • Fonctions Principales et Paramètres
        • Le Système d'Essais
        • 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 de l'étude
        • Démarrage et Paramètres Principaux
        • Paramètres des navigateurs et des appareils
        • Paramètres des fonctionnalités d'expérience
      • Description
        • Plus de détails sur les informations de description
        • Images, Liens et Références dans les Descriptions
      • Variables
      • Médias
      • Traduire
      • Exécuter
      • Publier et enregistrer
        • Exigences pour laPublication d'une Étude dans Labvanced
        • Recrutement de Participants et Crowdsourcing
        • Sélection et Confirmation de la Licence
        • Après la publication de votre étude Labvanced
      • Partage
      • Participants
      • 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
    • Vue d'ensemble des vidéos
    • Démarrer avec Labvanced
    • Création de tâches
    • Vidéos d'éléments
    • Événements & Variables
    • Sujets avancés
  • Guides pratiques
    • Introduction
    • Tâche de Stroop
    • Tâche de décision lexicale
    • Tâche de cueing visuel de Posner
    • Paradigme de clignotement de cécité au changement
    • Étude d'exemple de suivi oculaire
    • Étude de suivi oculaire des nourrissons
    • Étude de capture d'attention avec suivi de souris
    • Présentation visuelle sérielle rapide
    • Étude ChatGPT
    • Démonstration de suivi oculaire : SVG comme AOIs
    • Démonstration multi-utilisateur : Afficher les curseurs des sujets
    • Configuration de base du contrôleur de jeu/joystick
    • Étude d'application de bureau avec intégration EEG
  • FAQ
    • Fonctionnalités
    • Sécurité & Confidentialité des données
    • Licences
    • Précision de Labvanced
    • Utilisation programmatique & API
    • Utilisation de Labvanced hors ligne
    • Dépannage
    • Questions sur la création d'études
  • Notes de version
  • Salle de classe

Système d'Événements

Description

Le Système d'Événements est essentiel pour toute étude. C'est ainsi que vous configurez des 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 est composé de déclencheurs et d'actions. Ici, vous configurez des règles, comme ‘lorsque cela se produit’ (déclencheur), alors ‘faites cela’ (action). Par exemple : si un participant clique sur une image spécifique (déclencheur), alors montrez une image différente et aléatoire (action).

Aperçu de l'utilisation des déclencheurs et des actions dans Labvanced.

Pour une introduction sur le fonctionnement des événements dans Labvanced, veuillez consulter cette vidéo rapide :

Création d'Événements - Aperçu

Les événements sont gérés dans l'Éditeur de Tâches sous l'onglet "Événements" dans le coin supérieur droit. De nouveaux événements peuvent être créés en cliquant sur + Événement Image pour des événements qui devraient se produire sur cette image, ou en cliquant sur + Événement Essai qui applique l'événement à toutes les images. Tous les événements existants sont affichés dans une vue liste dans 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

Quoi qu'il en soit, un événement est toujours défini pour tous les essais dans un groupe d'essais pour le(s) cadre(s) spécifié(s). Cependant, une logique personnalisée permet aux utilisateurs d'exécuter des événements uniquement dans certains essais, conditions ou dans d'autres circonstances.

La vidéo ci-dessous donne un aperçu des déclencheurs et des actions disponibles dans Labvanced :

L'ordre d'exécution des événements peut être ajusté. Par défaut, les événements ayant le même déclencheur sont plus en haut de la liste et seront exécutés en premier. Les événements peuvent également être copiés et supprimés. En sélectionnant un événement existant, les spécificités sont affichées dans le panneau inférieur droit (Propriétés de l'événement). Pour une meilleure vue d'ensemble, les événements existants peuvent également être rouverts (icône à côté du champ de nom).

Déclencheurs

Le déclencheur définit quand l'événement sera exécuté. Cela pourrait être un clic de souris sur un objet particulier, une certaine saisie au clavier, un changement de variable, le début d'un fichier vidéo, ou bien d'autres choses. Tous les déclencheurs et leurs paramètres sont expliqués dans la liste suivante :

Catégorie de Déclencheur Options de Déclencheur Description
Déclencheurs d'Entrée Utilisateur
  • Déclencheurs de Souris
  • Déclencheurs de Clavier
  • Clics sur Boutons
  • Entrée sur Saisie
  • Déclencheur de Défilement
  • Déclencheur de Manette/Joystick
Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur pouvant être activé manuellement par l'utilisateur/participant en faisant quelque chose comme déplacer leur souris, cliquer sur un élément de 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 le fait de regarder un élément spécifique ou des changements dans les mouvements de tête.
Déclencheurs d'Essai et d'Image
  • Init de Tâche
  • Init d'Image
  • Début d'Image
  • Fin d'Image
Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux images, comme quand une image commence ou se termine.
Déclencheur de Valeur de Variable ChangéeVariable (Valeur Changée)Un déclencheur pour l'événement se produit lorsqu'il y a un changement dans la valeur d'une variable spécifique.
Déclencheur d'Objet MédiasDéclencheur d'Objet MédiasCe déclencheur se produit par rapport aux objets médias, comme lorsqu'il y a une pause dans un fichier vidéo/audio, un enregistrement terminé, etc.
Déclencheurs API
  • Déclencheur Websocket
  • Déclencheur Open AI
Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API.
Déclencheurs Globaux
  • Pause / Reprendre l'Expérience
  • Participant a Quitte l'Étude Multiutilisateurs
Les déclencheurs globaux se réfèrent à tout changement majeur dans une expérience, comme le fait d'être mis en pause ou qu'un participant d'une étude multi-utilisateurs parte.

Déclencheurs d'Entrée Utilisateur

Les déclencheurs d'entrée utilisateur se réfèrent à tout déclencheur pouvant être activé manuellement par l'utilisateur/participant.

 Le 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 à venir.

Option de Déclencheur d'Entrée UtilisateurAperçu
Déclencheur de Souris Tout mouvement de souris peut être utilisé comme déclencheur pour initier un événement, tel que : défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou cibles spécifiques à un déclencheur. Par exemple, un clic de souris sera utilisé comme déclencheur uniquement si une image spécifique est cliquée.
Déclencheur de ClavierToute pression sur le clavier peut être utilisée comme déclencheur pour initier un événement. Vous pouvez spécifier des lettres ou des chiffres spécifiques du clavier comme déclencheurs.
Clics sur BoutonsLes objets de bouton créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements.
Entrée sur SaisieCe déclencheur est couramment utilisé lorsqu'un participant appuie sur 'Entrée' pendant une expérience, comme moyen de soumettre sa réponse écrite ou son entrée dans les zones de texte.
Déclencheur de DéfilementCe déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier les directions de défilement x ou y, ainsi que sur quels éléments le défilement se produit pour être utilisés comme déclencheurs d'événements.
Déclencheur de Manette/JoystickCe déclencheur vous permet d'utiliser des manettes et des contrôleurs de joystick dans votre conception expérimentale comme un appareil d'entrée pour l'enregistrement de données.

Déclencheur de Souris

L'option ‘Déclencheur de Souris’ est un déclencheur d'événement très populaire car elle initie un événement basé sur toute interaction de souris, telle que : déplacer la souris vers le haut/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 de 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 lors de l'utilisation des déclencheurs de souris :

Élément 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éclencheur de souris sont disponibles dans la liste déroulante :
  • Clic : Déclenché par un clic de souris
  • Pression : Déclenché par un appui de souris
  • Relâchement : Déclenché par un relâchement de souris
  • Survol : Déclenché par un survol d'objet
  • Quitter : Déclenché en quittant un objet
  • Déplacer : Déclenché par tout mouvement de souris
Bouton

liste déroulante :
Explication du paramètre de 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 des cibles de souris

Dans l'exemple ci-dessus, ‘Image_1’ est la cible du clic de bouton qui déclenchera l'événement.

Des cibles multiples peuvent être ajoutées en cliquant sur l'option ‘+Ajouter Cible’ en bas.
Lorsque vous spécifiez une cible, les options suivantes sont disponibles :
  • Déclencheur sur l'Arrière-Plan de l'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 tout élément de l'image.
  • Ajouter des Cibles : sélectionner les éléments spécifiques qui doivent être cliqués pour activer le déclencheur.
  • Note : Après avoir sélectionné le déclencheur de souris dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de souris spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheurs de Clavier

L'option ‘Déclencheur de Clavier’ est un autre moyen populaire d'avoir un déclencheur d'é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 défini pour être une pression sur le clavier qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont pressées :

Exemple du déclencheur de clavier utilisé.

Voici un aperçu complet des touches et options dont vous disposez lors de l'utilisation des déclencheurs de clavier :

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

liste déroulante :
Liste déroulante des actions de touches Voici les options d'action de clavier disponibles :
  • Pression de Touche : Déclenché par l'appui sur une touche (la touche est enfoncée)
  • Appuyer ou Maintenir la Touche : Déclenche lorsque la touche est enfoncée ou maintenue
  • Relâcher la Touche : Déclenché par le relâchement de la touche
Note : Une touche doit être relâchée avant qu'elle puisse être à nouveau "déclenchée".
Touches

les touches qui déclenchent l'événement
Zoom des options de touches.La touche utilisée comme déclencheur est spécifiée en sélectionnant les options ici en cliquant sur +Ajouter:
  • Flèches : les quatre touches fléchées
  • Nombres : Nombres de 0 à 9
  • Lettres : Toutes les lettres de l'alphabet anglais
  • Spécial : Touches spéciales (Entrée, Espace, Contrôle, Tab, Majuscule)
  • Touches F : F1 à F10
  • toute touche : toute 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 touches du pavé numérique permet d'utiliser les touches du pavé numérique comme déclencheurs dans l'expérience.

Pour l'option permettre la propagation des événements, 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 que le premier événement soit terminé.
  • Note : Après avoir sélectionné le déclencheur de clavier dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de clavier spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheur de Clic sur Bouton

Si vous avez un objet de bouton ou de navigation placé dans l'éditeur, vous pouvez les utiliser comme partie d'un événement où le clic sur le bouton agit comme un déclencheur pour une action.

Le menu de clic sur 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 sur bouton

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

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

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

Déclencheur d'Entrée sur Saisie

Déclenche lorsque : La touche Entrée/Retour est enfoncée sur le clavier pendant qu'un élément spécifique est actif.

Paramètres :

  • Ajouter des Cibles : Ajouter un élément de saisie à l'Événement.

  • Note : Après avoir sélectionné le déclencheur d'Entrée sur Saisie dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de saisie d'Entrée spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheur de Défilement

Déclenche lorsque : La barre de défilement, le défilement sur le pavé tactile, ou la molette de défilement de la souris est utilisé 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'appliquera.

Note : Pour les longs textes, 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.

  • Note : Après avoir sélectionné le déclencheur de Défilement dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de défilement spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheur de Manette/Joystick

Le Déclencheur de Manette/Joystick vous permet d'utiliser des manettes et des contrôleurs de joystick dans votre conception expérimentale comme un appareil d'entrée pour l'enregistrement de données. Note : n'oubliez pas d'activer cette option sous l'onglet Paramètres d'Étude dans la colonne ‘Fonctionnalités d'Expérience’.

menu de déclencheur de manette

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

options du menu de déclencheur de manette

Après avoir connecté votre manette, vous pouvez préciser quelles touches spécifiques doivent être utilisées comme déclencheurs. Lors de la pression de 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 ▵. Note : Il est important de dire qu'il y a des variations entre les manettes sur la manière dont l'attribution des ID de touche fonctionne.

déclencheur de manette, définition des touches pour les commandes

Suite à la pression d'une touche, les données en direct apparaîtront également dans la seconde moitié de cette boîte de dialogue de déclenchement où vous pouvez voir comment les valeurs changent en temps réel selon ce que vous appuyez ou relâchez :

flux de données en direct du déclencheur de manette

Consultez cet accompagnement pour plus de détails et un exemple d'une étude utilisant ce déclencheur.

Le tableau ci-dessous explique ces options en détail.

Élément du MenuZone de MenuOptions de Déclencheur de Manette / Joystick
Écouter les boutonsDéfinir le déclencheur pour écouter les boutonsI.) Spécifiez que le déclencheur est lié au bouton et s'il s'agit d'une clé d'appui, d'appui ou de relâchement, ou de relâchement.

II.) Spécifiez 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 le(s) bouton(s) de votre manette.
Écouter les axesDéfinir le déclencheur pour écouter les changements d'axesS'il y a besoin de mouvements d'axes, alors vous pouvez spécifier que le déclencheur se produira chaque fois que le seuil change par une valeur spécifique. La valeur par défaut est 0.01.
Statut de connexionStatut 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 seront affichées où toute entrée que vous faites sur votre dispositif sera affichée ici. Cela est utile pour les tests lors de la configuration de votre étude et pour déterminer quelles touches ou axes vous souhaitez utiliser.

Note : Après avoir sélectionné le déclencheur de Manette / Joystick dans le système d'événements, vous avez la possibilité d'utiliser et de référencer ses valeurs spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheurs de Signaux Physiologiques

Ces déclencheurs s'appliqueront uniquement 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 lorsque :

  • Globalement, ce déclencheur s'appliquera lorsque le suivi oculaire a été activé.
  • Déclenche uniquement en regardant des éléments spécifiques.

Paramètres :

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

  • Note : 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 valeurs de regard spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheur de Fixation de Suivi Oculaire

Ce déclencheur est toujours en phase BETA.

  • Note : Après avoir sélectionné le déclencheur de clavier dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de fixation spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheur de Suivi de Tête

Déclenche lorsque:

  • Changements dans l'orientation de la tête ou mouvements de la tête.

  • Note : Après avoir sélectionné le déclencheur de Suivi de Tête dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de suivi de tête spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheurs d'Essai et d'Image

Déclencheur Init de Tâche

Déclenche lorsque :

  • Le premier cadre du premier essai d'une tâche. Ne sera exécuté qu'une seule fois par tâche, malgré le fait d'être affiché dans l'onglet Événements pour toutes les instances de ce cadre.

Ce déclencheur se marie bien avec les actions Shuffle et Read From. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les images de données alors que la tâche commence 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

  • Note : Après avoir sélectionné le déclencheur Init de Tâche dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur Init de Tâche à travers différentes actions avec le menu de sélection de valeur.

Déclencheur Init d'Image

Déclenche lorsque :

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

Ce déclencheur se marie bien avec les actions Shuffle, Read From et Draw Random Number. Avec ces combinaisons, ces actions peuvent être complétées avant que l'image n'apparaisse, laissant un chemin clair pour que d'autres actions commencent lorsque l'image commence.

Note : Ne pas utiliser le déclencheur Init d'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 d'Image se produit entre les essais, donc il n'y a pas un compte entièrement précis de l'essai ou de la condition qui s'apprête à être affiché.

Paramètres : Aucun

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

Note sur les Déclencheurs Init de Tâche et d'Image : Comme les déclencheurs Init de Tâche et d'Image se produisent avant que la tâche ou l'image ne commence, les variables créées pendant cette période seront réinitialisées lorsque la tâche/l'image commencera réellement. Un avertissement apparaîtra lorsque vous utilisez cet événement :

avertissement de réinitialisation d'init d'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 de variable si vous ne souhaitez pas que les valeurs de variable soient réinitialisées.

Déclencheur de Début d'Image

Déclenche Lors :

  • Début de l'image

Paramètres : Aucun

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

Déclencheur de Fin d'Image

Déclenche Lors :

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

Paramètres : Aucun

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

Déclencheur de Valeur de Variable Changée

Valeur de Variable Changée

Déclenche Lors :

  • La valeur d'une variable change par rapport à sa valeur de départ

Paramètres :

  • Variables : Sélectionnez une ou plusieurs variables sur lesquelles vous souhaitez "écouter" les changements. Tout changement dans la valeur de ces variables déclenchera immédiatement l'Action correspondante.

  • Note : Après avoir sélectionné le déclencheur de Valeur de Variable Changée dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur de Valeur de Variable Changée à travers différentes actions avec le menu de sélection de valeur.

Déclencheurs d'Objet Médias

Déclencheur d'Objet Médias

Anciennement connu sous les déclencheurs séparés "Contrôle Audio/VIDÉO" et "Contrôle d'Objet".

Déclenche Lors :

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

Paramètres :

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

  • Exécuter Sur : Sélectionner le sous-type de déclencheur

    • Options d'Objet Audio ou Vidéo :
      • Lecture Démarrée : Déclenche lorsque l'élément commence à jouer
      • Lecture Arrêtée : Déclenche lorsque l'élément est mis en pause
      • Lecture Terminée : Déclenche lorsque l'élément arrête de jouer
    • Options d'Objet Vidéo, Audio ou d'Enregistrement d'Écran :
      • Enregistrement Terminé : Déclenche lorsque l'enregistrement audio a été arrêté
      • 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 du fichier est complet
    • Options d'Objet Instantané de Caméra :
      • Instantané Terminé : Déclenche lorsque la caméra a réussi à prendre un instantané
      • Téléchargement Complet : Déclenche lorsque le téléchargement de l'instantané est terminé
  • Note : Après avoir sélectionné le déclencheur d'Objet Médias dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs d'Objet Médias spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheurs API

Si vous avez besoin d'envoyer ou de 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 du websocket/API doit être reçu et traité comme le déclencheur de l'Action.

L'option de déclencheur Websocket.

En cliquant sur cette option, les éléments suivants apparaissent.

Le menu de dialogue déclencheur Websocket.

  • Accepter/Recevoir de : Détecte automatiquement l'adresse IP de l'hôte local. Peut être changé manuellement dans l'onglet ‘Paramètres d'Étude’ sous la colonne ‘Fonctionnalités d'Expérience’.
  • Déclencheur/message : saisissez le message qui servira de déclencheur. Tapez 'tous' pour accepter plus d'un message comme déclencheur.

Pour un exemple de la manière dont les Déclencheurs/API Actions sont utilisés, veuillez consulter cette démo https://www.labvanced.com/page/library/51053 en cliquant sur l'option ‘Inspecter’ dans la boîte de dialogue.

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

  • Note : Après avoir sélectionné le déclencheur WebSocket dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs de WebSocket spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Déclencheur OpenAI

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

Le menu de Déclencheur OpenAI dans Labvanced.

La sélection de cette option entraînera l'affichage des paramètres suivants :

Les options du menu de déclencheur OpenAI.

NOTE : Référez-vous également à ce guide où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant ce déclencheur.

Dans l'exemple ci-dessous, le cadre de données qui a été assigné est appelé ‘df’ et le résultat du ‘Déclencheur OpenAI’ sera ajouté à ce cadre de données. Ce cadre de données doit avoir deux colonnes. La première colonne indiquera le ‘rôle’ et la deuxième la ‘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 que vous avez indiqué ici.

  • Note : Après avoir sélectionné le déclencheur OpenAI dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs OpenAI spécifiques au déclencheur à travers différentes 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-utilisateurs ! Les options suivantes sont répertoriées comme Déclencheurs Globaux :

  • Pause / Reprendre l'Expérience
  • Participant a Quitte l'Étude Multiutilisateurs

Le menu des déclencheurs globaux dans Labvanced.

Déclencheur Pause/Reprendre l'Expérience

Le déclencheur ‘Pause / Reprendre l'Expérience’ est une option qui vous permet d'exécuter un événement basé sur la mise en pause ou la reprise de l'expérience.

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

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

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

  • Expérience Mise en Pause : Le participant met en pause (quitte le plein écran) l'étude.

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

  • Note : Après avoir sélectionné le déclencheur Pause/Reprendre l'Expérience dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur à travers différentes actions avec le menu de sélection de valeur.

Participant a Quitte l'Étude Multiutilisateurs

Si un participant quitte une étude multi-utilisateurs, cela peut également être utilisé comme un déclencheur pour un événement. Si un participant quitte une étude multi-utilisateurs, cela affecte l'expérience à un niveau global car cela empêche d'autres participants de continuer l'étude.

L'option Participant a Quitte l'Étude Multiutilisateurs 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-utilisateurs.

Boîte de dialogue pour le déclencheur de participant a quitté l'étude multi-utilisateurs.

  • Note : Après avoir sélectionné le déclencheur Participant a Quitte l'Étude Multiutilisateurs dans le système d'événements, vous avez la possibilité d'utiliser et de référencer valeurs spécifiques au déclencheur à travers différentes 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 à partir de tableaux, ou passer 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 l'imbrication d'actions les unes dans les autres (par exemple, une boucle while dans une instruction if). Ainsi, le système d'événements peut être considéré comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme les invocations de fonction, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit que presque toute logique expérimentale peut être mise en œuvre sans utiliser certaines structures programmatiques/syntaxiques.

Le tableau ci-dessous fournit un aperçu introductif des actions disponibles dans Labvanced :

Catégorie d'Action Options d'Action Description
Actions d'Objet
  • Définir Propriété d'Objet
  • Contrôler Objet Médias
  • Copier Objet
  • Pour Chaque Objet
Les actions d'objet se réfèrent à toute manipulation qui se produira sur un objet qui existe dans la tâche.
Actions de Variable
  • Définir / Enregistrer Variable
  • Copier dans le Presse-papiers
  • Tirer un Nombre Aléatoire
  • Obtenir Paramètre URL
  • Lire depuis / Écrire vers Dispositif
  • Lire depuis / Écrire vers Variable Partagée
  • Math & Statistiques
  • Enregistrer des Variables Instantanément
  • Filtre Moyenne Mobile
  • Distribuer Variable
Toute action qui lit ou enregistre une valeur de variable.
Actions de Tableau
  • Sélectionner depuis Tableau (Lire)
  • Ajouter / Retirer Entrées de Tableau
  • Modifier Entrée de Tableau (Remplacer)
  • Mélanger Entrées de Tableau
Les opérations de tableau impliquent la sélection, l'ajout, la suppression, le changement et le mélange de tableaux et de leurs entrées.
Opérations sur Cadres de Données
  • Lire depuis / Écrire vers Cadre de Données
  • Mélanger Entrées de Cadre de Données
Ces actions sont pertinentes si vous travaillez avec des fichiers .csv (cadres de données) dans votre expérience.
Actions de Saut
  • Sauter À
  • Accepter / Terminer Session
  • Rejeter / Terminer Session
  • Rediriger vers URL
Vous permet de naviguer dans l'expérience en sautant à une section spécifique, ainsi que d'accepter et de rejeter des sections des participants.
Actions de Contrôle
  • Actions de Condition (Si…Alors)
  • Actions Répétées (Boucle While)
  • Actions Retardées (Callback Temporel)
  • Groupe d'Actions
Les actions de contrôle sont utilisées pour exécuter des séquences spécifiques d'événements, comme la logique if/then, les boucles (comme jouer un son répété ou faire clignoter une image), ainsi que pour voir si certaines conditions se complètent.
Actions API
  • Envoyer vers Websocket
  • Envoyer vers OpenAI
Se réfère aux 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.

Actions sur les objets

Les actions sur les objets font référence à toute manipulation qui se produira sur un objet qui existe dans la tâche. Il existe plusieurs options d'actions sur les objets :

  • Définir la propriété de l'objet
  • Contrôler l'objet mé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 vous le souhaitez en spécifiant l'objet en question, la propriété à modifier et la nouvelle valeur.

Dans l'exemple ci-dessous, l'action 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 temps auquel ce changement s'est produit à 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 que vous rencontrez lorsque vous travaillez avec l’action 'Définir la propriété de l'objet' :

Élément de menuZone de menuOptions de déclenchement de 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 ce cadre 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 laproprié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 ce que la valeur de la nouvelle propriété de l'objet doit être à 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 le temps lorsque ce changement est reflété à l'écran (mesuré en millisecondes depuis le début de l'image).La case à cocher pour enregistrer la valeur temporelle des changements de propriété de l'objet.Lorsqu'une propriété est modifiée, cela prendra un court laps de temps (environ ~10 ms pour que les changements soient visibles). Avec cette option, vous pouvez enregistrer plus précisément le temps auquel la propriété modifiée est réellement visible lors du prochain rafraîchissement de l'affichage.

Remarque : Une fois cette option sélectionnée, une boîte de dialogue apparaîtra pour vous inviter à indiquer (ou créer une nouvelle variable) où cette valeur capturée doit être stockée. La variable doit être numérique en tant que 'type de donnée.'

Action Contrôler l'objet média

Précédemment les actions distinctes "Contrôler Audio/VIDÉO" et "Contrôler Objet".

Effet : Change la lecture des éléments vidéo/audio ou change l'état des éléments de téléchargement/enregistrement.

Paramètres :

  • Cible : Sélectionnez un objet média
  • Effet : Sélectionnez une sous-action
    • Options d'Objet Audio ou Vidéo :
      • Démarrer la Lecture : Démarre la lecture de la vidéo / du fichier audio
      • Arrêter la Lecture : Arrête la vidéo / le fichier audio
      • Mettre en Pause la Lecture : Met en pause la vidéo / le fichier audio
      • JumpToTime : vous permet de spécifier un temps en millisecondes vers lequel sauter dans le fichier audio/vidéo
      • Muet : désactive le son de l'objet
      • Réactiver : restaure le son de l'objet
    • Options d'Objet Audio, Vidéo, ou enregistrement d'écran :
      • Démarrer l'enregistrement : Démarre un nouvel enregistrement (audio)
      • Arrêter l'enregistrement : Arrête l'enregistrement (audio)
      • Démarrer le téléchargement : Démarre le téléchargement du fichier
      • Effacer l'enregistrement : Supprime les données d'enregistrement (audio).
      • Démarrer la lecture : Démarre la lecture du fichier enregistré
      • Arrêter la lecture : Arrête la lecture du fichier enregistré
      • Mettre en Pause l'enregistrement : met l'enregistrement de l'objet en pause
      • Reprendre l'enregistrement : reprend l'enregistrement de l'objet
    • Options Objet de Téléchargement de Fichier :
      • Démarrer le téléchargement : démarre le processus de téléchargement pour le fichier sélectionné
      • Effacer le fichier : Supprime le fichier sélectionné
      • Choisir un fichier : permet au participant de choisir le fichier souhaité
    • Options objet de capture d'image 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 capture à l'expérience
      • Prendre une capture : 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 dans le cadre à copier.
  • Nombre de copies : Entrez le nombre de copies à faire de l'objet source.
  • Définir nouveau nom d'élément : Choisissez parmi plusieurs paramètres pour déterminer les noms des copies.
  • Attribuer un nom avec un suffixe incrémental : Ajoute une balise numérique à la fin du nouveau nom d'élément pour différencier les copies.
  • Séquence d'actions : Vous permet de choisir (dans la liste habituelle d'actions) ce qui arrivera aux copies. Sélectionnez "ObjetActuel" 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 de l'objet(s) à cibler. Pour plusieurs objets sur un cadre où certains ont des noms identiques, cela fonctionne bien.
  • Séquence d'actions : Vous permet de choisir (dans la liste habituelle d'actions) ce qui arrivera aux éléments sélectionnés. Sélectionnez "ObjetActuel" 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 entre les sessions.

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

Le tableau ci-dessous fournit un aperçu introductif de toutes les options d'actions sur les variables disponibles dans Labvanced. Chacune d'elles est décrite plus en détail dans les sections suivantes.

Option d'Action sur les VariablesDescription
Définir / Enregistrer la VariableÉcrire ou définir une valeur de variable
Copier dans le Presse-papiersCopier 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 sauvegarde dans une variable
Obtenir le Paramètre de l'URLSauvegardez une valeur de l’URL unique du participant
Lire depuis / Écrire vers le Dispositif Lit ou écrit une variable dans/sur 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 Labvanced.
Lire depuis / Écrire vers une Variable PartagéeLit ou écrit dans une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou privée à chaque individu.
Mathématiques & StatistiquesEffectue une opération mathématique sur une variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.
Enregistrer Instantanément les VariablesCrée une photo instantanée de toutes les valeurs de variables et envoie ceci au serveur Labvanced.
Filtre de Moyenne MobileCalcule une moyenne mobile (une moyenne mise à jour constamment des données) de certaines entrées et stocke le résultat dans une nouvelle variable.
Distribuer la 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 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 des événements

Élément de menuZone de menuDescription
SélectionnerSélectionner quels participants la variable à distribuer est envoyéeEn 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 la variable à distribuer est envoyéeL'icône de stylo symbolise le menu de sélection de valeur qui est utilisé pour définir et spécifier les valeurs exactes qui doivent être attribuées à la variable sélectionnée (comme spécifié dans le bouton vert à gauche du signe égal (=)).

Dans l'exemple ci-dessous, nous avons créé une nouvelle variable appelée counter et utilisé une option arithmétique du menu de sélection de valeur pour faire augmenter la valeur de la variable de 1 (en fonction du déclencheur défini dans 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 possible l'enregistrement de la valeur de la variable. La variable (à gauche) est créée manuellement tandis que la valeur à droite du signe égal (=) est une valeur spécifique aux déclencheurs 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' en fonction des valeurs des variables.

Action Copier dans le Presse-papiers

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

Action Tirer un Nombre Aléatoire

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

Paramètres :

  • Type : Choisissez entre valeurs continues et discrètes
  • Distribution : Choisissez entre distribution gaussienne et uniforme
  • Tirages Multiples (booléen vrai/faux) : Choisissez de tirer une fois ou plusieurs fois.
  • Nr de Tirages : Sélectionnez le nombre de tirages
  • Min : Définir la valeur minimale pour la distribution uniforme
  • Max : Définir la valeur maximum pour la distribution uniforme
  • Moyenne : Définir la valeur moyenne pour la distribution gaussienne
  • Écart Type : Définir l'écart type pour la distribution gaussienne
  • Sauvegarder dans la Variable : Sélectionnez une variable où les valeurs seront stockées.

Action Obtenir le Paramètre de l'URL

Effet : sauvegarde une valeur de l'URL unique du participant

Paramètres :

  • Nom du paramètre : entrez le nom du paramètre souhaité
  • Sauvegarder dans la Variable : sélectionnez la variable dans laquelle sauvegarder la valeur du paramètre

Cette action peut ê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 vers le Dispositif

Effet : Lit ou écrit une variable dans/sur 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 Labvanced.

Paramètres :

  • Choisissez de lire ou d'écrire sur 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 les images présentées à chaque participant lors de la Session 1 et vous assurer que des images différentes leur sont présentées lors de la Session 2.
    • Créez un tableau d'images et sélectionnez-en aléatoirement quelques-unes à présenter à chaque session.
    • Écrire sur le Dispositif : le numéro d'index des images présentées lors de la Session 1.
    • Lire depuis le Dispositif : lors de la Session 2, lisez les index des images de la Session 1 et incluez une action JavaScript qui empêche ces index d'être sélectionnés pour la deuxième session.

Action Lire depuis/Écrire vers une Variable Partagée

Effet : Lit ou écrit dans une variable qui est partagée entre les sessions d'une étude. La variable peut être partagée avec tous les participants ou 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 un changement, puis envoie la variable à l'étude.
      • Lire uniquement la valeur partagée depuis le serveur : appelle la variable qui est partagée dans l'étude, mais ne fait aucun changement.
      • Écrire uniquement la variable sur le serveur : fait des changements à la variable partagée, mais ne l'affiche pas aux participants.
      • Partager les valeurs entre différents participants (pas seulement entre les sessions) : permet aux participants de voir les valeurs des variables synchronisées des autres participants au cours des sessions. Cette option est sélectionnée par défaut, mais peut être désélectionnée en cliquant sur la case à cocher.
  • Séquence d'actions :
    • Choisissez ce qui arrive à la variable partagée/synchronisée dans la liste de toutes les actions disponibles.

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

  • Avec cette action, les données spécifiques au participant peuvent être transférées d'une session à l'autre et peuvent être partagées entre les participants au cours des sessions.
  • Par exemple, vous pouvez utiliser cette action pour enregistrer un score sur un test et ensuite permettre au participant de comparer son score à la moyenne des autres participants qui ont terminé le test.
  • Un autre exemple (similaire à l'Action Lire depuis/Écrire vers le Dispositif) serait d'avoir des participants choisir 5 images qu'ils aiment dans un tableau, effectuer une tâche, puis présenter ces 5 images à nouveau lors d'une session ultérieure. La différence est que cette action peut être utilisée pour montrer aux autres participants les images qui ont été choisies, ou pour exclure ces images des options disponibles d'un autre participant.

Action Math & Statistiques

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

Paramètres :

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

Action Enregistrer Instantanément les Variables

Effet : Crée une photo instantanée de toutes les valeurs de variables et envoie ceci au serveur Labvanced.

Paramètres : Aucuns

Action Filtre de Moyenne Mobile

Effet : Calcule une moyenne mobile (une moyenne mise à jour constamment des données) de certaines entrées et stocke le résultat dans une nouvelle variable.

Paramètres :

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

Action Distribuer la Variable

L'action Distribuer la Variable est essentielle pour les études multi-utilisateurs dans Labvanced. Avec cette action, une valeur de variable peut être partagée entre les participants, permettant essentiellement à l'information (y compris les emplacements des stimuli et les changements) d'être reflétée sur les écrans des participants.

L'Action Distribuer la Variable dans le menu d'actions Labvanced.

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

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

L'Action Distribuer la Variable utilisée avec toutes les options de menu définies comme exemple.

Consultez cette démo qui incorpore la distribution de variable et la fonction de boîte de chat ici : Tâche de Description d'Image avec Ajout de Chat.

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

Élément de menuZone de menuOptions et Description de l'Action Distribuer la Variable
Distribuer la valeur àSélectionner quels participants la variable à distribuer est envoyéeChoisissez à quels autres participants la valeur doit être envoyée.
  • Tous les participants : Envoyez cette valeur à tous les participants
  • Participants Sélectionnés : Envoyez la valeur aux 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 modifié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 un moyen de protéger votre expérience contre l'engorgement du serveur et agit comme une stratégie de précaution pour contrôler le taux auquel les requêtes (c'est-à-dire les mises à jour via la distribution de variable) sont envoyées au serveur. Les options de stratégie suivantes sont disponibles :
  • Debounce : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, alors les nouveaux messages serveur seront 'debounced' (seul le message le plus récent sera envoyé après un intervalle de 100 ms sans aucune exécution de cette action).
  • Throttle : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, alors les nouveaux messages seront régulés (c'est-à-dire, après que 100 ms se soit écoulé depuis le dernier message envoyé, seul le message le plus récent sera distribué).
  • Discard : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, les nouveaux messages dans cette fenêtre de 100 ms seront rejetés.
  • Queue : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, les nouvelles valeurs de variable seront mises en file d'attente (jusqu'à une taille de file d'attente maximale de 10 messages).

Actions sur les Tableaux

Action Sélectionner (Lire) depuis un Tableau

Effet : Va lire une variable d'un tableau et stocker cette valeur dans une variable scalaire.

Paramètres :

  • Variable de Tableau : Tableau d'entrée pour lire la valeur.
  • Type d'Index : Détermine quel type d'index est utilisé.
    • Fixe : Utiliser un index fixe pour l'opération de lecture. Dans ce cas, tapez la position à partir de laquelle l'information doit être lue (basée sur 1).
    • Variable : Utiliser une variable numérique comme index pour l'opération de lecture. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer la position de la lecture.
    • Fin du Tableau : Lire depuis la fin du tableau.
  • Variable de Sortie : Sélectionnez une variable scalaire où la valeur lue sera stockée.

Action Ajouter / Supprimer des Entrées de Tableau

Effet : Va ajouter et/ou supprimer des entrées d'un tableau.

Paramètres :

  • Variable de Tableau : Variable de tableau où l'opération d'ajout ou de suppression doit être exécutée.
  • Type d'Index : Détermine quel type d'index est utilisé.
    • Fixe : Utiliser un index fixe pour l'opération d'insertion / de suppression. Dans ce cas, tapez dans la position du tableau où les entrées doivent être insérées / supprimées. (basée sur 1).
    • Variable : Utiliser une variable numérique comme index pour l'opération d'insertion / de suppression. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer où les entrées doivent être insérées / supprimées.
    • Fin du Tableau : Insérer / supprimer depuis la fin du tableau.
  • Nr d'entrées à supprimer : Va supprimer les entrées de tableau (avant d'insérer de nouvelles entrées) en commençant à la position d'index définie. 0 indique qu'aucune valeur ne sera supprimée.
  • Variable(s) à Insérer : Sélectionnez une ou plusieurs 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 : Va remplacer / 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 : Utiliser un index fixe pour l'opération de remplacement. Dans ce cas, tapez dans la position du tableau qui doit être changée (basée sur 1).
    • Variable : Utiliser une variable numérique comme index pour l'opération de remplacement. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer la position de l'opération de remplacement.
    • Fin du Tableau : Remplacer la dernière entrée dans le tableau.
  • Variable d'Entrée : Sélectionnez une variable (scalaire) qui contient le nouveau valeur.

Action Mélanger les Entrées de Tableau

Effet : Va mélanger les entrées /l'ordre dans un tableau.

Paramètres : Aucuns

Opérations sur le Cadre de Données

Action Lire depuis / Écrire vers le Cadre de Données

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

Paramètres :

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

Action Mélanger les Entrées du Cadre de Données

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

Paramètres :

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

Actions de Saut

Action Sauter À

Effet : "Saute" le participant à une é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.
    • Image Suivante : Saute à l’image suivante. S'il n'y a plus d'images définies dans un essai, il sautera à la première image du prochain essai.
    • Essai Suivant : Saute au prochain essai. S'il n'y a plus d'essais définis, il sautera au premier essai de la prochaine tâche.
    • Tâche Suivante : Saute à la prochaine tâche. S'il n'y a plus de tâches définies, il sautera à la première tâche du prochain bloc.
    • Bloc Suivant : Saute au prochain bloc. S'il n'y a plus de blocs définis, la session se terminera.
    • Image Précédente : Saute à l'image précédente. S'il n'y a pas d'images précédentes, l'action ne sera pas exécutée.
    • Image Spécifique : Saute à une image spécifique. Les utilisateurs sélectionnent directement l'image à laquelle sauter.
    • Essai Spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro d'essai à sauter.
    • Tâche Spécifique : Saute à la première occurrence de la tâche spécifiée dans le bloc actuel. Les utilisateurs sélectionnent directement la tâche à sauter.
    • Bloc Spécifique : Saute à la première occurrence du bloc spécifié. Les utilisateurs sélectionnent directement le bloc à sauter.
  • Vérifiez les Réponses Requises Avant : Si activé, l'expérience vérifiera si toutes les réponses requises ont déjà été répondues. Si non, l'action de saut ne sera pas exécutée.

Action Accepter/Terminer la Session

Effet : Acceptera les données du participant, mettra fin à la session d'enregistrement et affichera le code de crowdsourcing.

Paramètres :

  • Enregistrer les données de l'essai avant de terminer la session : Si activé, les données de l’essai le plus récent seront stockées (envoyées au serveur) avant de quitter l'étude.
  • Afficher la page de fin par défaut : Si activé, l'écran de fin par défaut de Labvanced apparaîtra. Si c'est une session de crowdsourcing (un lien de crowdsourcing a été utilisé), le code de compensation sera affiché au participant. Si désactivé, l'expérience se terminera après avoir montré l'image actuelle et ne montrera pas l'écran de fin par défaut avec le code de compensation.

Action Rejeter/Terminer la Session

Effet : Met fin à la session d'enregistrement, ne marque PAS les données du participant comme complètes, et ne montre PAS l'écran de fin par défaut avec le code de compensation.

Lors de l'utilisation de cette action pour rejeter les données d'un participant, les utilisateurs doivent afficher un message approprié aux participants expliquant la raison pour laquelle ils ne seront pas récompensés pour leur temps.

Paramètres : Aucuns

Action Rediriger vers URL

Effet : Redirige le participant vers une URL spécifique.

Remarque : L'URL doit inclure le https:// au début pour que cette action fonctionne.

Actions de Contrôle

Actions de Condition (Si... Alors... Sinon Si) Action

Effet : Évalue une déclaration si-alors et exécute une série d'actions en fonction. Chaque déclaration Si/Autre Si consiste en des comparaisons AND/OR imbriquées pour évaluer si toutes les exigences sont respectées (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 Exigence : Ajoutez une nouvelle exigence à 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 à, non égal, etc.).
  • Ajouter un Groupe OU : Un seul des exigences dans un Groupe OU doit être vrai pour que l'ensemble du groupe soit vrai. Ajoutez un groupe OU si les sous-actions doivent être exécutées dans plusieurs cas.
  • Ajouter un Groupe AND : Toutes les exigences au sein d'un Groupe AND doivent être vraies pour que l'ensemble du groupe soit vrai. Ajoutez un groupe AND si les sous-actions ne doivent être exécutées que lorsque plusieurs exigences sont remplies.
  • Séquence d'Actions : Chaque déclaration Si / Autre 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 / Autre 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 exigences de la déclaration associée Si / Autre Si sont remplies.
  • Ajouter un Cas Autre Si : L'Action de Condition peut consister en plusieurs déclarations Si / Autre Si --> Alors distinctes. Cependant, seule une déclaration peut être exécutée. Si une déclaration Si / Autre Si est évaluée positivement (retourne vrai), les actions dans le bloc Alors sont exécutées et le reste de l'Action de Condition est ignoré.
  • Ajouter un Cas Sinon (vrai / faux) : Si activé, une option par défaut / de secours est ajoutée à l'action de condition. Si aucune des déclarations Si / Autre Si 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) Action

Effet : Exécute à plusieurs reprises une série d'actions, soit immédiatement, soit dans un intervalle défini. Une condition d'arrêt peut être spécifiée afin que l'exécution de la boucle soit arrêtée.

Paramètres :

  • Type d'exécution : Choisissez entre exécution immédiate ou exécution chronométrée
    • Exécuter la boucle complète : Cela exécutera la boucle continuellement jusqu'à ce que la condition d'arrêt soit remplie.
    • Exécuter toutes les ... ms : Cela exécutera la boucle à 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'attribuer une valeur entière numérique pour le nombre de fois que la boucle doit être exécutée. Cela remplace la nécessité de définir une condition d'arrêt.
  • Intervalle d'exécution : Cela détermine l'intervalle d'exécution.
  • Commencer immédiatement (vrai / faux) : Si activé, cela exécutera la boucle immédiatement. Si désactivé, la boucle sera démarrée lors de l'intervalle d'exécution suivant.
  • Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de la 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 savoir quand l'exécution de la boucle doit être arrêtée. Tout comme pour les déclarations Si / Autre Si, on peut combiner des groupes AND, des groupes OU, et des exigences pour la comparaison logique.
  • Séquence d'actions : La séquence d'actions liste toutes les actions qui sont exécutées à chaque itération de la boucle. Une nouvelle action peut être ajoutée via l'icône "Ajouter Action".

Actions Retardées (Callback Temporel) Action

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

Paramètres :

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

Groupe d'Actions

Les actions peuvent également être organisées en groupes d'actions. Les groupes d'actions permettent de regrouper certaines actions ensemble pour une structure visuelle plus facile, mais aussi si vous souhaitez copier, dupliquer ou supprimer plusieurs actions en une seule 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 devez envoyer ou communiquer des données d'un serveur externe vers Labvanced, alors les 'Actions API' et les ‘Déclencheurs API’ peuvent être utilisés. Vous avez les actions suivantes disponibles sous cette catégorie :

  • Envoyer au Websocket
  • Envoyer à OpenAI

Pour que ces actions soient 'disponibles' ou utilisables, vous devez saisir une clé API dans les Paramètres de l'Étude sous la colonne 'Fonctionnalités de l'Expérience'. Une fois que la clé API a été fournie là-bas, alors ces actions ne seront plus grises dans le menu.

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

Action Envoyer au Websocket

L'Action Envoyer au Websocket dans le menu d'actions 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 complète de l'événement peuvent être consultés ici : https://www.labvanced.com/page/library/51053 en cliquant sur 'Inspecter'.

Élément de menuDescription
Envoyer À :Spécifie l'adresse du Websocket qui est indiquée dans les 'Paramètres de l'Étude' sous la colonne 'Fonctionnalités de l'Expérience'
Déclencheur / message à envoyer :Spécifiez le déclencheur ou le message que vous souhaitez envoyer.
Variable à envoyer (optionnelle) :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 de chaîne, à OpenAI. Veuillez noter que pour que cette option soit disponible, vous devez saisir votre clé API dans l'onglet 'Paramètres de l'Étude' sous la colonne 'Fonctionnalités de l'Expérience'.

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

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

Options pour l'action Envoyer à OpenAI.

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

Exemple de l'action Envoyer à OpenAI 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émonstration en soumettant ce formulaire de contact.

REMARQUE : 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 détaillée des champs inclus sous 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é.

Remarque : pour spécifier la version de ChatGPT, veuillez consulter les 'Paramètres de l'Étude' sous la colonne 'Fonctionnalités de l'Expérience'
DataFrame d'Historique de ChatChamp pour spécifier la variable du dataframeLien vers une variable de dataframe avec 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 dataframe qui est lié ici.

Le dataframe peut également être manipulé avec des actions sur les dataframes. Pour plus de références, veuillez consulter les docs de OpenAI.
Insérer Message ‘+’ L'icône d'insertion de message.En cliquant sur ceci, la boîte de dialogue pour les variables 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 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 faire exactement cela ! 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 s'exécute comme une action lorsqu'il est 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 lors 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 les mêmes éléments encore et encore. Par exemple, si vous avez un événement similaire à un qui existe déjà, vous pouvez simplement le copier, le coller et le modifier, au lieu de le construire depuis le début.

Le Menu de Sélection de Valeurs

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

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

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

Cliquer sur l'icône de stylo mène à un menu déroulant où vous spécifiez la valeur à lire ou à écrire. Le menu déroulant commencera toujours par l'énumération d'une option de valeur spécifique à un déclencheur, puis continuera avec les autres 5 catégories (Temps Actuel, Valeur Constante, Variable, Cadre / Tâche / Option, et Opérations), toutes ayant leurs propres options. Celles-ci seront décrites plus loin 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 un Déclencheur de Souris est utilisé. Comme vous pouvez le voir, le premier élément du menu à gauche commence par une catégorie spécifique au déclencheur puis passe aux autres 5 catégories (Temps Actuel, etc).

Options de Menu

Le tableau ci-dessous explique davantage les catégories et les options :

CatégorieOptionsDescription
Dépendant du déclencheurDépend du type de déclencheur que vous avez précédemment sélectionné pour l'événement.Basé sur le déclencheur que vous avez sélectionné pour un événement, vous aurez une liste spécifique d'options qui apparaîtra en haut du menu de sélection de valeur à choisir. Veuillez vous référer à la section sur les valeurs spécifiques au déclencheur pour voir une liste complète d'options et de descriptions.
Temps Actuel
  • Horodatage UNIX
  • Temps Depuis le Début du Cadre
Mesure et rappelle les valeurs temporelles.
Valeur Constante
  • Chaîne
  • Numérique
  • Booléen
  • Catégorique
  • Date
  • Temps
  • Couleur
Assigne des valeurs constantes basées sur le type de variable dont vous avez besoin, comme une chaîne ou un numérique. Celles-ci sont parfois utilisées en combinaison avec d'autres options comme Arithmetic pour créer des compteurs.
Variable
  • Sélectionner Variable
  • Sélectionner Valeur d'un Tableau
  • Sélectionner Valeur d'un Cadre de Données
Spécifiez ou référez-vous à une variable ou sélectionnez une valeur d'un tableau ou d'un cadre de données.
Cadre / Tâche / Objet
  • Propriété d'Objet
  • Cadre
  • Suivi Oculaire
  • Appareil
Vous permet d'extraire des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (s'il est activé), et à l'appareil (taux de rafraîchissement de l'écran).
Opérations
  • Arithmétique
  • Opération de Chaîne
  • Opération Mathématique
Utilisez des opérations pour effectuer des modifications spécifiques à vos variables telles que la combinaison de valeurs variables, la transformation de chaînes pour qu'elles soient toutes en minuscules, ou l'exécution d'opérations mathématiques.

Valeurs de Temps Actuel

Avec l'option 'Temps Actuel', vous pouvez enregistrer ou vous référer à des valeurs en rapport avec 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 la quantité de temps écoulé depuis le début du cadre. Le plus souvent, cela équivaut au temps de réaction.

Valeurs Constantes

Assignez des valeurs constantes en fonction du type de variable dont vous avez besoin, comme une chaîne ou un numérique. Celles-ci sont parfois utilisées en combinaison avec d'autres options comme Arithmetic pour créer des compteurs.

Les options suivantes sont disponibles :

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

Constante : Chaîne

Assigne une valeur de texte / chaîne.

Constante : Numérique

Assigne une valeur numérique / de nombre.

Constante : Booléen

Assigne une valeur de vrai ou faux.

Constante : Catégorique

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

Constante : Date

Assigne une valeur de date.

Constante : Temps

Assigne une valeur de temps.

Constante : Couleur

Assigne une valeur de couleur (chaîne hexadécimale).

Valeurs de Variable

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

  • Sélectionner Variable
  • Sélectionner Valeur d'un Tableau
  • Sélectionner Valeur d'un Cadre de Données

Sélectionner Variable

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

Sélectionner Valeur d'un Tableau

Vous permet de sélectionner une valeur d'un tableau.

Sélectionner Valeur d'un Cadre de Données

Vous permet de sélectionner une valeur d'un cadre de données que vous avez créé.

Valeurs de Cadre / Tâche / Objet

Vous permet d'extraire des valeurs associées aux propriétés d'objet, au cadre, au suivi oculaire (s'il est activé), et à l'appareil (taux 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 la Souris en CacheLa dernière valeur de coordonnée X de la souris du participant.
Dernière Position Y de la Souris en CacheLa dernière valeur de coordonnée Y de la souris du participant.
Dernier Tableau [X,Y] de la Souris en CacheLa dernière valeur de coordonnées [X,Y] de la souris du participant au format tableau.
Nom du CadreLe nom du cadre.

Suivi Oculaire

Options de Valeurs de Suivi OculaireDescription
Dernière Coordonnée X en CacheLa dernière valeur de coordonnée X du regard du participant.
Dernière Coordonnée Y en CacheLa dernière valeur de coordonnée Y du regard du participant.
Dernier Tableau [X,Y] de Coordonnée en CacheLa dernière valeur de coordonnées [X,Y] du regard du participant au format tableau.
Dernier Tableau [X,Y,T] de Coordonnée + Temps en CacheLa dernière valeur de coordonnées [X,Y] du regard du participant, plus la valeur T de capture de la caméra au format tableau.

Appareil

  • Taux de Rafraîchissement : La valeur du taux de rafraîchissement de l'appareil du participant.

Opérations

Utilisez des opérations pour effectuer des changements spécifiés à vos variables tels que la combinaison de valeurs variables, la transformation de chaînes pour qu'elles soient toutes en minuscules, ou l'exécution d'opérations mathématiques.

Les options suivantes sont disponibles :

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

Arithmétique

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

Le menu Arithmétique dans Labvanced.

Essentiellement, l'opération arithmétique vous permet d'effectuer des opérations sur plusieurs valeurs.

En sélectionnant cette option, une icône de stylo supplémentaire (c'est-à-dire le Menu de Sélection de 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 les 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 constantes de chaîne, c'est-à-dire le point-virgule : et l'espace brisé <br>. Cette action crée l'effet d'un chat utilisateur qui peut être utilisé dans une étude multi-utilisateurs.

Opération de Chaîne

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

→ Ex : (AAABBB) se transforme en (aaabbb)
En MajusculesChange toutes les lettres d'une variable chaîne en 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 tous les espaces entre les lettres d'une variable chaîne.

→ Ex : (aaa bbbb cccc) se transforme en (aaabbbbccc)
Élaguer les EspacesSupprime les espaces au début d'une variable 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 floored.
ceilRenvoie la valeur ceiled.
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 aux valeurs qui sont associées au déclencheur défini dans un événement particulier. Par exemple, si votre événement utilise un déclencheur de souris, alors, dans certaines zones où l'action est spécifiée (telles que lors de l'utilisation d'une action Définir / Enregistrer une Variable ou d'une action Définir Propriété d'Objet), vous pouvez référencer les valeurs spécifiques au déclencheur de souris dans le menu de sélection de valeur.

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

Démontrant comment les valeurs spécifiques au déclencheur de la souris sont utilisées pour capturer le suivi de la souris.

Ci-dessous se trouve un tableau de tous les types de valeurs spécifiques au déclencheur qui peuvent être trouvées dans Labvanced, suivi d'une explication approfondie de chaque option.

NomOptions de Valeur - Vue d'Ensemble
Déclencheur (Souris)
  • Position de la Souris X
  • Position de la Souris Y
  • Tableau de la Souris [X,Y]
  • Nom du Stimulus
  • Informations sur le Stimulus
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Clavier)
  • Id de la Touche
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre) li>
Déclencheur (Barre de Boutons)
  • Nom du Stimulus
  • Informations sur le Stimulus
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Entrer sur Input)
  • Id de la Touche
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Scroll)
  • Nom du Stimulus
  • Informations sur le Stimulus
  • Position de Défilement X
  • Position de Défilement Y
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Gamepad/ Joystick)
  • Id de l'Appareil Gamepad
  • Touches Pressées (Tableau)
  • Touches Pressées ou Maintenues (Tableau)
  • Touches Relâchées (Tableau)
  • Axes (Tableau)
  • Horodatage du Gamepad (Unixtime)
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Regard Suivi Oculaire)
  • Coordonnée X
  • Coordonnée Y
  • Tableau de Coordonnée [X,Y]
  • Nom du Stimulus
  • Informations sur le Stimulus
  • Temps de Capture de la Caméra T
  • Confiance du Regard C
  • Coord. + Temps [X,Y, T] tableau
  • Coord. + Temps + Confiance [X,Y, T,C] tableau
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Fixation Suivi Oculaire)
  • Centroid X de la Fixation
  • Centroid Y de la Fixation
  • Durée de la Fixation
  • Temps de Début de la Fixation
  • Temps de Fin de la Fixation
  • Dispersion de la Fixation
  • Nom du Stimulus
  • Informations sur le Stimulus
  • [X,Y, Durée, Début, Fin, Disp]
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Suivi de Tête)
  • Temps de Capture de la Caméra T
  • Tourné 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 du Nez [X,Y, Z, T] tableau
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur Depuis le Début du Cadre
Déclencheur (À l'Initialisation de la Tâche)
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (À l'Initialisation du Cadre)
  • TrialNr
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (au Début du Cadre)
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (À la Fin du Cadre)
  • Temps Total du Cadre
  • Horodatage du Déclencheur (Unixtime)
  • 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 (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Déclenchement d'Objet Média)
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Déclencheur Websocket)
  • Message
  • Données
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Déclencheur OpenAI)
  • Réponse Chat GPT
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Événement Global d'Expérience)
  • Temps Total du Cadre
  • Raison de l'Événement Global
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)
Déclencheur (Utilisateur Quitte l'Expérience)
  • Nombre Restant de Participants
  • Horodatage du Déclencheur (Unixtime)
  • Temps du Déclencheur (Depuis le Début du Cadre)

Déclencheur (Souris) Valeurs

Lorsqu'un déclencheur de souris est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Les options de valeur de déclencheur de souris disponibles

Options de Déclencheur (Souris)Description
Souris XRenvoie la position actuelle de la souris X dans les coordonnées du cadre.
Souris YRenvoie la position actuelle de la souris Y dans les coordonnées du cadre.
Tableau [X,Y] de la SourisLes coordonnées de la souris [X,Y] 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).
Informations sur le StimulusLes informations sur le stimulus de l'objet qui a déclenché l'événement.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur s'est produit.

Déclencheur (Clavier) Valeurs

Lorsqu'un déclencheur de clavier est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Clavier)Description
Id de la ToucheLa valeur ID de la touche qui a été pressée comme déclencheur.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur s'est produit.

Déclencheur (Barre de Boutons) Valeurs

Lorsqu'un déclencheur de clic sur bouton est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Barre de Boutons)Description
Nom du StimulusLe nom de l'objet bouton qui a déclenché l'événement.
Informations sur le StimulusLes informations sur le stimulus de l'objet bouton qui a déclenché l'événement.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur s'est produit.

Déclencheur (Entrer sur Input) Valeurs

Lorsqu'un déclencheur Entrer sur Input est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Entrer sur Input)Description
Id de la ToucheLa valeur ID de la touche qui a été pressée comme déclencheur.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur s'est produit.

Déclencheur (Scroll) Valeurs

Lorsqu'un déclencheur de Scroll est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Scroll)Description
Nom du StimulusLe nom de l'objet bouton qui a déclenché l'événement.
Informations sur le StimulusLes informations sur le 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 (Unixtime)L'horodatage de quand le déclencheur de défilement s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur de défilement s'est produit.

Déclencheur (Gamepad/ Joystick) Valeurs

Lorsqu'un Déclencheur Gamepad/Joystick est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

option de menu de déclencheur de game pad

Options de Déclencheur (Gamepad/ Joystick)Description
Id de l'Appareil GamepadL'ID ou le nom du gamepad qui était connecté.
Touches Pressées (Tableau)Les touches qui ont été pressées.
Touches Pressées ou Maintenues (Tableau)Les touches qui ont été pressées ou maintenues.
Touches Relâchées (Tableau)Les touches qui ont été relâchées.
Axes (Tableau)Les valeurs des axes.
Horodatage du Gamepad (Unixtime)L'horodatage du gamepad en Unixtime.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur se produit en Unixtime.
Temps du Déclencheur (Depuis le Début du Cadre)L'horodatage en Unixtime de quand le déclencheur se produit par rapport au début de l'apparition du cadre.

Déclencheur (Regard Suivi Oculaire) Valeurs

Lorsqu'un Déclencheur de Regard Suivi Oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

les options de valeur du déclencheur de regard

Options de Déclencheur (Regard 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 déclenché le déclencheur de regard.
Informations sur le StimulusLes informations sur le stimulus derrière le stimulus qui a déclenché le déclencheur de regard.
Temps de Capture de la Caméra TLe moment exact où la capture a eu lieu. Dans le pipeline de suivi oculaire Labvanced, un instantané de caméra se produit en premier avant que l'algorithme et le réseau de neurones effectuent les calculs de regard. Ainsi, le Temps de Capture de la Caméra T est un horodatage UNIX du moment où l'instantané initial s'est produit. Pour plus d'informations concernant la technologie derrière notre suivi oculaire basé sur webcam, veuillez vous référer à notre page technologique ET.
Confiance du Regard CCette valeur va de 0 à 1 et fait référence à la confiance et à la probabilité qu'il y ait un œil ouvert dans l'instantané d'image et sert essentiellement de détecteur de clignement. Veuillez consulter notre article publié évalué par des 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 (Unixtime)L'horodatage de quand le déclencheur de regard s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur de regard s'est produit.

Déclencheur(Fixation Suivi Oculaire) Valeurs

Lorsqu'un Déclencheur de Fixation Suivi Oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Fixation Suivi Oculaire)Description
Centroid X de la FixationLe point central de la fixation comme valeur X.
Centroid Y de la FixationLe point central de la fixation comme valeur Y.
Durée de la FixationLa durée de la fixation détectée.
Temps de Début de la FixationLe temps de début de la fixation détectée.
Temps de Fin de la FixationLe temps de fin de la fixation détectée.
Dispersion de la 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.
Informations sur le StimulusLes informations sur le stimulus de l'objet bouton qui a déclenché l'événement.
[X, Y, Durée, Début, Fin, Disp]Un tableau des éléments suivants : valeurs x et y du centroïde de la fixation, la durée de la fixation, le temps de début, le temps de fin et la valeur de dispersion.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur de fixation s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur de fixation s'est produit.

Déclencheur (Suivi de Tête) Valeurs

Lorsqu'un Déclencheur de Suivi de Tête est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Suivi de Tête)Description
Temps de Capture de la Caméra TQuand la caméra a capturé le cadre, c'est-à-dire un horodatage unix du moment où la capture du cadre a eu lieu. C'est le moment où l'image / cadre a été capturé avant que tout traitement ne se produise.
Tourné de la TêteRotation de la tête de gauche à droite, appelée yaw dans la littérature.
Inclinaison de la TêteInclinaison de la tête de haut en bas, connue sous le nom de pitch dans la littérature.
Roulement de la TêteCapture le mouvement de la tête qui roule 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écifique du nez, cela inclut les coordonnées x et y pour l'endroit où se trouve le nez ainsi que la variable d'horodatage (T) du moment où la mesure a eu lieu.
Vecteur du 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 prête 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'assiste pas à l'expérience), la valeur Z diminue de 1 et se rapproche de 0.
Horodatage du Déclencheur (Unixtime)Moment de l'expérience où le déclencheur lui-même se produit où le suivi de la tête a été détecté et tient compte de quand le déclencheur s'est produit dans le système. Essentiellement, il s'agit du moment où le traitement de l'image / du cadre est traité et cette valeur est en grande partie 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 CadreIl s'agit de la valeur temporelle à laquelle le déclencheur s'est produit par rapport au moment où l'apparition du cadre s'est produite.

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

Lorsqu'un Déclencheur d'Initialisation de la Tâche est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

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

Déclencheur (À l'Initialisation du Cadre) Valeurs

Lorsqu'un Déclencheur d'Initialisation de Cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (À l'Initialisation du Cadre)Description
TrialNrLe Numéro d'Essai au moment où le Déclencheur d'Initialisation du Cadre s'est produit.
Horodatage du Déclencheur (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre.

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

Lorsqu'un Déclencheur au Début du Cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (au Début du Cadre)Description
Horodatage du Déclencheur (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre.

Déclencheur (À la Fin du Cadre) Valeurs

Lorsqu'un Déclencheur À la Fin du Cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (À la Fin du Cadre)Description
Temps Total du CadreLe temps total en millisecondes qui a été passé sur le cadre.
Horodatage du Déclencheur (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps en millisecondes lorsque le déclencheur s'est produit depuis le début du cadre.

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

Lorsqu'un Déclencheur de Valeur de Variable Changée est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Valeur de Variable Changée)Description
Nouvelle Valeur dans la VariableFait référence à la nouvelle valeur d'une variable.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur de changement de variable s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le changement de valeur de la variable s'est produit.

Déclencheur (Objet Média Déclencheur) Valeurs

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

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

Déclencheur (Websocket Déclencheur) Valeurs

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

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

Déclencheur (OpenAI Déclencheur) Valeurs

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

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

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

Lorsqu'un Déclencheur de Pause / Reprise d'Expérience est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Événement Global d'Expérience)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 de chaîne qui indique la raison du déclenchement, telle que le départ d'un participant de l'étude.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le déclencheur d'événement global s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le déclencheur d'événement global s'est produit.

Déclencheur (Utilisateur Quitte l'Expérience) Valeurs

Lorsqu'un Déclencheur Participant A quitté l'Étude Multi-utilisateurs est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de l'utilisation de certaines actions :

Options de Déclencheur (Utilisateur Quitte l'Expérience)Description
Nombre Restant de Participants Le nombre de participants restant dans l'étude.
Horodatage du Déclencheur (Unixtime)L'horodatage de quand le Déclencheur Utilisateur Quitte l'Expérience s'est produit au format Unix avec des millisecondes.
Temps du Déclencheur (Depuis le Début du Cadre)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à quand le Déclencheur Utilisateur Quitte l'Expérience s'est produit.

N'hésitez pas à soumettre un autre bloc de contenu à traduire.

Prev
Objets
Next
Variables