Ereignissystem

Illustration des Ereignissystems in Labvanced.

Beschreibung

Das Ereignissystem ist für jede Studie unerlässlich. So richten Sie Werte ein, die aufgezeichnet werden sollen, lassen das Experiment fortschreiten und erstellen Aufgaben. Benutzer können ein Ereignissystem erstellen, um alle Funktionen, Logik und Interaktionen in einer Aufgabe auszuführen. Ein Ereignis fungiert häufig als Vermittler zwischen Objekten und Variablen.

  • Für eine vollständige Liste der Auslöser
  • Für die vollständige Liste der Aktionen
  • Für weitere Informationen zum Value-Select-Menü zum Einstellen von Werten unter Ereignissen
Überblick darüber, wie Auslöser und Aktionen in Labvanced verwendet werden.

Das Ereignissystem besteht aus Auslösern und Aktionen. Hier richten Sie Regeln ein, wie 'wenn dies geschieht' (Auslöser)' dann 'mache dies' (Aktion). Zum Beispiel: Wenn ein Teilnehmer auf ein bestimmtes Bild klickt (Auslöser), dann zeige ein anderes, zufälliges Bild (Aktion).

Für eine Einführung, wie Ereignisse in Labvanced funktionieren, sehen Sie sich bitte dieses kurze Video an:

Erstellung von Ereignissen - Überblick

Ereignisse werden im Aufgabeneditor unter dem Tab "Ereignisse" in der oberen rechten Ecke verwaltet. Neue Ereignisse können durch einen Klick auf + Frame Event für Ereignisse, die auf diesem Frame auftreten sollen, oder durch einen Klick auf + Trial Event, das das Ereignis auf alle Frames anwendet, erstellt werden. Alle vorhandenen Ereignisse werden in einer Listenansicht im rechten Seitenpanel angezeigt. Ereignisse werden auf Frame-Ebene definiert und können für jeden Frame separat/spezifisch oder dupliziert/dasselbe auf jedem Frame in einer Versuchsreihe sein.

Hinzufügen eines Ereignisses in Labvanced

In jedem Fall wird ein Ereignis immer für alle Versuche innerhalb einer Versuchsgruppe für den angegebenen Frame/die angegebenen Frames definiert. Eine benutzerdefinierte Logik ermöglicht es den Benutzern jedoch, Ereignisse nur in bestimmten Versuchen, Bedingungen oder unter anderen Umständen auszuführen.

Das folgende Video gibt einen Überblick über die in Labvanced verfügbaren Auslöser und Aktionen:

Die Ausführungsreihenfolge der Ereignisse kann angepasst werden. Standardmäßig stehen Ereignisse mit demselben Auslöser weiter oben in der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Bei der Auswahl eines vorhandenen Ereignisses werden die spezifischen Details im unteren rechten Bereich (Ereigniseigenschaften) angezeigt. Zur besseren Übersicht können vorhandene Ereignisse auch wieder geöffnet werden (Symbol neben dem Namensfeld).

Auslöser

Der Auslöser definiert, wann das Ereignis ausgeführt wird. Dies könnte ein Mausklick auf ein bestimmtes Objekt, eine bestimmte Tastatureingabe, eine Änderung eines Variablenwerts, der Beginn einer Videodatei oder viele andere Dinge sein. Alle Auslöser und ihre Einstellungen / Parameter werden in der folgenden Liste erklärt:

Auslöser-Kategorie Auslöser-Optionen Beschreibung
Benutzereingabe-AuslöserBenutzereingabe-Auslöser beziehen sich auf alle Auslöser, die manuell vom Benutzer/Teilnehmer aktiviert werden können, indem sie beispielsweise die Maus bewegen, eine Taste drücken, scrollen usw.
Physiologische Signal-AuslöserPhysiologische Signal-Auslöser treten auf, wenn ein bestimmter physiologischer Input vorliegt, wie das Anstarren eines bestimmten Elements oder Änderungen der Kopfbewegungen.
Versuchs- und Frame-AuslöserDiese Auslöser treten in Bezug auf die experimentellen Versuche und Frames auf, wie wenn ein Frame beginnt oder endet.
Variable-Wert-Änderung-AuslöserVariable (Wert geändert)Ein Auslöser für das Ereignis tritt auf, wenn es eine Änderung in einem bestimmten Variablenwert gibt.
Medienobjekt-AuslöserMedienobjekt-AuslöserDieser Auslöser tritt in Bezug auf Medienobjekte auf, wie ein Pause in einer Video-/Audio-Datei, ein abgeschlossenes Recording usw.
API-AuslöserDies sind Auslöser, die auftreten, wenn es eingehende Daten von einer API gibt.
Globale AuslöserGlobale Auslöser beziehen sich auf alle wesentlichen Änderungen an einem Experiment, wie beispielsweise eine Pause oder das Verlassen eines Teilnehmers in einer Mehrbenutzerstudie.

Benutzereingabe-Auslöser

Benutzereingabe-Auslöser beziehen sich auf alle Auslöser, die manuell vom Benutzer/Teilnehmer aktiviert werden können.

Das Menü für Benutzereingabe-Auslöser in Labvanced

Die folgende Tabelle bietet einen einführenden Überblick über alle in Labvanced verfügbaren Benutzereingabe-Auslöser. Jeder von ihnen wird in den kommenden Abschnitten detaillierter beschrieben.

Benutzereingabe-Auslöser-OptionÜbersicht
Mausauslöser Jede Mausbewegung kann als Auslöser verwendet werden, um ein Ereignis zu initiieren, wie z.B.: scrollen, klicken, überfahren, usw. Sie können auch spezifische Elemente oder Ziele mit einem Auslöser verknüpfen. Zum Beispiel wird ein Mausklick nur dann als Auslöser verwendet, wenn ein bestimmtes Bild angeklickt wird.
TastaturauslöserJeder Tastendruck kann als Auslöser verwendet werden, um ein Ereignis zu initiieren. Sie können spezifische Tastaturbuchstaben oder Zahlen als Auslöser festlegen.
Button-KlicksButton-Objekte, die in Labvanced erstellt wurden, können als Auslöser verwendet werden, um Ereignisse zu initiieren.
Enter bei EingabeDieser Auslöser wird häufig verwendet, wenn ein Teilnehmer während eines Experiments 'Enter' drückt, um ihre schriftliche Antwort oder Eingabe in Textfeldbereichen abzugeben.
Scroll-AuslöserDieser Auslöser tritt auf, wenn der Teilnehmer scrollt. Sie können die x- oder y-Scrollrichtungen angeben sowie über welche Elemente das Scrollen erfolgt, um als Ereignisauslöser verwendet zu werden.
Gamepad-/Joystick-AuslöserDieser Auslöser ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimentellen Design als Eingabegerät zur Aufzeichnung von Daten zu nutzen.

Mausauslöser

Die Option 'Mausauslöser' ist ein sehr beliebter Ereignisauslöser, da sie ein Ereignis basierend auf jeder Mausinteraktion initiiert, wie z.B.: die Maus nach oben/unten bewegen, klicken, über einem spezifischen Objekt verweilen, ein spezifisches Objekt verlassen oder jede Bewegung überhaupt!

Die 'Mausauslöser'-Menüoption innerhalb des Eingabeauslösermenüs in Labvanced.

Das folgende Beispiel zeigt einen 'Mausauslöser', der auftritt, wenn ein 'Klick' durch den 'Linken' Mausklick auf das 'Ziel'-Objekt namens 'Image_1' ausgeführt wird:

Beispiel für die Verwendung der Mausauslöser-Option in Labvanced.

Nachfolgend finden Sie einen vollständigen Überblick über die Optionen, die Sie bei der Arbeit mit Mausauslösern haben:

MenüpunktMenübereichOptionen und Spezifikationen für Mausauslöser
Aktion

Dropdown-Liste:		Verfügbare Mausaktionen zur Festlegung des TriggerverhaltensDie folgenden Optionen für Mausauslöser sind aus der Dropdown-Liste verfügbar:
  • Klick: Ausgelöst durch Mausklick
  • PressDown: Ausgelöst durch Mausklick nach unten
  • PressUp: Ausgelöst durch Mausklick nach oben
  • Hover: Ausgelöst durch Überfahren eines Objekts
  • Leave: Ausgelöst durch Verlassen eines Objekts
  • Move: Ausgelöst durch jede Mausbewegung
Button

Dropdown-Liste:		Erklärung der Maustaste-Einstellung
  • Links: Ausgelöst durch die linke Maustaste
  • Rechts: Ausgelöst durch die rechte Maustaste
Ziele

Optionen:		Nahaufnahme des Mauszielbereichs

Im obigen Beispiel ist 'Image_1' das Ziel des Button-Klicks, der das Ereignis auslöst.

Mehrere Ziele können hinzugefügt werden, indem Sie die ‘+Ziel hinzufügen’-Option unten klicken.		 Bei der Angabe eines Ziels sind die folgenden Optionen verfügbar:
  • Auslösen auf Frame-Hintergrund: Der Mausauslöser kann ohne Klicken auf ein Objekt oder Element aktiviert werden.
  • Jedes Element: Der Mausauslöser kann aktiviert werden, wenn auf jedes Element im Frame geklickt wird.
  • Ziele hinzufügen: Wählen Sie die spezifischen Elemente aus, die angeklickt werden müssen, um den Auslöser zu aktivieren.

Tastaturauslöser

Die Option „Tastaturauslöser“ ist eine weitere beliebte Methode, um ein Ereignis auszulösen. Grundsätzlich kann jede Eingabe von der Tastatur als Trigger verwendet werden. Dazu gehört: das Drücken, Halten oder Loslassen einer Taste.

Die Tastaturauslöser-Option in Labvanced

Im folgenden Beispiel ist der Trigger als Tastendruck festgelegt, der auftritt, wenn die angegebenen Zielzahlen (0, 2 oder 6) gedrückt werden:

Beispiel für die Verwendung des Tastaturauslösers.

Hier ist eine vollständige Übersicht der Tasten und Optionen, die Sie beim Arbeiten mit Tastaturauslösern haben:

MenüpunktMenübereichOptionen für Tastaturauslöser
Aktion

Dropdown-Liste:		Dropdown-Liste der Tastenaktionen Dies sind die verfügbaren Tastaturaktionsoptionen:
  • PressKey: Wird durch das Drücken einer Taste (Taste ist gedrückt) ausgelöst
  • Press ODER Halte Taste: Auslösen, wenn die Taste entweder gedrückt oder gehalten wird
  • ReleaseKey: Wird durch das Loslassen einer Taste ausgelöst
Hinweis: Eine Taste muss losgelassen werden, damit sie erneut als Trigger „feuern“ kann.
Tasten

welche Taste das Ereignis auslöst		Nahaufnahme der Schaltflächenoptionen.Welche Taste als Trigger verwendet wird, wird hier angegeben, indem Sie die Optionen durch Klicken auf +Hinzufügen: auswählen:
  • Pfeile: die vier Pfeiltasten
  • Zahlen: Zahlen von 0-9
  • Buchstaben: Alle Buchstaben des englischen Alphabets
  • Sonder: Sondertasten (Enter, Leertaste, Steuerung, Tabulator, Umschalt)
  • F-Tasten: F1 bis F10
  • jeder Schaltfläche: jede dieser Tasten ist akzeptabel
Sie können mehrere Tastaturauslöser hinzufügen, indem Sie erneut auf die Schaltfläche +Hinzufügen: klicken.
Zusätzliche OptionenZusätzliche Optionen für Tastaturauslöser Die Option Zahlenblock-Tasten aktivieren ermöglicht die Verwendung von Zahlenblocktasten als Trigger innerhalb des Experiments.

Für die Option Ereignisweitergabe erlauben: Wenn mehrere Ereignisse denselben Tastaturauslöser haben, werden alle ohne ihn ausgelöst/triggere. Nur das erste wird ausgelöst, und die Ereignisausführung stoppt, nachdem das erste Ereignis abgeschlossen ist.

Button-Klick-Trigger

Wenn Sie ein Button- oder Navigationsobjekt im Editor platziert haben, können Sie es als Teil eines Ereignisses nutzen, bei dem das Klicken auf die Schaltfläche als Trigger für eine Aktion fungiert.

Das Button-Klick-Menü in Labvanced

Das Klicken auf diesen Trigger zeigt das folgende Menü an, in dem Sie angeben können, welche spezifische Schaltfläche als Trigger fungiert:

Verfügbare Optionen für den Button-Klick-Trigger

Hier ist ein genauerer Blick auf die enthaltenen Punkte:

MenüpunktMenübereichButton-Klick-Trigger-Optionen
Ziel:

+Ziel festlegen		Die Schaltfläche "Ziel festlegen". Auswahl eines Schaltflächenelements als Ziel
Schaltfläche:
Option		Der Bereich zur Auswahl von Schaltflächenoptionen.Geben Sie an, welche spezifische Schaltfläche im Frame verwendet wird

Eingabe mit Enter-Trigger

Trigger auf: Die Enter-/Rücktaste wird auf der Tastatur gedrückt, während ein bestimmtes Element aktiv ist.

Parameter:

  • Ziele hinzufügen: Ein Eingabeelement zum Ereignis hinzufügen.

  • Hinweis: Nachdem Sie den Eingabe-mit-Enter-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Eingabe-mit-Enter-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Scroll-Trigger

Trigger auf: Die Bildlaufleiste, das Scrollen auf dem Trackpad oder das Scrollrad der Maus wird auf einem bestimmten Element verwendet.

Parameter:

  • Wählen Sie, ob das Scrollen auf der Y-Achse oder der X-Achse erfolgt (vertikales Rollen oder horizontales Rollen).

Ziel: Legen Sie das Zielelement fest, auf das der Scroll-Trigger angewendet wird.

Hinweis: Für langen Text müssen im Panel 'Objekteigenschaften' im Abschnitt 'Stil' die Optionen Overflow-X und/oder Overflow-Y die Option Scrollen ausgewählt haben.

Gamepad-/Joystick-Trigger

Der Gamepad-/Joystick-Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimental Design als Eingabegerät zur Datenerfassung zu verwenden. Hinweis: Denken Sie daran, diese Option im Einstellungen Tab zu aktivieren.

Erfahren Sie mehr.

Physiologische Signaltrigger

Diese Trigger gelten nur, wenn die Augenverfolgung und/oder die Kopfverfolgung für die Aufgabe aktiviert wurden.

Augenverfolgungsgaze-Trigger

Trigger auf:

  • Insgesamt gilt dieser Trigger, wenn die Augenverfolgung aktiviert ist.
  • Nur Trigger beim Blick auf bestimmte Elemente.

Parameter:

  • Wenn Sie nur auf bestimmten Elementen auslösen möchten, fügen Sie diese Elemente als Ziele hinzu.

  • Hinweis: Nachdem Sie den Augenverfolgungsgaze-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Gaze-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Augenverfolgungsfixation-Trigger

Dieser Trigger befindet sich noch in der BETA-Phase.

Kopfverfolgungs-Trigger

Trigger auf:

  • Änderungen in der Kopfhaltung oder Kopfbewegung.

  • Hinweis: Nachdem Sie den Kopfverfolgungs-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Kopfverfolgungswerte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Versuch und Rahmen-Trigger

Aufgabeninit-Trigger

Trigger auf:

  • Der erste Frame des ersten Versuchs einer Aufgabe. Wird nur einmal pro Aufgabe ausgeführt, obwohl er im Register „Ereignisse“ für alle Instanzen dieses Frames angezeigt wird.

Dieser Trigger eignet sich gut für die Shuffle- und Read-From-Aktionen. Mit diesen Kombinationen können Sie Array-Einträge oder Datenrahmen zu Beginn der Aufgabe mischen und Probanden Gruppen von Stimuli zuweisen, ohne mehrere Ereignisse zu erstellen, um Stimuli oder Daten auszulesen.

Parameter: Keine

Frame Init Trigger

Auslöser bei:

  • Der Initialisierung des Frames, bevor er für den Teilnehmer sichtbar wird.

Dieser Auslöser passt gut zu den Aktionen Shuffle, Read From und Draw Random Number. Mit diesen Kombinationen können diese Aktionen abgeschlossen werden, bevor der Frame erscheint, und so einen klaren Weg für andere Aktionen schaffen, die beginnen, wenn der Frame startet.

Hinweis: Verwenden Sie den Frame Init-Auslöser nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Trial Number oder Condition Number betreffen. Dies liegt daran, dass der Frame Init-Auslöser zwischen den Trials auftritt, sodass keine vollständig genaue Zählung des Trials oder der Bedingung vorliegt, die angezeigt werden soll.

Parameter: Keine

Hinweis zu Task- und Frame Init-Auslösern: Da die Task- und Frame Init-Auslöser auftreten, bevor die Aufgabe oder der Frame beginnt, werden Variablen, die in dieser Zeit erstellt werden, zurückgesetzt, wenn die Aufgabe/der Frame tatsächlich beginnt. Eine Warnung wird angezeigt, wenn Sie dieses Ereignis verwenden:

frame init warning

Denken Sie daran, das Kästchen "Zurücksetzen am Beginn des Trials" im Variablen-Eigenschaftenfenster abzuwählen, wenn Sie nicht möchten, dass die Variablenwerte zurückgesetzt werden.

Frame Start Trigger

Auslöser bei:

  • Beginn des Frames

Parameter: Keine

Frame End Trigger

Auslöser bei:

  • Ende des Frames (nachdem der Frame nicht mehr sichtbar ist)

Parameter: Keine

Variable Value Changed Trigger

Variable Value Changed

Auslöser bei:

  • Der Wert einer Variable ändert sich von seinem Ausgangswert

Parameter:

  • Variablen: Wählen Sie eine oder mehrere Variablen aus, bei denen Sie Änderungen „überwachen“ möchten. Jede Änderung des Wertes dieser Variablen löst sofort die entsprechende Aktion aus.

  • Hinweis: Nach Auswahl des Variable Value Changed-Auslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Variable Value Changed-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Media Object Triggers

Media Object Trigger

Früher bekannt als die separaten "Control Audio/Video Trigger" und "Control Object" Auslöser.

Auslöser bei:

  • Start, Pause oder Stopp einer Video- oder Audiodatei
  • Dateiupload abgeschlossen, Datei ausgewählt, Aufnahme abgeschlossen eines Aufnahmeobjekts
  • Snapshot abgeschlossen oder Upload abgeschlossen eines Kamera-Snapshot-Objekts

Parameter:

  • Ziel: Wählen Sie ein Objektelement aus, das im Frame vorhanden ist

  • Ausführen bei: Wählen Sie Untertyp des Auslösers

    • Audio- oder Videoobjekt-Optionen:
      • Wiedergabe gestartet: Wird ausgelöst, wenn das Element mit der Wiedergabe beginnt
      • Wiedergabe gestoppt: Wird ausgelöst, wenn das Element pausiert
      • Wiedergabe beendet: Wird ausgelöst, wenn das Element mit der Wiedergabe aufhört
    • Video-, Audio- oder Bildschirmaufnahmeobjekt-Optionen:
      • Aufnahme beendet: Wird ausgelöst, wenn die Audioaufnahme gestoppt hat
      • Upload abgeschlossen: Wird ausgelöst, wenn der Datei-Upload abgeschlossen ist
    • Dateiupload-Objekt-Optionen:
      • Datei ausgewählt: Wird ausgelöst, wenn eine Datei ausgewählt wird
      • Upload abgeschlossen: Wird ausgelöst, wenn der Datei-Upload abgeschlossen ist
    • Kamera-Snapshot-Objekt-Optionen:
      • Snapshot beendet: Wird ausgelöst, wenn die Kamera erfolgreich ein Snapshot aufgenommen hat
      • Upload abgeschlossen: Wird ausgelöst, wenn der Snapshot fertigg hochgeladen ist

  • Hinweis: Nach Auswahl des Media Object-Auslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Media Object-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

API Triggers

Wenn Sie Daten von einem externen Server in Labvanced senden oder kommunizieren müssen, können "API Triggers" und „API Actions“ verwendet werden. Folgendes kann als Auslöser verwendet werden:

  • Websocket Trigger
  • OpenAI Trigger
  • PostMessage Received

Das API-Auslösermenü in Labvanced.

Websocket Trigger

Der Websocket Trigger wird verwendet, wenn eine Nachricht von dem Websocket/API empfangen wird, die als Auslöser für die Aktion verarbeitet werden soll.

Die Websocket-Auslösermenüoption.

Nach dem Klicken auf diese Option erscheinen die folgenden Elemente.

Das Websocket-Auslösedialogmenü.

  • Akzeptieren/Empfangen von: Ermittelt automatisch die IP-Adresse des lokalen Hosts. Kann manuell im Tab Settings unter Sonderfunktionen geändert werden.
  • Auslöser/Nachricht: Geben Sie die Nachricht ein, die als Auslöser dienen soll. Tippen Sie 'any', um mehr als eine Nachricht als Auslöser zu akzeptieren.

Für ein Beispiel, wie API Triggers / Actions verwendet werden, besuchen Sie bitte diese Demo https://www.labvanced.com/page/library/51053, indem Sie die Option „Untersuchen“ im Dialogfeld auswählen.

Für weitere Informationen über API-Zugriff besuchen Sie bitte diese Seite.

OpenAI Trigger

Der „OpenAI Trigger“ kann verwendet werden, um eine Aktion basierend auf eingehenden Informationen von OpenAI zu initiieren.

Das OpenAI Trigger-Menü in Labvanced.

Die Auswahl dieser Option führt dazu, dass die folgenden Parameter angezeigt werden:

Die OpenAI-Auslösermenüoptionen.

HINWEIS: Verweisen Sie auch auf dieses Tutorial, in dem wir eine Studie Schritt für Schritt aufbauen und ChatGPT in einer Studie integrieren und diesen Auslöser verwenden.

Im folgenden Beispiel wird der Datenrahmen, der zugewiesen wurde, 'df' genannt, und das Ergebnis aus dem „OpenAI Trigger“ wird an diesen Datenrahmen angehängt. Dieser Datenrahmen muss zwei Spalten haben. Die erste Spalte bezeichnet die „Rolle“ und die zweite Spalte die „Chat-Nachricht.“ Die Werte aus der Aktion werden automatisch an den hier verlinkten Datenrahmen angehängt.

Ein Beispiel für den OpenAI-Auslöser in Labvanced.

Wenn Sie auch die „Send to OpenAI“ Action verwenden, müssen Sie denselben Datenrahmen dort verwenden, wie Sie hier angegeben haben.

PostMessage Received Trigger

Der PostMessage Received Auslöser wird ausgelöst, wenn das laufende Experiment eine eingehende Nachricht aus einer externen Quelle über die PostMessage-API des Browsers erhält. Dies ist nützlich, um ein Experiment mit einer übergeordneten Seite, einer benutzerdefinierten Anwendung oder einer eingebetteten externen Website zu verbinden, die Daten in die Studie sendet.

Erfahren Sie mehr.

Global Triggers

Globale Auslöser treten auf, wann immer eine wesentliche Änderung im Experiment erfolgt, d.h. etwas, das „global“ ist, z.B. das Pausieren des Experiments oder ein Teilnehmer, der eine Mehrbenutzerstudie verlässt! Die folgenden Optionen werden als globale Auslöser aufgeführt:

  • Experiment pausieren / fortsetzen
  • Teilnehmer hat die Mehrbenutzerstudie verlassen

Das globale Auslösermenü in Labvanced.

Pause/Resume Experiment

Der Auslöser „Pause / Resume Experiment“ ist eine Option, die es Ihnen ermöglicht, ein Ereignis basierend auf dem Pausieren oder Fortsetzen des Experiments auszuführen.

Die Option, eine Pause im Experiment als Auslöser zu verwenden.

```

Nach Auswahl dieses Triggers erscheint die folgende Ansicht, in der Sie die Art des Triggers weiter spezifizieren können, ob er im Experiment beim Anhalten oder Fortsetzen / Wiederaufnehmen ausgeführt werden soll:

Dialogmenü für diesen globalen TriggerVerfügbare Optionen im globalen Trigger-Menü

  • Experiment Pausiert: Der Teilnehmer pausiert (verlassen den Vollbildmodus) das Experiment.

  • Experiment Fortgesetzt: Der Teilnehmer setzt das Experiment fort. Dieser Trigger funktioniert gut für Augenbewegungsstudien. Er kann verwendet werden, um den Teilnehmer zu einem vorherigen Versuch oder Frame zurückzuschicken, wenn er seine virtuelle Kinnstütze verlassen hat.

  • Hinweis: Nach Auswahl des Pause/Wiederaufnahme-Experiment-Triggers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Werte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Teilnehmer hat Multiuser-Studie verlassen

Wenn ein Teilnehmer eine Multiuser-Studie verlässt, kann dies ebenfalls als Trigger für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Multiuser-Studie verlässt, hat dies Auswirkungen auf das Experiment auf globaler Ebene, da es anderen Teilnehmern nicht erlaubt, das Experiment fortzusetzen.

Die Option Teilnehmer hat die Multiuser-Studie verlassen als Trigger in Labvanced

Durch Auswahl dieses Triggers können Sie festlegen, welche Art von Aktion erfolgen soll, wenn ein Teilnehmer eine Multiuser-Studie verlässt.

Das Dialogfeld des Triggers Teilnehmer hat die Multiuser-Studie verlassen.

  • Hinweis: Nach Auswahl des Triggers Teilnehmer hat Multiuser-Studie verlassen im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Werte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Aktionen

Aktionen definieren, was passieren soll, wenn das Ereignis ausgeführt wird. Sie können verwendet werden, um Variablen und Objektmerkmale zu ändern, Daten zu erfassen, Daten zu lesen und zu schreiben von / zu Arrays oder zum nächsten Versuch oder zur nächsten Aufgabe zu springen. Oft gibt es mehrere Aktionen pro Ereignis. Mit "ControlActions" kann man logische Operationen (If-Else-Anweisungen), Schleifen, Callback-Funktionen sowie das Verschachteln von Aktionen innerhalb anderer Aktionen (z. B. eine While-Schleife innerhalb einer If-Anweisung) verwenden. Daher kann das Ereignissystem als grafische Programmierumgebung angesehen werden. In dieser Ansicht fungieren Trigger als Funktionsaufrufe, während Aktionen die funktionale Logik beschreiben. Dieser Ansatz garantiert, dass fast jede experimentelle Logik implementiert werden kann, ohne bestimmte programmatische/syntaktische Strukturen zu verwenden.

Die folgende Tabelle bietet einen einführenden Überblick über die in Labvanced verfügbaren Aktionen:

Aktionskategorie Aktionsoptionen Beschreibung
ObjektaktionenObjektaktionen beziehen sich auf jede Manipulation, die an einem innerhalb der Aufgabe existierenden Objekt durchgeführt wird.
VariablenaktionenJede Aktion, die einen Variablenwert liest oder aufzeichnet.
ArrayaktionenArrayoperationen umfassen das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und ihren Einträgen.
DatenrahmenoperationenDiese Aktionen sind relevant, wenn Sie mit .csv-Dateien (Datenrahmen) in Ihrem Experiment arbeiten.
SprungaktionenErmöglicht Ihnen, im Experiment zu navigieren, indem Sie zu einem bestimmten Abschnitt springen und auch Teilnehmerabschnitte annehmen und ablehnen.
SteueraktionenSteueraktionen werden verwendet, um spezifische Sequenzen von Ereignissen auszuführen, wie logische If/Then-Abfolgen, Schleifen (wie das Abspielen eines wiederholten Sounds oder das Blitzen eines Bildes) sowie um eine Verzögerung für das Eintreten einer Aktion einzurichten.
API-AktionenBezieht sich auf API-spezifische Aktionen zum Senden von Daten an eine API.
Code-AktionenCode-Aktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten.
EinfügeaktionEinfügeaktionErmöglicht es Ihnen, eine Aktion einzufügen, die Sie zuvor kopiert haben.

Objektaktionen

Objektaktionen beziehen sich auf jede Manipulation, die an einem innerhalb der Aufgabe existierenden Objekt durchgeführt wird. Es gibt mehrere Objektaktionsoptionen:

  • Objekteigenschaft setzen
  • Medienobjekt steuern
  • Objekt kopieren
  • Für jedes Objekt

Die Option Objektaktionen in Labvanced.

Objekteigenschaft setzen Aktion

Mit der Aktion „Objekteigenschaft setzen“ können Sie das Erscheinungsbild eines Objekts nach Belieben ändern, indem Sie das betreffende Objekt, die zu ändernde Eigenschaft und den neuen Wert angeben.

Lernen Sie mehr.

Medienobjekt steuern Aktion

Ehemals die separaten Aktionen "Audio/Video steuern" und "Objekt steuern".

Wirkung: Ändert die Wiedergabe von Video-/Audioelementen oder ändert den Status von Upload-/Aufzeichnungselementen.

Parameter:

  • Ziel: Wählen Sie ein Medienobjekt aus
  • Effekt: Wählen Sie eine Unteraktion aus
    • Audio- oder Videoobjektoptionen:
      • Wiedergabe starten: Startet die Wiedergabe der Video-/Audiodatei
      • Wiedergabe stoppen: Stoppt die Video-/Audiodatei
      • Wiedergabe pausieren: Pausiert die Video-/Audiodatei
      • JumpToTime: ermöglicht es Ihnen, eine Zeit in Millisekunden anzugeben, zu der im Audio-/Video-File gesprungen werden soll
      • Stummschalten: Schaltet den Ton des Objekts aus
      • Stummschaltung aufheben: Stellt den Ton des Objekts wieder her
    • Audio-, Video- oder Bildschirmaufnahme-Objektoptionen:
      • Aufnahme starten: Startet eine neue (Audio-)Aufnahme
      • Aufnahme stoppen: Stoppt die (Audio-)Aufnahme
      • Upload starten: Beginnt den Upload der Datei
      • Aufnahme löschen: Löscht die (Audio-)Aufnahmedaten.
      • Wiedergabe starten: Startet die Wiedergabe der aufgezeichneten Datei
      • Wiedergabe stoppen: Stoppt die Wiedergabe der aufgezeichneten Datei
      • Aufnahme pausieren: pausiert die Aufnahme des Objekts
      • Aufnahme fortsetzen: setzt die Aufnahme des Objekts fort
    • Datei-Upload-Objektoptionen:
      • Upload starten: startet den Uploadprozess für die ausgewählte Datei
      • Datei löschen: Löscht die ausgewählte Datei
      • Datei auswählen: ermöglicht es dem Teilnehmer, die gewünschte Datei auszuwählen
    • Kamera-Snapshot-Objektoptionen:
      • Kamera starten: aktiviert die Kamera des Teilnehmers
      • Kamera stoppen: schaltet die Kamera des Teilnehmers aus
      • Upload starten: beginnt den Snapshot zum Experiment hochzuladen
      • Snapshot machen: macht ein Bild mit der Kamera des Teilnehmers

Objekt kopieren Aktion

Wirkung: Kopiert ein Objekt, wodurch die Notwendigkeit für mehrere separate Objekte und doppelte Ereignisse entfällt.

Parameter:

  • Quelle: Wählen Sie das Objekt im Frame aus, das kopiert werden soll.
  • Anzahl der Kopien: Geben Sie die Anzahl der Kopien an, die vom Quellobjekt erstellt werden sollen.
  • Neuen Elementnamen festlegen: Wählen Sie aus mehreren Parametern, um die Namen der Kopien festzulegen.
  • Namen mit fortlaufendem Postfix zuweisen: Fügt dem Ende des neuen Elementnamens ein numerisches Tag hinzu, um die Kopien zu unterscheiden.
  • Aktionssequenz: Ermöglicht Ihnen, auszuwählen (aus der gewohnten Aktionsliste), was mit den Kopien passieren soll. Wählen Sie "CurrentObject" als Ziel, um die Aktion auf alle Kopien anzuwenden.#### ForEach Objekt Aktion Wirkung: Wendet eine Aktion auf mehrere Objekte desselben Typs an.

Parameter:

  • Filter: Wählen Sie den Typ des anvisierten Elements aus.
  • Zusätzlichen Namensfilter zulassen: Geben Sie den Namen des/der anvisierten Objekte ein. Bei mehreren Objekten in einem Frame, bei denen einige identische Namen haben, funktioniert dies gut.
  • Aktionssequenz: Ermöglicht Ihnen, aus der üblichen Liste von Aktionen auszuwählen, was mit den ausgewählten Elementen geschehen soll. Wählen Sie "CurrentObject" als Ziel, um die Aktion auf alle Elemente anzuwenden, die die oben festgelegten Kriterien erfüllen.

Variablenaktionen

Variablenaktionen werden verwendet, um Variablenwerte festzulegen oder zu erstellen, Werte aufzuzeichnen und zu definieren, einschließlich Werte, die über Sitzungen hinweg bestehen bleiben.

Standort der Variablenaktionen im Ereignissystem

Die folgende Tabelle bietet einen einführenden Überblick über alle in Labvanced verfügbaren Optionen für Variablenaktionen. Jede von ihnen wird in den kommenden Abschnitten genauer beschrieben.

Option für VariablenaktionBeschreibung
Set / Record VariableSchreiben oder Festlegen eines Variablenwerts
Copy to ClipboardKopiert einen Variablenwert in die interne Zwischenablage des Computers.
Draw Random NumberZieht eine oder mehrere Zufallszahl(en) und speichert sie in einer Variablen
Get URL ParameterSpeichert einen Wert aus der einzigartigen URL des Teilnehmers
Read from / Write to Device Liest oder schreibt eine Variable aus/ in den Speicher des lokalen Geräts. Diese Aktion speichert Daten auf dem Gerät des Teilnehmers, anstatt die Daten an die Labvanced-Server zu senden.
Read from / Write to Shared VariableLiest von oder schreibt in eine Variable, die über die Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jede Person sein.
Math & StatisticsFührt eine mathematische Operation mit einer Eingangsvariablen (Array) durch und speichert das Ergebnis in einer Ausgangsvariablen.
Record Variables InstantlyErstellt einen Snapshot aller Variablenwerte und sendet diesen an den Labvanced-Server.
Moving Average FilterBerechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingabe und speichert das Ergebnis in einer neuen Variablen.
Distribute VariableSendet einen Wert an andere Teilnehmer. Der Wert wird in einer Variablen gespeichert.

Set / Record Variable Aktion

Die ‘Set / Record Variable’-Aktion wird in jedem Experiment in Labvanced verwendet, da sie festlegt, wie Werte und Verhaltensmaßnahmen gespeichert und aufgezeichnet werden.

Standort der Set/Record-Variablenaktion im Ereignissystem

Beim Klicken auf diese Aktion wird das folgende Dialogmenü angezeigt, in dem Sie angeben können, welche Variable aufgezeichnet werden soll und welcher Wert von Interesse ist:

Set/Record-Variablenoptionen im Ereignissystem

MenüpunktMenübereichBeschreibung
SelectAuswahl, an welche Teilnehmer die verteilte Variable gesendet wirdDurch Klicken auf Auswählen geben Sie an, welche Variable den Wert speichern soll. Von hier aus können Sie auch eine neue Variable erstellen.
StiftsymbolAuswahl, an welche Teilnehmer die verteilte Variable gesendet wirdDas Stiftsymbol symbolisiert das Wertauswahlmenü, das verwendet wird, um die genauen Werte zu definieren und anzugeben, die der ausgewählten Variable (wie links vom Gleichheitszeichen (=) angegeben) zugewiesen werden sollen.

Im folgenden Beispiel haben wir eine neue Variable namens counter erstellt und eine arithmetische Option aus dem Wertauswahlmenü verwendet, um den Variablenwert um 1 zu erhöhen (basierend auf dem im vorherigen Schritt definierten Trigger).

Erstellen einer Zählervariablen in Labvanced

Das folgende Bild zeichnet die X-,Y-Koordinaten der Maus auf, um das Maus-Tracking während einer Studie zu erfassen. Das Bild zeigt, wie drei Aktionen verwendet werden, um die Aufzeichnung von Variablenwerten zu ermöglichen. Die Variable (links) wird manuell erstellt, während der Wert auf der rechten Seite des Gleichheitszeichens (=) ein mausauslöserspezifischer Wert ist, den das System bereitstellt und auf den Sie sich bei der Aufzeichnung von Werten beziehen können.

Erstellen von Variablen für Maus-Tracking und Messung von Koordinaten in Labvanced

Hinweis: Die Set / Record Variable-Aktion wird auch häufig im Kontext von Control Actions verwendet, bei denen Sie Bedingungen mithilfe von 'if / then' und 'while loops' basierend auf Variablenwerten festlegen können.

Copy to Clipboard Aktion

Wirkung: Kopiert einen Variablenwert in die interne Zwischenablage des Computers.

Draw Random Number Aktion

Wirkung: Zieht eine oder mehrere Zufallszahl(en) und speichert sie in einer Variablen.

Parameter:

  • Typ: Wählen Sie zwischen kontinuierlichen und diskreten Werten.
  • Verteilung: Wählen Sie zwischen gaußscher und gleichmäßiger Verteilung.
  • Mehrfache Ziehungen (boolesch wahr/falsch): Wählen Sie, ob einmal oder mehrmals gezogen werden soll.
  • Anzahl der Ziehungen: Wählen Sie die Anzahl der Ziehungen.
  • Min: Definieren Sie den Mindestwert für die gleichmäßige Verteilung.
  • Max: Definieren Sie den Höchstwert für die gleichmäßige Verteilung.
  • Mittelwert: Definieren Sie den Mittelwert für die gaußsche Verteilung.
  • Standardabweichung: Definieren Sie die Standardabweichung für die gaußsche Verteilung.
  • In Variable speichern: Wählen Sie eine Variable aus, in der der/die Wert(e) gespeichert werden.

Get URL Parameter Aktion

Wirkung: Speichert einen Wert aus der einzigartigen URL des Teilnehmers.

Parameter:

  • Parametername: Geben Sie den Namen des gewünschten Parameters ein.
  • In Variable speichern: Wählen Sie die Variable aus, in der der Parameterwert gespeichert werden soll.

Diese Aktion könnte mit anderen Aktionen kombiniert werden, um einzigartige URLs für Teilnehmer zu erstellen oder Informationen zu extrahieren, die für die Datenanalyse erforderlich sind.

Read from/Write to Device Aktion

Wirkung: Liest oder schreibt eine Variable aus/ in den Speicher des lokalen Geräts. Diese Aktion speichert Daten auf dem Gerät des Teilnehmers, anstatt die Daten an die Labvanced-Server zu senden.

Parameter:

  • Wählen Sie aus, ob Sie vom lokalen Gerät lesen oder auf dieses schreiben möchten.
  • Wählen Sie die Variable aus, die gelesen oder geschrieben werden soll.

Anwendungsfall: Langzeit/Multi-Session-Studien

  • Mit dieser Aktion können gerätespezifische Daten von Sitzung zu Sitzung übertragen werden, vorausgesetzt, der gleiche Teilnehmer verwendet für jede Sitzung dasselbe Gerät.
  • Beispielsweise können Sie diese Aktion verwenden, um aufzuzeichnen, welche Bilder jedem Teilnehmer in Sitzung 1 präsentiert wurden, und sicherzustellen, dass in Sitzung 2 andere Bilder präsentiert werden.
    • Erstellen Sie ein Array von Bildern und wählen Sie zufällig einige aus, die in jeder Sitzung präsentiert werden.
    • Schreiben Sie auf das Gerät: die Indexnummer der in Sitzung 1 präsentierten Bilder.
    • Lesen Sie vom Gerät: lesen Sie in Sitzung 2 die Indizes der Bilder aus Sitzung 1 und fügen Sie eine JavaScript-Aktion hinzu, die verhindert, dass diese Indizes für die zweite Sitzung ausgewählt werden.

Read from/Write to Shared Variable Aktion

Wirkung: Liest von oder schreibt in eine Variable, die über die Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jede Person sein.

Parameter:

  • Wählen Sie die zu synchronisierende Variable aus. Muss entweder skalar oder ein Array sein.
  • Erweiterte Optionen:
    • Speicherkey: Wählen Sie den Namen einer Variablen, die als Schlüssel dient, um auf die synchronisierte Variable zuzugreifen.
    • Lese- oder Schreibmethode:
      • Lesen, ändern und dann in die geteilte Variable schreiben: Liest die Variable, nimmt eine Änderung vor und sendet die Variable an die Studie.
      • Nur den gemeinsamen Wert vom Server lesen: Ruft die Variable ab, die innerhalb der Studie geteilt wird, nimmt jedoch keine Änderungen vor.
      • Nur Variable auf den Server schreiben: Nehmen Sie Änderungen an der geteilten Variable vor, zeigen Sie diese jedoch den Teilnehmern nicht an.
      • Werte zwischen verschiedenen Teilnehmern teilen (nicht nur zwischen Sitzungen): Ermöglicht es den Teilnehmern, die synchronisierten Werte der Variablen über Sitzungen hinweg zu sehen. Diese Option ist standardmäßig ausgewählt, kann jedoch durch Klicken auf das Kontrollkästchen abgewählt werden.
  • Aktionssequenz:
    • Wählen Sie aus, was mit der geteilten/synchronisierten Variablen aus der Liste aller verfügbaren Aktionen geschieht.

Anwendungsfall: Langzeit/Multi-Session-Studien

  • Mit dieser Aktion können teilnehmerspezifische Daten von Sitzung zu Sitzung übertragen werden und können zwischen Teilnehmern über Sitzungen hinweg geteilt werden.
  • Beispielsweise können Sie diese Aktion verwenden, um einen Punktestand bei einem Test aufzuzeichnen und dann dem Teilnehmer zu ermöglichen, seinen Punktestand mit dem Durchschnittswert der anderen Teilnehmer, die den Test abgeschlossen haben, zu vergleichen.
  • Ein weiteres Beispiel (ähnlich wie die Read from/Write to Device Aktion) besteht darin, dass Teilnehmer 5 Bilder auswählen, die ihnen aus einem Array gefallen, eine Aufgabe durchführen und dann diese 5 Bilder in einer späteren Sitzung erneut präsentieren. Der Unterschied besteht darin, dass diese Aktion verwendet werden kann, um anderen Teilnehmern die ausgewählten Bilder zu zeigen oder diese Bilder von den verfügbaren Optionen eines anderen Teilnehmers auszuschließen.```markdown

Math & Statistics Action

Wirkung: Führt eine mathematische Operation an einer Eingangsvariablen (Array) durch und speichert das Ergebnis in einer Ausgangsvariable.

Parameter:

  • Typ: Wählen Sie zwischen Array-Operationen, linearer Algebra und statistischen Tests
  • Operation: Wählen Sie eine mathematische Operation (z. B. Summe, min, stdev usw.)
  • Eingangsarray: Wählen Sie eine Eingangsvariable (Array), auf der die Operation ausgeführt wird
  • Parameter: Einige Operationen haben zusätzliche Parameter.
  • Ausgabe: Wählen Sie eine Ausgangsvariable, in der das Ergebnis gespeichert wird.

Record Variables Instantly Action

Wirkung: Erstellt einen Snapshot aller Variablenwerte und sendet diesen an den Labvanced-Server.

Parameter: Keine

Moving Average Filter Action

Wirkung: Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) eines Eingangs und speichert das Ergebnis in einer neuen Variablen.

Parameter:

  • Filterform: Wählen Sie den Filtertyp
    • Einfacher gleitender Durchschnitt: Berechnet einen einfachen gleitenden Durchschnitt, bei dem alle Proben das gleiche Gewicht haben.
    • Linear gewichteter gleitender Durchschnitt: Gewichtet die Proben so, dass die Gewichte der Proben linear abnehmen.
    • Exponentialgewichteter gleitender Durchschnitt: Gewichtet die Proben so, dass die Gewichte der Proben exponentiell abnehmen.
  • Anzahl der Proben: Bestimmt, wie viele Proben pro Schritt verwendet werden.
  • Eingabe: Wählen Sie eine Eingangsvariable (Array), auf der der gleitende Durchschnitt berechnet wird.
  • Ausgabe: Wählen Sie eine Ausgangsvariable, in der das Ergebnis gespeichert wird.

Distribute Variable Action

Die Distribute Variable-Aktion ist entscheidend für Multi-User-Studien in Labvanced. Mit dieser Aktion kann ein Variablenwert zwischen Teilnehmern geteilt werden, wodurch Informationen (einschließlich Stimuli-Standorte und etwaige Änderungen) auf den Bildschirmen der Teilnehmer angezeigt werden.

Die Distribute Variable-Aktion im Labvanced-Aktionsmenü.

Nach Auswahl dieser Aktion erscheint das folgende Dialogfeld, in dem Sie angeben können, welcher Variablenwert zwischen den Teilnehmern verteilt wird.

Das Bild unten zeigt, wie ein funktionales Dialogfeld für die Distribute Variable-Aktion aussieht, wenn alle Menüelemente ausgefüllt sind. In diesem Beispiel wird die Verteilungsvariable als Methode verwendet, um einen Chat zwischen zwei Teilnehmern zu erstellen, indem der Wert einer Variablen aus einem Eingabefeldobjekt verteilt wird.

Die Distribute Variable wird in einem Beispiel verwendet, das alle Menüoptionen eingestellt hat.

Schauen Sie sich diese Demo an, die die Verteilungsvariable und die Chatbox-Funktion hier integriert: Bildbeschreibung Aufgabe mit Chat-Add-On.

Eine vollständige Erklärung der Menüelemente im Dialogfeld finden Sie unten:

MenüpunktMenübereichOptionen und Beschreibungen zur Distribute Variable-Aktion
Distribute value toAuswahl, an welche Teilnehmer die verteilte Variable gesendet wirdWählen Sie aus, an welche anderen Teilnehmer der Wert gesendet werden soll.
  • Alle Teilnehmer: Senden Sie diesen Wert an alle Teilnehmer
  • Ausgewählte Teilnehmer: Senden Sie den Wert an ausgewählte Teilnehmer.
Choose target variable and valueSpezifizierung des Zielvariablen und der Werte
  • Zielvariable: Wählen Sie eine Zielvariable, in der der Wert gespeichert wird.
  • Wert: Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.
BlockDie Blockoption der verteilten VariableWenn aktiviert, kann die Zielvariable nicht geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist.
Rate Limit StrategyDie Optionen der Ratenlimitstrategie der verteilten VariableDie Ratenlimitstrategie ist eine Möglichkeit, Ihr Experiment vor einer Überlastung des Servers zu schützen, und dient als Vorsichtsstrategie zur Kontrolle der Häufigkeit, mit der Anfragen (d. h. Updates über die Verteilungsvariable) an den Server gesendet werden. Die folgenden Strategieoptionen sind verfügbar:
  • Debounce: Wenn diese Aktion mehr als einmal pro 100 ms-Zeitfenster ausgeführt wird, werden neue Servernachrichten „debounced“ (nur die zuletzt erhaltene Nachricht wird nach einem Intervall von 100 ms ohne Ausführung dieser Aktion gesendet).
  • Throttle: Wenn diese Aktion mehr als einmal pro 100 ms-Zeitfenster ausgeführt wird, werden neue Nachrichten gedrosselt (d. h., nachdem 100 ms seit der letzten gesendeten Nachricht vergangen sind, wird nur die zuletzt gesendete Nachricht verteilt).
  • Discard: Wenn diese Aktion mehr als einmal pro 100 ms-Zeitfenster ausgeführt wird, werden neue Nachrichten innerhalb dieses 100 ms-Fensters verworfen.
  • Queue: Wenn diese Aktion mehr als einmal pro 100 ms-Zeitfenster ausgeführt wird, werden neue Variablenwerte in eine Warteschlange gestellt (bis zu einer maximalen Warteschlangengröße von 10 Nachrichten).

Array Actions

Select (Read) from Array Action

Wirkung: Liest eine Variable aus einem Array und speichert diesen Wert in einer skalaren Variable.

Parameter:

  • Array-Variable: Eingangsarray zum Auslesen des Wertes.
  • Indextyp: Bestimmt, welche Art von Index verwendet wird.
    • Fest: Verwenden Sie einen festen Index für die Leseoperation. In diesem Fall geben Sie die Position ein, von wo die Informationen ausgelesen werden sollen (1 basiert).
    • Variabel: Verwenden Sie eine numerische Variable als Index für die Leseoperation. In diesem Fall wählen Sie eine skalare numerische Variable, um die Position des Auslesens zu bestimmen.
    • Ende des Arrays: Lesen Sie vom Ende des Arrays.
  • Ausgabevariable: Wählen Sie eine skalare Variable, in der der ausgelesene Wert gespeichert wird.

Add / Remove Array Entries Action

Wirkung: Fügt Einträge in ein Array hinzu und/oder entfernt sie.

Parameter:

  • Array-Variable: Array-Variable, auf der die Hinzufügung oder Löschoperation ausgeführt werden soll.
  • Indextyp: Bestimmt, welche Art von Index verwendet wird.
    • Fest: Verwenden Sie einen festen Index für die Einfüge-/Löschoperation. In diesem Fall geben Sie die Array-Position ein, an der die Einträge eingefügt/gelöscht werden sollen. (1 basiert).
    • Variabel: Verwenden Sie eine numerische Variable als Index für die Einfüge-/Löschoperation. In diesem Fall wählen Sie eine skalare numerische Variable, um zu bestimmen, wo die Einträge eingefügt/gelöscht werden sollen.
    • Ende des Arrays: Einfügen/Löschen vom Ende des Arrays.
  • Anzahl der zu löschenden Einträge: Entfernt die Array-Einträge (vor dem Einfügen neuer Einträge) beginnend ab der definierten Indexposition. 0 bedeutet, dass keine Werte entfernt werden.
  • Variable(n) zum Einfügen: Wählen Sie eine oder mehrere skalare Variable(n), die an der definierten Indexposition zur Array-Variablen hinzugefügt werden.

Change (Replace) Array Entry Action

Wirkung: Ersetzt/ändert einen Wert innerhalb eines Arrays.

Parameter:

  • Array-Variable: Array-Variable, in der ein Wert geändert werden soll
  • Indextyp: Bestimmt, welche Art von Index verwendet wird.
    • Fest: Verwenden Sie einen festen Index für die Ersetzoperation. In diesem Fall geben Sie die Array-Position ein, die geändert werden soll (1 basiert).
    • Variabel: Verwenden Sie eine numerische Variable als Index für die Ersetzoperation. In diesem Fall wählen Sie eine skalare numerische Variable, um die Position der Ersetzoperation zu bestimmen.
    • Ende des Arrays: Ersetzen Sie den letzten Eintrag im Array.
  • Eingangsvariable: Wählen Sie eine (skalare) Variable, die den neuen Wert hält.

Shuffle Array Entries Action

Wirkung: Mischt die Einträge/Reihenfolge innerhalb eines Arrays.

Parameter: Keine

Data Frame Operations

Read from / Write to Data Frame Action

Wirkung: Liest Werte aus oder schreibt Werte in einen Datenrahmen und speichert diese in einer neuen Array-Variable.

Parameter:

  • Datenrahmen-Variable: Wählen Sie die Variable des Datenrahmens, die gelesen werden soll.
  • Lesen oder Schreiben: Wählen Sie, ob aus dem ausgewählten Datenrahmen gelesen oder in den ausgewählten Datenrahmen geschrieben werden soll.
  • Nach Zeile oder Spalte: Wählen Sie, wie die Daten gelesen werden sollen.
  • Indextyp: Wählen Sie den Typ der Indexvariable, der verwendet wird, um den Datenrahmen zu lesen. Kann fest, variabel oder die letzte Zeile sein.
  • Indexvariable: Wählen Sie die Variable, die als Index verwendet wird, um den Datenrahmen zu lesen.
  • Ausgabevariable: Wählen Sie die Variable, in der die gelesenen/geschriebenen Daten als Ausgabe gespeichert werden. Muss eine Array-Variable sein.

Shuffle Data Frame Entries Action

Wirkung: Mischt die Reihenfolge der Einträge im Datenrahmen.

Parameter:

  • Wählen Sie den Datenrahmen zum Mischen aus.
  • Wählen Sie aus, ob der Datenrahmen nach Zeilen oder Spalten gemischt werden soll.

Jump Actions

Jump To Action

Wirkung: "Springt" der Teilnehmer zu einem anderen Schritt im Experiment. Diese Aktion kann die Reihenfolge von Versuchen und Aufgaben in einem Experiment ändern und kann verwendet werden, um eine individualisierte experimentelle Logik für jeden Teilnehmer zu erstellen.

Parameter:

  • Springe zu: Bestimmt, wohin im Experiment gesprungen werden soll.
    • Nächstes Frame: Springt zum nächsten Frame. Wenn keine weiteren Frames in einem Versuch definiert sind, springt es zum ersten Frame des nächsten Versuchs.
    • Nächster Versuch: Springt zum nächsten Versuch. Wenn keine weiteren Versuche definiert sind, springt es zum ersten Versuch der nächsten Aufgabe.
    • Nächste Aufgabe: Springt zur nächsten Aufgabe. Wenn keine weiteren Aufgaben definiert sind, springt es zur ersten Aufgabe des nächsten Blocks.
    • Nächster Block: Springt zum nächsten Block. Wenn keine weiteren Blöcke definiert sind, endet die Sitzung.
    • Vorheriges Frame: Springt zum vorherigen Frame. Wenn es keine vorherigen Frames gibt, wird die Aktion nicht ausgeführt.
    • Bestimmter Frame: Springt zu einem bestimmten Frame. Benutzer wählen direkt den Frame aus, zu dem gesprungen werden soll.
    • Bestimmter Versuch: Springt zu einem bestimmten Versuch. Benutzer wählen direkt die Versuchsnummer aus, zu der gesprungen werden soll.
    • Bestimmte Aufgabe: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Benutzer wählen direkt die Aufgabe aus, zu der gesprungen werden soll.
    • Bestimmter Block: Springt zur ersten Instanz des angegebenen Blocks. Benutzer wählen direkt den Block aus, zu dem gesprungen werden soll.
  • Überprüfen Sie erforderliche Antworten vor: Wenn aktiviert, wird das Experiment überprüfen, ob alle erforderlichen Antworten bereits beantwortet wurden. Wenn nicht, wird die Sprungaktion nicht ausgeführt.
#### Accept/End Session Action
Effect: Akzeptiert die Daten des Teilnehmers, beendet die Aufzeichnungssitzung und zeigt den Crowdsourcing-Code an.

Parameters:
* Record trial data before finish session: Wenn aktiviert, werden die aktuellsten Versuchsdaten gespeichert (an den Server gesendet), bevor die Studie verlassen wird.
* Show default ending page: Wenn aktiviert, wird die Standard-Endseite von Labvanced angezeigt. Wenn dies eine Crowdsourcing-Sitzung ist (Crowdsourcing-Link wurde verwendet), wird der Kompensationscode dem Teilnehmer angezeigt. Wenn deaktiviert, wird das Experiment nach dem Anzeigen des aktuellen Frames beendet und die Standard-Endseite mit dem Kompensationscode wird nicht angezeigt.

#### Reject/End Session Action
Effect: Beendet die Aufzeichnungssitzung, kennzeichnet die Daten des Teilnehmers NICHT als vollständig und zeigt die Standard-Endseite mit dem Kompensationscode NICHT an.

Wenn diese Aktion verwendet wird, um die Daten eines Teilnehmers abzulehnen, sollten die Benutzer eine passende Nachricht an die Teilnehmer anzeigen, die den Grund erklärt, warum sie nicht für ihre Zeit belohnt werden.

Parameters: Keine

#### Redirect to URL Action
Effect: Leitet den Teilnehmer zu einer bestimmten URL weiter.

Note: Die URL muss zu Beginn das https:// enthalten, damit diese Aktion funktioniert.

### Control Actions

#### Requirement Actions (If... Then... Else If) Action
Effect: Bewertet eine If-Then-Anweisung und führt eine Reihe von Aktionen abhängig aus. Jede If / Else-If-Anweisung besteht aus geschachtelten AND / OR-Vergleichen, um zu bewerten, ob alle Anforderungen erfüllt sind (Anweisung ist wahr) oder nicht (Anweisung ist falsch). Wenn die Anweisung wahr ist, werden die Aktionen unter "Then" ausgeführt.

Parameters:
* Add Requirement: Fügen Sie eine neue Anforderung zu einer Aussage hinzu. Das "value-select" Menü erscheint auf beiden Seiten, um einen logischen Vergleich zu erstellen. In der Mitte der Aussage können Sie auswählen, wie beide Seiten verglichen werden sollen (z. B. gleich, kleiner als, ungleich usw.).
* Add OR Group: Nur eine von allen Anforderungen innerhalb einer OR-Gruppe muss wahr sein, damit die gesamte Gruppe wahr ist. Fügen Sie eine OR-Gruppe hinzu, wenn die Unteraktionen in mehreren Fällen ausgeführt werden sollen.
* Add AND Group: Alle Anforderungen innerhalb einer AND-Gruppe müssen wahr sein, damit die gesamte Gruppe wahr ist. Fügen Sie eine AND-Gruppe hinzu, wenn die Unteraktionen nur ausgeführt werden sollen, wenn mehrere Anforderungen erfüllt sind.
* Action Sequence: Jede If / Else-If-Anweisung hat eine Liste von Aktionen, die unter "Then" definiert sind. Die Aktionssequenz listet alle Aktionen für eine bestimmte If / Else-If-Anweisung auf. Eine neue Aktion kann über das Symbol "Add Action" hinzugefügt werden. Die Aktionssequenz wird nur ausgeführt, wenn die Anforderung(en) der zugehörigen If / Else-if-Anweisung erfüllt sind.
* Add Else-If Case: Die Anforderungsaktion kann aus mehreren separaten If / Else-If --> Then-Anweisungen bestehen. Allerdings kann nur eine Anweisung ausgeführt werden. Wenn eine If / Else-If-Anweisung positiv bewertet wird (wahr zurückgibt), werden die Aktionen im Then-Block ausgeführt und der Rest der Anforderungsaktion wird übersprungen.
* Add Else Case (true / false): Wenn aktiviert, wird eine Standard- / Fallback-Option zur Anforderungsaktion hinzugefügt. Wenn keine der If / Else-If-Anweisungen ausgeführt wird (wahr zurückgibt), werden die im Else-Fall definierten Aktionen ausgeführt.

#### Repeated Actions (While Loop) Action
Effect: Führt wiederholt eine Reihe von Aktionen entweder sofort oder innerhalb eines definierten Intervalls aus. Eine Stoppbedingung kann festgelegt werden, sodass die Schleifen-Ausführung gestoppt wird.

Parameters:
* Execution Type: Wählen Sie zwischen sofortiger Ausführung oder zeitgesteuerter Ausführung
    * Execute complete loop: Dies führt die Schleife kontinuierlich aus, bis die Stoppbedingung erfüllt ist.
    * Execute every ... ms: Dies führt die Schleife mit einem definierten Intervall aus (z. B. wird die Schleife alle 50 ms ausgeführt).
* Define the number of loops: Wenn "Execute every ... ms" ausgewählt ist, haben die Benutzer die Option, einen numerischen ganzzahligen Wert für die Anzahl der Ausführungen der Schleife festzulegen. Dies ersetzt die Notwendigkeit, eine Stoppbedingung zu definieren.
* Execution Interval: Dies bestimmt das Ausführungsintervall.
* Start immediately (true / false): Wenn aktiviert, wird die Schleife sofort ausgeführt. Wenn deaktiviert, wird die Schleife im nächsten Ausführungsintervall gestartet.
* Allow multiple starts (true / false): Wenn aktiviert, können mehrere Schleifeninstanzen parallel gestartet werden. Wenn deaktiviert, kann nur eine Schleifeninstanz gleichzeitig ausgeführt werden.
* Enable stop condition (true / false): Wenn aktiviert, kann eine Stoppbedingung für die Schleife festgelegt werden.
* Stop Condition: Die Stoppbedingung kann verwendet werden, um einen logischen Ausdruck zu spezifizieren, wann die Schleifen-Ausführung gestoppt werden soll. Ähnlich wie bei den If / Else-If-Anweisungen können AND-Gruppen, OR-Gruppen und Anforderungen für den logischen Vergleich kombiniert werden.
* Action Sequence: Die Aktionssequenz listet alle Aktionen auf, die bei jeder Wiederholung der Schleife ausgeführt werden. Eine neue Aktion kann über das Symbol "Add Action" hinzugefügt werden.

#### Delayed Actions (Time Callback) Action
Effect: Führt eine Reihe von Aktionen nach einer bestimmten Zeitverzögerung aus.

Parameters:
* Delay Type: Wählen Sie zwischen einer festen Verzögerung oder einer variablen Verzögerung
    * Fixed Delay: Die Aktionen werden nach einer festen Verzögerung ausgeführt.
    * Variable Delay: Die Aktionen werden nach einer in einer (numerischen) Variablen angegebenen Verzögerung ausgeführt.
* Delay: Die Länge der Verzögerung in Millisekunden (ms).
* Action Sequence: Die Aktionssequenz listet alle Aktionen auf, die nach der angegebenen Zeitverzögerung ausgeführt werden. Eine neue Aktion kann über das Symbol "Add Action" hinzugefügt werden.

#### Action Group

Aktionen können auch in **Aktionsgruppen** organisiert werden. Aktionsgruppen ermöglichen es Ihnen, bestimmte Aktionen für eine einfachere visuelle Struktur zusammenzufassen, aber auch, wenn Sie mehrere Aktionen auf einmal kopieren, duplizieren oder löschen möchten.

[Learn more.](/content/learn/de/guide/events/action-group.html)

### API Actions 

Wenn Sie Daten von einem externen Server in Labvanced senden oder kommunizieren müssen, können 'API Actions' und [‘API Triggers’](/content/learn/de/guide/task-editor/event-system.html#api-triggers) verwendet werden. Ihnen stehen die folgenden Aktionen unter dieser Kategorie zur Verfügung: 
* Send PostMessage
* Send To Websocket
* Send to OpenAI

Damit diese Aktionen „verfügbar“ oder verwendbar sind, müssen Sie einen API-Schlüssel im [`Settings`](/content/learn/de/guide/settings/) Tab eingeben.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/api_menu.webp" alt="Die API-Aktion im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

#### Send PostMessage Action

Die `Send PostMessage`-Aktion sendet eine Nachricht von einem laufenden Labvanced-Experiment an ein externes Ziel, wie beispielsweise eine übergeordnete Webseite oder ein eingebettetes Frame, unter Verwendung der postMessage-API des Browsers.

[Learn more.](/content/learn/de/guide/events/send-postmessage-action.html)

#### Send to Websocket Action

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_a_menu.webp" alt="Die Send to Websocket-Aktion im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Bei Auswahl dieser Aktion erscheinen die folgenden Optionen:

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_action_m.webp" alt="Optionen für die Send to Websocket-Aktion." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Das obige Beispiel und die vollständige Ereignisstruktur können hier aufgerufen werden: [https://www.labvanced.com/page/library/51053](https://www.labvanced.com/page/library/51053) durch Klicken auf 'Inspect.'

| Menu Item | Description |   
|----------|----------| 
| **Send To:**    | Gibt die Websocket-Adresse an, die im [`Settings`](/content/learn/de/guide/settings/) Tab unter `Besondere Funktionen` aufgeführt ist.    | 
| **Trigger / message to send:**   | Geben Sie den Trigger oder die Nachricht an, die gesendet werden soll.    | 
| **Send Variable (optional):**   | Geben Sie die Variable an, die ebenfalls als Teil der Aktion gesendet werden kann.    | 

**[Für weitere Informationen über API-Zugriff besuchen Sie bitte diese Seite.](https://www.labvanced.com/content/learn/de/guide/api-access/)**

#### Send to OpenAI Action
Die ‚Send to OpenAI‘-Aktion ermöglicht es Ihnen, Informationen, wie einen Zeichenfolgen-Eingabewert, an OpenAI zu senden. Bitte beachten Sie, dass Sie für diese Option Ihren API-Schlüssel im [`Settings`](/content/learn/de/guide/settings/) Tab unter `Besondere Funktionen` auflisten müssen.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_a_menu.webp" alt="Die Send to OpenAI-Aktion im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>

Die folgenden Optionen erscheinen, wenn Sie dieses Ereignis anklicken: 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_dialog_action.webp" alt="Optionen für die Send to OpenAI-Aktion." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Hier ist ein funktionales Beispiel dafür, wie dieses Ereignis aussieht, wenn alle notwendigen Informationen bereitgestellt werden: 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_ex_action.webp" alt="Beispiel für die Nutzung der Send to OpenAI-Aktion." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 
```

Um ein besseres Verständnis dafür zu bekommen, wie Sie diese Funktion nutzen und sie in Aktion sehen können, zögern Sie bitte nicht, uns für eine Demo zu kontaktieren, indem Sie [dieses Kontaktformular](https://www.labvanced.com/?openCallDialog=true) ausfüllen. 

**HINWEIS:** Sehen Sie sich auch [dieses Tutorial](/content/learn/de/walkthroughs/2024-09-chatgpt-study-example/) an, in dem wir eine Studie Schritt für Schritt aufbauen und ChatGPT in eine Studie integrieren und diese Aktion nutzen. 

Hier ist eine tiefere Erklärung der Felder, die unter der Aktion 'An OpenAI senden' enthalten sind: 

| Menüpunkte| Menübereich | Optionen für die Aktion 'An OpenAI senden' |
|:-----:|----| ----------| 
| **`Modelltyp`**   |  ![Dropdown-Liste für Modelltyp](/content_imgs/learn/guide/task-editor/imgs/events/ai_model_type.webp)    | <img width=500/> Gibt das KI-Modell an, das verwendet werden soll. <br><br>   |
| **`Chatverlauf-Datenrahmen`**   | ![Feld zur Angabe der Datenrahmenvariable](/content_imgs/learn/guide/task-editor/imgs/events/ai_df.webp)   | Verknüpfung zu einer Datenrahmenvariable mit zwei Spalten. Die erste Spalte bezeichnet die 'Rolle' und die zweite Spalte die 'Chatnachricht.' Die Werte aus der Aktion werden automatisch an den hier verknüpften Datenrahmen angehängt. <br><br> Der Datenrahmen kann auch mit Datenrahmenaktionen manipuliert werden. Für weitere Informationen siehe [Docs von OpenAI.](https://platform.openai.com/docs/api-reference/chat/create) |
| **`Nachricht einfügen ‘+’ `**   |  ![Das Symbol zum Einfügen von Nachrichten.](/content_imgs/learn/guide/task-editor/imgs/events/ai_roles.webp)    | Wenn Sie darauf klicken, erscheint das Dialogfeld für die Variable. Sie müssen angeben, welcher 'Variablen'-Wert an OpenAI gesendet wird, sowie die 'Rolle' der zugehörigen Nachricht:<ul><li>**system:** bezieht sich auf das hochrangige ChatGPT-System </li><li>**user:** der Teilnehmer </li><li>**assistant:** bezieht sich auf eine spezifische Unterrolle, die innerhalb des Systems erstellt wurde  </li></ul> |

Da sich OpenAI täglich weiterentwickelt, überprüfen Sie bitte die [Docs von OpenAI](https://platform.openai.com/docs/api-reference/chat/create) für weitere Klarstellungen.

### Code-Aktionen 

In einigen Fällen kann es erforderlich sein, dass Ihr Experiment benutzerdefinierten Code benötigt. Mit diesen Aktionen können Sie genau das tun! Die folgenden Optionen sind im Menü 'Code-Aktionen' verfügbar:
* JavaScript ausführen
* Globales CSS festlegen

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/code_actions_menu.webp" alt="Die Code-Aktionen im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

#### Aktion 'JavaScript ausführen'
Die Aktion 'JavaScript ausführen' ermöglicht es Ihnen, spezifische Ereignisse zu programmieren und Labvanced-Variablen in Ihrer Studie zu lesen/setzen, indem Sie benutzerdefiniertes JavaScript eingeben, das als Aktion ausgeführt wird, wenn es ausgelöst wird. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/run_js.webp" alt="Die Aktion 'JavaScript ausführen' im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Wenn die oben genannte Aktion 'JavaScript ausführen' ausgewählt wird, sehen Sie einen Bereich (einen Code-Editor), in dem der JavaScript-Code geschrieben werden sollte, sowie Anweisungen zur Verwendung:

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/js_editor.webp" alt="Der JavaScript-Code-Editor in Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

#### Aktion 'Globales CSS festlegen'
Mit der Aktion 'Globales CSS festlegen' können Sie benutzerdefinierten CSS-Code verwenden, um einen Aspekt der Studie bei einem Trigger zu ändern. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_css.webp" alt="Die Aktion 'Globales CSS festlegen' im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Das folgende Feld öffnet sich, wenn Sie auf diese Aktion klicken: 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/css_editor.webp" alt="Der CSS-Code-Editor in Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Ein Beispiel für die Verwendung der Aktion 'Globales CSS festlegen' wäre, die Hintergrundfarbe der Studie zu ändern, wenn ein Teilnehmer aus einer Mehrfachauswahlfrage eine bestimmte Farbe auswählt.

### Einfügeaktion
Diese Option ermöglicht es Ihnen, eine Aktion einzufügen, die Sie zuvor erstellt und kopiert haben. Sie ermöglicht es Ihnen, schneller zu arbeiten, wenn Sie Ihr Experiment entwerfen, sodass Sie nicht immer wieder dieselben Elemente auswählen müssen. Zum Beispiel, wenn Sie ein Ereignis haben, das einem bereits bestehenden ähnelt, können Sie es einfach kopieren, einfügen und modifizieren, anstatt es von Grund auf neu zu erstellen. 

## Das Wertauswahlmenü 
<img align="left" width="10%" style="padding: 10px;" height="auto" loading ="lazy" src="/content_imgs/learn/guide/task-editor/imgs/events/value_select_icon.webp">Wenn Sie mit bestimmten Ereignissen arbeiten, werden Sie feststellen, dass ein Stiftsymbol erscheint. Dies wird als Wertauswahlmenü bezeichnet, da es Ihnen ermöglicht, auszuwählen und anzugeben, welche Art von Werten aufgezeichnet oder verfolgt werden sollen. Es ist eine sehr leistungsstarke und wichtige Option, die Sie für Ihr experimentelles Design und Ihre Einrichtung verwenden müssen. 

Dieses Stiftsymbol / Wertauswahlmenü erscheint in verschiedenen Bereichen für bestimmte Aktionen im Ereignissystem, zum Beispiel die Aktion 'Variable festlegen / Aufzeichnen', die Aktion 'Objekteigenschaft festlegen' und die Anforderung (Wenn ... Dann) Aktion, wie unten gezeigt.   

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/value_select_menu_locations.webp" alt="Der Wertauswahlort in Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 


Ein Klick auf das Stiftsymbol führt zu einem Dropdown-Menü, in dem Sie den Wert festlegen, der ausgelesen oder geschrieben werden soll. **Das Dropdown-Menü beginnt immer damit, eine auslöserspezifische Wertoption aufzulisten und geht dann zu den anderen 5 Kategorien (Aktuelle Zeit, Konstantwert, Variable, Frame / Aufgabe / Option und Operationen), die jeweils eigene Optionen haben.** Diese werden weiter unten näher beschrieben. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/value_select_menu.webp" alt="Das Wertauswahlmenü in Labvanced" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Das obige Bild zeigt, wie das Wertauswahlmenü aussieht, wenn ein Mausttrigger verwendet wird. Wie Sie sehen können, beginnt das erste Menüelement auf der linken Seite mit einer auslöserspezifischen Kategorie und wechselt dann zu den anderen 5 Kategorien (Aktuelle Zeit usw.). 

### Menüoptionen
Die folgende Tabelle erklärt die Kategorien und Optionen näher:

| Kategorie | Optionen | Beschreibung |
|:---:|---|---|
| [`Auslöserspezifisch`](#trigger-specific-values) |  Hängt von der Auslöserart ab, die Sie zuvor für das Ereignis ausgewählt haben. | Basierend auf dem Auslöser, den Sie für ein Ereignis ausgewählt haben, wird eine spezifische Liste von Optionen oben im Wertauswahlmenü angezeigt, aus der Sie wählen können. Bitte beachten Sie den Abschnitt über [Auslöserspezifische Werte](#trigger-specific-values), um die vollständige Liste der Optionen und Beschreibungen zu sehen. |
| [`Aktuelle Zeit`](#current-time-values) | <ul><li> [UNIX Timestamp](#current-time-unix-timestamp) </li><li> [Zeit seit Beginn des Frames](#current-time-time-from-frame-onset) </li> </ul> | Zeitwerte messen und aufrufen. |
| [`Konstantwert`](#constant-values) | <ul><li> Zeichenfolge </li><li> Numerisch </li><li> Boolean </li><li> Kategorisch </li><li> Datum</li><li> Zeit </li><li> Farbe </li> </ul> | Weisen Sie Konstantwerte basierend auf dem Typ der benötigten Variablen zu, wie Zeichenfolgen oder numerisch. Diese werden manchmal in Kombination mit anderen Optionen wie [`Arithmetik`](#arithmetic) verwendet, um Zähler zu erstellen. | 
| [`Variable`](#variable-values) | <ul> <li> Variable auswählen </li><li> Wert aus Array auswählen </li><li>  Wert aus Datenrahmen auswählen </li></ul> | Geben Sie eine Variable an oder verweisen Sie auf eine Variable oder wählen Sie einen Wert aus einem Array oder Datenrahmen aus. |
| [`Frame / Aufgabe / Objekt`](#frame-task-object-values) | <ul><li> Objekteigenschaft </li><li> Frame </li><li>  Augenverfolgung </li><li>  Gerät </li> </ul> | Ermöglicht das Abrufen von Werten, die mit Objekteigenschaften, dem Frame, der Augenverfolgung (wenn aktiviert) und dem Gerät (Bildschirmaktualisierungsrate) verknüpft sind. |
| [`Operationen`](#operations) | <ul><li>Arithmetik </li><li> Zeichenfolgenoperation </li><li>  Mathematikoperation </li> </ul> | Verwenden Sie Operationen, um bestimmte Änderungen an Ihren Variablen vorzunehmen, wie z.B. das Kombinieren von Variablenwerten, das Transformieren von Zeichenfolgen, sodass sie alle klein geschrieben sind, oder mathematische Operationen auszuführen. |


###  Aktuelle Zeitwerte
Mit der Option 'Aktuelle Zeit' können Sie Werte in Bezug auf die Zeit aufzeichnen oder darauf verweisen. 

Die folgenden Optionen sind verfügbar: 
* [UNIX Timestamp](#current-time-unix-timestamp)
* [Zeit seit Beginn des Frames](#current-time-time-from-frame-onset)

#### Aktuelle Zeit: UNIX Timestamp
Dieser Wert erfasst einen Zeitstempel im UNIX-Format in Millisekunden.  

#### Aktuelle Zeit: Zeit seit Beginn des Frames
Dieser Wert erfasst die Zeit, die seit dem Beginn des Frames vergangen ist. Dies entspricht meist der Reaktionszeit.

### Konstantwerte
Weisen Sie Konstantwerte basierend auf dem Typ der benötigten Variablen zu, wie Zeichenfolgen oder numerisch. Diese werden manchmal in Kombination mit anderen Optionen wie [`Arithmetik`](#arithmetic) verwendet, um Zähler zu erstellen. 

Die folgenden Optionen sind verfügbar: 
* [Zeichenfolge](#constant-string)
* [Numerisch](#constant-numeric)
* [Boolean](#constant-boolean)
* [Kategorisch](#constant-categorical)
* [Datum](#constant-date)
* [Zeit](#constant-time)
* [Farbe](#constant-color)

#### Konstant: Zeichenfolge
Weist einen Zeichenfolgen-/Textwert zu.

#### Konstant: Numerisch
Weist einen numerischen/Wert zu.

#### Konstant: Boolean
Weist einen Wert von wahr oder falsch zu.

#### Konstant: Kategorisch
Weist einen Niveauwert (hauptsächlich für Faktoren) zu.

#### Konstant: Datum
Weist einen Datumswert zu.

#### Konstant: Zeit
Weist einen Zeitwert zu.

#### Konstant: Farbe
Weist einen Farbwert (hex-zeichenfolge) zu.

### Variable Werte
Geben Sie eine Variable an oder verweisen Sie auf eine Variable oder wählen Sie einen Wert aus einem Array oder Datenrahmen aus.  Die folgenden Optionen sind verfügbar:
* [Variable auswählen](#select-variable)
* [Wert aus Array auswählen](#select-value-from-array)
* [Wert aus Datenrahmen auswählen](#select-value-from-data-frame)

#### Variablen auswählen
Ermöglicht Ihnen, eine Variable auszuwählen und darauf zu verweisen.

#### Wert aus Array auswählen
Ermöglicht Ihnen, einen Wert aus einem Array auszuwählen.

#### Wert aus Datenrahmen auswählen
Ermöglicht Ihnen, einen Wert aus einem Datenrahmen auszuwählen, den Sie erstellt haben.

### Rahmen / Aufgabe / Objektwerte
Ermöglicht Ihnen, Werte abzurufen, die mit Objekt-Eigenschaften, dem Rahmen, der Augenverfolgung (falls aktiviert) und dem Gerät (Bildschirmaktualisierungsrate) verknüpft sind.
* [Objekteigenschaft](#object-property)
* [Rahmen](#frame)
* [Augenverfolgung](#eye-tracking)
* [Gerät](#device)

#### Objekteigenschaft 
Liest eine Objekteigenschaft aus.

#### Rahmen

| Optionen für Rahmenwerte | Beschreibung |
| :---: | ---|
| **`Letzte zwischengespeicherte Maus X-Position`** | Der letzte X-Koordinatenwert der Maus des Teilnehmers. |
| **`Letzte zwischengespeicherte Maus Y-Position`** | Der letzte Y-Koordinatenwert der Maus des Teilnehmers. | 
| **`Letztes zwischengespeichertes Maus [X,Y] Array`** | Der letzte [X,Y] Koordinatenwert der Maus des Teilnehmers im Array-Format. | 
| **`Rahmenname`** | Der Name des Rahmens. |  

#### Augenverfolgung

| Optionen für Augenverfolgungswerte | Beschreibung |
| :---: | ---|
| **`Letzte zwischengespeicherte Koordinate X`** | Der letzte X-Koordinatenwert des Blicks des Teilnehmers. |
| **`Letzte zwischengespeicherte Koordinate Y`** | Der letzte Y-Koordinatenwert des Blicks des Teilnehmers.  | 
| **`Letztes zwischengespeichertes Koordinate [X,Y] Array`** | Der letzte [X,Y] Koordinatenwert des Blicks des Teilnehmers im Array-Format. | 
| **`Letzte zwischengespeicherte Koordinate + Zeit [X,Y,T] Array`** | Der letzte [X,Y] Koordinatenwert des Blicks des Teilnehmers, plus der Kamerafang T-Wert im Array-Format. |  

#### Gerät
* **Aktualisierungsrate:** Der Aktualisierungsratenwert des Geräts des Teilnehmers.

### Operationen
Verwenden Sie Operationen, um bestimmte Änderungen an Ihren Variablen vorzunehmen, wie das Kombinieren von Variablenwerten, das Transformieren von Zeichenfolgen in Kleinbuchstaben oder das Ausführen von mathematischen Operationen.

Die folgenden Optionen sind verfügbar:
* [Arithmetik](#arithmetic)
* [String-Operation](#string-operation)
* [Mathe-Operation](#math-operation)

#### Arithmetik 
Arithmetische Operationen sind für viele verschiedene Zwecke nützlich, einschließlich der Kombination von Zeichenfolgen und sogar der Modifizierung von Objekteigenschaften.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/arithmetic_menu.webp" alt="Das Arithmetik-Menü in Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 
 
Im Wesentlichen ermöglicht die arithmetische Operation Ihnen, Operationen auf mehreren Werten auszuführen.

Nach Auswahl dieser Option wird ein zusätzliches Stiftsymbol (d.h. Wertauswahlmenü) angezeigt, sowie eine Liste von Operationen wie Addition.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/arithmetic_selected.webp" alt="Der Standort der Arithmetik-Option in Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Die Werte können mit diesen 5 verschiedenen Operationen manipuliert werden: 
* (+) Addition
* (-) Subtraktion
* (/) Division
* (*) Multiplikation
* (%) Modulo

Das folgende Beispiel zeigt, wie arithmetische Operationen verwendet werden, um eine neue Zeichenfolgenvariable (im grünen Button) mit dem Namen 'intermediateVar' zu erstellen.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/chat_example_explained.webp" alt="Beispiel für die Verwendung von arithmetischen Operationen zur Erstellung einer neuen Zeichenfolgenvariable." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Der neue Variablenwert (von 'intermediateVar') wird definiert, indem mehrere arithmetische Operationen zusammen mit einer Kombination aus zuvor erstellten Variablen (d.h. 'userChatName' und 'chatInput') sowie [konstanten Zeichenfolgenwerten](#constant-8594-string) verwendet werden, d.h. dem Semikolon `:` und dem Leerzeichen `<br>`. Diese Aktion erzeugt den Effekt eines Benutzerchats, der in einer Mehrbenutzerstudie verwendet werden kann.

#### String-Operation

| Optionen für String-Operationen | Beschreibung |
| :---: | ---|
| **`Zu Kleinbuchstaben`** | Ändert alle Buchstaben in einer Zeichenfolgenvariable in kleine Buchstaben.<br><br> **&#8594; Bsp:** (AAABBB) wird zu (aaabbb) |
| **`Zu Großbuchstaben`** | Ändert alle Buchstaben in der Zeichenfolgenvariable in Großbuchstaben.<br><br> **&#8594; Bsp:** (aaabbb) wird zu (AAABBB) |
| **`Zu Link`** | Wandelt die Zeichenfolge in einer Variablen in eine URL um, die in einem anderen Fenster geöffnet wird |
| **`Leerzeichen entfernen`** | Entfernt alle Leerzeichen zwischen den Buchstaben in einer Zeichenfolgenvariablen.<br><br> **&#8594; Bsp:** (aaa bbbb cccc) wird zu (aaabbbbccc) |
| **`Leerzeichen trimmen`** | Entfernt die Leerzeichen am Anfang einer Zeichenfolgenvariablen.<br><br> **&#8594; Bsp:** (  aaabbbcccc) wird zu (aaabbbcccc) |
| **`Substring durch Regexp ersetzen`** | Ersetzt bestimmte Buchstaben in einer Zeichenfolgenvariablen.<br><br> **&#8594; Bsp:** (aaabbbccc) ersetzt _bbb_ durch _xxx_, was den Wert in (aaaxxxccc) verwandelt |


#### Math-Operation
Führt eine mathematische Operation auf einem Skalarwert aus.

| Optionen für Math-Operationen | Beschreibung |
| :---: | ---|
| **`abs`** | Gibt die absolute Zahl eines Wertes zurück. |
| **`sqrt`** | Gibt die Quadratwurzel eines Wertes zurück. | 
| **`round`** | Gibt den gerundeten Wert mit 0 bis 3 Dezimalstellen zurück. | 
| **`floor`** | Gibt den abgerundeten Wert zurück. |  
| **`ceil`** | Gibt den aufgerundeten Wert zurück. | 
| **`cos`** | Gibt den Cosinuswert zurück. | 
| **`sin`** | Gibt den Sinuswert zurück. | 
| **`tan`** | Gibt den Tangenswert zurück. | 

### Trigger-spezifische Werte

Trigger-spezifische Werte beziehen sich auf Werte, die mit dem Trigger verknüpft sind, der innerhalb eines bestimmten Ereignisses definiert ist. Wenn beispielsweise Ihr Ereignis einen Maus-Trigger verwendet, können Sie unter bestimmten Bereichen, in denen die Aktion festgelegt ist (wie bei Verwendung einer [`Set / Record Variable`](#set-record-variable-action)-Aktion oder einer [`Set Object Property`](#set-object-property-action)-Aktion), auf maus-spezifische Triggerwerte im [Wertauswahlmenü](#the-value-select-menu) verweisen.

Im folgenden Beispiel werden trigger-spezifische Werte für einen Maus-Trigger verwendet, um x- und y-Werte und ein [X,Y] Array mithilfe einer [`Set / Record Variable`](#set-record-variable-action)-Aktion aufzuzeichnen.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/mouse_track_ex.webp" alt="Demonstration, wie mäusespezifische Triggerwerte verwendet werden, um Mausverfolgung zu erfassen." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 


Nachfolgend finden Sie eine Tabelle aller Arten von trigger-spezifischen Werten, die in Labvanced gefunden werden können, gefolgt von einer detaillierten Erklärung jeder Option.


| Name| Übersicht der Wertoptionen |
| :---: | ---|
| [`Trigger (Maus)`](#trigger-mouse-values)  | <ul><li> Maus X </li><li> Maus Y </li><li> Maus [X,Y] Array </li><li> Stimulusname </li><li> Stimulusinfo </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li> </ul> <img width=500/>|
| [`Trigger (Tastatur)`](#trigger-keyboard-values) | <ul><li> Id der Taste </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) li> </li></ul> |
| [`Trigger (Schaltflächenleiste)`](#trigger-button-bar-values) | <ul><li> Stimulusname </li><li> Stimulusinfo </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn)  </li></ul> |
| [`Trigger (Eingabe bei Enter)`](#trigger-enter-on-input-values)  | <ul><li> Id der Taste  </li><li> Trigger-Zeitstempel (Unixzeit)  </li><li> Trigger-Zeit (Von Rahmenbeginn)  </li></ul> |
| [`Trigger (Scrollen)`](#trigger-scroll-values) | <ul><li> Stimulusname </li><li> Stimulusinfo</li><li> Scrollposition X </li><li> Scrollposition Y </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> | 
| [`Trigger (Gamepad/Joystick)`](#trigger-gamepad-joystick-values) | <ul><li>Gamepad-Geräte-ID </li><li> Gedrückte Tasten (Array) </li><li> Gedrückte oder gehaltene Tasten (Array) </li><li> Losgelassene Tasten (Array) </li><li> Achsen (Array) </li><li> Gamepad-Zeitstempel (Unixzeit) </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Augenverfolgung Blicke)`](#trigger-eyetracking-gaze-values) | <ul><li> Koordinate X </li><li> Koordinate Y </li><li> Koordinate [X,Y] Array </li><li> Stimulusname </li><li> Stimulusinfo </li><li> Kamerafangzeit T </li><li> Blickkonfidenz C </li><li> Koord. + Zeit [X,Y, T] Array </li><li> Koord. + Zeit + Konfidenz [X,Y, T,C] Array </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> | 
| [`Trigger (Augenverfolgung Fixation)`](#trigger-eyetracking-fixation-values) | <ul><li> Fixations-Zentrum X </li><li> Fixations-Zentrum Y </li><li> Fixationsdauer </li><li> Fixationsstartzeit </li><li> Fixationsendzeit </li><li> Fixationsstreuung </li><li> Stimulusname </li><li> Stimulusinfo </li><li> [X,Y, Dauer, Start, Ende, Streuung] </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn)  </li></ul> |
| [`Trigger (Kopfverfolgung)`](#trigger-head-tracking-values) |  <ul><li> Kamerafangzeit T </li><li>  Kopfneigung </li><li>  Kopfneigung </li><li>  Kopfrollen </li><li>  Kopfposition [X,Y, T] Array </li><li>  Nasenposition [X,Y, T] Array </li><li>  Nasenvektor [X,Y, Z, T] Array </li><li>  Trigger-Zeitstempel (Unixzeit) </li><li>  Trigger-Zeit von Rahmenbeginn </li></ul> |
| [`Trigger (Bei Aufgabeninitialisierung)`](#trigger-on-task-initialization-values) |  <ul><li>  Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Bei Rahmeninitialisierung)`](#trigger-on-frame-init-values) |  <ul><li>  VersuchNr </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Bei Rahmenstart)`](#trigger-on-frame-start-values) |  <ul><li>  Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Bei Rahmenende)`](#trigger-on-frame-end-values)  |  <ul><li> Gesamt-Rahmenzeit </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |		
| [`Trigger (Variable Wert geändert)`](#trigger-variable-value-changed-values) |  <ul><li> Neuer Wert in Variable </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Medienobjekt-Trigger)`](#trigger-media-object-trigger-values) |  <ul><li>  Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Websocket-Trigger)`](#trigger-websocket-trigger-values) |  <ul><li>  Nachricht </li><li> Daten </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (OpenAI-Trigger)`](#trigger-openai-trigger-values) |  <ul><li>  Chat-GPT-Antwort </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (PostMessage erhalten)`](#trigger-postmessage-received-values) |  <ul><li> Nachrichteninhalt </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |
| [`Trigger (Globales Experimentereignis)`](#trigger-global-experiment-event-values) |  <ul><li>  Gesamt-Rahmenzeit </li><li> Grund für globales Ereignis </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn)  </li></ul> |
| [`Trigger (Benutzer verlässt Experiment)`](#trigger-user-leaves-experiment-values) |  <ul><li>  Verbleibende Anzahl der Teilnehmer  </li><li> Trigger-Zeitstempel (Unixzeit) </li><li> Trigger-Zeit (Von Rahmenbeginn) </li></ul> |

#### Trigger (Maus) Werte
Wenn ein [Maus-Trigger](#mouse-trigger) verwendet wird, können die folgenden [trigger-spezifischen Werte](#trigger-specific-values) bei bestimmten Aktionen aufgerufen werden:  

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/mouse_trigger_specific_values.webp" alt="Die verfügbaren Maus-Trigger-Wertoptionen" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Trigger (Maus) Optionen | Beschreibung |
| :---: | ---|
| **`Maus X`** | Gibt die aktuelle Maus-X-Position in Bildkoordinaten zurück. |
| **`Maus Y`**|  Gibt die aktuelle Maus-Y-Position in Bildkoordinaten zurück. |
| **`Maus [X,Y] Array`** | Die Maus- [X,Y] Koordinaten im Array-Format. | 
| **`Stimulus-Name`** | Der Name des Objekts, das das Ereignis ausgelöst hat (z. B. welches Bild angeklickt wurde). |
| **`Stimulus-Info`** | Die Stimulus-Info des Objekts, das das Ereignis ausgelöst hat. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Trigger eintrat. |


#### Trigger (Tastatur) Werte
Wenn ein [Tastatur-Trigger](#keyboard-triggers) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden: 

| Trigger (Tastatur) Optionen | Beschreibung |
| :---: | ---|
| **`ID der Taste`** | Der ID-Wert der Taste, die als Trigger gedrückt wurde. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Trigger eintrat. |

#### Trigger (Buttonleiste) Werte

Wenn ein [Button-Klick-Trigger](#button-click-trigger) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

| Trigger (Buttonleiste) Optionen | Beschreibung |
| :---: | ---|
| **`Stimulus-Name`** | Der Name des Button-Objekts, das das Ereignis ausgelöst hat. |
| **`Stimulus-Info`** | Die Stimulus-Info des Button-Objekts, das das Ereignis ausgelöst hat. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Trigger eintrat. |

#### Trigger (Enter bei Eingabe) Werte

Wenn ein [Enter bei Eingabe-Trigger](#enter-on-input-trigger) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

| Trigger (Enter bei Eingabe) Optionen | Beschreibung |
| :---: | ---|
| **`ID der Taste`** | Der ID-Wert der Taste, die als Trigger gedrückt wurde. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Trigger eintrat. |


#### Trigger (Scrollen) Werte

Wenn ein [Scroll-Trigger](#scroll-trigger) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

| Trigger (Scrollen) Optionen | Beschreibung |
| :---: | ---|
| **`Stimulus-Name`** | Der Name des Button-Objekts, das das Ereignis ausgelöst hat. |
| **`Stimulus-Info`** | Die Stimulus-Info des Button-Objekts, das das Ereignis ausgelöst hat. |
| **`Scrollposition X`** | Die Scrollposition in X der Maus, als das Ereignis ausgelöst wurde.  |
| **`Scrollposition Y`** | Die Scrollposition in Y der Maus, als das Ereignis ausgelöst wurde. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Scroll-Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Scroll-Trigger eintrat. |

#### Trigger (Gamepad/Joystick) Werte

Wenn ein [`Gamepad/Joystick-Trigger`](#gamepad-joystick-trigger) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

<p style="text-align:center;">
<img width="80%" style="padding: 10px; border:1px solid #39AECB" height="auto" loading="lazy" src="/content_imgs/learn/guide/task-editor/imgs/events/gamepad_trigger_specific.webp" alt="Gamepad-Trigger-Menüoption">
</p>

| Trigger (Gamepad/Joystick) Optionen | Beschreibung |
| :---: | ---|
| **`Gamepad-Geräte-ID`** | Die ID oder der Name des angeschlossenen Gamepads. |
| **`Gedrückte Tasten (Array)`** | Die Tasten, die gedrückt wurden. |
| **`Gedrückte ODER gehaltene Tasten (Array)`** | Die Tasten, die gedrückt oder gehalten wurden. |
| **`Freigegebene Tasten (Array)`** | Die Tasten, die freigegeben wurden. |
| **`Achsen (Array)`** | Die Achsenwerte. |
| **`Gamepad-Zeitstempel (Unixtime)`** | Der Gamepad-Zeitstempel in Unixtime. |
| **`Trigger-Zeitstempel (Unixtime)`** | Zeitstempel, wann der Trigger in Unixtime eintritt. |
| **`Trigger-Zeit (Von Framebeginn)`** | Zeitstempel in Unixtime, wann der Trigger in Bezug auf den Beginn des Frames eintritt. |

#### Trigger (Eyetracking Blick) Werte

Wenn ein [Eyetracking Blick-Trigger](#eyetracking-gaze-trigger) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/ET_gaze_trigger_specific_values.webp" alt="Die Blick-Trigger-Wertoptionen" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| Trigger&nbsp;(Eyetracking Blick)&nbsp;Optionen  | Beschreibung  |
| :---: | --- |
| **`Koordinate X`** | Der Wert der X-Koordinate des Blicks. |
| **`Koordinate Y`** | Der Wert der Y-Koordinate des Blicks. |
| **`Koordinate [X,Y] Array`** | Die Blickkoordinaten X,Y im Array-Format. |
| **`Stimulus-Name`** | Der Name des Stimulus, der den Blick-Trigger ausgelöst hat. |
| **`Stimulus-Info`** | Die Stimulus-Informationen hinter dem Stimulus, der den Blick-Trigger ausgelöst hat.  |
| **`Kamera-Aufnahmezeit T`** |  Die genaue Zeit, zu der der Snapshot gemacht wurde. In der Labvanced-Eyetracking-Pipeline erfolgt ein Kamera-Snapshot zuerst, bevor der Algorithmus und das neuronale Netzwerk Blickberechnungen durchführen. Daher ist die `Kamera-Aufnahmezeit T` ein UNIX-Zeitstempel, wann der ursprüngliche Snapshot gemacht wurde. Für weitere Informationen zur Technologie hinter unserem webcam-basierten Eyetracking verweisen wir auf unsere [ET-Technologie-Seite.](/content/technology/de/labvanced-eye-tracking/)   |
| **`Blick-Konfidenz C`** | Dieser Wert reicht von 0 bis 1 und bezieht sich auf das Vertrauen und die Wahrscheinlichkeit, dass ein offenes Auge im Bildsnapshot vorhanden ist und dient im Wesentlichen als „Blinkdetektor“. Bitte verweisen Sie auf unser [veröffentlichtes, peer-reviewed Papier](https://link.springer.com/article/10.3758/s13428-023-02237-8) für weitere Details.  |
| **`Koord. + Zeit [X,Y,T] Array`** | Ein Array, das die x/y-Koordinaten des Blicks und den Zeitstempel der Kamera-Aufnahmezeit (T) enthält, wie oben beschrieben.  |
| **`Koord. + Zeit + Konfidenz [X,Y, T,C] Array`** | Ein Array, das die x/y-Koordinaten des Blicks sowie den Zeitstempel der Kamera-Aufnahmezeit (T) und die Blick-Konfidenz (C) enthält, wie oben beschrieben. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Blick-Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Blick-Trigger eintrat. |

#### Trigger(Eyetracking Fixierung) Werte

Wenn ein [Eyetracking Fixierungs-Trigger](#eyetracking-fixation-trigger) verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

| Trigger&nbsp;(Eyetracking Fixierung) Optionen | Beschreibung |
| :---: | ---|
| **`Fixations-Schwerpunkt X`** | Der Mittelpunkt der Fixierung als X-Wert. |
| **`Fixations-Schwerpunkt Y`** | Der Mittelpunkt der Fixierung als Y-Wert. |
| **`Fixations-Dauer`** | Die Dauer der erkannten Fixierung. |
| **`Fixations-Startzeit`** | Die Startzeit der erkannten Fixierung. |
| **`Fixations-Endzeit`** | Die Endzeit der erkannten Fixierung. |
| **`Fixations-Streuung`** | Bezieht sich darauf, wie verteilt die Blickwerte innerhalb einer erkannten Fixierung sind. |
| **`Stimulus-Name`** | Der Name des Button-Objekts, das das Ereignis ausgelöst hat. |
| **`Stimulus-Info`** | Die Stimulus-Info des Button-Objekts, das das Ereignis ausgelöst hat. |
| **`[X, Y, Dauer, Start, Ende, Streuung]`** | Ein Array der folgenden: x- und y-Werte des Schwerpunkts der Fixierung, die Dauer der Fixierung, die Startzeit, die Endzeit und den Streuungswert. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Fixierungs-Trigger im Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Von Framebeginn)`** | Die verstrichene Zeit in Millisekunden, gemessen vom Beginn des Framebeginns bis zu dem Zeitpunkt, an dem der Fixierungs-Trigger eintrat. |#### Trigger (Kopfverfolgung) Werte

Wenn ein [Kopfverfolgungs-Trigger](#headtracking-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger&nbsp;(Kopfverfolgung) Optionen | Beschreibung |
| :---: | ---|
| **`Kamerafangzeit T`** | Wann die Kamera den Frame erfasst hat, d. h. ein Unix-Zeitstempel, wann die Frame-Erfassung stattfand. Dies ist die Zeit, in der das Bild / der Frame erfasst wurde, bevor eine Verarbeitung erfolgt. |
| **`Kopfbewegung`** | Kopfbewegung von links nach rechts, dies wird in der Literatur als Gier bezeichnet. |
| **`Kopfneigung`** | Kopfneigung von oben nach unten, bekannt als Kopfneigung in der Literatur. |
| **`Kopfrolle`** | Erfasst die Bewegung des Kopfes von Seite zu Seite. |
| **`Kopfposition [X,Y, T] Array`** | Dieses Array erfasst die numerischen Werte, die mit der Kopfposition verbunden sind, einschließlich der X- und Y-Koordinaten für die Mitte des Kopfes sowie der Zeitstempelvariablen (T). |
| **`Nasenposition [X,Y, T] Array`** | Dieses Array erfasst die numerischen Werte, die speziell mit der Position der Nase verbunden sind, einschließlich der X- und Y-Koordinaten, wo sich die Nase befindet, sowie der Zeitstempelvariablen (T), wann die Messung stattfand. |
| **`Nasenvektor [X,Y, Z, T] Array`** | Diese Messung funktioniert, indem ein Vektor von der Nasenspitze projiziert wird, und ist nützlich, um zu testen, ob der Teilnehmer auf den Bildschirm achtet (dies ist besonders wichtig für Studien, bei denen das Eye-Tracking nicht aktiviert ist). Wenn die Nase also vom Bildschirm weg zeigt (d. h. der Teilnehmer achtet nicht auf das Experiment), sinkt der Z-Wert von 1 und bewegt sich näher zu 0. |
| **`Trigger-Zeitstempel (Unixtime)`** | Zeitpunkt während des Experiments, an dem der Trigger selbst erfolgt, wo die Kopfverfolgung erkannt wurde und berücksichtigt, wann der Trigger im System auftrat. Im Wesentlichen ist dies der Zeitpunkt, an dem das Bild / der Frame verarbeitet wird und dieser Wert wesentlich von der Grafikkarte des Teilnehmers beeinflusst wird. Theoretisch sollte es so nah wie möglich am Wert T sein. |
| **`Trigger-Zeit vom Frame Beginn`** | Dies ist der Zeitwert, wann der Trigger in Bezug auf den Beginn des Frames auftrat. |

#### Trigger (Beim Task-Initialisierung) Werte

Wenn ein [Task-Init-Trigger](#task-init-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Beim Task-Initialisierung) Optionen | Beschreibung |
| :---: | ---|
| **`Trigger-Zeitstempel (Unixtime)`** | Der Unix-Zeitstempel des Triggers in Millisekunden. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die Zeit in Millisekunden, wann der Trigger vom Frame-Beginn auftrat. |

#### Trigger (Beim Frame-Init) Werte

Wenn ein [Frame-Init-Trigger](#frame-init-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Beim Frame-Init) Optionen | Beschreibung |
| :---: | ---|
| **`TrialNr`** | Die Versuchsnummer, wann der Frame-Init-Trigger auftrat. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Unix-Zeitstempel des Triggers in Millisekunden. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die Zeit in Millisekunden, wann der Trigger vom Frame-Beginn auftrat. |

#### Trigger (Beim Frame-Start) Werte

Wenn ein [Frame-Start-Trigger](#frame-start-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Beim Frame-Start) Optionen | Beschreibung |
| :---: | ---|
| **`Trigger-Zeitstempel (Unixtime)`** | Der Unix-Zeitstempel des Triggers in Millisekunden. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die Zeit in Millisekunden, wann der Trigger vom Frame-Beginn auftrat. |

#### Trigger (Beim Frame-Ende) Werte

Wenn ein [Frame-Ende-Trigger](#frame-end-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Beim Frame-Ende) Optionen | Beschreibung |
| :---: | ---|
| **`Gesamte Frame-Zeit`** | Die gesamte Zeit in Millisekunden, die für den Frame aufgebracht wurde. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Unix-Zeitstempel des Triggers in Millisekunden. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die Zeit in Millisekunden, wann der Trigger vom Frame-Beginn auftrat. |

#### Trigger (Wert der Variable geändert) Werte

Wenn ein [Wert der Variable geändert-Trigger](#variable-value-changed-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Wert der Variable geändert) Optionen | Beschreibung |
| :---: | ---|
| **`Neuer Wert in der Variable`** | Bezieht sich auf den neuen Wert einer Variable. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Auslöser für die Änderung der Variable in Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, als die Änderung des Variablenwerts auftrat. |

#### Trigger (Medienobjekt-Trigger) Werte

Wenn ein [Medienobjekt-Trigger](#media-object-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Medienobjekt-Trigger) Optionen | Beschreibung |
| :---: | ---|
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Medienobjekt-Trigger in Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, an dem der Medienobjekt-Trigger auftrat. |

#### Trigger (Websocket-Trigger) Werte

Wenn ein [Websocket-Trigger](#websocket-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Websocket-Trigger) Optionen | Beschreibung |
| :---: | ---|
| **`Nachricht`** | Eine Nachricht, die verwendet werden kann, um zu beschreiben und zu kennzeichnen, was es Ihnen (auf der Empfängerseite) ermöglicht, zwischen verschiedenen Arten von Daten zu filtern. |
| **`Daten`** | Ein Wert, der verschiedene Arten von Daten halten kann, wie die Entscheidungen der Teilnehmer, Zeitstempel, Maus X/Y-Koordinaten usw. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Websocket-Trigger in Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, an dem der Websocket-Trigger auftrat. |

#### Trigger (OpenAI-Trigger) Werte

Wenn ein [OpenAI-Trigger](#openai-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (OpenAI-Trigger) Optionen | Beschreibung |
| :---: | ---|
| **`Chat GPT Antwort`** | Der Wert der Antwort von ChatGPT. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der OpenAI-Trigger in Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, an dem der OpenAI-Trigger auftrat. |

#### Trigger (PostMessage Empfangen) Werte

Wenn ein [PostMessage Empfangen-Trigger](#postmessage-received-trigger) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (PostMessage Empfangen) Optionen | Beschreibung |
| :---: | ---|
| **`Nachrichteninhalt`** | Die Datennutzlast der empfangenen postMessage, wie sie von der externen Quelle gesendet wurde. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der PostMessage Empfangen-Trigger in Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, an dem der Trigger auftrat. |

#### Trigger (Globales Experiment-Ereignis) Werte

Wenn ein [Pause / Fortsetzen Experiment Trigger](#pause-resume-experiment) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger (Globales Experiment-Ereignis) Optionen | Beschreibung |
| :---: | ---|
| **`Gesamte Frame-Zeit`** | Bezieht sich auf die gesamte Frame-Zeit, die vor dem Trigger zur Verfügung stand. |
| **`Grund für das globale Ereignis`** | Ein String-Wert, der den Grund des Triggers angibt, wie z. B. das Verlassen des Teilnehmers aus der Studie. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der globale Ereignis-Trigger in Unix-Zeitformat mit Millisekunden auftrat. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, an dem der globale Ereignis-Trigger auftrat. |

#### Trigger (Teilnehmer verlässt Experiment) Werte

Wenn ein [Teilnehmer hat Multiuser-Studie verlassen-Trigger](#participant-left-multiuser-study) verwendet wird, können die folgenden spezifischen Werte abgefragt werden, wenn mit bestimmten Aktionen gearbeitet wird:

| Trigger&nbsp;(Teilnehmer&nbsp;verliert Experiment) Optionen | Beschreibung |
| :---: | ---|
| **`Verbleibende Teilnehmerzahl`** | Die Anzahl der verbleibenden Teilnehmer in der Studie. |
| **`Trigger-Zeitstempel (Unixtime)`** | Der Zeitstempel, wann der Benutzer das Experiment verlassen hat, in Unix-Zeitformat mit Millisekunden. |
| **`Trigger-Zeit (Vom Frame-Beginn)`** | Die vergangene Zeit in Millisekunden, gemessen vom Beginn des Frame-Beginns bis zu dem Zeitpunkt, an dem der Benutzer das Experiment verlassen hat. |