labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Guide
    • COMMENCER

      • Éditeur de tâche
      • Présentation des stimuli
      • Exactitude de la réponse
      • Objets
      • Événements
      • Variables
      • Assistant de tâche
      • Système d'essai
      • Conception de l'étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
    • SUJETS EN VEDETTE

      • Conception d'expérience
        • Créer une étude
        • Modèles de Data Frame
      • Randomisation & Équilibre
      • Suivi oculaire
        • Présentation des Stimuli dans une Tâche de Suivi Oculaire
        • Comment Choisir les Paramètres de Calibration du Suivi Oculaire
        • Configurer le Suivi Oculaire dans une Tâche
        • Enregistrement et exportation des données de regard
        • Utiliser des formes comme zones d'intérêt (AOI) pour le suivi des yeux
        • L'expérience de calibration des participants
      • Questionnaires
      • Application de bureau
      • Études d'exemples
      • Recrutement de participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres sujets

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

      • Aperçu : Onglets principaux
      • Tableau de bord
      • Mes études
      • Études partagées
      • Mes fichiers
      • Bibliothèque d'expériences
      • Mon compte
      • Licence & Services
    • ONGLETS DE L'ÉTUDE

      • Aperçu : Onglets spécifiques à l'étude
      • Conception de l'étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
      • Éditeur de tâche
        • Contrôles de Tâches
        • Le Système des 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
        • Fonctions de l'Éditeur de Texte
        • Options de suivi oculaire dans l'éditeur de tâches
        • Suivi de la tête dans une tâche
        • Études Multi-Utilisateur
      • Paramètres
      • Variables
      • Médias
      • Textes & Traduire
      • Lancer & Participer
      • Gestion des sujets
      • Dataview et Export
        • Vue des données et sélection des variables & des tâches (ancienne version)
        • Accéder aux Enregistrements (Version ANCIENNE)
  • Vidéos
    • Aperçu des Vidéos
    • Commencer avec Labvanced
    • Créer des Tâches
    • Vidéos des Éléments
    • Événements & Variables
    • Sujets Avancés
  • Guides
    • Introduction
    • Tâche de Stroop
    • Tâche de Décision Lexicale
    • Tâche de Signalement de Gaze Posner
    • Paragigme de Clignotement d'Apathie
    • Étude d'Œil Suivant
    • Étude d'Œil Suivant de Bébé
    • Étude de Capture Attentionnelle avec Suivi de Souris
    • Présentation Visuelle Sérielle Rapide
    • Étude ChatGPT
    • Démonstration de Suivi Oculaire : SVG comme AOIs
    • Démonstration Multi-Utilisateur : Montrer les Curseurs des Sujets
    • Contrôleur de Gamepad / Joystick - Configuration de Base
    • Étude d'Application de Bureau avec Intégration EEG
    • Équilibrage des Groupes entre Sujets et Configuration des Variables
  • FAQ
    • Fonctionnalités
    • Politique de Support & Directives
    • Sécurité & Confidentialité des Données
    • Licences
    • Précision de Labvanced
    • Utilisation Programmatique & API
    • Utilisation de Labvanced Hors Ligne
    • Résolution de Problèmes
    • Questions de Création d'Études
  • Archives de la Newsletter
  • Documents
  • Salle de Cours

Système d'événements

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

Description

Le système d'événements est essentiel pour toute étude. C'est ainsi que vous configurez les valeurs à enregistrer, faites progresser l'expérience et créez des tâches. Les utilisateurs peuvent créer un système d'événements pour exécuter toutes les fonctionnalités, logiques et interactions dans une tâche. Un événement agit souvent comme un médiateur entre des objets et des variables.

  • Pour une liste complète des déclencheurs
  • Pour la liste complète des actions
  • Pour plus d'informations sur le menu de sélection de valeur pour définir des valeurs sous les événements
Aperçu de la façon dont les déclencheurs et les actions sont utilisés dans Labvanced.

Le système d'événements est composé de déclencheurs et d'actions. Ici, vous définissez des règles, comme 'quand cela se produit' (déclencheur), 'alors faites cela' (action). Par exemple : si un participant clique sur une image spécifique (déclencheur), alors montrez une autre image aléatoire (action).

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

Création d'événements - Vue d'ensemble

Les événements sont gérés dans l'éditeur de tâches sous l'onglet "Événements" dans le coin supérieur droit. De nouveaux événements peuvent être créés en cliquant sur + Frame Event pour les événements qui doivent se produire sur cette image ou en cliquant sur + Trial Event, ce qui applique l'événement à toutes les images. Tous les événements existants sont affichés dans une vue en liste dans le panneau latéral droit. 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 au sein d'un groupe d'essai pour les images spécifiées. Cependant, une logique personnalisée permet aux utilisateurs d'exécuter des événements uniquement dans certains essais, conditions ou dans d'autres circonstances.

Sélection d'un Déclencheur

Lorsque vous créez un nouvel événement, la sélection du déclencheur s'ouvre sous forme de grille de tuiles. Les types de déclencheurs sont organisés par catégorie (Entrée utilisateur, Signal physiologique, Essai et Image, Variable, Objet multimédia, API et Global). Une boîte de recherche en haut vous permet de filtrer les types de déclencheurs par nom. Cliquez sur n'importe quelle tuile pour la définir comme déclencheur de l'événement.

Une fois qu'un déclencheur est sélectionné, l'événement affiche une barre compacte avec le nom et l'icône du déclencheur actuel. Pour passer à un autre déclencheur, cliquez sur le bouton Change trigger (icône de crayon) pour rouvrir la grille de tuiles.

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

L'ordre d'exécution des événements peut être ajusté. Par défaut, les événements avec le même déclencheur sont plus en haut de la liste et seront exécutés en premier. Les événements peuvent également être copiés et supprimés. Lors de la sélection d'un événement existant, les 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 rouvrir (icône à côté du champ du nom).

Déclencheurs

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

Catégorie de déclencheur Options de déclencheur Description
User Input Triggers
  • Déclencheurs de souris
  • Déclencheurs de clavier
  • Clics de bouton
  • Entrée sur Input
  • 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 sa souris, cliquer sur un élément de clavier, faire défiler, etc.
Physiological Signal Triggers
  • Regard de suivi des yeux
  • Fixation de suivi des yeux
  • Suivi de la tête
Les déclencheurs de signaux physiologiques se produisent lorsqu'il y a une entrée physiologique spécifiée, comme fixer un élément spécifique ou des changements dans les mouvements de la tête.
Trial and Frame Triggers
  • Init Tâche
  • Init Image
  • Début de l'image
  • Fin de l'image
Ces déclencheurs se produisent par rapport aux essais expérimentaux et aux images, comme lorsque le cadre commence ou se termine.
Variable Value Changed TriggerVariable (Valeur changée)Un déclencheur pour l'événement se produit lorsqu'il y a un changement dans la valeur d'une variable spécifique.
Media Object TriggerDéclencheur d'objet multimédiaCe déclencheur se produit par rapport aux objets multimédias, comme une pause dans un fichier vidéo/audio, un enregistrement terminé, etc.
API Triggers
  • Déclencheur Websocket
  • Déclencheur Open AI
  • Message Publié Reçu
Ce sont des déclencheurs qui se produisent lorsqu'il y a des données entrantes d'une API.
Global Triggers
  • Pause / Reprendre l'expérience
  • Participant quitté l'étude multi-utilisateur
Les déclencheurs globaux se réfèrent à tout changement majeur dans une expérience, comme elle étant mise en pause ou un participant dans une étude multi-utilisateur quittant.

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éclencheur 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 utilisateurVue d'ensemble
Mouse Trigger Tout mouvement de souris peut être utilisé comme déclencheur pour initier un événement, tel que : défiler, cliquer, survoler, etc. Vous pouvez également associer des éléments ou cibles spécifiques à un déclencheur. Par exemple, un clic de souris sera utilisé comme déclencheur uniquement si une image spécifique est cliquée.
Keyboard TriggerToute pression de touche 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 en tant que déclencheurs.
Button-ClicksLes objets de bouton créés dans Labvanced peuvent être utilisés comme déclencheurs pour initier des événements.
Enter on InputCe déclencheur est couramment utilisé lorsqu'un participant appuie sur 'Entrée' lors d'une expérience, comme moyen de soumettre sa réponse écrite ou son entrée dans des zones de champ de texte.
Scroll TriggerCe déclencheur se produit lorsque le participant fait défiler. Vous pouvez spécifier des directions de défilement x ou y, ainsi que sur quels éléments le défilement se produit pour être utilisé en tant que déclencheurs d'événements.
Gamepad/ Joystick TriggerCe déclencheur vous permet d'utiliser des manettes et des contrôleurs de joystick dans votre conception expérimentale comme un périphérique d'entrée pour enregistrer des données.

Déclencheur de souris

L'option 'Déclencheur de souris' est un déclencheur d'événement très populaire car elle initie un événement basé sur toute interaction de la souris, comme : déplacer la souris vers le haut / vers le bas, cliquer, survoler un objet spécifique, quitter un objet spécifique, ou tout mouvement du tout !

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

L'exemple ci-dessous montre un 'Déclencheur de souris' qui se produira lorsqu'un 'Clic' est effectué par un clic de souris 'Gauche' 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 disponibles lors de l'utilisation des déclencheurs de souris :

Élément du menuZone de menuOptions et spécifications des déclencheurs de souris
Action

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

liste déroulante :
Explication du paramètre du bouton de la souris
  • Gauche : Déclenché par le bouton gauche de la souris
  • Droit : Déclenché par le bouton droit de la souris
Targets

options :
Gros plan sur la zone cible de la souris

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

Plusieurs cibles peuvent être ajoutées en cliquant sur l'option ‘+Add Target’ en bas.
Lors de la spécification d'une cible, les options suivantes sont disponibles :
  • Déclencher sur l'arrière-plan de la trame : 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é lorsque vous cliquez sur tout élément sur la trame.
  • Ajouter des cibles : sélectionner l’élément(s) spécifique(s) qui doit(vent) ê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 les valeurs spécifiques au déclencheur de souris dans diverses actions avec le menu de sélection de valeur.

Déclencheurs de Clavier

L'option ‘Déclencheur de Clavier’ est une autre manière populaire de déclencher un événement. Essentiellement, toute entrée provenant 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 configuré pour être une pression de clavier qui se produit lorsque les valeurs numériques cibles spécifiées (0, 2 ou 6) sont pressées :

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

Voici un aperçu complet des clés et options disponibles 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 pression de touche (la touche est enfoncée)
  • Pression OU Maintien de la Touche : Déclenche lorsque la touche est soit enfoncée soit maintenue
  • Relâcher la Touche : Déclenché par relâchement de la touche
Note : Une touche doit être relâchée avant de pouvoir ‘déclencher’ à nouveau comme un déclencheur.
Keys

quelle touche déclenche l'événement
Gros plan des options de touches.Quelle touche est utilisée comme déclencheur est spécifié en sélectionnant les options ici en cliquez sur +Add:
  • Flèches : les quatre touches de flèche
  • Chiffres : Chiffres de 0-9
  • Lettres : Toutes les lettres de l'alphabet anglais
  • Spécial : Touches spéciales (Entrée, Espace, Contrôle, Tab, Maj)
  • Touches F : F1 à F10
  • n'importe quelle touche : n'importe laquelle de ces touches est acceptable
Vous pouvez ajouter plusieurs déclencheurs de clavier en cliquant à nouveau sur le bouton +Add:
Options SupplémentairesOptions supplémentaires pour les déclencheurs de clavier L'option activer les boutons du pavé numérique permet l'utilisation des 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/s’effectuent sans cela. Seul le premier se déclenchera et l'exécution de l'événement s'arrêtera après le premier événement terminé.
  • 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 les valeurs spécifiques au déclencheur de clavier dans diverses actions avec le menu de sélection de valeur.

Déclencheur de Clic de Bouton

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

Le menu de clic de bouton dans Labvanced

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

Options disponibles pour le déclencheur de clic de bouton

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

Élément du menuZone de menuOptions de Déclencheur de Clic de Bouton
Cible :

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

Déclencheur Entrée sur Input

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

Paramètres :

  • Ajouter des Cibles : Ajouter un élément d'entrée à l'Événement.

  • Note : Après avoir sélectionné le déclencheur Entrée sur Input dans le système d'événements, vous avez la possibilité d'utiliser et de référencer les valeurs spécifiques au déclencheur Entrée sur Input dans diverses 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 souris est utilisée sur un élément spécifique.

Paramètres :

  • Choisissez si le défilement est sur l'axe Y ou l'axe X (défilement vertical ou horizontal).

Cible : Définissez l'élément cible auquel le déclencheur de défilement s'appliquera.

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

  • 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 les valeurs spécifiques au déclencheur de défilement dans diverses actions avec le menu de sélection de valeur.

Déclencheur de Gamepad / Joystick

Le Gamepad/ Joystick Trigger vous permet de faire usage des manettes de jeu et des contrôleurs de joystick dans votre conception expérimentale en tant que dispositif d'entrée pour l'enregistrement des données. Note : n'oubliez pas d'activer cette option sous l'onglet Settings.

En savoir plus.

Déclencheurs de Signaux Physiologiques

Ces déclencheurs ne s'appliqueront que si le suivi oculaire et/ou le suivi de la tête a été activé pour la tâche.

Déclencheur de Regard de Suivi Oculaire

Déclenche lorsque :

  • Dans l'ensemble, ce déclencheur s'appliquera lorsque le suivi oculaire a été activé.
  • Déclenche uniquement lorsque vous regardez 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 en tant que 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 les valeurs spécifiques au déclencheur de regard dans diverses actions avec le menu de sélection de valeur.

En savoir plus : Consultez la page dédiée au Déclencheur de Regard de Suivi Oculaire pour activer le suivi oculaire, enregistrer les données de regard, et des exemples pratiques.

Déclencheur de Fixation de Suivi Oculaire

Ce déclencheur est encore 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 les valeurs spécifiques à la fixation de suivi oculaire dans diverses actions avec le menu de sélection de valeur.

En savoir plus : Consultez la page dédiée au Déclencheur de Fixation de Suivi Oculaire pour activer la Détection de Fixation, enregistrer les données de fixation, et des exemples pratiques.

Déclencheur de Suivi de Tête

Déclenche lorsque :

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

  • Remarque : Après avoir sélectionné le déclencheur de suivi de tête dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de suivi de tête spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Déclencheurs d'essai et de cadre

Déclencheur d'initialisation de tâche

Déclenche lors de :

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

Ce déclencheur se marie bien avec les actions Mélanger et Lire à partir de. Avec ces combinaisons, vous pouvez mélanger les entrées de tableau ou les cadres de données au démarrage de la tâche et assigner des sujets à des ensembles de stimuli sans avoir à créer plusieurs événements pour lire les stimuli ou les données.

Paramètres : Aucun

  • Remarque : Après avoir sélectionné le déclencheur d'initialisation de tâche dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs d'initialisation de tâche spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Déclencheur d'initialisation de cadre

Déclenche lors de :

  • L'initialisation du cadre, avant qu'il ne devienne visible pour le participant.

Ce déclencheur se marie bien avec les actions Mélanger, Lire à partir de et Dessiner un nombre aléatoire. Avec ces combinaisons, ces actions peuvent être terminées avant que le cadre n'apparaisse, laissant un chemin clair pour que d'autres actions commencent lorsque le cadre commence.

Remarque : Ne pas utiliser le déclencheur d'initialisation de cadre avec des événements qui enregistrent une variable ou qui impliquent des variables système telles que le numéro d'essai ou le numéro de condition. En effet, le déclencheur d'initialisation de cadre se produit entre les essais, donc il n'y a pas de comptage totalement précis de l'essai ou de la condition sur le point d'être affiché.

Paramètres : Aucun

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

Remarque sur les déclencheurs d'initialisation de tâche et de cadre : Parce que les déclencheurs d'initialisation de tâche et de cadre se produisent avant le début de la tâche ou du cadre, les variables créées pendant ce temps seront réinitialisées lorsque la tâche/le cadre commencera réellement. Un avertissement apparaîtra lors de l'utilisation de cet événement :

avertissement d'initialisation de cadre

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

Déclencheur de début de cadre

Déclenche lors de :

  • Début du cadre

Paramètres : Aucun

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

Déclencheur de fin de cadre

Déclenche lors de :

  • Fin du cadre (après que le cadre ne soit plus visible)

Paramètres : Aucun

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

Déclencheur de valeur de variable changée

Valeur de variable changée

Déclenche lors de :

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

Paramètres :

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

  • Remarque : Après avoir sélectionné le déclencheur de valeur de variable changée dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs de variable changée spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Déclencheurs d'objet multimédia

Déclencheur d'objet multimédia

Autrefois connu sous les noms de déclencheurs séparés "Contrôler l'audio/vidéo" et "Contrôler objet".

Déclenche lors de :

  • Début, pause ou arrêt d'un fichier vidéo ou audio
  • Téléchargement de fichier terminé, fichier sélectionné, enregistrement terminé d'un objet d'enregistrement
  • Instantané terminé ou téléchargement complet d'un objet d'instantané de caméra

Paramètres :

  • Cible : Sélectionnez un élément d'objet qui existe sur le cadre

  • Exécuter sur : Sélectionnez le sous-type de déclencheur

    • Options d'objet audio ou vidéo :
      • Lecture démarrée : Déclenche lorsque l'élément commence à jouer
      • Lecture arrêtée : Déclenche lorsque l'élément est en pause
      • Lecture terminée : Déclenche lorsque l'élément arrête de jouer
    • Options d'objet vidéo, audio ou 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 de fichier est complet
    • Options d'objet d'instantané de caméra :
      • Instantané terminé : Déclenche lorsque la caméra a réussi à prendre un instantané
      • Téléchargement complet : Déclenche lorsque l'instantané est terminé de télécharger
  • Remarque : Après avoir sélectionné le déclencheur d'objet multimédia dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs d'objet multimédia spécifiques au déclencheur dans diverses actions avec le menu de sélection de valeur.

Déclencheurs API

Si vous avez besoin d'envoyer ou de communiquer des données d'un serveur externe à 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
  • MessagePost reçu

Le menu de déclencheurs API dans Labvanced.

Déclencheur Websocket

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

L'option de menu de déclencheur Websocket.

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

Le menu de dialogue du déclencheur Websocket.

  • Accepter/Recevoir de : Détecte automatiquement l'adresse IP de l'hôte local. Peut être modifiée manuellement dans l'onglet Settings sous Special Features.
  • Déclencheur/message : saisissez le message qui servira de déclencheur. Tapez 'any' pour accepter plus d'un message comme déclencheur.

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

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

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

Déclencheur OpenAI

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

Le menu du Déclencheur OpenAI dans Labvanced.

Sélectionner cette option affichera les paramètres suivants :

Les options du menu de déclencheurs OpenAI.

REMARQUE : Consultez également ce guide où nous construisons une étude étape par étape, intégrant ChatGPT dans une étude et utilisant ce déclencheur.

Dans l'exemple ci-dessous, le cadre de données qui a été assigné 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 désignera le ‘rôle’ et la deuxième colonne le ‘message de chat.’ Les valeurs de l'action seront automatiquement ajoutées au cadre de données qui est lié ici.

Un exemple du Déclencheur OpenAI dans Labvanced.

Si vous utilisez également l'‘Action Envoyer à OpenAI’, alors vous devez utiliser le même cadre de données que vous avez indiqué ici.

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

Déclencheur MessagePost reçu

Le PostMessage Received déclenche lorsque l'expérience en cours reçoit un message entrant d'une source externe via l'API postMessage du navigateur. Il est utile pour connecter une expérience à une page parente, à une application personnalisée ou à un site web externe intégré qui envoie des données dans l'étude.

En savoir plus.

  • Remarque : Après avoir sélectionné le déclencheur MessagePost reçu dans le système d'événements, vous avez la possibilité d'utiliser et de faire référence aux valeurs spécifiques au déclencheur MessagePost reçu dans diverses actions avec le menu de sélection de valeur.

Déclencheurs globaux

Les déclencheurs globaux se produisent chaque fois qu'un changement majeur se produit dans l'expérience, c'est-à-dire quelque chose qui est "global", comme mettre l'expérience en pause ou un participant quittant une étude multi-utilisateurs ! Les options suivantes sont répertoriées comme des déclencheurs globaux :

  • Mettre en pause / Reprendre l'expérience
  • Participant a quitté l'étude multi-utilisateurs

Le menu des déclencheurs globaux dans Labvanced.

Mettre en pause/Reprendre l'expérience

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

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

Après avoir sélectionné ce déclencheur, la vue suivante apparaît où vous pouvez préciser davantage la nature du déclencheur, qu'il doit être exécuté lorsque l'expérience est mise en pause ou 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 (sort en plein écran) l'étude.

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

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

Participant a quitté l'étude multi-utilisateurs

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 les autres participants de continuer l'étude.

L'option Participant a quitté l'étude multi-utilisateurs 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.

La boîte de dialogue du déclencheur participant a quitté l'étude multi-utilisateurs.

  • Remarque : Après avoir sélectionné le déclencheur Participant a quitté l'étude multi-utilisateurs dans le système d'événements, vous avez la possibilité d'utiliser et de référencer des valeurs spécifiques au déclencheur dans diverses actions avec le menu des sélecteurs 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 modifier des variables et des propriétés d'objet, enregistrer des données, lire et écrire des données vers / depuis des tableaux, ou passer au prochain essai ou tâche. Souvent, il y a plusieurs actions par événement. En utilisant "ControlActions", on peut effectuer des opérations logiques (instructions If-Else), des boucles, des fonctions de rappel, ainsi que imbriquer des actions les unes dans les autres (par exemple, une boucle while à l'intérieur d'une instruction if). Ainsi, le système d'événements peut être vu comme un environnement de programmation graphique. Dans cette vue, les déclencheurs agissent comme des appels de fonction, tandis que les actions décrivent la logique fonctionnelle. Cette approche garantit qu'une presque toute logique expérimentale peut être mise en œuvre sans avoir recours à certaines structures programmatiques / syntaxiques.

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

Catégorie d'Action Options d'Action Description
Object Actions
  • Définir la Propriété de l'Objet
  • Contrôler l'Objet Média
  • Copier l'Objet
  • PourChaque Objet
Les actions sur les objets se réfèrent à toute manipulation qui se produira sur un objet existant dans la tâche.
Variable Actions
  • Définir / Enregistrer la Variable
  • Copier dans le Presse-papiers
  • Tirer un Nombre Aléatoire
  • Obtenir le Paramètre URL
  • Lire depuis / Écrire sur le Dispositif
  • Lire depuis / Écrire sur la Variable Partagée
  • Math & Statistiques
  • Enregistrer des Variables Instantanément
  • Filtre de Moyenne Mobile
  • Distribuer la Variable
Toute action qui lit ou enregistre une valeur de variable.
Array Actions
  • Sélectionner Dans le Tableau (Lire)
  • Ajouter / Supprimer des Éléments de Tableau
  • Modifier l'Élément du Tableau (Remplacer)
  • Mélanger les Éléments du Tableau
Les opérations sur les tableaux impliquent la sélection, l'ajout, la suppression, le changement et le mélange des tableaux et de leurs éléments.
Data Frame Operations
  • Lire depuis / Écrire sur le Cadre de Données
  • Mélanger les Éléments du Cadre de Données
Ces actions sont pertinentes si vous travaillez avec des fichiers .csv (cadres de données) dans votre expérience.
Jump Actions
  • Aller à
  • Accepter / Terminer la Session
  • Rejeter / Terminer la Session
  • Rediriger vers l'URL
Vous permet de naviguer dans l'expérience en passant à une section spécifique, ainsi que d'accepter et de rejeter les sections des participants.
Control Actions
  • Actions de Condition (Si...Alors)
  • Actions Répétées (Boucle While)
  • Actions Retardées (Callback de Temps)
  • Groupe d'Actions
Les actions de contrôle sont utilisées pour exécuter des séquences d'événements spécifiques, comme la logique si/alors, les boucles (comme jouer un son répété ou faire clignoter une image), ainsi que pour établir un délai pour lorsque se produit une action.
API Actions
  • Envoyer PostMessage
  • Envoyer vers Websocket
  • Envoyer vers OpenAI
Se réfère aux actions spécifiques à l'API pour envoyer des données à une API.
Code Actions
  • Exécuter JavaScript
  • Définir CSS Global
Les actions de code vous permettent de travailler avec JavaScript ou CSS.
Paste ActionAction de CollageVous permet de coller une action que vous avez copiée précédemment.

Actions sur les Objets

Les actions sur les objets se réfèrent à toute manipulation qui se produira sur un objet existant dans la tâche. Il y a plusieurs options d'Action sur les Objets :

  • Définir la Propriété de l'Objet
  • Contrôler l'Objet Média
  • Copier l'Objet
  • PourChaque Objet

L'option Actions sur les Objets dans Labvanced.

Action Définir la Propriété de l'Objet

Avec l'action 'Définir la Propriété de l'Objet', vous pouvez changer l'apparence d'un objet comme bon vous semble en spécifiant l'objet en question, la propriété à modifier et la nouvelle valeur.

En savoir plus.

Action Contrôler l'Objet Média

Auparavant, les actions "Contrôler Audio/ Vidéo" et "Contrôler Objet" étaient séparées.

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électionner un objet média
  • Effet : Sélectionner une sous-action
    • Options d'Objet Audio ou Vidéo :
      • Démarrer la Lecture : Commence à lire le fichier vidéo/audio
      • Arrêter la Lecture : Arrête le fichier vidéo/audio
      • Mettre en Pause la Lecture : Met en pause le fichier vidéo/audio
      • JumpToTime : permet de spécifier un temps en millisecondes à sauter dans le fichier audio/vidéo
      • Couper le son : éteint le son de l'objet
      • Rétablir le Son : restaure le son de l'objet
    • Options d'Objet Audio, Vidéo ou d'Enregistrement d'Écran :
      • Démarrer l'Enregistrement : Commence un nouvel enregistrement (audio)
      • Arrêter l'Enregistrement : Arrête l'enregistrement (audio)
      • Démarrer le Téléchargement : Commence à télécharger le fichier
      • Effacer l'Enregistrement : Supprime les données d'enregistrement (audio).
      • Démarrer la Lecture : Commence à lire le fichier enregistré
      • Arrêter la Lecture : Arrête la lecture du fichier enregistré
      • Mettre en Pause l'Enregistrement : met en pause l'enregistrement de l'objet
      • Reprendre l'Enregistrement : reprend l'enregistrement de l'objet
    • Options d'Objet de Téléchargement de Fichier :
      • Démarrer le Téléchargement : commence le processus de téléchargement pour le fichier sélectionné
      • Effacer le Fichier : Supprime le fichier sélectionné
      • Choisir le Fichier : permet au participant de choisir le fichier souhaité
    • Options d'Objet de Prise de Vue par Caméra :
      • Démarrer la Caméra : allume la caméra du participant
      • Arrêter la Caméra : éteint la caméra du participant
      • Démarrer le Téléchargement : commence à télécharger la capture d'écran vers l'expérience
      • Prendre une Capture d'Écran : prend une photo à l'aide de la caméra du participant

Action de copie d'objet

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

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 le nouveau nom de l'élément : Choisissez parmi plusieurs paramètres pour déterminer les noms des copies.
  • Attribuer un nom avec un suffixe incrémental : Ajoute une étiquette numérique à la fin du nouveau nom de l'élément pour différencier les copies.
  • Séquence d'action : Vous permet de choisir (dans la liste habituelle des actions) ce qui arrivera aux copies. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à toutes les copies.

Action PourChaque Objet

Effet : Applique une action à plusieurs objets du même type.

Paramètres :

  • Filtre : Choisissez le type d'élément à cibler.
  • Autoriser un filtre de nom supplémentaire : Tapez le nom des objets à cibler. Pour plusieurs objets sur un cadre où certains ont des noms identiques, cela fonctionne bien.
  • Séquence d'action : Vous permet de choisir (dans la liste habituelle des actions) ce qui arrivera aux éléments sélectionnés. Sélectionnez "CurrentObject" comme cible pour appliquer l'action à tous les éléments répondant aux critères spécifiés ci-dessus.

Actions sur les variables

Les actions sur les variables sont utilisées pour définir ou créer des valeurs de variables, enregistrer et définir des valeurs, y compris des valeurs à travers les sessions.

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

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

Option d'action sur les variablesDescription
Set / Record VariableÉcrire ou définir une valeur de variable
Copy to ClipboardCopier une valeur de variable dans le presse-papiers interne de l'ordinateur.
Draw Random NumberTire un ou plusieurs nombre(s) aléatoire(s) et les enregistre dans une variable
Get URL ParameterEnregistrer une valeur de l'URL unique du participant
Read from / Write to Device Lit ou écrit une variable dans/sur le stockage local de l'appareil. Cette action enregistre des données sur l'appareil du participant plutôt que d'envoyer les données aux serveurs de Labvanced.
Read from / Write to Shared VariableLit ou écrit dans une variable qui est partagée à travers les sessions d'une étude. La variable peut être partagée avec tous les participants ou être privée à chaque individu.
Math & StatisticsEffectue une opération mathématique sur une certaine variable d'entrée (tableau) et enregistre le résultat dans une variable de sortie.
Record Variables InstantlyCrée un instantané de toutes les valeurs des variables et l'envoie au serveur Labvanced.
Moving Average FilterCalcule une moyenne mobile (une moyenne en constante mise à jour des données) d'une certaine entrée et stocke le résultat dans une nouvelle variable.
Distribute VariableEnvoie une valeur à d'autres participants. La valeur est stockée dans une variable.

Action Définir / Enregistrer Variable

L'action ‘Définir / Enregistrer Variable’ est destinée à être utilisée dans chaque expérience Labvanced car c'est ainsi que les valeurs et mesures comportementales sont stockées et enregistrées.

Emplacement de l'action de définition/enregistrement de 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éfinition/enregistrement de variable dans le système d'événements

Éléments du menuZone du menuDescription
SelectSélectionner quels participants le distributeur de variables est envoyéEn cliquant sur sélectionner, vous indiquez quelle variable doit stocker la valeur. De là, vous pouvez également créer une nouvelle variable.
Icône de styloSélectionner quels participants le distributeur de variables est envoyéL'icône de stylo symbolise le menu de sélection de valeur qui est utilisé pour définir et spécifier les valeurs exactes qui doivent être attribuées à la variable sélectionnée (comme précisé dans le bouton vert à gauche du signe égal (=)).

Dans l'exemple ci-dessous, nous avons créé une nouvelle variable appelée counter et utilisé une option arithmétique du menu de sélection de valeurs pour faire augmenter la valeur de la variable de 1 (basé sur le 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 montre comment trois actions sont utilisées pour rendre possible l'enregistrement des valeurs des variables. La variable (à gauche) est créée manuellement tandis que la valeur à droite du signe égal (=) est une valeur spécifique à un déclencheur de 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 Set / Record Variable est également couramment utilisée dans le contexte de Control Actions où vous pouvez spécifier des conditions à l'aide de "si/alors" et "boucles while" basées sur les 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 enregistre dans une variable.

Paramètres :

  • Type : Choisir entre des valeurs continues et discrètes
  • Distribution : Choisir entre distribution gaussienne et uniforme
  • Plusieurs tirages (booléen vrai/faux) : Choisir de tirer une fois ou plusieurs fois.
  • Nb de tirages : Sélectionner le nombre de tirages
  • Min : Définir la valeur minimale pour la distribution uniforme
  • Max : Définir la valeur maximale pour la distribution uniforme
  • Moyenne : Définir la valeur moyenne pour la distribution gaussienne
  • Écart type : Définir l'écart type pour la distribution gaussienne
  • Enregistrer dans une variable : Sélectionner une variable où les valeurs sont stockées.

Action Obtenir le Paramètre d'URL

Effet : enregistre une valeur de l'URL unique du participant.

Paramètres :

  • Nom du paramètre : saisir le nom du paramètre souhaité
  • Enregistrer dans une variable : sélectionner la variable dans laquelle enregistrer la valeur du paramètre.

Cette action pourrait être combinée avec d'autres actions pour construire des URL uniques pour les participants ou extraire des informations nécessaires à l'analyse des données.

Action Lire de / Écrire sur l'Appareil

Effet : Lit ou écrit une variable dans/sur le stockage local de l'appareil. Cette action enregistre des données sur l'appareil du participant plutôt que d'envoyer les données aux serveurs de Labvanced.

Paramètres :

  • Choisir de lire ou d'écrire sur l'appareil local.
  • Choisir la variable à lire ou écrire.

Cas d'utilisation : Études longitudinales/multi-sessions

  • Avec cette action, les données spécifiques à l'appareil peuvent être transférées d'une session à l'autre, à condition que le même participant utilise le même appareil pour chaque session.
  • Par exemple, vous pouvez utiliser cette action pour enregistrer quelles images ont été présentées à chaque participant dans la Session 1 et vous assurer que des images différentes leur sont présentées dans la Session 2.
    • Créez un tableau d'images et sélectionnez-en quelques-unes au hasard à présenter dans chaque session.
    • Écrivez sur l'appareil : le numéro d'index des images présentées dans la Session 1.
    • Lisez depuis l'appareil : dans la Session 2, lisez les index des images de la Session 1 et incluez une action JavaScript qui empêche ces index d'être sélectionnés pour la deuxième session.

Action Lire de / Écrire sur une Variable Partagée

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

Paramètres :

  • Choisir la variable à synchroniser. Doit être soit scalaire soit un tableau.
  • Options avancées
    • Clé de stockage : choisir le nom d'une variable pour servir de clé d'accès à la variable synchronisée.
    • Méthode de lecture ou d'écriture :
      • Lire, modifier, puis écrire la variable partagée : lit la variable, y apporte une modification, puis envoie la variable à l'étude.
      • Lire seulement la valeur partagée du serveur : appelle la variable qui est partagée au sein de l'étude, mais ne fait aucune modification.
      • Écrire seulement la variable sur le serveur : apporte des modifications à la variable partagée, mais ne l'affiche pas aux participants.
      • Partager des valeurs entre différents participants (pas seulement entre sessions) : permet aux participants de voir les valeurs des variables synchronisées des autres participants à travers les sessions. Cette option est sélectionnée par défaut, mais peut être désélectionnée en cliquant sur la case à cocher.
  • Séquence d'action :
    • Choisissez ce qui arrive à la variable partagée/synchronisée à partir de la liste de toutes les actions disponibles.

Use Case: Études longitudinales / multi-sessions

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

Action Math & Statistiques

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

Paramètres :

  • Type : Choisir entre Opérations sur les tableaux, Algèbre linéaire et Tests statistiques
  • Opération : Choisir une opération mathématique (e.g. somme, min, écart type, etc.)
  • Tableau d'entrée : Choisir 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électionner une variable de sortie où le résultat sera stocké.

Action Enregistrer des Variables Instantanément

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

Paramètres : Aucun

Action Filtre de Moyenne Mobile

Effet : Calcule une moyenne mobile (une moyenne à jour en permanence des données) d'une entrée et stocke le résultat dans une nouvelle variable.

Paramètres :

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

Action Distribuer des Variables

L'action Distribuer des Variables est essentielle pour des études multi-utilisateurs dans Labvanced. Avec cette action, une valeur de variable peut être partagée entre les participants, permettant essentiellement aux informations (y compris les emplacements des stimuli et toutes modifications) d'être reflétées sur les écrans des participants.

L'action Distribuer des Variables dans le menu d'action Labvanced.

Après avoir sélectionné 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 des Variables lorsque tous les éléments du menu sont remplis. Dans cet exemple, la variable distribuée est une action qui est utilisée comme moyen de créer un chat entre deux participants en distribuant la valeur d'une variable d'un objet de champ d'entrée.

La variable Distribuer étant utilisée avec toutes les options de menu définies comme exemple.

Découvrez cette démo qui intègre la variable distribuée et la fonctionnalité de chat ici : Tâche de Description d'image avec module complémentaire de chat.

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

Élément de MenuZone de MenuOptions et Description de l'Action Distribuer des Variables
Distribute value toSélection de quels participants la variable distribuée est envoyéeChoisir à quels autres participants la valeur doit être envoyée.
  • Tous les participants : Envoyer cette valeur à tous les participants
  • Participants Sélectionnés : Envoyer la valeur aux participants sélectionnés.
Choose target variable and valueSpécification de la cible de variable et des valeurs
  • Variable Cible : Choisir une variable cible où la valeur sera stockée.
  • Valeur : Déterminer la valeur qui doit être envoyée aux autres participants.
BlockL'option de blocage de la variable distribuéeSi activé, la variable cible ne peut pas être modifiée jusqu'à ce que la distribution de valeur actuelle soit terminée.
Rate Limit StrategyLes 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 un débordement du serveur et agit comme une stratégie préventive pour contrôler la fréquence à laquelle les requêtes (c'est-à-dire, les mises à jour via la variable distribuée) 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, de nouveaux messages serveur seront "debounced" (seul le message le plus récent sera envoyé après un intervalle de 100 ms sans exécution de cette action).
  • Throttle : Lorsque cette action s'exécute plus d'une fois par fenêtre de temps de 100 ms, de nouveaux messages seront limités (c'est-à-dire qu'après 100 ms passées 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, de 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, de 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 : Lira une variable dans un tableau et stockera cette valeur dans une variable scalaire.

Paramètres :

  • Variable de Tableau : Tableau d'entrée pour lire la valeur.
  • Type d'Index : Détermine quel type d'index est utilisé.
    • Fixe : Utiliser un index fixe pour l'opération de lecture. Dans ce cas, tapez la position à partir de laquelle l'information doit être lue (1 basé).
    • 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 de Tableau : Lire depuis la fin du tableau.
  • Variable de sortie : Sélectionner une variable scalaire où la valeur lue sera stockée.

Action Ajouter / Enlever des Éléments de Tableau

Effet : Ajoute et/ou enlève des entrées d'un tableau.

Paramètres :

  • Variable de Tableau : Variable de tableau où l'opération ajouter ou retirer doit être exécutée.
  • Type d'Index : Détermine quel type d'index est utilisé.
    • Fixe : Utiliser un index fixe pour l'opération d'insertion / suppression. Dans ce cas, tapez la position du tableau où les entrées doivent être insérées / supprimées. (1 basé).
    • Variable : Utiliser une variable numérique comme index pour l'opération d'insertion / suppression. Dans ce cas, sélectionnez une variable numérique scalaire pour déterminer où les entrées doivent être insérées / supprimées.
    • Fin de Tableau : Insérer / supprimer depuis la fin du tableau.
  • Nombre d'entrées à supprimer : Enlèvera les entrées du tableau (avant d'insérer de nouvelles entrées) à partir de la position d'index définie. 0 indique qu'aucune valeur ne sera enlevée.
  • Variable(s) à insérer : Sélectionnez une ou plusieurs variables scalaires, qui seront ajoutées à la variable du tableau à la position d'index définie.

Action Changer (Remplacer) une Entrée de Tableau

Effet : Remplace / modifie 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 la position du tableau qui doit être changée (1 basé).
    • 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 de Tableau : Remplace la dernière entrée dans le tableau.
  • Variable d'entrée : Sélectionnez une variable (scalaire) qui contient la nouvelle valeur.

Action Réorganiser les Entrées du Tableau

Effet : Mélangera les entrées / l'ordre dans un tableau.

Paramètres : Aucun

Opérations sur les Cadres de Données

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

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

Paramètres :

  • Variable de cadre de données : sélectionner 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 vers le cadre de données sélectionné.
  • Par ligne ou colonne : Choisissez comment les données doivent être lues.
  • Type d'index : Choisissez le type de variable d'index qui sera utilisé pour lire le cadre de données. Peut être fixe, variable ou la dernière ligne.
  • Variable d'index : Choisissez la variable qui sera utilisée comme index pour lire le cadre de données.
  • Variable de sortie : Choisissez la variable où les données lues/écrites seront stockées comme sortie. Doit être une variable de tableau.

Action Mélanger les Entrées 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

Sauter à l'action

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

Paramètres :

  • Sauter à : Détermine où sauter dans l'expérience.
    • Prochain cadre : Saute au cadre suivant. S'il n'y a plus de cadres définis dans un essai, il sautera au premier cadre du prochain essai.
    • Prochain essai : Saute au prochain essai. S'il n'y a plus d'essais définis, il sautera au premier essai de la prochaine tâche.
    • Prochaine tâche : Saute à la prochaine tâche. S'il n'y a plus de tâches définies, il sautera à la première tâche du prochain bloc.
    • Prochain bloc : Saute au prochain bloc. S'il n'y a plus de blocs définis, la session se terminera.
    • Cadre précédent : Saute au cadre précédent. S'il n'y a pas de cadres précédents, l'action ne sera pas exécutée.
    • Cadre spécifique : Saute à un cadre spécifique. Les utilisateurs sélectionnent directement le cadre vers lequel sauter.
    • Essai spécifique : Saute à un essai spécifique. Les utilisateurs sélectionnent directement le numéro de l'essai vers lequel sauter.
    • Tâche spécifique : Saute à la première instance de la tâche spécifiée dans le bloc actuel. Les utilisateurs sélectionnent directement la tâche vers laquelle sauter.
    • Bloc spécifique : Saute à la première instance du bloc spécifié. Les utilisateurs sélectionnent directement le bloc vers lequel sauter.
  • Vérifier les réponses requises avant : Si activé, l'expérience vérifiera si toutes les réponses requises ont déjà été répondues. Sinon, l'action de saut n'est pas exécutée.

Accepter / Terminer l'action de 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 des essais 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. S'il s'agit d'une session de crowdsourcing (un lien de crowdsourcing a été utilisé), le code de compensation sera montré au participant. Si désactivé, l'expérience se terminera après avoir affiché le cadre actuel et ne montrera pas l'écran de fin par défaut avec le code de compensation.

Rejeter / Terminer l'action de session

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

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

Paramètres : Aucun

Rediriger vers l'action URL

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

Note : 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 / Sinon-Si consiste en des comparaisons imbriquées ET / OU pour évaluer si toutes les conditions sont remplies (la déclaration est vraie) ou non (la déclaration est fausse). Si la déclaration est vraie, les actions sous "Alors" sont exécutées.

Paramètres :

  • Ajouter une condition : Ajouter une nouvelle condition à une déclaration. Le menu "sélection de valeur" apparaîtra des deux côtés pour faire une comparaison logique. Au milieu de la déclaration, vous pouvez choisir comment les deux côtés doivent être comparés (par exemple, égal, moins que, inégal, etc.).
  • Ajouter un groupe OU : Un seul des exigences au sein d'un groupe OU doit être vrai pour que l'ensemble du groupe soit vrai. Ajoutez un groupe OU si les sous-actions doivent être exécutées dans plusieurs cas.
  • Ajouter un groupe ET : Toutes les conditions au sein d'un groupe ET doivent être vraies pour que l'ensemble du groupe soit vrai. Ajoutez un groupe ET si les sous-actions doivent être exécutées uniquement lorsque plusieurs conditions sont remplies.
  • Séquence d'actions : Chaque déclaration Si / Sinon-Si a une liste d'actions, qui sont définies sous "Alors". La séquence d'actions répertorie toutes les actions pour une certaine déclaration Si / Sinon-Si. Une nouvelle action peut être ajoutée via l'icône "Ajouter une action". La séquence d'actions sera exécutée uniquement si les condition(s) de la déclaration Si / Sinon-Si associée sont remplies.
  • Ajouter un cas Sinon-Si : L'action de condition peut consister en plusieurs déclarations séparées Si / Sinon-Si --> Alors. Cependant, seule une déclaration peut être exécutée. Si une déclaration Si / Sinon-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 / Sinon-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 : Ceci exécutera la boucle continuellement jusqu'à ce que la condition d'arrêt soit remplie.
    • Exécuter toutes les ... ms : Ceci exécutera la boucle avec un intervalle défini (par exemple, la boucle est exécutée toutes les 50 ms).
  • Définir le nombre de boucles : Lorsque "Exécuter toutes les ... ms" est sélectionné, les utilisateurs ont la possibilité d'assigner une valeur entière numérique pour le nombre de fois que la boucle doit être exécutée. Cela remplace le besoin de définir une condition d'arrêt.
  • Intervalle d'exécution : Cela détermine l'intervalle d'exécution.
  • Commencer immédiatement (vrai / faux) : Si activé, cela exécutera la boucle immédiatement. Si désactivé, la boucle sera lancée lors du prochain intervalle d'exécution.
  • Autoriser plusieurs démarrages (vrai / faux) : Si activé, plusieurs instances de boucle peuvent être démarrées en parallèle. Si désactivé, une seule instance de boucle peut être exécutée à la fois.
  • Activer la condition d'arrêt (vrai / faux) : Si activé, une condition d'arrêt pour la boucle peut être spécifiée.
  • Condition d'arrêt : La condition d'arrêt peut être utilisée pour spécifier une expression logique pour quand l'exécution de la boucle doit être arrêtée. Similaire aux déclarations Si / Sinon-Si, on peut combiner des groupes ET, des groupes OU et des exigences pour la comparaison logique.
  • Séquence d'actions : La séquence d'actions répertorie toutes les actions qui sont exécutées à chaque itération de la boucle. Une nouvelle action peut être ajoutée via l'icône "Ajouter une action".

Actions différées ( rappel de temps) Action

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

Paramètres :

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

Groupe d'actions

Les actions peuvent également être organisées en groupes d'actions. Les groupes d'actions vous permettent de regrouper certaines actions ensemble pour une structure visuelle plus facile, mais aussi si vous souhaitez copier, dupliquer ou supprimer plusieurs actions à la fois.

En savoir plus.

Actions API

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

  • Envoyer PostMessage
  • Envoyer vers Websocket
  • Envoyer vers OpenAI

Pour que ces actions soient 'disponibles' ou utilisables, vous devez entrer une clé API dans l'onglet Settings.

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

Envoyer PostMessage Action

L'action Send PostMessage envoie un message d'une expérience Labvanced en cours à une cible externe, comme une page web parente ou un cadre intégré, en utilisant l'API postMessage du navigateur.

En savoir plus.

Envoyer vers Websocket Action

L'action Envoyer vers Websocket dans le menu d'action Labvanced.

Lorsque vous sélectionnez cette action, les options suivantes apparaissent :

Options pour l'action Envoyer vers 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 vers :Spécifie l'adresse Websocket qui est listée dans l'onglet Settings sous Special Features.
Déclencheur/message à envoyer :Spécifiez le déclencheur ou le message que vous souhaitez envoyer.
Envoyer variable (optionnel) :Indiquez la variable qui peut également être envoyée en tant que partie de l'action.

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

Envoyer vers OpenAI Action

L'action 'Envoyer vers OpenAI' vous permet d'envoyer des informations, comme une valeur d'entrée de chaîne, à OpenAI. Veuillez noter que pour que cette option soit disponible, vous devez inscrire votre clé API dans l'onglet Settings sous Special Features.

L'action Envoyer vers OpenAI dans le menu d'action Labvanced.

Les options suivantes apparaîtront lorsque vous cliquerez sur cet événement :

Options pour l'action Envoyer à OpenAI.

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

Exemple de l'action Envoyer à OpenAI en cours d'utilisation.

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

NOTE : Référez-vous également à ce tutoriel où nous construisons une étude étape par étape, en intégrant ChatGPT dans une étude et en utilisant cette action.

Voici une explication plus approfondie des champs inclus sous l'action 'Envoyer à OpenAI' :

Élément de menuZone de menuOptions de l'action 'Envoyer à OpenAI'
Model TypeListe déroulante du type de modèle Spécifie le modèle d'IA qui va être utilisé.

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

Le cadre de données peut également être manipulé avec des actions de cadre de données. Pour d'autres références, veuillez consulter la documentation d'OpenAI.
Insert Message ‘+’ L'icône d'insertion de message.En cliquant dessus, la boîte de dialogue des variables apparaîtra. Vous devrez indiquer quelle valeur de ‘Variable’ est envoyée à OpenAI ainsi que le ‘rôle’ du message associé :
  • système : se réfère au système ChatGPT de haut niveau
  • utilisateur : le participant
  • assistant : se réfère à un sous-rôle spécifique créé au sein du système

Étant donné qu'OpenAI évolue chaque jour, 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 sous le menu 'Actions de code' :

  • Exécuter JavaScript
  • Définir le CSS global

Les actions de code dans le menu d'actions de 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écutera comme une action lorsqu'il est déclenché.

L'action Exécuter JavaScript dans le menu d'actions de 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 le CSS global

Avec l'action 'Définir le CSS global', vous pouvez utiliser du code CSS personnalisé pour changer un aspect de l'étude lors d'un déclenchement.

L'action Définir le CSS global dans le menu d'actions de 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 le CSS global' serait de changer la couleur de fond de l'étude lorsqu'un participant sélectionne une couleur spécifique dans une question à choix 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 que vous n'ayez pas à continuer à sélectionner les mêmes éléments encore et encore. Par exemple, si vous avez un événement similaire à un qui existe déjà, vous pouvez simplement le copier, le coller et le modifier, au lieu de le construire depuis le début.

Menu de sélection de valeur

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

Cette icône de crayon / menu de sélection de valeur apparaît à divers endroits pour certaines actions dans le système d'événements, telles que l'action Définir / Enregistrer la variable, l'action Définir la propriété de l'objet, et l'action Exigence (Si... Alors), comme indiqué ci-dessous.

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

Cliquer sur l'icône de crayon mène à un menu déroulant où vous spécifiez la valeur à lire ou à écrire. Le menu déroulant commencera toujours par lister une option de valeur spécifique au déclencheur, puis continuera avec les 5 autres catégories (Heure actuelle, Valeur constante, Variable, Cadre / Tâche / Option et Opérations), qui ont toutes leurs propres options. Celles-ci seront décrites plus en détail ci-dessous.

Le menu de sélection de valeur dans Labvanced

L'image ci-dessus montre à quoi ressemble le menu de sélection de valeur lorsqu'un déclencheur de souris est utilisé. Comme vous pouvez le voir, le premier élément de menu à gauche commence par une catégorie spécifique au déclencheur, puis passe aux autres 5 catégories (Heure actuelle, etc).

Options du menu

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

CatégorieOptionsDescription
Trigger-specificDépend du type de déclencheur que vous avez précédemment sélectionné pour l'événement.En fonction du déclencheur que vous avez sélectionné pour un événement, vous aurez une liste spécifique d'options qui apparaîtra en haut du menu de sélection de valeur à choisir. Veuillez vous référer à la section sur les valeurs spécifiques au déclencheur pour voir une liste complète des options et des descriptions.
Current Time
  • Horodatage UNIX
  • Temps depuis le début du cadre
Mesurer et appeler des valeurs temporelles.
Constant Value
  • Chaîne
  • Numérique
  • Booléen
  • Catégorique
  • Date
  • Temps
  • Couleur
Attribuer 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.
Variable
  • Sélectionner variable
  • Sélectionner valeur du tableau
  • Sélectionner valeur du cadre de données
Spécifiez ou faites référence à une variable ou sélectionnez une valeur à partir d'un tableau ou d'un cadre de données.
Frame / Task / Object
  • Propriété de l'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).
Operations
  • Arithmétique
  • Opération de chaîne
  • Opération mathématique
Utiliser des opérations pour effectuer des modifications spécifiques à vos variables telles que la combinaison de valeurs de 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 le temps écoulé depuis le début du cadre. La plupart du temps, cela équivaut au temps de réaction.

Valeurs constantes

Attribuer 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

Attribue une valeur de chaîne / texte.

Constante : Numérique

Attribue une valeur numérique / nombre.

Constante : Booléen

Attribue une valeur de vrai ou faux.

Constante : Catégorique

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

Constante : Date

Attribue une valeur de date.

Constante : Temps

Attribue une valeur de temps.

Constante : Couleur

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

Valeurs des variables

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

  • Sélectionner une variable
  • Sélectionner une valeur dans un tableau
  • Sélectionner une valeur dans un cadre de données

Sélectionner une variable

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

Sélectionner une valeur dans un tableau

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

Sélectionner une valeur dans un cadre de données

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

Valeurs de cadre / tâche / objet

Vous permet de récupérer des valeurs associées aux propriétés des objets, au cadre, au suivi oculaire (si activé), et au dispositif (taux de rafraîchissement de l'écran).

  • Propriété de l'objet
  • Cadre
  • Suivi oculaire
  • Dispositif

Propriété de l'objet

Lit une propriété d'objet.

Cadre

Options de valeur du cadreDescription
Last cached Mouse X PositionLa dernière valeur de la coordonnée X de la souris du participant.
Last cached Mouse Y PositionLa dernière valeur de la coordonnée Y de la souris du participant.
Last cached Mouse [X,Y] ArrayLa dernière valeur de coordonnée [X,Y] de la souris du participant au format tableau.
Frame NameLe nom du cadre.

Suivi oculaire

Options de valeur de suivi oculaireDescription
Last cached Coordinate XLa dernière valeur de la coordonnée X du regard du participant.
Last cached Coordinate YLa dernière valeur de la coordonnée Y du regard du participant.
Last cached Coordinate [X,Y] ArrayLa dernière valeur de coordonnée [X,Y] du regard du participant au format tableau.
Last cached Coordinate + Time [X,Y,T] ArrayLa dernière valeur de coordonnée [X,Y] du regard du participant, plus la valeur T de la capture de la caméra au format tableau.

Dispositif

  • Taux de rafraîchissement : La valeur du taux de rafraîchissement du dispositif du participant.

Opérations

Utilisez des opérations pour effectuer des changements spécifiques à vos variables, comme combiner des valeurs de variable, transformer des chaînes pour qu'elles soient toutes en minuscules, ou exécuter des opérations mathématiques.

Les options suivantes sont disponibles :

  • Arithmétique
  • Opération sur chaîne
  • Opération mathématique

Arithmétique

Les opérations arithmétiques sont utiles à de nombreuses fins, y compris la combinaison de chaînes et même la modification des propriétés des objets.

Le menu Arithmétique dans Labvanced.

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

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

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

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

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

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

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

La nouvelle valeur de variable (de 'intermediateVar') est définie en utilisant plusieurs opérations arithmétiques ainsi qu'une combinaison de variables précédemment créées (c'est-à-dire 'userChatName' et 'chatInput'), ainsi que des valeurs de chaîne constantes, c'est-à-dire le point-virgule : et l'espace de séparation <br>. Cette action crée l'effet d'un chat utilisateur qui peut être utilisé dans une étude multi-utilisateur.

Opération sur chaîne

Options d'opération sur chaîneDescription
To LowercaseChange toutes les lettres dans une variable de chaîne en minuscules.

→ Ex : (AAABBB) se transforme en (aaabbb)
To UppercaseChange toutes les lettres dans la variable de chaîne en lettres majuscules.

→ Ex : (aaabbb) se transforme en (AAABBB)
To LinkTransforme la chaîne dans une variable en une URL qui s'ouvre dans une autre fenêtre
Remove WhitespacesSupprime tous les espaces entre les lettres dans une variable de chaîne.

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

→ Ex : ( aaabbbcccc) se transforme en (aaabbbcccc)
Replace Substring RegexpRemplace certaines lettres dans une variable de valeur de chaîne.

→ Ex : (aaabbbccc) remplace bbb par xxx ce qui transforme la valeur en (aaaxxxccc)

Opération mathématique

Effectue une opération mathématique sur une valeur scalaire.

Options d'opération mathématiqueDescription
absRenvoie le nombre absolu d'une valeur.
sqrtRenvoie la racine carrée d'une valeur.
roundRenvoie la valeur arrondie avec 0 à 3 décimales.
floorRenvoie la valeur arrondie à l'entier inférieur.
ceilRenvoie la valeur arrondie à l'entier supérieur.
cosRenvoie la valeur du cosinus.
sinRenvoie la valeur du sinus.
tanRenvoie la valeur de la tangente.

Valeurs spécifiques à un déclencheur

Les valeurs spécifiques à un déclencheur se réfèrent aux valeurs associées au déclencheur défini dans un événement particulier. Par exemple, si votre événement utilise un déclencheur de souris, alors, sous certaines zones où l'action est spécifiée (comme lors de l'utilisation d'une action Set / Record Variable ou d'une action Set Object Property), vous pouvez référencer des valeurs spécifiques au déclencheur de souris dans le menu de sélection de valeurs.

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

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

Voici un tableau de tous les types de valeurs spécifiques à un déclencheur que l'on peut trouver dans Labvanced, suivi d'une explication détaillée de chaque option.

NomOptions de valeur - Vue d'ensemble
Trigger (Mouse)
  • Position X de la souris
  • Position Y de la souris
  • Tableau [X,Y] de la souris
  • Nom du stimulus
  • Infos sur le stimulus
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Keyboard)
  • Id de la touche
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Button Bar)
  • Nom du stimulus
  • Infos sur le stimulus
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Enter On Input)
  • Id de la touche
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Scroll)
  • Nom du stimulus
  • Infos sur le stimulus
  • Position de défilement X
  • Position de défilement Y
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Gamepad/ Joystick)
  • Id de dispositif de 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 (À partir du début du cadre)
Trigger (Eyetracking Gaze)
  • Coordonnée X
  • Coordonnée Y
  • Tableau de coordonnées [X,Y]
  • Nom du stimulus
  • Infos sur le stimulus
  • Temps de capture de la caméra T
  • Confiance du regard C
  • Coordonnée + Temps [X,Y, T] tableau
  • Coordonnée + Temps + Confiance [X,Y, T,C] tableau
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Eyetracking Fixation)
  • Coordonnée du centre de la fixation X
  • Coordonnée du centre de la fixation Y
  • Durée de la fixation
  • Heure de début de la fixation
  • Heure de fin de la fixation
  • Dispersion de la fixation
  • Nom du stimulus
  • Infos sur le stimulus
  • [X,Y, Dur, Début, Fin, Disp]
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Head Tracking)
  • Temps de capture de la caméra T
  • Trame de données de facemesh
  • Rotation de la tête
  • Inclinaison de la tête
  • Roulement de la tête
  • Position de la tête [X,Y, T] tableau
  • Position du nez [X,Y, T] tableau
  • Vecteur du nez [X,Y, Z, T] tableau
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur à partir du début du cadre
Trigger (On Task Initialization)
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (On Frame Init)
  • Numéro de l'essai
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (on Frame Start)
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (On Frame End)
  • Temps total du cadre
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Variable Value Changed)
  • Nouvelle valeur dans la variable
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Media Object Trigger)
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Websocket Trigger)
  • Message
  • Données
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (OpenAI Trigger)
  • Réponse Chat GPT
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (PostMessage Received)
  • Contenu du message
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (Global Experiment Event)
  • Temps total du cadre
  • Raison de l'événement global
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)
Trigger (User Leaves Experiment)
  • Nombre restant de participants
  • Horodatage du déclencheur (Unixtime)
  • Temps du déclencheur (À partir du début du cadre)

Valeurs de déclenchement (Souris)

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

Les options de valeur de déclencheur de souris disponibles

Options de déclenchement (Souris)Description
Mouse XRenvoie la position actuelle de la souris en X en coordonnées de cadre.
Mouse YRenvoie la position actuelle de la souris en Y en coordonnées de cadre.
Mouse [X,Y] ArrayLes coordonnées [X,Y] de la souris au format tableau.
Stimulus NameLe nom de l'objet qui a déclenché l'événement (exemple : quelle image a été cliquée).
Stimulus InfoLes informations sur le stimulus de l'objet qui a déclenché l'événement.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclenchement en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclenchement.

Valeurs de déclenchement (Clavier)

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

Options de déclenchement (Clavier)Description
Id of KeyLa valeur d'ID de la touche qui a été pressée comme déclencheur.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclenchement en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclenchement.

Valeurs de déclenchement (Barre de boutons)

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

Options de déclenchement (Barre de boutons)Description
Stimulus NameLe nom de l'objet bouton qui a déclenché l'événement.
Stimulus InfoLes informations sur le stimulus de l'objet bouton qui a déclenché l'événement.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclenchement en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclenchement.

Valeurs de déclenchement (Entrée sur Input)

Lorsque un déclencheur d'Entrée sur Input est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de déclenchement (Entrée sur Input)Description
Id of KeyLa valeur d'ID de la touche qui a été pressée comme déclencheur.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclenchement en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclenchement.

Valeurs de déclenchement (Défilement)

Lorsque un déclencheur de défilement est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de déclenchement (Défilement)Description
Stimulus NameLe nom de l'objet bouton qui a déclenché l'événement.
Stimulus InfoLes informations sur le stimulus de l'objet bouton qui a déclenché l'événement.
Scroll Position XLa position de défilement en X de la souris lorsque l'événement a été déclenché.
Scroll Position YLa position de défilement en Y de la souris lorsque l'événement a été déclenché.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclenchement de défilement en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclenchement de défilement.

Valeurs de déclenchement (Manette/Joystick)

Lorsque un Gamepad/Joystick trigger est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

option de menu de déclencheur de manette de jeu

Options de déclenchement (Manette/Joystick)Description
Gamepad Device IdL'ID ou le nom de la manette qui était connectée.
Pressed Keys (Array)Les touches qui ont été pressées.
Pressed OR Hold Keys (Array)Les touches qui ont été pressées ou maintenues.
Released Keys (Array)Les touches qui ont été relâchées.
Axes (Array)Les valeurs des axes.
Gamepad Timestamp (Unixtime)L'horodatage de la manette en temps Unix.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclenchement en temps Unix.
Trigger Time (From Frame Onset)L'horodatage en temps Unix de l'occurrence du déclenchement en relation avec l'apparition du cadre.

Valeurs de déclenchement (Sélection du regard avec suivi oculaire)

Lorsque un déclencheur de regard avec suivi oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de valeur de déclencheur de regard

Options de déclenchement (Sélection de regard avec suivi oculaire) Description
Coordinate XLa valeur de la coordonnée X du regard.
Coordinate YLa valeur de la coordonnée Y du regard.
Coordinate [X,Y] ArrayLes coordonnées du regard X,Y au format tableau.
Stimulus NameLe nom du stimulus qui a initié le déclencheur de regard.
Stimulus InfoLes informations sur le stimulus derrière le stimulus qui a initié le déclencheur de regard.
Camera Capture Time TLe moment exact où la capture d'image a eu lieu. Dans le pipeline de suivi oculaire Labvanced, une capture d'image de la caméra se produit d'abord avant que l'algorithme et le réseau de neurones effectuent les calculs de regard. Ainsi, le Camera Capture Time T est un horodatage UNIX du moment où la capture initiale a eu lieu. Pour plus d'informations sur la technologie derrière notre suivi oculaire basé sur webcam, veuillez consulter notre page de technologie ET.
Gaze Confidence CCette valeur varie de 0 à 1 et se réfère à la confiance et à la probabilité qu'un œil soit ouvert dans la capture d'image, servant essentiellement de « détecteur de clignement ». Veuillez consulter notre article évalué par des pairs publié pour plus de détails.
Coord. + Time [X,Y,T] ArrayUn tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de la caméra (T) comme décrit ci-dessus.
Coord. + Time + Confidence [X,Y, T,C] ArrayUn tableau contenant les coordonnées x/y du regard et l'horodatage du temps de capture de la caméra (T) et la confiance du regard (C) comme décrit ci-dessus.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclencheur de regard en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclencheur de regard.

En savoir plus : Consultez la page dédiée au Déclencheur de regard avec suivi oculaire pour activer le suivi oculaire, enregistrer les données de regard, et des exemples pratiques.

Valeurs de déclenchement (Fixation sur le suivi oculaire)

Lorsque un déclencheur de fixation sur le suivi oculaire est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de déclenchement (Fixation sur le suivi oculaire)Description
Fixation Centroid XLe point central de la fixation en tant que valeur X.
Fixation Centroid YLe point central de la fixation en tant que valeur Y.
Fixation DurationLa durée de la fixation détectée.
Fixation Start TimeLe temps de début de la fixation détectée.
Fixation End TimeLe temps de fin de la fixation détectée.
Fixation DispersionSe réfère à la dispersion des valeurs de regard au sein d'une fixation détectée.
Stimulus NameLe nom de l'objet bouton qui a déclenché l'événement.
Stimulus InfoLes informations sur le stimulus de l'objet bouton qui a déclenché l'événement.
[X, Y, Dur, Start, End, Disp]Un tableau des éléments suivants : les valeurs x et y du 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.
Trigger Timestamp (Unixtime)L'horodatage de l'occurrence du déclencheur de fixation en format Unix Time avec des millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début de l'apparition du cadre jusqu'à l'occurrence du déclenchement de fixation.

En savoir plus : Consultez la page dédiée à Eyetracking Fixation Trigger pour activer la détection de fixation, enregistrer les données de fixation et voir des exemples pratiques.

Valeurs du Déclencheur (Suivi de Tête)

Lorsque un déclencheur de suivi de tête est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Suivi de Tête)Description
Camera Capture Time TLorsque 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 temps que l'image / le cadre a été capturé avant tout traitement.
Facemesh DataframeUn cadre de données contenant les 468 points de repère faciaux détectés par le modèle de maillage facial. Chaque ligne représente un point de repère avec ses coordonnées x, y et z dans l'espace de cadre normalisé. Utilisez cette valeur pour accéder à la géométrie faciale détaillée par cadre, comme les repères des lèvres, des yeux ou de la mâchoire.
Head TurnRotation de la tête de gauche à droite, ce qui est appelé le lacet dans la littérature.
Head TiltInclinaison de la tête de haut en bas, connue comme l'inclinaison de la tête dans la littérature.
Head RollCapture le mouvement de la tête roulant de côté à côté.
Head Position [X,Y, T] ArrayCe 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).
Nose Position [X,Y, T] ArrayCe tableau capture les valeurs numériques associées spécifiquement à la position du nez, cela inclut les coordonnées x et y pour l'emplacement du nez ainsi que la variable d'horodatage (T) du moment où la mesure a eu lieu.
Nose Vector [X,Y, Z, T] ArrayCette mesure fonctionne en projetant un vecteur depuis la pointe du nez et est utile pour tester si le participant est attentif à l'écran (cela est particulièrement important pour les études où le suivi oculaire n'est pas activé). Ainsi, si le nez pointe hors de l'écran (c'est-à-dire que le participant n'est pas attentif à l'expérience), la valeur Z diminue de 1 et se rapproche de 0.
Trigger Timestamp (Unixtime)Point temporel durant l'expérience où le déclencheur lui-même se produit, où le suivi de tête a été détecté et tient compte du moment où le déclencheur s'est produit dans le système. Essentiellement, c'est le moment où le traitement de l'image / du cadre est effectué et cette valeur est largement affectée par la carte graphique du participant. En théorie, elle devrait être aussi proche que possible de la valeur T.
Trigger Time from Frame OnsetC'est la valeur temporelle du moment où le déclencheur s'est produit par rapport au moment où le début du cadre s'est produit.

Valeurs du Déclencheur (Sur Initialisation de Tâche)

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

Options de Déclencheur (Sur Initialisation de Tâche)Description
Trigger Timestamp (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Trigger Time (From Frame Onset)Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre.

Valeurs du Déclencheur (Sur Initialisation de Cadre)

Lorsque un déclencheur d'initialisation de cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Sur Initialisation de Cadre)Description
TrialNrLe numéro d'essai du moment où le déclencheur d'initialisation de cadre s'est produit.
Trigger Timestamp (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Trigger Time (From Frame Onset)Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre.

Valeurs du Déclencheur (Sur Début de Cadre)

Lorsque un déclencheur de début de cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Sur Début de Cadre)Description
Trigger Timestamp (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Trigger Time (From Frame Onset)Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre.

Valeurs du Déclencheur (Sur Fin de Cadre)

Lorsque un déclencheur de fin de cadre est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Sur Fin de Cadre)Description
Total Frame TimeLe temps total en millisecondes passé sur le cadre.
Trigger Timestamp (Unixtime)L'horodatage Unix du déclencheur en millisecondes.
Trigger Time (From Frame Onset)Le temps en millisecondes du moment où le déclencheur s'est produit depuis le début du cadre.

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

Lorsque un déclencheur de valeur de variable changée est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Valeur de Variable Changée)Description
New Value in VariableSe réfère à la nouvelle valeur d'une variable.
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur de changement de variable s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où la valeur de la variable a été changée.

Valeurs du Déclencheur (Déclencheur d'Objet Média)

Lorsque un déclencheur d'objet média est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Déclencheur d'Objet Média)Description
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur d'objet média s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur d'objet média s'est produit.

Valeurs du Déclencheur (Déclencheur Websocket)

Lorsque un déclencheur WebSocket est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Déclencheur Websocket)Description
MessageUn message qui peut être utilisé pour décrire et étiqueter ce qui vous permet (du côté récepteur) de filtrer entre différents types de données.
DataUne valeur qui peut contenir différents types de données, telles que les choix des participants, les horodatages, les coordonnées x/y de la souris, etc.
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur WebSocket s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur WebSocket s'est produit.

Valeurs du Déclencheur (Déclencheur OpenAI)

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

Options de Déclencheur (Déclencheur OpenAI)Description
Chat GPT AnswerLa valeur de la réponse de ChatGPT.
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur OpenAI s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur OpenAI s'est produit.

Valeurs du Déclencheur (Message Post Reçu)

Lorsque un déclencheur de message post reçu est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Message Post Reçu)Description
Message ContentLa charge utile de données du postMessage reçu, telle qu'elle a été envoyée par la source externe.
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur de message post reçu s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur s'est produit.

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

Lorsque un déclencheur de pause / reprise d'expérience est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (Événement Global d'Expérience)Description
Total Frame TimeSe réfère au temps total de cadre qui a été alloué avant le déclencheur.
Reason for Global EventUne valeur de chaîne qui indique la raison du déclencheur, comme le départ d'un participant de l'étude.
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur d'événement global s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur d'événement global s'est produit.

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

Lorsque un déclencheur de participant quittant l'étude multi-utilisateur est utilisé, les valeurs spécifiques au déclencheur suivantes peuvent être appelées lors de certaines actions :

Options de Déclencheur (L'Utilisateur Quitte l'Expérience)Description
Remaining Number of Participants Le nombre de participants restant dans l'étude.
Trigger Timestamp (Unixtime)L'horodatage du moment où le déclencheur "L'utilisateur quitte l'expérience" s'est produit au format Unix Time avec millisecondes.
Trigger Time (From Frame Onset)Le temps écoulé en millisecondes mesuré depuis le début du début du cadre jusqu'au moment où le déclencheur "L'utilisateur quitte l'expérience" a eu lieu.
Prev
Objets
Next
Variables