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
Anleitung
Videos
Anleitungen
Häufige Fragen
Newsletter-Archiv
Dokumente
Klassenzimmer
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Anleitung
Videos
Anleitungen
Häufige Fragen
Newsletter-Archiv
Dokumente
Klassenzimmer
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Leitfaden
    • ERSTE SCHRITTE

      • Aufgabeneditor
      • Stimuluspräsentation
      • Korrektheit der Antworten
      • Objekte
      • Ereignisse
      • Variablen
      • Aufgabenassistent
      • Versuchsablauf
      • Studiengestaltung
        • Aufgaben
        • Blöcke
        • Sitzungen
        • Gruppen
    • PROGRAMMIERTE THEMEN

      • Experimentgestaltung
        • Eine Studie erstellen
        • Datenrahmenmuster
      • Zufallsverteilung & Balance
      • Eye Tracking
        • Präsentation von Stimuli in einer Eye Tracking-Aufgabe
        • Wie man die Einstellungen zur Kalibrierung des Eye Trackings auswählt
        • Einrichtung der Augenverfolgung in einer Aufgabe
        • Aufzeichnen und Exportieren von Blickdaten
        • Verwendung von Formen als Interessensgebiete (AOI) für Eye Tracking
        • Die Teilnehmerkalibrierungserfahrung
      • Web-Bridge
      • Fragebögen
      • Desktop-App
      • Beispielstudien
      • Teilnehmerrekrutierung
      • API-Zugriff
        • REST API
        • Webhook-API
        • WebSocket API
      • Weitere Themen

        • Präzise Stimuluszeiten
        • Multi-User-Studien
        • Kopfverfolgung in Labvanced | Anleitung
    • HAUPT APP TABS

      • Übersicht: Haupt-Tabs
      • Dashboard
      • Meine Studien
      • Geteilte Studien
      • Meine Dateien
      • Experimentbibliothek
      • Mein Konto
      • Lizenz & Dienstleistungen
    • STUDIENTABS

      • Übersicht: Studien-spezifische Tabs
      • Studiengestaltung
        • Aufgaben
        • Blöcke
        • Sitzungen
        • Gruppen
      • Aufgabeneditor
        • Task Controls
        • Das Versuchs-System
        • Canvas- und Seitenrahmen
        • Objekte
        • Objekt Eigenschaften Tabellen
        • Variablen
        • Systemvariablen-Tabellen
        • Das Ereignissystem
        • Texteditor-Funktionen
        • Optionen für das Eye Tracking im Task-Editor
        • Kopfverfolgung in einer Aufgabe
        • Multi-User-Studien
      • Einstellungen
      • Variablen
      • Medien
      • Texte & Übersetzen
      • Starten & Teilnehmen
      • Teilnehmerverwaltung
      • Datensicht und Export
        • Datensicht und Variablen- & Aufgaben Auswahl (alte Version)
        • Zugriff auf Aufnahmen (ALTE Version)
  • Videos
    • Video Übersicht
    • Erste Schritte in Labvanced
    • Aufgaben erstellen
    • Element Videos
    • Ereignisse & Variablen
    • Fortgeschrittene Themen
  • Anleitungen
    • Einführung
    • Stroop-Aufgabe
    • Lexikalische Entscheidungsaufgabe
    • Posner Gaze Cueing Aufgabe
    • Change Blindness Flicker Paradigma
    • Augenverfolgungsstudie Beispielstudie
    • Augenverfolgungsstudie mit Säuglingen
    • Aufmerksamkeitserfassung Studie mit Maustracking
    • Schnelle serielle visuelle Präsentation
    • ChatGPT Studie
    • Augenverfolgungsdemo: SVGs als AOIs
    • Multi-User-Demo: Zeige die Cursors der Teilnehmer
    • Gamepad / Joystick Controller - Grundaufbau
    • Desktop-App-Studie mit EEG-Integration
    • Gruppenbalance und Variablenaufbau zwischen den Teilnehmern
    • Website-Rahmen Augenverfolgung Anleitung
    • Bedingte Webcam Augenverfolgung
  • FAQ
    • Funktionen
    • Support-Richtlinien & Richtlinien
    • Sicherheit & Datenschutz
    • Lizenzierung
    • Präzision von Labvanced
    • Programmgesteuerte Nutzung & API
    • Labvanced offline nutzen
    • Fehlerbehebung
    • Fragen zur Erstellung von Studien
  • Newsletter-Archiv
  • Dokumente
  • Klassenzimmer
Header-Illustration zur Aufzeichnung und zum Export von Blickdaten in Labvanced

Aufzeichnen und Exportieren von Blickdaten {/examples/}

Sobald Eye-Tracking aktiviert und für eine Aufgabe konfiguriert ist (siehe Einrichten von Eye-Tracking in einer Aufgabe), benötigen Sie Ereignisse, die tatsächlich Blickdaten als aufgezeichnete Variablen erfassen.

Automatisierte Ereigniseinrichtung

In dem Moment, in dem Sie Enable Eye-Tracking: im Aufgabeneditor aktivieren, erscheint ein Dialogfeld "Eyetracking-Einrichtung", das Ihnen anbietet, diese Ereignisse für Sie zu erstellen:

Eyetracking-Einrichtungsdialog, der anbietet, automatisch Ereignisse zur Aufzeichnung von Blick und Fixation zu erstellen

  • Record gaze timeseries [X,Y,T,C]: erstellt ein Ereignis zur Aufzeichnung des Blicks, standardmäßig aktiviert
  • Record fixation timeseries [X,Y,Dur,Start,End,Disp]: erstellt ein Ereignis zur Aufzeichnung der Fixation, standardmäßig aktiviert. Wenn der Fixationserkennungsmodus Ihrer Aufgabe auf No Fixation Detection eingestellt war, schaltet die Akzeptanz dieser Option ihn automatisch ein.

Sie wählen auch den Geltungsbereich: On all frames (der Standard) wendet die Aufzeichnungsereignisse auf jedes Frame im Experiment an, oder Select a frame beschränkt sie auf ein bestimmtes Frame. Durch Klicken auf Add Events werden die Ereignisse mit diesen Auswahlmöglichkeiten erstellt; Skip schließt das Dialogfeld, ohne etwas zu erstellen.

Dies deckt den häufigen Fall ab: Die Aufzeichnung jeder Blick- und Fixationsprobe über ein Experiment. Bauen Sie die Ereignisse manuell, wenn Sie diesen Dialog übersprungen haben, die Aufzeichnung auf spezifische Stimulusobjekte beschränken müssen (siehe unten) oder Eye-Tracking-Ereignisse zu einer bereits vorhandenen Aufgabe hinzufügen.

Manuelles Aufzeichnen von Blickkoordinaten

Um eine Zeitschriftsreihe von Blickkoordinaten aufzuzeichnen:

  1. Fügen Sie ein neues Ereignis aus dem Ereignisseditor hinzu.
  2. Wählen Sie für den Auslöser Physiological Signal Triggers → Eyetracking Gaze.
  3. Wählen Sie für die Aktion Variable Actions → Set / Record Variable, und erstellen Sie eine neue Variable:
    • Format: Array (empfohlen, damit ein Paar aus X/Y-Koordinaten zusammen gespeichert werden kann)
    • Aufzeichnungsmodus: All changes / time series, damit jede Blickaktualisierung aufgezeichnet wird, nicht nur der endgültige Wert am Ende eines Experiments
  4. Wählen Sie im Wertauswahlmenü Coord. + Time + Confidence [X,Y,T,C] Array aus den Trigger (Eyetracking Gaze)-Optionen. Dies zeichnet die X- und Y-Koordinaten, einen genauen Zeitstempel und einen Vertrauenswert in einem einzelnen Array auf.

Es gibt auch einen Eyetracking Fixation-Auslöser, der die Fixationen eines Teilnehmers meldet (wo ihr Blick verweilt, anstatt jede einzelne Blickprobe) unter Verwendung des im Aufgaben-Setup konfigurierten Fixationserkennungsmodus. Dieser befindet sich derzeit im Beta-Stadium.

Beschränkung der Aufzeichnung auf spezifische Stimulusobjekte

Sowohl die Eyetracking Gaze- als auch die Eyetracking Fixation-Auslöser können so beschränkt werden, dass sie nur feuern, wenn der Teilnehmer auf spezifische Stimulusobjekte schaut, anstatt überall im Frame. Wählen Sie hierzu die Option, nur auf bestimmten Elementen auszulösen, und fügen Sie diese Elemente als Ziele hinzu. Dies ist nützlich, wenn Sie nur wissen möchten, ob ein Teilnehmer auf ein bestimmtes Bild oder eine Region geschaut hat, nicht jedoch, wo sich sein Blick sonst im Frame befindet.

Aufzeichnung von Kalibrierungs- und Versuchsfehlern

Neben Blickkoordinaten können Sie aufzeichnen, wie genau das Eye-Tracking für einen bestimmten Teilnehmer war:

  1. Fügen Sie ein weiteres Ereignis hinzu, mit On Frame Start als Auslöser.
  2. Wählen Sie für die Aktion Variable Actions → Set / Record Variable.
  3. Wählen Sie im Wertauswahlmenü unter Frame/Task/Object → Eyetracking Error Trial aus, um den Fehler für den aktuellen Versuch aufzuzeichnen, oder Error Calibration, um den Fehler aus der ursprünglichen Kalibrierung aufzuzeichnen.

Beide Fehlerwerte sind durchschnittliche euklidische Abstände, in Frame-Einheiten, zwischen den vorhergesagten Blickkoordinaten und den tatsächlichen Ziel-Fixationsstandorten, die während der Kalibrierung oder zwischen den Versuchen angezeigt werden. Beide aufzuzeichnen, ermöglicht es Ihnen, Teilnehmer oder spezifische Versuche auszuschließen, die während der Analyse unter Ihrem Genauigkeitsgrenzwert liegen.

Exportieren von Blickdaten

Navigieren Sie zur Dataview & Export-Registerkarte, um auf Ihre aufgezeichneten Daten zuzugreifen. Es gibt zwei Arten des Exports:

  • Normale Daten: einmal pro Versuch aufgezeichnet, wie Antworten, Bedingungen und Kalibrierungs-/Versuchsfehler, wenn Sie sich entschieden haben, sie aufzuzeichnen. Jede Variable ist ihre eigene Spalte, jeder Versuch ist seine eigene Zeile.
  • Zeitschriftsdaten: während eines Experiments kontinuierlich aufgezeichnet, was Blickkoordinaten verwenden, da sie viele Male pro Sekunde aktualisiert werden. Jede Zeile stellt eine Blickprobe dar, zusammen mit einer separaten times-Spalte, die über alle Zeitschriftsvariablen hinweg geteilt wird.

Vorschau der Daten, die mit Labvanced's Webcam-Eye-Tracking gesammelt wurden.

Vorschau der Daten, die mit Labvanced's Webcam-Eye-Tracking gesammelt wurden
X: X-Koordinate des Blicks; Y: Y-Koordinate des Blicks; T: Zeitstempel; C: Vertrauensintervall

Einige Dinge sind zu beachten, wenn Sie mit diesen Spalten arbeiten:

  • Basieren Sie Ihre Zeitmessungen auf T und nicht auf der separaten times-Spalte. T ist der angepasste Zeitstempel, wann die Kamera tatsächlich das Bild aufgezeichnet hat, während times reflektiert, wann Labvanced den Wert aufgezeichnet hat, was leicht hinter dem tatsächlichen Erfassungszeitpunkt zurückbleibt, da der Algorithmus einige Millisekunden benötigt, um jede Aufnahme zuerst zu verarbeiten.
  • C variiert von 0 bis 1. Ein Wert nahe 1 zeigt eine zuverlässige Erkennung an; ein Wert nahe 0 deutet typischerweise auf ein Blinzeln hin oder dass die Augen des Teilnehmers für die Kamera nicht sichtbar waren.
  • Die Abtastrate ist nicht perfekt konstant und kann aus T bestimmt werden. Im Allgemeinen sind Abtastraten über 30 Hz aufgrund der Hardwarebeschränkungen der meisten kommerziell erhältlichen Webcams nicht erreichbar.

Das GitHub-Repository von Labvanced enthält Skripte zur weiteren Verarbeitung exportierter Eye-Tracking- und WebSocket-Daten.

Häufig Gestellte Fragen

Wenn ich das automatisierte Dialogfeld zur Eyetracking-Einrichtung überspringe, kann ich dann trotzdem Blickdaten aufzeichnen?
Ja. Bauen Sie stattdessen die Aufzeichnungsereignisse manuell mit einem `Eyetracking Gaze` oder `Eyetracking Fixation`-Trigger und einer `Set / Record Variable`-Aktion, wie oben beschrieben. Dies ist auch der Weg, wenn Sie die Aufzeichnung auf spezifische Stimulusobjekte beschränken müssen oder Eye-Tracking-Ereignisse zu einer bereits vorhandenen Aufgabe hinzufügen.
Sollte ich meine Timing-Analyse auf der `times`-Spalte oder auf `T` basieren?
Verwenden Sie `T`. `T` (`Camera Capture Time T`) ist der angepasste Zeitstempel, wann die Kamera tatsächlich das Bild aufgenommen hat, während `times` reflektiert, wann Labvanced den Wert aufgezeichnet hat, was leicht verzögert ist, da der Algorithmus einige Millisekunden benötigt, um jede Aufnahme zuerst zu verarbeiten. Dasselbe gilt für `Camera Capture Time T` unter den Werten des Emotionserkennungsauslösers im Wert-Auswahlmenü.
Was bedeutet ein Vertrauenswert (`C`) nahe 0?
In der Regel deutet das auf ein Blinzeln hin oder dass die Augen des Teilnehmers für die Kamera nicht sichtbar waren. Ein Wert nahe 1 zeigt eine zuverlässige Erkennung an.
Warum wird mein Blickdaten nicht mit konstant perfekter Rate erfasst?
Die Abtastrate ist nicht perfekt konstant und kann aus `T` bestimmt werden. Im Allgemeinen sind Abtastraten über 30 Hz aufgrund der Hardwarebeschränkungen der meisten kommerziell verfügbaren Webcams nicht erreichbar.
Wie weiß ich, ob eine qualitativ schlechte Kalibrierung oder ein spezifisches Experiment für schlechte Blickdaten verantwortlich ist?
Das Aufzeichnen von sowohl `Error Calibration` als auch `Error Trial` als Variablen. Beide sind durchschnittliche euklidische Abstände, in Frame-Einheiten, zwischen den vorhergesagten Blickkoordinaten und den tatsächlichen Ziel-Fixationsstandorten, was Ihnen ermöglicht, Teilnehmer oder spezifische Versuche auszuschließen, die während der Analyse unter Ihrem Genauigkeitsgrenzwert liegen.
Kann ich Blickdaten nur für spezifische Objekte aufzeichnen, anstatt für den gesamten Frame?
Ja. Sowohl die `Eyetracking Gaze`- als auch die `Eyetracking Fixation`-Trigger können so eingestellt werden, dass sie nur feuern, wenn der Teilnehmer auf spezifische Stimulusobjekte schaut, die als Ziele hinzugefügt wurden, anstatt überall im Frame.

Weiterführende Literatur

Einrichten von Eye-Tracking in einer Aufgabe

Aktivieren Sie Eye-Tracking und konfigurieren Sie die Neukalibrierung, bevor Sie die Ereignisse auf dieser Seite erstellen.

Formen als Interessensgebiete (AOI) verwenden

Definieren Sie Bereiche eines Frames, auf die Blick- und Fixationsauslöser abzielen können.

Webcam-Eye-Tracking-Technologie

Wie Labvanced's Webcam-Eye-Tracking-Technologie funktioniert.

Zeitreihenvariablen

Die allgemeinen Einstellungen für Aufzeichnungsart und Abtastmethode, die steuern, wie kontinuierliche Daten wie Blick erfasst werden.

Aufgabensteuerungen

Das automatisierte Dialogfeld zur Eyetracking-Einrichtung, das oben angezeigt wird, im Kontext des vollständigen Referenzhandbuchs für Aufgabensteuerungen.

Prev
Einrichtung der Augenverfolgung in einer Aufgabe
Next
Verwendung von Formen als Interessensgebiete (AOI) für Eye Tracking