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âche
        • 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

Enregistrement et Exportation des Données de Regard

Une fois le suivi oculaire activé et configuré pour une tâche (voir Configuration du Suivi Oculaire dans une Tâche), vous avez besoin d'événements qui capturent réellement les données de regard en tant que variables enregistrées.

Configuration Automatisée des Événements

Au moment où vous cochez Enable Eye-Tracking: dans l'éditeur de tâches, une boîte de dialogue "Configuration du Suivi Oculaire" apparaît, vous offrant de créer ces événements pour vous :

Boîte de dialogue de Configuration du Suivi Oculaire offrant de créer automatiquement des événements d'enregistrement de regard et de fixation

  • Record gaze timeseries [X,Y,T,C] : crée un événement d'enregistrement de regard, coché par défaut
  • Record fixation timeseries [X,Y,Dur,Start,End,Disp] : crée un événement d'enregistrement de fixation, coché par défaut. Si le mode de Détection de Fixation de votre tâche était réglé sur No Fixation Detection, accepter cette option l'active automatiquement.

Vous choisissez également la portée : On all frames (la valeur par défaut) applique les événements d'enregistrement à chaque image du procès, ou Select a frame les limite à une image spécifique. En cliquant sur Add Events, vous créez les événements avec ces choix ; Skip ferme la boîte de dialogue sans rien créer.

Cela couvre le cas courant : enregistrer chaque échantillon de regard et de fixation au cours d'un procès. Construisez les événements manuellement si vous avez sauté cette boîte de dialogue, si vous devez restreindre l'enregistrement à des objets de stimulus spécifiques (voir ci-dessous), ou si vous ajoutez des événements de suivi oculaire à une tâche qui existe déjà.

Enregistrement Manuel des Coordonnées de Regard

Pour enregistrer une série chronologique de coordonnées de regard :

  1. Ajoutez un nouvel événement depuis l'éditeur d'événements.
  2. Pour le déclencheur, sélectionnez Physiological Signal Triggers → Eyetracking Gaze.
  3. Pour l'action, sélectionnez Variable Actions → Set / Record Variable, puis créez une nouvelle variable :
    • Format : Array (recommandé, afin qu'une paire de coordonnées X/Y puisse être stockée ensemble)
    • Type d'Enregistrement : All changes / time series, de sorte que chaque mise à jour de regard soit enregistrée, et pas seulement la valeur finale à la fin d'un procès
  4. Dans le menu de sélection de la valeur, choisissez Coord. + Time + Confidence [X,Y,T,C] Array parmi les options Trigger (Eyetracking Gaze). Cela enregistre les coordonnées X et Y, un timestamp précis, et une valeur de confiance dans un seul tableau.

Il y a aussi un déclencheur Eyetracking Fixation, qui rapporte les fixations d'un participant (où son regard se stabilise, plutôt que chaque échantillon de regard individuel) en utilisant le mode de Détection de Fixation configuré dans la configuration de la tâche. Il est actuellement en bêta.

Restreindre l'Enregistrement à des Objets de Stimulus Spécifiques

Les déclencheurs Eyetracking Gaze et Eyetracking Fixation peuvent être restreints pour ne se déclencher que lorsque le participant regarde des objets de stimulus spécifiques, plutôt que n'importe où sur l'image. Pour ce faire, sélectionnez l'option pour ne déclencher que sur des éléments spécifiques, puis ajoutez ces éléments comme cibles. Cela est utile lorsque vous ne vous souciez que de savoir si un participant a regardé une image ou une région particulière, et non de leur position de regard partout ailleurs sur l'image.

Enregistrement de la Calibration et de l'Erreur de Procès

Parallèlement aux coordonnées de regard, vous pouvez enregistrer à quel point le suivi oculaire était précis pour un participant donné :

  1. Ajoutez un autre événement, avec On Frame Start comme déclencheur.
  2. Pour l'action, sélectionnez Variable Actions → Set / Record Variable.
  3. Dans le menu de sélection de la valeur, sous Frame/Task/Object → Eyetracking, choisissez Error Trial pour enregistrer l'erreur du procès actuel, ou Error Calibration pour enregistrer l'erreur de la calibration originale.

Les deux valeurs d'erreur sont des distances euclidiennes moyennes, en unités d'image, entre les coordonnées de regard prédites et les emplacements de fixation cibles réels montrés lors de la calibration ou entre les procès. En enregistrant les deux, vous pouvez exclure les participants, ou des procès spécifiques, qui tombent en dessous de votre seuil de précision lors de l'analyse.

Exportation des Données de Regard

Accédez à l'onglet Dataview & Export pour accéder à vos données enregistrées. Il existe deux types d'exportation :

  • Données normales : enregistrées une fois par procès, telles que les réponses, conditions et erreurs de calibration/procès si vous avez choisi de les enregistrer. Chaque variable est sa propre colonne, chaque procès sa propre ligne.
  • Données de série chronologique : enregistrées en continu tout au long d'un procès, ce que les coordonnées de regard utilisent puisque celles-ci se mettent à jour plusieurs fois par seconde. Chaque ligne représente un échantillon de regard, avec une colonne times séparée partagée entre toutes les variables de série chronologique.

Aperçu des données collectées à l'aide de la technologie de suivi oculaire par webcam de Labvanced.

Aperçu des données collectées à l'aide de la technologie de suivi oculaire par webcam de Labvanced
X : Coordonnée X du regard ; Y : Coordonnée Y du regard ; T : Timestamp ; C : Intervalle de Confiance

Quelques points à garder à l'esprit lors de la manipulation de ces colonnes :

  • Basez vos mesures de temps sur T plutôt que sur la colonne times séparée. T est le timestamp ajusté du moment où la caméra a effectivement capturé l'image, tandis que times reflète quand Labvanced a enregistré la valeur, ce qui prend légèrement du retard par rapport au moment réel de capture puisque l'algorithme doit traiter chaque image en quelques millisecondes d'abord.
  • C varie de 0 à 1. Une valeur proche de 1 indique une détection de confiance ; une valeur proche de 0 indique typiquement un clignement d'œil ou que les yeux du participant n'étaient pas visibles par la caméra.
  • Le taux d'échantillonnage n'est pas parfaitement constant et peut être déterminé à partir de T. En général, des taux d'échantillonnage supérieurs à 30 Hz ne sont pas réalisables, en raison des contraintes matérielles de la plupart des webcams disponibles dans le commerce.

Le dépôt GitHub de Labvanced contient des scripts pour un traitement plus approfondi des données de suivi oculaire exportées et des données WebSocket.

Questions Fréquemment Posées

Si je saute la boîte de dialogue de Configuration Automatisée du Suivi Oculaire, puis-je néanmoins enregistrer des données de regard ?
Oui. Construisez les événements d'enregistrement manuellement à la place, en utilisant un déclencheur `Eyetracking Gaze` ou `Eyetracking Fixation` avec une action `Set / Record Variable`, comme décrit ci-dessus. C'est également le chemin à suivre si vous devez restreindre l'enregistrement à des objets de stimulus spécifiques, ou si vous ajoutez des événements de suivi oculaire à une tâche existante.
Dois-je baser mon analyse temporelle sur la colonne `times` ou sur `T` ?
Utilisez `T`. `T` (`Camera Capture Time T`) est le timestamp ajusté du moment où la caméra a réellement capturé l'image, tandis que `times` reflète quand Labvanced a enregistré la valeur, ce qui prend légèrement du retard puisque l'algorithme a besoin de quelques millisecondes pour traiter chaque image d'abord. La même distinction s'applique à `Camera Capture Time T` sous les valeurs du déclencheur de Détection d'Émotion dans le Menu de Sélection de Valeur.
Que signifie une valeur de Confiance (`C`) proche de 0 ?
Cela indique généralement un clignement d'œil ou que les yeux du participant n'étaient pas visibles par la caméra. Une valeur proche de 1 indique une détection de confiance.
Pourquoi mes données de regard ne sont-elles pas échantillonnées à un rythme parfaitement constant ?
Le taux d'échantillonnage n'est pas parfaitement constant et peut être déterminé à partir de `T`. En général, des taux d'échantillonnage supérieurs à 30 Hz ne sont pas réalisables, en raison des contraintes matérielles de la plupart des webcams disponibles dans le commerce.
Comment savoir si une calibration de mauvaise qualité ou un procès spécifique est responsable de mauvaises données de regard ?
Enregistrez à la fois `Error Calibration` et `Error Trial` en tant que variables. Les deux sont des distances euclidiennes moyennes, en unités d'image, entre les coordonnées de regard prédites et les emplacements de fixation cibles réels, ce qui vous permet d'exclure les participants ou des procès spécifiques qui tombent en dessous de votre seuil de précision lors de l'analyse.
Puis-je enregistrer des données de regard uniquement pour des objets spécifiques, plutôt que pour toute l'image ?
Oui. Les déclencheurs `Eyetracking Gaze` et `Eyetracking Fixation` peuvent être restreints pour se déclencher uniquement lorsque le participant regarde des objets de stimulus spécifiques ajoutés en tant que cibles, plutôt que n'importe où sur l'image.

Lectures Complémentaires

Configuration du Suivi Oculaire dans une Tâche

Activez le suivi oculaire et configurez la recalibration avant de créer les événements sur cette page.

Utilisation des Formes comme Zones d'Intérêt (AOI)

Définissez des régions d'une image que les déclencheurs de regard et de fixation peuvent cibler.

Technologie de Suivi Oculaire par Webcam

Comment fonctionne la technologie de suivi oculaire par webcam de Labvanced.

Variables de Série Chronologique

Les paramètres généraux de Type d'Enregistrement et de Méthode d'Échantillonnage qui contrôlent comment des données continues comme le regard sont capturées.

Contrôles de Tâche

La boîte de dialogue de Configuration Automatisée du Suivi Oculaire présentée ci-dessus, dans le contexte de la référence complète des Contrôles de Tâche.

Prev
Configurer le Suivi Oculaire dans une Tâche
Next
Utiliser des formes comme zones d'intérêt (AOI) pour le suivi des yeux