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

      • Aufgaben-Editor
      • Frames
        • Canvas-Rahmen
        • Seitenrahmen
        • Website-Rahmen
      • Versuchstimeline
      • Stimuluspräsentation
      • Richtigkeit der Antwort
      • Objekte
      • Ereignisse
      • Variablen
      • Aufgaben-Assistent
      • Versuchssystem
      • Experimentdesign
        • Eine Studie erstellen
        • Datenrahmenmuster
        • Multi-User Experiment Design
        • Längsschnitt-Experimentdesign
    • HERVORGEHOBENE THEMEN

      • Randomisierung & Balance
      • Eye Tracking
        • Präsentation von Stimuli in einer Eye-Tracking-Aufgabe
        • So wählen Sie die Kalibrierungseinstellungen für die Augenverfolgung
        • Einrichtung der Augenverfolgung in einer Aufgabe
        • Aufzeichnen und Exportieren von Blickdaten
        • Verwendung von Formen als Interessensgebiete (AOI) für Eye Tracking
        • Die Teilnehmerkalibrierungserfahrung
      • Web-Brücke
        • Auswahl von Website-AOIs | Anker, Anpassen und Überprüfen des AOI-Trackings
        • Verfolgen des Mausverhaltens auf einer Website-AOI | Web Bridge Anleitung
      • Fragebögen
      • Desktop-App
      • Beispielstudien
      • Teilnehmer Rekrutierung
      • API-Zugriff
        • REST API
        • Webhook-API
        • WebSocket API
      • Weitere Themen

        • Präzise Stimuluszeiten
        • Multi-User-Studien
        • Kopfverfolgung in Labvanced | Anleitung
    • HAUPTABLAUF REGISTER

      • Übersicht: Haupt-Register
      • Dashboard
      • Meine Studien
      • Geteilte Studien
      • Meine Dateien
      • Experimentbibliothek
      • Mein Konto
      • Lizenz & Dienstleistungen
    • STUDIEN REGISTER

      • Übersicht: Studien-spezifische Register
      • Studiengestaltung
        • Aufgaben
        • Blöcke
        • Sitzungen
        • Gruppen
      • Aufgaben-Editor
        • Task Controls
        • Das Versuchs-System
        • Frame-Typen
        • Objekte
        • Objekt Eigenschaften Tabellen
        • Variablen
        • Systemvariablen-Tabelle
        • Das Ereignissystem
        • Texteditor-Funktionen
        • Optionen für Augenverfolgung im Aufgabeneditor
        • Kopfverfolgung in einer Aufgabe
        • Multi-User-Studien
      • Einstellungen
      • Variablen
      • Medien
      • Texte & Übersetzen
      • Starten & Teilnehmen
      • Teilnehmer-Management
      • Datenausblick und Export
        • Datensicht und Variablen- & Aufgaben Auswahl (alte Version)
        • Zugriff auf Aufnahmen (ALTE Version)
  • Videos
    • Videoübersicht
    • Erste Schritte mit Labvanced
    • Aufgaben erstellen
    • Element-Videos
    • Ereignisse & Variablen
    • Fortgeschrittene Themen
  • Anleitungen
    • Einführung
    • Stroop-Aufgabe
    • Lexikalische Entscheidungsaufgabe
    • Posner Blickaufforderung Aufgabe
    • Change Blindness Flicker Paradigma
    • Augenverfolgungsbeispielstudie
    • Augenverfolgungsstudie mit Säuglingen
    • Aufmerksamkeitserfassung Studie mit Mausverfolgung
    • Schnelle serielle visuelle Präsentation
    • ChatGPT-Studie
    • Augenverfolgungsdemo: SVGs als AOIs
    • Multi-User-Demo: Zeigen Sie die Cursorn der Teilnehmer
    • Gamepad / Joystick-Controller - Grundlegende Einrichtung
    • Desktop-App-Studie mit EEG-Integration
    • Gruppenbalancierung und Variablen-Setup zwischen den Probanden
    • Bau einer Multi-User-Studie
    • Website-Rahmen Augenverfolgungsanleitung
    • Bedingte Webcam-Augenverfolgung
  • FAQ
    • Funktionen
    • Support-Richtlinien & -Leitlinien
    • Sicherheit & Datenschutz
    • Lizenzierung
    • Präzision von Labvanced
    • Programmgesteuerte Nutzung & API
    • Labvanced offline verwenden
    • Fehlerbehebung
    • Fragen zur Studienerstellung
  • Newsletter-Archiv
  • Dokumente
  • Klassenzimmer
Header-Illustration zum Aufzeichnen und Exportieren von Blickdaten in Labvanced

Aufzeichnen und Exportieren von Blickdaten

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

Automatisierte Ereigniseinrichtung

Sobald Sie Enable Eye-Tracking: im Aufgabeneditor aktivieren, erscheint ein Dialogfeld "Blickverfolgungseinrichtung", das Ihnen anbietet, diese Ereignisse automatisch zu erstellen:

Dialogfeld zur Blickverfolgungseinrichtung, das anbietet, automatisch Ereignisse zur Aufnahme von Blick- und Fixationsdaten zu erstellen

  • Record gaze timeseries [X,Y,T,C]: erstellt ein Ereignis zum Aufzeichnen von Blickdaten, standardmäßig aktiviert
  • Record fixation timeseries [X,Y,Dur,Start,End,Disp]: erstellt ein Ereignis zum Aufzeichnen von Fixationen, standardmäßig aktiviert. Wenn der Fixationserkennungsmodus Ihrer Aufgabe auf No Fixation Detection eingestellt ist, wird durch die Annahme dieser Option dieser automatisch aktiviert.

Sie wählen auch den Umfang: On all frames (der Standard) wendet die Aufzeichnungsereignisse auf jeden Frame im Versuch an, oder Select a frame beschränkt sie auf einen bestimmten Frame. Ein Klick auf Add Events erstellt die Ereignisse mit diesen Optionen; Skip schließt den Dialog, ohne etwas zu erstellen.

Damit wird der häufige Fall abgedeckt: das Aufzeichnen jeder Blick- und Fixationsprobe während eines Versuchs. Erstellen Sie die Ereignisse manuell, falls Sie dieses Dialogfeld übersprungen haben, spezifische Stimulusobjekte (siehe unten) einschränken müssen oder Blickverfolgungsereignisse zu einer bereits bestehenden Aufgabe hinzufügen.

Manuelles Aufzeichnen von Blickkoordinaten

Um eine Zeitreihe von Blickkoordinaten aufzuzeichnen:

  1. Fügen Sie ein neues Ereignis aus dem Ereigniseditor hinzu.
  2. Für den Auslöser wählen Sie Physiological Signal Triggers → Eyetracking Gaze.
  3. Für die Aktion wählen Sie Variable Actions → Set / Record Variable, und erstellen Sie eine neue Variable:
    • Format: Array (empfohlen, damit ein Paar von X/Y-Koordinaten zusammen gespeichert werden kann)
    • Aufzeichnungsart: All changes / time series, damit jedes Blickupdate aufgezeichnet wird, nicht nur der endgültige Wert am Ende eines Versuchs
  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 (wohin ihr Blick sich richtet, anstatt jede einzelne Blickprobe) unter Verwendung des in der Aufgabeneinrichtung konfigurierten Fixationserkennungsmodus. Er befindet sich derzeit in der Beta-Phase.

Einschränkung der Aufzeichnung auf spezifische Stimulusobjekte

Sowohl die Eyetracking Gaze- als auch die Eyetracking Fixation-Auslöser können so eingeschränkt werden, dass sie nur auslösen, wenn der Teilnehmer auf bestimmte Stimulusobjekte blickt, anstatt auf irgendwo im Frame. Um dies zu tun, wählen Sie die Option, nur auf spezifische Elemente zu triggern, 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 auf seine Blickposition überall sonst im Frame.

Aufzeichnen von Kalibrierung und Versuchsfehler

Neben Blickkoordinaten können Sie aufzeichnen, wie genau die Blickverfolgung für einen bestimmten Teilnehmer war:

  1. Fügen Sie ein weiteres Ereignis hinzu, mit On Frame Start als Auslöser.
  2. Für die Aktion wählen Sie 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 der ursprünglichen Kalibrierung aufzuzeichnen.

Beide Fehlerwerte sind mittlere 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. Das Aufzeichnen beider Werte ermöglicht es Ihnen, Teilnehmer oder spezifische Versuche auszuschließen, die während der Analyse unter Ihrem Genauigkeitsdurchschnitt liegen.

Exportieren von Blickdaten

Navigieren Sie zum Dataview & Export-Tab, um auf Ihre aufgezeichneten Daten zuzugreifen. Es gibt zwei Arten von Exporten:

  • Normale Daten: einmal pro Versuch aufgezeichnet, wie Antworten, Bedingungen und Kalibrierungs-/Versuchsfehler, falls Sie sich entschieden haben, diese aufzuzeichnen. Jede Variable ist ihre eigene Spalte, jeder Versuch seine eigene Zeile.
  • Zeitenseriendaten: kontinuierlich während eines Versuchs aufgezeichnet, was die Blickkoordinaten verwenden, da sie viele Male pro Sekunde aktualisiert werden. Jede Zeile repräsentiert eine Blickprobe, neben einer separaten times-Spalte, die über alle Zeitenserien-Variablen geteilt wird.

Vorschau der gesammelten Daten mit Labvanced's Webcam-Blickverfolgung.

Vorschau der gesammelten Daten mit Labvanced's Webcam-Blickverfolgung
X: X-Koordinate des Blicks; Y: Y-Koordinate des Blicks; T: Zeitstempel; C: Vertrauensintervall

Ein paar Dinge, die Sie beachten sollten, wenn Sie mit diesen Spalten arbeiten:

  • Basiere deine Zeitmessungen auf T statt auf der separaten times-Spalte. T ist der angepasste Zeitstempel, wann die Kamera tatsächlich das Bild aufgenommen hat, während times widerspiegelt, wann Labvanced den Wert aufgezeichnet hat, der leicht hinter dem tatsächlichen Capture-Moment zurückbleibt, da der Algorithmus ein paar Millisekunden benötigt, um jedes Snapshot zuerst zu verarbeiten.
  • C reicht von 0 bis 1. Ein Wert nahe 1 weist auf eine sichere Erkennung hin; ein Wert nahe 0 weist typischerweise auf ein Blinzeln hin oder darauf, dass die Augen des Teilnehmers für die Kamera nicht sichtbar waren.
  • Die Abtastrate ist nicht perfekt konstant und kann von T bestimmt werden. Im Allgemeinen sind Abtastraten über 30 Hz nicht erreichbar, aufgrund der Hardwarebeschränkungen der meisten handelsüblichen Webcams.

Das GitHub-Repository von Labvanced enthält Skripte für die weitere Verarbeitung exportierter Blickverfolgungs- und WebSocket-Daten.

Häufig gestellte Fragen

Kann ich auch dann Blickdaten aufzeichnen, wenn ich den automatisierten Dialog zur Blickverfolgungseinrichtung überspringe?
Ja. Erstellen Sie die Aufzeichnungsereignisse stattdessen manuell, indem Sie einen `Eyetracking Gaze` oder `Eyetracking Fixation`-Auslöser mit einer `Set / Record Variable`-Aktion verwenden, wie oben behandelt. Dies ist auch der Weg, den Sie einschlagen sollten, wenn Sie die Aufzeichnung auf spezifische Stimulusobjekte einschränken müssen oder Blickverfolgungsereignisse zu einer bereits bestehenden Aufgabe hinzufügen.
Sollte ich meine Timing-Analyse auf die `times`-Spalte oder auf `T` stützen?
Verwenden Sie `T`. `T` (`Camera Capture Time T`) ist der angepasste Zeitstempel, wann die Kamera tatsächlich das Bild aufgenommen hat, während `times` widerspiegelt, wann Labvanced den Wert aufgezeichnet hat, der leicht hinterherhinkt, da der Algorithmus ein paar Millisekunden benötigt, um jedes Snapshot zuerst zu verarbeiten. Dieselbe Unterscheidung gilt für `Camera Capture Time T` unter den Werten des Auslösers zur Emotionserkennung im Wert-Auswahlmenü.
Was bedeutet ein Vertrauenswert (`C`) nahe 0?
Es weist typischerweise auf ein Blinzeln hin oder darauf, dass die Augen des Teilnehmers für die Kamera nicht sichtbar waren. Ein Wert nahe 1 weist auf eine sichere Erkennung hin.
Warum wird meine Blickdaten nicht mit einer perfekt konstanten Rate erfasst?
Die Abtastrate ist nicht perfekt konstant und kann von `T` bestimmt werden. Im Allgemeinen sind Abtastraten über 30 Hz nicht erreichbar, aufgrund der Hardwarebeschränkungen der meisten handelsüblichen Webcams.
Wie weiß ich, ob eine minderwertige Kalibrierung oder ein spezifischer Versuch für schlechte Blickdaten verantwortlich ist?
Aufzeichnen sowohl `Error Calibration` als auch `Error Trial` als Variablen. Beide sind mittlere euklidische Abstände, in Frame-Einheiten, zwischen den vorhergesagten Blickkoordinaten und den tatsächlichen Ziel-Fixationsstandorten, wodurch Sie Teilnehmer oder spezifische Versuche ausschließen können, die während der Analyse unter Ihrem Genauigkeitsdurchschnitt 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`-Auslöser können so eingeschränkt werden, dass sie nur dann auslösen, wenn der Teilnehmer auf bestimmte Stimulusobjekte blickt, die als Ziele hinzugefügt wurden, anstatt auf irgendwo im Frame.

Weiterführende Literatur

Einrichten der Blickverfolgung in einer Labvanced-Aufgabe

Einrichten der Blickverfolgung in einer Aufgabe

Aktivieren Sie die Blickverfolgung und konfigurieren Sie die Rekalibrierung, bevor Sie die Ereignisse auf dieser Seite erstellen.

Verwendung von Formen als Interessenbereiche für die Blickverfolgung

Verwendung von Formen als Interessenbereiche (AOI)

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

Webcam-Blickverfolgungstechnologie in Labvanced

Webcam-Blickverfolgungstechnologie

Wie die Webcam-Blickverfolgungstechnologie von Labvanced funktioniert.

Zeitreihenvariablen

Die allgemeinen Aufzeichnungs- und Abtastmethodeneinstellungen, die steuern, wie kontinuierliche Daten wie Blick erfasst werden.

Aufgabensteuerungen

Das oben gezeigte automatisierte Dialogfeld zur Blickverfolgungseinrichtung im Kontext des vollständigen Referenzhandbuchs zu Aufgabensteuerungen.

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