Ereignissystem

Beschreibung

Das Ereignissystem ist für jede Studie unerlässlich. Es ist der Weg, wie Sie Werte festlegen, die aufgezeichnet werden, das Experiment voranschreiten und Aufgaben erstellen. Benutzer können ein Ereignissystem erstellen, um die gesamte Funktionalität, 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 Trigger
• Für die vollständige Liste der Aktionen
• Für weitere Informationen zum Wert-Auswahlmenü zum Festlegen von Werten unter Ereignissen

Das Ereignissystem besteht aus Triggern und Aktionen. Hier legen Sie Regeln fest, wie: ‘wenn dies passiert’ (Trigger)’ dann ‘mache dies’ (Aktion). Zum Beispiel: Wenn ein Teilnehmer ein bestimmtes Bild anklickt (Trigger), dann zeigen Sie ein anderes, zufälliges Bild (Aktion).

Für eine Einführung, wie Ereignisse in Labvanced funktionieren, siehe dieses kurze Video:

Erstellung von Ereignissen - Übersicht

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 in diesem Frame stattfinden sollen, oder durch Klicken auf + Trial Event erstellt werden, wodurch das Ereignis auf alle Frames angewendet wird. Alle bestehenden Ereignisse werden in einer Listenansicht im rechten Seitenpanel angezeigt. Ereignisse werden auf Frame-Ebene definiert und können für jeden Frame getrennt/spezifisch oder dupliziert/dasselbe auf jedem Frame innerhalb eines Trials sein.

In jedem Fall ist ein Ereignis immer für alle Trials innerhalb einer Trial-Gruppe für den angegebenen Frame/die Frames definiert. Benutzerdefinierte Logik ermöglicht es den Benutzern jedoch, Ereignisse nur in bestimmten Trials, Bedingungen oder unter anderen Umständen auszuführen.

Auswahl eines Triggers

Wenn Sie ein neues Ereignis erstellen, öffnet sich die Triggerauswahl als Kachelgitter. Trigger-Typen sind nach Kategorien (Benutzereingabe, physiologisches Signal, Trial und Frame, Variable, Medienobjekt, API und Global) organisiert. Ein Suchfeld oben ermöglicht das Filtern von Trigger-Typen nach Namen. Klicken Sie auf eine beliebige Kachel, um sie als Trigger des Ereignisses festzulegen.

Sobald ein Trigger ausgewählt ist, zeigt das Ereignis eine kompakte Leiste mit dem aktuellen Triggernamen und -symbol. Um zu einem anderen Trigger zu wechseln, klicken Sie auf die Change trigger-Schaltfläche (Bleistift-Symbol), um das Kachelgitter erneut zu öffnen.

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

Die Ausführungsreihenfolge der Ereignisse kann angepasst werden. Standardmäßig stehen Ereignisse mit demselben Trigger weiter oben in der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Wenn ein bestehendes Ereignis ausgewählt ist, werden die Einzelheiten im unteren rechten (Ereigniseigenschaften) Bereich angezeigt. Für einen besseren Überblick können bestehende Ereignisse auch erneut geöffnet werden (Symbol neben dem Namensfeld).

Trigger

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

Triggerkategorie	Triggeroptionen	Beschreibung
User Input Triggers	Maus-Trigger Tastatur-Trigger Button-Klicks Eingabe bestätigen Scroll-Trigger Gamepad/ Joystick Trigger	Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der manuell durch den Benutzer/Teilnehmer aktiviert werden kann, indem er etwas tut, z. B. die Maus bewegt, auf ein Tastaturelement klickt, scrollt usw.
Physiological Signal Triggers	Augenverfolgung Blick Augenverfolgung Fixation Kopfverfolgung	Physiologische Signal-Trigger treten auf, wenn es einen bestimmten physiologischen Input gibt, wie das Ansehen eines bestimmten Elements oder Änderungen in Kopfbewegungen.
Trial and Frame Triggers	Aufgaben-Init Frame-Init Frame-Start Frame-Ende	Diese Trigger treten in Bezug auf die experimentellen Trials und Frames auf, z. B. wenn ein Frame beginnt oder endet.
Variable Value Changed Trigger	Variable (Wert geändert)	Ein Trigger für das Ereignis tritt auf, wenn es eine Änderung in einem bestimmten Variablenwert gibt.
Media Object Trigger	Medienobjekt-Trigger	Dieser Trigger tritt in Bezug auf Medienobjekte auf, wie z. B. eine Pause in einer Video-/Audio-Datei, ein abgeschlossenes Aufzeichnen usw.
API Triggers	Websocket-Trigger Open AI-Trigger PostMessage empfangen	Dies sind Trigger, die auftreten, wenn es eingehende Daten von einer API gibt.
Global Triggers	Experiment pausieren / fortsetzen Teilnehmer hat die Multi-User-Studie verlassen	Globale Trigger beziehen sich auf alle wesentlichen Änderungen an einem Experiment, z. B. wenn es pausiert wird oder ein Teilnehmer in einer Multi-User-Studie geht.

Benutzereingabe-Trigger

Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der manuell durch den Benutzer/Teilnehmer aktiviert werden kann.

Die folgende Tabelle gibt einen ersten Überblick über alle in Labvanced verfügbaren Benutzereingabe-Trigger. Jeder von ihnen wird in den kommenden Abschnitten detaillierter beschrieben.

Option für Benutzereingabe-Trigger	Übersicht
Mouse Trigger	Jede Mausbewegung kann als Trigger verwendet werden, um ein Ereignis zu starten, wie z. B.: Scrollen, Klicken, Hovering usw. Sie können auch spezifische Elemente oder Ziele mit einem Trigger verknüpfen. Zum Beispiel wird ein Mausklick nur dann als Trigger verwendet, wenn ein bestimmtes Bild angeklickt wird.
Keyboard Trigger	Jeder Tastendruck kann als Trigger verwendet werden, um ein Ereignis zu starten. Sie können spezifische Buchstaben oder Zahlen auf der Tastatur als Trigger festlegen.
Button-Clicks	Schaltflächenobjekte, die in Labvanced erstellt werden, können als Trigger verwendet werden, um Ereignisse zu starten.
Enter on Input	Dieser Trigger wird häufig verwendet, wenn ein Teilnehmer während eines Experiments 'Enter' drückt, um seine schriftliche Antwort oder Eingabe in Textfeldbereichen zu übermitteln.
Scroll Trigger	Dieser Trigger tritt auf, wenn der Teilnehmer scrollt. Sie können x- oder y-Scrollrichtung festlegen, sowie über welche Elemente der Scrollvorgang erfolgt, um als Ereignistrigger verwendet zu werden.
Gamepad/ Joystick Trigger	Dieser Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimentellen Design als Eingabegerät zur Datenerfassung zu verwenden.

Maus-Trigger

Die Option ‘Maus-Trigger’ ist ein sehr beliebter Ereignistrigger, da sie ein Ereignis basierend auf jeder Mausinteraktion initiiert, wie z. B.: die Maus nach oben / unten bewegen, klicken, über ein bestimmtes Objekt fahren, ein bestimmtes Objekt verlassen oder jede andere Bewegung überhaupt!

Das folgende Beispiel zeigt einen ‘Maus-Trigger’, der auftritt, wenn ein ‘Klick’ mit dem ‘Linken’ Mausklick auf das ‘Ziel’-Objekt mit dem Namen ‘Image_1’ durchgeführt wird:

Hier ist eine vollständige Übersicht über die Optionen, die Ihnen bei der Arbeit mit Mausauslösern zur Verfügung stehen:

Menüelement	Menübereich	Optionen und Spezifikationen für Mausauslöser
Action Dropdown-Liste:		Die folgenden Optionen für Mausauslöser sind in der Dropdown-Liste verfügbar: Klicken: Ausgelöst durch Mausklick Drücken: Ausgelöst durch Mausklick Loslassen: Ausgelöst durch Loslassen der Maus Hover: Ausgelöst durch Überfahren des Objekts mit der Maus Verlassen: Ausgelöst durch das Verlassen eines Objekts mit der Maus Bewegen: Ausgelöst durch jede Mausbewegung
Button Dropdown-Liste:		Links: Ausgelöst durch die linke Maustaste Rechts: Ausgelöst durch die rechte Maustaste
Targets Optionen:	Im obigen Beispiel ist ‚Image_1‘ das Ziel des Mausklicks, der das Ereignis auslöst. Mehrere Ziele können hinzugefügt werden, indem Sie die Option ‘+Add Target’ am Ende auswählen.	Bei der Festlegung eines Ziels stehen folgende Optionen zur Verfügung: Im Hintergrund des Rahmens auslösen: der Mausauslöser kann aktiviert werden, ohne ein Objekt oder ein Element anzuklicken. Jedes Element: der Mausauslöser kann aktiviert werden, wenn auf jedes Element im Rahmen geklickt wird. Ziele hinzufügen: Wählen Sie die spezifischen Elemente aus, die angeklickt werden müssen, um den Auslöser zu aktivieren.

• Hinweis: Nach der Auswahl des Mausauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Mauswerte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Tastaturauslöser

Die Option ‚Tastaturauslöser‘ ist eine weitere beliebte Möglichkeit, ein Ereignis auszulösen. Im Wesentlichen kann jede Eingabe von der Tastatur als Auslöser verwendet werden. Dazu gehört: Drücken, Halten oder Loslassen einer Taste.

Im folgenden Beispiel ist der Auslöser so eingestellt, dass er ein Tastendruck ist, der auftritt, wenn die angegebenen Zielnumerischen Werte (0, 2 oder 6) gedrückt werden:

Hier ist eine vollständige Übersicht über Tasten und Optionen, die Ihnen bei der Arbeit mit Tastaturauslösern zur Verfügung stehen:

Menüelement	Menübereich	Optionen für Tastaturauslöser
Action Dropdown-Liste:		Dies sind die Optionen für Tastatureingaben: PressKey: Ausgelöst durch Tastendruck (Taste ist gedrückt) Drücken ODER Halten: Ausgelöst, wenn die Taste entweder gedrückt oder gehalten wird ReleaseKey: Ausgelöst durch das Loslassen der Taste Hinweis: Eine Taste muss losgelassen werden, bevor sie erneut als Auslöser „feuern“ kann.
Keys Welche Taste das Ereignis auslöst		Welche Taste als Auslöser verwendet wird, wird festgelegt, indem die Optionen hier ausgewählt werden, indem Sie auf +Add: klicken. Pfeiltasten: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben des englischen Alphabets Spezial: Spezialtasten (Enter, Leertaste, Strg, Tab, Umschalt) F-Tasten: F1 bis F10 Beliebige Taste: jede dieser Tasten ist akzeptabel Sie können mehrere Tastaturauslöser hinzufügen, indem Sie erneut auf die Schaltfläche +Add: klicken.
Zusätzliche Optionen		Die Option Ziffernblocktasten aktivieren ermöglicht die Verwendung von Ziffernblocktasten als Auslöser innerhalb des Experiments. Für die Option Ereignisausbreitung zulassen, wenn mehrere Ereignisse denselben Tastaturauslöser haben, dann feuern/trigern alle ohne ihn. Nur das erste wird ausgeführt und die Ausführung des Ereignisses stoppt, nachdem das erste Ereignis abgeschlossen ist.

• Hinweis: Nach der Auswahl des Tastaturauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Tastaturwerte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Schaltflächenklickauslöser

Wenn Sie ein Button- oder Navigationsobjekt im Editor platziert haben, können Sie diese als Teil eines Ereignisses nutzen, in dem das Klicken auf die Schaltfläche als Auslöser für eine Aktion wirkt.

Das Klicken auf diesen Auslöser zeigt das folgende Menü, in dem Sie angeben können, welche spezifische Schaltfläche als Auslöser fungieren wird:

Hier ist ein genauerer Blick auf die gezeigten Elemente:

Menüelement	Menübereich	Optionen für Schaltflächenklickauslöser
Ziel: +Set Target		Auswahl eines Schaltflächenelements als Ziel
Button: Option		Geben Sie an, welche spezifische Schaltfläche im Rahmen

• Hinweis: Nach der Auswahl des Schaltflächenklickauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Schaltflächenklickwerte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Drücken von Enter bei der Eingabe

Der Auslöser wird ausgelöst, wenn die Enter/Return-Taste auf der Tastatur gedrückt wird, während ein spezifisches Element aktiv ist.

Parameter:

• Ziele hinzufügen: Fügen Sie ein Eingabeelement zum Ereignis hinzu.

• Hinweis: Nach der Auswahl des Enter bei Eingabe-Auslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Eingabewerte für Enter über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Scrollauslöser

Der Auslöser wird ausgelöst, wenn die Scrollleiste, das Scrollen auf dem Trackpad oder das Scrollrad der Maus auf einem bestimmten Element verwendet wird.

Parameter:

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

Ziel: Legen Sie das Ziel-Element fest, auf das der Scrollauslöser zutrifft.

Hinweis: Für langen Text müssen im Panel „Objekteigenschaften“ im Abschnitt „Stil“ die Overflow-Xund/oder Overflow-Y Optionen die scroll als ausgewählte Option haben.

• Hinweis: Nach der Auswahl des Scrollauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Scrollwerte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Gamepad-/Joystick-Auslöser

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

Erfahren Sie mehr.

Physiologische Signaltriggers

Diese Auslöser gelten nur, wenn Eye-Tracking und/oder Kopf-Tracking für die Aufgabe aktiviert wurden.

Eye-Tracking-Blickauslöser

Der Auslöser wird ausgelöst:

• Insgesamt wird dieser Auslöser angewendet, wenn Eye-Tracking aktiviert wurde.
• Nur auslösen, wenn auf spezifische Elemente geschaut wird.

Parameter:

• Wenn Sie ausgewählt haben, dass nur auf bestimmte Elemente ausgelöst werden soll, fügen Sie diese Elemente als Ziele hinzu.

• Hinweis: Nach der Auswahl des Eye-Tracking-Blickauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Blickwerte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Erfahren Sie mehr: Siehe die spezielle Eye-Tracking-Blickauslöser Seite für die Aktivierung des Eye-Trackings, das Aufzeichnen von Blickdaten und praktische Beispiele.

Eye-Tracking-Fixationsauslöser

Dieser Auslöser befindet sich noch in der BETA-Phase.

• Hinweis: Nach der Auswahl des Tastaturauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Fixationswerte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Erfahren Sie mehr: Siehe die spezielle Eye-Tracking-Fixationsauslöser Seite zur Aktivierung der Fixationsdetektion, zur Aufzeichnung von Fixationsdaten und für praktische Beispiele.

Kopf-Tracking-Auslöser

Der Auslöser wird ausgelöst:

• Änderungen in der Kopfhaltung oder Kopfbewegung.

• Hinweis: Nach der Auswahl des Kopf-Tracking-Auslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Kopf-Tracking-Werte über verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und zu referenzieren.

Test- und Rahmenauslöser

Aufgaben-Init-Auslöser

Auslöser bei:

• Dem ersten Rahmen des ersten Versuchs einer Aufgabe. Wird trotz der Anzeige im Ereignis-Tab für alle Instanzen dieses Rahmens nur einmal pro Aufgabe ausgeführt.

Dieser Auslöser harmoniert gut mit den Aktionen "Mischen" und "Auslesen von". Mit diesen Kombinationen können Sie beim Start der Aufgabe Array-Einträge oder Datenrahmen mischen und Probanden Gruppen von Stimuli zuweisen, ohne mehrere Ereignisse erstellen zu müssen, um Stimuli oder Daten auszulesen.

Parameter: Keine

• Hinweis: Nach der Auswahl des Aufgaben-Init-Auszählers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische Aufgaben-Init-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Rahmen-Init-Auslöser

Auslöser bei:

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

Dieser Auslöser harmoniert gut mit den Aktionen "Mischen", "Auslesen von" und "Zufallszahl ziehen". Mit diesen Kombinationen können diese Aktionen abgeschlossen werden, bevor der Rahmen erscheint, wodurch ein klarer Weg entsteht, damit andere Aktionen beginnen können, sobald der Rahmen startet.

Hinweis: Verwenden Sie den Rahmen-Init-Auslöser nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Versuchszahl oder Bedingungszahl beinhalten. Dies liegt daran, dass der Rahmen-Init-Auslöser zwischen den Versuchen auftritt, sodass keine vollständige genaue Zählung des Versuchs oder der Bedingung zur Verfügung steht, die angezeigt werden soll.

Parameter: Keine

• Hinweis: Nach der Auswahl des Rahmen-Init-Auszählers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische Rahmen-Init-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Hinweis zu Aufgaben- und Rahmen-Init-Auslösern: Da die Aufgaben- und Rahmen-Init-Auslöser auftreten, bevor die Aufgabe oder der Rahmen beginnt, werden Variablen, die in dieser Zeit erstellt wurden, zurückgesetzt, wenn die Aufgabe/der Rahmen tatsächlich beginnt. Eine Warnung wird beim Benutzen dieses Ereignisses angezeigt:

Denken Sie daran, das Kästchen "Zurücksetzen beim Start des Versuchs" im Fenster der VariablenEigenschaften abzuhaken, wenn Sie nicht möchten, dass die Variablenwerte zurückgesetzt werden.

Rahmen-Start-Auslöser

Auslöser bei:

• Start des Rahmens

Parameter: Keine

• Hinweis: Nach der Auswahl des Rahmen-Start-Auslösers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische Rahmen-Start-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Rahmen-Ende-Auslöser

Auslöser bei:

• Ende des Rahmens (nachdem der Rahmen nicht mehr sichtbar ist)

Parameter: Keine

• Hinweis: Nach der Auswahl des Rahmen-Ende-Auslösers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische Rahmen-Ende-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Auslöser bei Variablenwertänderung

Auslöser bei Variablenwertänderung

Auslöser bei:

• Der Wert einer Variable ändert sich von ihrem Startwert

Parameter:

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

• Hinweis: Nach der Auswahl des Auslösers für die Variablenwertänderung im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische Werte für die Variablenwertänderung in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Medienobjektauslöser

Medienobjektauslöser

Ehemals bekannt als der separate "Steuerelement Audio/Video-Auslöser" und "Steuerelementobjekt"-Auslöser.

Auslöser bei:

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

Parameter:

• Ziel: Wählen Sie ein Objekteelement, das auf dem Rahmen existiert

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

  • Audio- oder Videoobjektoptionen:
    • Wiedergabe gestartet: Auslöser, wenn das Element zu spielen beginnt
    • Wiedergabe gestoppt: Auslöser, wenn das Element pausiert
    • Wiedergabe beendet: Auslöser, wenn das Element aufhört zu spielen
  • Video-, Audio- oder Bildschirmaufnahmeobjektoptionen:
    • Aufnahme beendet: Auslöser, wenn die Audioaufnahme gestoppt wurde
    • Upload abgeschlossen: Auslöser, wenn der Datei-Upload abgeschlossen ist
  • Datei-Upload-Objektoptionen:
    • Datei ausgewählt: Auslöser, wenn eine Datei ausgewählt wird
    • Upload abgeschlossen: Auslöser, wenn der Datei-Upload abgeschlossen ist
  • Kamerasnapshot-Objektoptionen:
    • Snapshot abgeschlossen: Auslöser, wenn die Kamera erfolgreich ein Snapshot gemacht hat
    • Upload abgeschlossen: Auslöser, wenn der Snapshot erfolgreich hochgeladen wurde

• Hinweis: Nach der Auswahl des Medienobjektauslösers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische Medienobjektwerte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

API-Auslöser

Wenn Sie Daten von einem externen Server an Labvanced senden oder kommunizieren müssen, können 'API-Auslöser' und ‘API-Aktionen’ verwendet werden. Folgendes kann als Auslöser verwendet werden:

• Websocket-Auslöser
• OpenAI-Auslöser
• PostMessage empfangen

Websocket-Auslöser

Der Websocket-Auslöser wird verwendet, wenn eine Nachricht vom Websocket/API empfangen wird und als Auslöser für die Aktion verarbeitet wird.

Beim Klicken auf diese Option erscheinen die folgenden Elemente.

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

Für ein Beispiel, wie API-Auslöser/Aktionen verwendet werden, überprüfen Sie bitte diese Demo https://www.labvanced.com/page/library/51053, indem Sie die Option 'Inspektieren' im Dialogfeld auswählen.

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

• Hinweis: Nach der Auswahl des WebSocket-Auslösers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische WebSocket-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

OpenAI-Auslöser

Der 'OpenAI-Auslöser' kann verwendet werden, um eine Aktion basierend auf eingehenden Informationen von OpenAI zu initiieren.

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

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

Im folgenden Beispiel wird der zugewiesene Datenrahmen als 'df' bezeichnet und das Ergebnis des 'OpenAI-Auslösers' wird an diesen Datenrahmen angehängt. Dieser Datenrahmen muss zwei Spalten haben. 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.

Wenn Sie auch die „An OpenAI senden“-Aktion verwenden, müssen Sie denselben Datenrahmen dort verwenden, wie Sie ihn hier angegeben haben.

• Hinweis: Nach der Auswahl des OpenAI-Auslösers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische OpenAI-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

PostMessage empfangen Auslöser

Der PostMessage Received Auslöser wird aktiviert, wenn das laufende Experiment eine eingehende Nachricht von einer externen Quelle über die postMessage-API des Browsers empfängt. Er 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.

• Hinweis: Nach der Auswahl des "PostMessage empfangen"-Auslösers im Ereignissystem haben Sie die Möglichkeit, auslöserspezifische PostMessage empfangen-Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Globale Auslöser

Globale Auslöser treten auf, wenn eine große Änderung im Experiment erfolgt, d.h. etwas, das "global" ist, wie das Pausieren des Experiments oder das Verlassen eines Teilnehmers aus einer Mehrbenutzerstudie! Die folgenden Optionen sind als globale Auslöser aufgeführt:

• Experiment pausieren / fortsetzen
• Teilnehmer hat die Mehrbenutzerstudie verlassen

Experiment pausieren/fortsetzen

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

Nach Auswahl dieses Auslösers erscheint die folgende Ansicht, in der Sie weiter angeben können, wie der Auslöser ausgeführt werden soll, ob er im Falle einer Pause oder Fortsetzung des Experiments ausgeführt werden soll:

• Experiment pausiert: Der Teilnehmer pausiert (verlässt den Vollbildmodus) die Studie.

• Experiment fortgesetzt: Der Teilnehmer setzt die Studie fort. Dieser Auslöser funktioniert gut für Augenbewegungsstudien. Er kann verwendet werden, um den Teilnehmer zu einem vorherigen Versuch oder Frame zurückzuschicken, wenn er seinen virtuellen Kinnstütze verlassen hat.

• Hinweis: Nach Auswahl des Auslösers Experiment pausieren/fortsetzen im Ereignisystem haben Sie die Möglichkeit, auslöserspezifische Werte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zu verweisen.

Teilnehmer hat die Mehrbenutzerstudie verlassen

Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, kann dies ebenfalls als Auslöser für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, hat dies globale Auswirkungen auf das Experiment, da es anderen Teilnehmern die Fortsetzung der Studie verweigert.

Durch Auswahl dieses Auslösers können Sie angeben, welche Art von Aktion ausgeführt wird, wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt.

• Hinweis: Nach Auswahl des Auslösers 'Teilnehmer hat die Mehrbenutzerstudie verlassen' im Ereignisystem haben Sie die Möglichkeit, auslöserspezifische Werte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zu verweisen.

Aktionen

Aktionen definieren, was passieren soll, wenn das Ereignis ausgeführt wird. Sie können verwendet werden, um Variablen und Objekt-Eigenschaften zu ändern, Daten aufzuzeichnen, Daten zu lesen und zu schreiben aus / in Arrays oder um zum nächsten Versuch oder Task zu springen. Oft gibt es mehrere Aktionen pro Ereignis. Mit "ControlActions" kann man logische Operationen (If-Else-Anweisungen), Schleifen, Callback-Funktionen verwenden sowie Aktionen ineinander schachteln (z.B. eine While-Schleife innerhalb einer If-Anweisung). Daher kann das Ereignissystem als eine grafische Programmierumgebung angesehen werden. In dieser Ansicht fungieren Auslöser als Funktionsaufrufe, während Aktionen die funktionale Logik beschreiben. Dieser Ansatz garantiert, dass fast jede experimentelle Logik ohne die Verwendung bestimmter programmatischer / syntaktischer Strukturen implementiert werden kann.

Die folgende Tabelle bietet eine einführende Übersicht über die in Labvanced verfügbaren Aktionen:

Aktionskategorie	Aktionsoptionen	Beschreibung
Object Actions	Objekteigenschaft setzen Medienobjekt steuern Objekt kopieren Für jedes Objekt	Objekthandlungen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das innerhalb der Aufgabe existiert.
Variable Actions	Variable setzen / aufzeichnen In Zwischenablage kopieren Zufallszahl ziehen URL-Parameter abrufen Von / Nach Gerät lesen / schreiben Von / Nach gemeinsamer Variable lesen / schreiben Mathematik & Statistik Variablen sofort aufzeichnen Gleitender Durchschnittsfilter Variable verteilen	Jede Aktion, die einen Variablenwert liest oder aufzeichnet.
Array Actions	Aus Array auswählen (lesen) Arrayeinträge hinzufügen / entfernen Arrayeintrag ändern (ersetzen) Arrayeinträge mischen	Arrayoperationen umfassen das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und deren Einträgen.
Data Frame Operations	Von / Nach Datenrahmen lesen / schreiben Datenrahmeneinträge mischen	Diese Aktionen sind relevant, wenn Sie in Ihrem Experiment mit .csv-Dateien (Datenrahmen) arbeiten.
Jump Actions	Springe zu Sitzung akzeptieren / beenden Sitzung ablehnen / beenden Umleitung zu URL	Ermöglicht Ihnen, innerhalb des Experiments zu navigieren, indem Sie zu einem bestimmten Abschnitt springen, sowie Teilnehmerabschnitte zu akzeptieren und abzulehnen.
Control Actions	Erforderliche Aktionen (Wenn…Dann) Wiederholte Aktionen (While Schleife) Verzögerte Aktionen (Zeit-Callback) Aktionsgruppe	Steueraktionen werden verwendet, um spezifische Ereignisse auszuführen, wie if/then Logik, Schleifen (z.B. ein wiederholt abgespieltes Geräusch oder ein blinkendes Bild), sowie um eine Verzögerung festzulegen, wann eine Aktion ausgeführt wird.
API Actions	PostMessage senden An Websocket senden An OpenAI senden	Bezieht sich auf API-spezifische Aktionen zum Senden von Daten an eine API.
Code Actions	JavaScript ausführen Globale CSS festlegen	Code-Aktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten.
Paste Action	Einfügeaktion	Ermöglicht Ihnen, eine zuvor kopierte Aktion einzufügen.

Objektaktionen

Objektaktionen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das innerhalb der Aufgabe existiert. Es gibt mehrere Optionen für Objektaktionen:

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

Objekteigenschaft setzen Aktion

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

Mehr erfahren.

Medienobjekt steuern Aktion

Früher die separaten Aktionen „Audio/Video steuern“ und „Objekt steuern“.

Wirkung: Ändert die Wiedergabe von Video-/Audioelementen oder ändert den Zustand von Upload-/Aufzeichnungs-Elementen.

Parameter:

• Ziel: Wählen Sie ein Medienobjekt aus
• Wirkung: Wählen Sie eine Unteraktion aus
  • Audio- oder Videoobjektoptionen:
    • Wiedergabe starten: Beginnt mit der Wiedergabe der Video- / Audiodatei
    • Wiedergabe stoppen: Stoppt die Video- / Audiodatei
    • Wiedergabe pausieren: Pausiert die Video- / Audiodatei
    • JumpToTime: Ermöglicht Ihnen, eine Zeit in Millisekunden anzugeben, zu der in der Audio-/Videodatei gesprungen werden soll
    • Stummschalten: Schaltet den Ton des Objekts aus
    • Wiederherstellen: Stellt den Ton des Objekts wieder her
  • Audio-, Video- oder Bildschirmaufnahme-Objektoptionen:
    • Aufnahme starten: Beginnt eine neue (Audio-)Aufnahme
    • Aufnahme stoppen: Stoppt die (Audio-)Aufnahme
    • Hochladen starten: Beginnt mit dem Hochladen der Datei
    • Aufnahme löschen: Löscht die (Audio-)Aufnahmedaten.
    • Wiedergabe starten: Beginn mit der Wiedergabe der aufgenommenen Datei
    • Wiedergabe stoppen: Stoppt die Wiedergabe der aufgenommenen Datei
    • Aufnahme pausieren: Pausiert die Aufnahme des Objekts
    • Aufnahme fortsetzen: Setzt die Aufnahme des Objekts fort
  • Datei-Upload-Objektoptionen:
    • Hochladen starten: Beginnt den Hochladeprozess für die ausgewählte Datei
    • Datei löschen: Löscht die ausgewählte Datei
    • Datei auswählen: Ermöglicht dem Teilnehmer, die gewünschte Datei auszuwählen
  • Kamera-Snapshot-Objektoptionen:
    • Kamera starten: Schaltet die Kamera des Teilnehmers ein
    • Kamera stoppen: Schaltet die Kamera des Teilnehmers aus
    • Hochladen starten: Beginnt, das Snapshot in das Experiment hochzuladen
    • Snapshot machen: Macht ein Bild mit der Kamera des Teilnehmers

Objekt kopieren Aktion

Wirkung: Kopiert ein Objekt und ersetzt die Notwendigkeit für mehrere separate Objekte und doppelte Ereignisse.

Parameter:

• Quelle: Wählen Sie das Objekt im Frame, 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 zu bestimmen.
• Name mit inkrementierendem 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 üblichen Liste von Aktionen), was mit den Kopien passieren wird. Wählen Sie "CurrentObject" als Ziel, um die Aktion auf alle Kopien anzuwenden.

Für jedes Objekt Aktion

Wirkung: Wendet eine Aktion auf mehrere Objekte desselben Typs an.

Parameter:

• Filter: Wählen Sie den Typ des zu zielenden Elements aus.
• Zusätzlichen Namensfilter zulassen: Geben Sie den Namen des/der zu zielenden Objekte(n) ein. Für mehrere Objekte auf einem Frame, bei denen einige identische Namen haben, funktioniert dies gut.
• Aktionssequenz: Ermöglicht Ihnen, auszuwählen (aus der üblichen Liste von Aktionen), was mit den ausgewählten Elementen passieren wird. Wählen Sie "CurrentObject" als Ziel, um die Aktion auf alle Elemente anzuwenden, die die oben angegebenen Kriterien erfüllen.

Variablenaktionen

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

Die folgende Tabelle bietet eine einführende Übersicht über alle in Labvanced verfügbaren Variablenaktionsoptionen. Jede davon wird in den kommenden Abschnitten detaillierter beschrieben.

Variablenaktionsoption	Beschreibung
Set / Record Variable	Schreiben oder Setzen eines Variablenwerts
Copy to Clipboard	Kopiert einen Variablenwert in die interne Zwischenablage des Computers.
Draw Random Number	Zieht eine oder mehrere Zufallszahl(en) und speichert sie in einer Variablen
Get URL Parameter	Speichert einen Wert aus der einzigartigen URL des Teilnehmers
Read from / Write to Device	Liest oder schreibt eine Variable aus/in den lokalen Gerätespeicher. Diese Aktion speichert Daten auf dem Gerät des Teilnehmers, anstatt die Daten an die Labvanced-Server zu senden.
Read from / Write to Shared Variable	Liest aus oder schreibt in eine Variable, die über Sitzungen einer Studie hinweg geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jede Einzelperson sein.
Math & Statistics	Führt eine mathematische Operation auf einer Eingangsvariablen (Array) durch und speichert das Ergebnis in einer Ausgangsvariablen.
Record Variables Instantly	Erstellt einen Snapshot aller Variablenwerte und sendet dies an den Labvanced-Server.
Moving Average Filter	Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingabe und speichert das Ergebnis in einer neuen Variablen.
Distribute Variable	Sendet einen Wert an andere Teilnehmer. Der Wert wird in einer Variablen gespeichert.

Setzen / Aufzeichnen der Variablenaktion

Die Aktion „Setzen / Aufzeichnen der Variablen“ wird in jedem Experiment in Labvanced verwendet, da dies der Weg ist, wie Werte und Verhaltensmaße gespeichert und aufgezeichnet werden.

Wenn Sie auf diese Aktion klicken, erscheint das folgende Dialogmenü, in dem Sie angeben können, welche Variable aufgezeichnet werden soll und der interessierende Wert:

Menüelement	Menübereich	Beschreibung
Select		Bei Auswahl geben Sie an, welche Variable den Wert speichern soll. Hier können Sie auch eine neue Variable erstellen.
Stift-Symbol		Das Stiftsymbol symbolisiert das Wertauswahlmenü, das verwendet wird, um die genauen Werte zu definieren und festzulegen, die der ausgewählten Variable zugewiesen werden sollen (wie im grünen Button links neben dem Gleichheitszeichen (=) angegeben).

Im folgenden Beispiel haben wir eine neue Variable mit dem Namen 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).

Das Bild unten 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 mausspezifischer Trigger-Wert ist, den das System bereitstellt und auf den Sie bei der Aufzeichnung von Werten verweisen können.

Hinweis: Die Set / Record VariableAktion wird auch häufig im Kontext von Control Actions verwendet, wo Sie Bedingungen mit 'if / then' und 'while Loops' basierend auf Variablenwerten angeben können.

Kopieren in die Zwischenablage Aktion

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

Zufallszahl ziehen 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 (boolean true/false): Wählen Sie, ob einmal oder mehrmals gezogen werden soll.
• Anzahl der Ziehungen: Wählen Sie die Anzahl der Ziehungen aus
• 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.

URL-Parameter abrufen 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.

Aus/Schreiben in Gerätespeicher Aktion

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

Parameter:

• Wählen Sie Lesen von oder Schreiben in den lokalen Speicher.
• Wählen Sie die Variable, die gelesen oder geschrieben werden soll.

Anwendungsfall: Längsschnitt-/Multi-Sitzungsstudien

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

Aus/Schreiben in geteilte Variable Aktion

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

Parameter:

• Wählen Sie die zu synchronisierende Variable. Muss entweder skalar oder ein Array sein.
• Erweiterten Optionen
  • Speicherschlüssel: Wählen Sie den Namen einer Variablen, die als Schlüssel zur Zugriffssteuerung auf die synchronisierte Variable dient.
  • Lese- oder Schreibmethode:
    • Lesen, ändern und dann die geteilte Variable schreiben: liest die Variable, ändert sie und sendet dann die Variable an die Studie.
    • Nur den geteilten Wert vom Server lesen: ruft die Variable ab, die innerhalb der Studie geteilt wird, aber ändert nichts.
    • Nur die Variable auf den Server schreiben: ändert die geteilte Variable, wird jedoch nicht den Teilnehmern angezeigt.
    • Werte zwischen verschiedenen Teilnehmern teilen (nicht nur zwischen Sitzungen): Ermöglicht es den Teilnehmern, die synchronisierten Variablenwerte über Sitzungen hinweg zu sehen. Diese Option ist standardmäßig ausgewählt, kann aber durch Klicken auf das Kontrollkästchen deaktiviert werden.
• Aktionssequenz:
  • Wählen Sie aus, was mit der geteilten/synchronisierten Variable aus der Liste aller verfügbaren Aktionen geschieht.

Verwendungszweck: Längsschnitt-/Multi-Session-Studien

• Mit dieser Aktion können teilnehmerbezogene Daten von Sitzung zu Sitzung übertragen und zwischen den Teilnehmern über mehrere Sitzungen hinweg geteilt werden.
• Sie können diese Aktion verwenden, um eine Punktzahl in einem Test aufzuzeichnen und dem Teilnehmer dann zu ermöglichen, seine Punktzahl mit der durchschnittlichen Punktzahl der anderen Teilnehmer zu vergleichen, die den Test abgeschlossen haben.
• Ein weiteres Beispiel (ähnlich der Aktion "Von/Zu Gerät lesen/schreiben") besteht darin, die Teilnehmer 5 Bilder auszuwählen, die ihnen gefallen, aus einer Reihe, eine Aufgabe auszuführen und diese 5 Bilder dann in einer späteren Sitzung erneut zu präsentieren. Der Unterschied besteht darin, dass diese Aktion verwendet werden kann, um anderen Teilnehmern die ausgewählten Bilder zu zeigen oder diese Bilder aus anderen verfügbaren Optionen für einen Teilnehmer auszuschließen.

Mathematik- und Statistikaktion

Wirkung: Führt eine mathematische Operation auf einer Eingangsvariable (Array) aus und speichert das Ergebnis in einer Ausgangsvariablen.

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.)
• Eingangs-Array: 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.

Variablen sofort aufzeichnen Aktion

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

Parameter: Keine

Gleitender Durchschnittsfilter Aktion

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

Parameter:

• Filterform: Wählen Sie den Filtertyp aus
  • Einfacher Gleitender Durchschnitt: Berechnet einen einfachen gleitenden Durchschnitt, bei dem alle Proben dasselbe Gewicht haben.
  • Linear gewichteter gleitender Durchschnitt: Gewichtet die Proben so, dass die Gewichte der Proben linear abnehmen.
  • Exponentieller 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.

Variable verteilen Aktion

Die Aktion "Variable verteilen" ist unerlässlich für Multi-User-Studien in Labvanced. Mit dieser Aktion kann ein Variablenwert zwischen den Teilnehmern geteilt werden, wodurch Informationen (einschließlich Standort der Stimuli und etwaige Änderungen) auf den Bildschirmen der Teilnehmer widergespiegelt werden können. Siehe Variable verteilen Aktion für eine detaillierte Anleitung zu dieser Aktion.

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 das funktionale Dialogfeld der Aktion "Variable verteilen" aussieht, wenn alle Menüelemente ausgefüllt sind. In diesem Beispiel ist die verteilte Variable eine Aktion, die als Möglichkeit verwendet wird, eine Chatfunktion zwischen zwei Teilnehmern zu erstellen, indem der Wert einer Variablen aus einem Eingabefeldobjekt verteilt wird.

Sehen Sie sich diese Demo an, die die verteilte Variable und die Chatbox-Funktion hier integriert: Bildbeschreibungsaufgabe mit Chat-Add-On.

Eine vollständige Erklärung der Elemente des Dialogmenüs finden Sie unten:

Menüelement	Menübereich	Optionen und Beschreibung der Aktion "Variable verteilen"
Distribute value to		Wä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 value		Zielvariable: Wählen Sie eine Zielvariable aus, in der der Wert gespeichert wird. Wert: Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.
Block		Wenn aktiviert, kann die Zielvariable nicht geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist.
Rate Limit Strategy		Die Geschwindigkeitsbegrenzungsstrategie ist eine Möglichkeit, Ihr Experiment vor einer Überlastung des Servers zu schützen und fungiert als vorsorgliche Strategie zur Kontrolle der Rate, mit der Anfragen (d.h. Updates über die verteilte Variable) an den Server gesendet werden. Die folgenden Strategieoptionen stehen zur Verfügung: Debounce: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Servernachrichten 'debounced' (nur die letzte 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 vergangen sind, seit die letzte Nachricht gesendet wurde, wird nur die letzte 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 eingereiht (bis zu einer maximalen Warteschlangengröße von 10 Nachrichten).

Array-Aktionen

Aus Array lesen (Select) Aktion

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

Parameter:

• Array-Variable: Eingangs-Array 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 an, von der die Informationen ausgelesen werden sollen (1-basierend).
  • Variabel: Verwenden Sie eine numerische Variable als Index für die Leseoperation. In diesem Fall wählen Sie eine skalare numerische Variable aus, um die Position des Auslesens zu bestimmen.
  • Ende des Arrays: Lesen Sie von Ende des Arrays.
• Ausgangsvariable: Wählen Sie eine skalare Variable aus, in der der ausgelesene Wert gespeichert wird.

Array-Einträge hinzufügen / entfernen Aktion

Wirkung: Fügt Einträge zu einem Array hinzu und/oder entfernt sie von einem Array.

Parameter:

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

Array-Eintrag ändern (Replace) Aktion

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 Ersetzungsoperation. In diesem Fall geben Sie die Array-Position an, die geändert werden soll (1-basierend).
  • Variabel: Verwenden Sie eine numerische Variable als Index für die Ersetzungsoperation. In diesem Fall wählen Sie eine skalare numerische Variable aus, um die Position der Ersetzungsoperation zu bestimmen.
  • Ende des Arrays: Ersetzen Sie den letzten Eintrag im Array.
• Eingangsvariable: Wählen Sie eine (skalare) Variable aus, die den neuen Wert hält.

Array-Einträge mischen Aktion

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

Parameter: Keine

Datenrahmenoperationen

Aus Datenrahmen lesen / In Datenrahmen schreiben Aktion

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

Parameter:

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

Datenrahmen-Einträge mischen Aktion

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

Parameter:

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

Sprungaktionen

Jump To Action

Wirkung: "Springt" den 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:

• Jump To: Bestimmt, wohin im Experiment gesprungen wird.
  • Next Frame: Springt zum nächsten Frame. Wenn keine weiteren Frames in einem Versuch definiert sind, springt es zum ersten Frame des nächsten Versuchs.
  • Next Trial: Springt zum nächsten Versuch. Wenn keine weiteren Versuche definiert sind, springt es zum ersten Versuch der nächsten Aufgabe.
  • Next Task: Springt zur nächsten Aufgabe. Wenn keine weiteren Aufgaben definiert sind, springt es zur ersten Aufgabe des nächsten Blocks.
  • Next Block: Springt zum nächsten Block. Wenn keine weiteren Blöcke definiert sind, endet die Sitzung.
  • Previous Frame: Springt zum vorherigen Frame. Wenn keine vorherigen Frames vorhanden sind, wird die Aktion nicht ausgeführt.
  • Specific Frame: Springt zu einem bestimmten Frame. Die Benutzer wählen direkt den Frame aus, zu dem gesprungen werden soll.
  • Specific Trial: Springt zu einem bestimmten Versuch. Die Benutzer wählen direkt die Versuchsnummer aus, zu der gesprungen werden soll.
  • Specific Task: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Die Benutzer wählen direkt die Aufgabe aus, zu der gesprungen werden soll.
  • Specific Block: Springt zur ersten Instanz des angegebenen Blocks. Die Benutzer wählen direkt den Block aus, zu dem gesprungen werden soll.
• Check Required Answers Before: Wenn aktiviert, überprüft das Experiment, ob alle erforderlichen Antworten bereits beantwortet wurden. Andernfalls wird die Sprung-Aktion nicht ausgeführt.

Accept/End Session Action

Wirkung: Akzeptiert die Daten des Teilnehmers, beendet die Aufnahmesitzung und zeigt den Crowdsourcing-Code an.

Parameter:

• Record trial data before finish session: Wenn aktiviert, werden die neuesten 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 Entschädigungscode dem Teilnehmer angezeigt. Wenn deaktiviert, endet das Experiment nach dem Anzeigen des aktuellen Frames und zeigt nicht die Standard-Endseite mit Entschädigungscode an.

Reject/End Session Action

Wirkung: Beendet die Aufnahmesitzung, markiert die Daten des Teilnehmers NICHT als vollständig und zeigt NICHT die Standard-Endseite mit Entschädigungscode an.

Bei Verwendung dieser Aktion, um die Daten eines Teilnehmers abzulehnen, sollten die Benutzer den Teilnehmern eine angemessene Nachricht anzeigen, die erklärt, warum sie nicht für ihre Zeit belohnt werden.

Parameter: Keine

Redirect to URL Action

Wirkung: Leitet den Teilnehmer zu einer bestimmten URL weiter.

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

Control Actions

Requirement Actions (If... Then... Else If) Action

Wirkung: Bewertet eine Wenn-Dann-Aussage und führt eine Reihe von Aktionen abhängig aus. Jede Wenn/Else-if-Aussage besteht aus verschachtelten UND/ODER-Vergleichen, um zu bewerten, ob alle Anforderungen erfüllt sind (Aussage ist wahr) oder nicht (Aussage ist falsch). Wenn die Aussage wahr ist, werden die Aktionen unter "Dann" ausgeführt. Siehe Requirement Action für eine ausführliche Anleitung zu dieser Aktion.

Parameter:

• Add Requirement: Fügt eine neue Anforderung zu einer Aussage hinzu. Das "Wert-Auswahl"-Menü erscheint auf beiden Seiten, um einen logischen Vergleich zu erstellen. In der Mitte der Aussage können Sie auswählen, wie die beiden Seiten verglichen werden sollen (z.B. gleich, kleiner als, ungleich, usw.).
• Add OR Group: Nur eine der Anforderungen innerhalb einer ODER-Gruppe muss wahr sein, damit die gesamte Gruppe wahr ist. Fügen Sie eine ODER-Gruppe hinzu, wenn die Unteraktionen in mehreren Fällen ausgeführt werden sollen.
• Add AND Group: Alle Anforderungen innerhalb einer UND-Gruppe müssen wahr sein, damit die gesamte Gruppe wahr ist. Fügen Sie eine UND-Gruppe hinzu, wenn die Unteraktionen nur ausgeführt werden sollen, wenn mehrere Anforderungen erfüllt sind.
• Action Sequence: Jede Wenn/Else-if-Aussage hat eine Liste von Aktionen, die unter "Dann" definiert sind. Die Aktionssequenz listet alle Aktionen für eine bestimmte Wenn/Else-if-Aussage auf. Eine neue Aktion kann über das Symbol "Aktion hinzufügen" hinzugefügt werden. Die Aktionssequenz wird nur ausgeführt, wenn die Anforderung(en) der zugehörigen Wenn/Else-if-Aussage erfüllt sind.
• Add Else-If Case: Die Anforderungsaktion kann aus mehreren separaten Wenn/Else-if --> Dann-Aussagen bestehen. Es kann jedoch nur eine Aussage ausgeführt werden. Wenn eine Wenn/Else-if-Aussage positiv bewertet wird (wahr zurückgibt), werden die Aktionen im Dann-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 Wenn/Else-if-Aussagen ausgeführt wird (wahr zurückgibt), werden die Aktionen definiert im else-Fall ausgeführt.

Repeated Actions (While Loop) Action

Wirkung: Führt wiederholt eine Reihe von Aktionen entweder sofort oder innerhalb eines definierten Zeitintervalls aus. Eine Stoppbedingung kann angegeben werden, damit die Schleifen-Ausführung gestoppt wird.

Parameter:

• 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 definiertem Intervall aus (z.B. die Schleife wird alle 50 ms ausgeführt).
• Define the number of loops: Wenn "Execute every ... ms" ausgewählt ist, haben die Benutzer die Möglichkeit, einen ganzzahligen Wert für die Anzahl der Male anzugeben, die die Schleife ausgeführt werden soll. 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 beim nächsten Ausführungsintervall gestartet.
• Allow multiple starts (true / false): Wenn aktiviert, können mehrere Schleifeninstanzen parallel gestartet werden. Wenn deaktiviert, kann immer nur eine Schleifeninstanz ausgeführt werden.
• Enable stop condition (true / false): Wenn aktiviert, kann eine Stoppbedingung für die Schleife angegeben werden.
• Stop Condition: Die Stoppbedingung kann verwendet werden, um einen logischen Ausdruck anzugeben, wann die Schleifen-Ausführung gestoppt werden soll. Ähnlich wie bei den Wenn/Else-if-Aussagen kann man UND-Gruppen, ODER-Gruppen und Anforderungen für den logischen Vergleich kombinieren.
• Action Sequence: Die Aktionssequenz listet alle Aktionen, die in jeder Iteration der Schleife ausgeführt werden. Eine neue Aktion kann über das Symbol "Aktion hinzufügen" hinzugefügt werden.

Delayed Actions (Time Callback) Action

Wirkung: Führt eine Reihe von Aktionen nach einer bestimmten Zeitverzögerung aus

Parameter:

• 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 festgelegten Verzögerung ausgeführt.
• Delay: Die Länge der Verzögerung in Millisekunden (ms).
• Action Sequence: Die Aktionssequenz listet alle Aktionen, die nach der festgelegten Zeitverzögerung ausgeführt werden. Eine neue Aktion kann über das Symbol "Aktion hinzufügen" hinzugefügt werden.

Action Group

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

Learn more.

API Actions

Wenn Sie Daten von einem externen Server an Labvanced senden oder kommunizieren müssen, können ‚API Actions‘ und ‚API Triggers‘ verwendet werden. Sie haben die folgenden Aktionen in dieser Kategorie zur Verfügung:

• Send PostMessage
• Send To Websocket
• Send to OpenAI

Damit diese Aktionen 'verfügbar' oder nutzbar sind, müssen Sie einen API-Schlüssel im Settings Tab eingeben.

Send PostMessage Action

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

Learn more.

Send to Websocket Action

Bei Auswahl dieser Aktion erscheinen die folgenden Optionen:

Das obige Beispiel und die vollständige Ereignistruktur können hier angezeigt werden: https://www.labvanced.com/page/library/51053 durch Klicken auf ‚Untersuchen.‘

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

Send to OpenAI Action

Die ‚Send to OpenAI‘-Aktion ermöglicht es Ihnen, Informationen, wie einen String-Eingabewert, an OpenAI zu senden. Bitte beachten Sie, dass dieser Option verfügbar ist, Sie Ihren API-Schlüssel im Settings Tab unter Special Features auflisten müssen.

Die folgenden Optionen erscheinen, wenn Sie dieses Ereignis anklicken:

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

Für ein besseres Verständnis, wie Sie diese Funktion nutzen können und sie in Aktion sehen, können Sie uns gerne für eine Demo kontaktieren, indem Sie dieses Kontaktformular ausfüllen.

HINWEIS: Beachten Sie auch diese Schritt-für-Schritt-Anleitung, in der wir eine Studie Schritt für Schritt erstellen, ChatGPT in eine Studie integrieren und diese Aktion nutzen.

Hier ist eine tiefere Erklärung der Felder, die unter der 'Send to OpenAI'-Aktion enthalten sind:

Menüpunkt	Menübereich	Optionen der 'Send to OpenAI'-Aktion
Model Type		Gibt das AI-Modell an, das verwendet werden soll.
Chat History Dataframe		Verknüpfung zu einer Datenrahmen-Variable mit zwei Spalten. Die erste Spalte steht für die 'Rolle' und die zweite Spalte für die 'Chat-Nachricht.' Die Werte aus der Aktion werden automatisch an den hier verknüpften Datenrahmen angehängt. Der Datenrahmen kann auch mit Datenrahmen-Aktionen manipuliert werden. Für weitere Informationen siehe die Dokumentation von OpenAI.
Insert Message ‘+’		Durch Klicken hierauf erscheint das Dialogfeld für Variablen. Sie müssen angeben, welcher 'Variablen'-Wert an OpenAI gesendet wird, sowie die 'Rolle' der zugehörigen Nachricht: system: bezieht sich auf das übergeordnete ChatGPT-System user: den Teilnehmer assistant: bezieht sich auf eine bestimmte Unterrolle, die innerhalb des Systems erstellt wurde

Da OpenAI sich täglich weiterentwickelt, überprüfen Sie bitte die Dokumentation von OpenAI für weitere Klarstellungen.

Code-Aktionen

In einigen Fällen kann es erforderlich sein, dass Ihr Experiment benutzerdefinierten Code verwendet. 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

JavaScript-Aktion ausführen

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

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

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.

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

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

Aktion einfügen

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 gestalten, sodass Sie nicht immer wieder dieselben Elemente auswählen müssen. Wenn Sie beispielsweise ein Ereignis haben, das einem bereits bestehenden ähnlich ist, können Sie es einfach kopieren, einfügen und ändern, anstatt es von Anfang an neu zu erstellen.

Das Wertauswahlmenü

Wenn Sie mit bestimmten Ereignissen arbeiten, wird ein Stiftsymbol angezeigt. Dies wird als Wertauswahlmenü bezeichnet, da es Ihnen ermöglicht, auszuwählen und anzuweisen, 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 Setup nutzen werden.

Dieses Stiftsymbol / Wertauswahlmenü erscheint an verschiedenen Stellen für bestimmte Aktionen im Ereignissystem, wie beispielsweise die Setzen / Aufzeichnen von Variablen-Aktion, die Setzen von Objektattributen-Aktion und die Anforderung (Wenn... Dann)-Aktion, wie unten gezeigt.

Ein Klick auf das Stiftsymbol führt zu einem Dropdown-Menü, in dem Sie den Wert angeben, der ausgelesen oder geschrieben werden soll. Das Dropdown-Menü beginnt immer mit einer trigger-spezifischen Wertoption und fährt dann mit den anderen 5 Kategorien (Aktuelle Zeit, Konstantwert, Variable, Rahmen / Aufgabe / Option und Operationen) fort, von denen jede ihre eigenen Optionen hat. Diese werden weiter unten beschrieben.

Das obige Bild zeigt, wie das Wertauswahlmenü aussieht, wenn ein Maustrigger verwendet wird. Wie Sie sehen können, beginnt der erste Menüpunkt links mit einer trigger-spezifischen Kategorie und fährt dann mit den anderen 5 Kategorien (Aktuelle Zeit usw.) fort.

Menüoptionen

Die folgende Tabelle erklärt die Kategorien und Optionen näher:

Aktuelle Zeitwerte

Mit der Option 'Aktuelle Zeit' können Sie Werte in Bezug auf die Zeit aufzeichnen oder angeben.

Die folgenden Optionen stehen zur Verfügung:

• UNIX-Zeitstempel
• Zeit seit Beginn des Frames

Aktuelle Zeit: UNIX-Zeitstempel

Dieser Wert erfasst einen Zeitstempel im UNIX-Format in Millisekunden.

Aktuelle Zeit: Zeit seit Rahmenbeginn

Dieser Wert erfasst die Zeit, die seit dem Beginn des Frames vergangen ist. In den meisten Fällen entspricht dies der Reaktionszeit.

Konstante Werte

Weisen Sie konstante Werte basierend auf dem Typ der benötigten Variablen zu, wie z.B. Zeichenfolgen oder numerische Werte. Diese werden manchmal in Kombination mit anderen Optionen wie Arithmetic verwendet, um Zähler zu erstellen.

Die folgenden Optionen sind verfügbar:

• Zeichenfolge
• Numerisch
• Boolesch
• Kategorial
• Datum
• Zeit
• Farbe

Konstante: Zeichenfolge

Weist einen Zeichenfolgen-/Textwert zu.

Konstante: Numerisch

Weist einen numerischen/Wertwert zu.

Konstante: Boolesch

Weist einen Wert von true oder false zu.

Konstante: Kategorial

Weist einen Ebenenwert zu (meistens für Faktoren).

Konstante: Datum

Weist einen Datumswert zu.

Konstante: Zeit

Weist einen Zeitwert zu.

Konstante: Farbe

Weist einen Farbwert (Hex-String) zu.

Variable Werte

Spezifizieren 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
• Wert aus Array auswählen
• Wert aus Datenrahmen auswählen

Variable auswählen

Ermöglicht es Ihnen, eine Variable auszuwählen und darauf zu verweisen.

Wert aus Array auswählen

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

Wert aus Datenrahmen auswählen

Ermöglicht es Ihnen, einen Wert aus einem von Ihnen erstellten Datenrahmen auszuwählen.

Rahmen / Aufgabe / Objekt Werte

Ermöglicht es Ihnen, Werte abzurufen, die mit Objekt-Eigenschaften, dem Rahmen, der Augenverfolgung (wenn aktiviert) und dem Gerät (Bildschirmaktualisierungsrate) verbunden sind.

• Objekteigenschaft
• Rahmen
• Augenverfolgung
• Gerät

Objekteigenschaft

Liest eine Objekteigenschaft aus.

Rahmen

Augenverfolgung

Gerät

• Aktualisierungsrate: Der Aktualisierungsratenwert des Geräts des Teilnehmers.

Operationen

Verwenden Sie Operationen, um spezifizierte Änderungen an Ihren Variablen vorzunehmen, wie z.B. das Kombinieren von Variablenwerten, das Transformieren von Zeichenfolgen in Kleinbuchstaben oder das Ausführen mathematischer Operationen.

Die folgenden Optionen sind verfügbar:

• Arithmetik
• String-Operation
• Mathematik-Operation

Arithmetik

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

Im Wesentlichen erlaubt die arithmetische Operation, Operationen auf mehreren Werten durchzuführen.

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

Die Werte können mithilfe dieser 5 verschiedenen Operationen manipuliert werden:

• (+) Addition
• (-) Subtraktion
• (/) Division
• (*) Multiplikation
• (%) Modulo

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

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

String-Operation

Mathematik-Operation

Führt eine mathematische Operation auf einem Skalarwert aus.

Trigger-spezifische Werte

Trigger-spezifische Werte beziehen sich auf Werte, die mit dem im Rahmen eines bestimmten Ereignisses definierten Trigger verbunden sind. Zum Beispiel, wenn Ihr Ereignis einen Maus-Trigger verwendet, können Sie unter bestimmten Bereichen, in denen die Aktion spezifiziert ist (wie bei der Verwendung einer Set / Record Variable Aktion oder einer Set Object Property Aktion), auf trigger-spezifische Werte des Maus-Triggers im Wertauswahlmenü.

Im folgenden Beispiel werden trigger-spezifische Werte für einen Maus-Trigger verwendet, um X- und Y-Werte sowie ein [X,Y] Array mithilfe einer Set / Record Variable Aktion aufzuzeichnen.

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	Optionen für Wertübersicht
Trigger (Mouse)	Maus X Maus Y Maus [X,Y] Array Stimulus-Name Stimulus-Info Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Keyboard)	Id der Taste Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Button Bar)	Stimulus-Name Stimulus-Info Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Enter On Input)	Id der Taste Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Scroll)	Stimulus-Name Stimulus-Info Scroll-Position X Scroll-Position Y Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Gamepad/ Joystick)	Gamepad-Geräte-ID Gedrückte Tasten (Array) Gedrückte oder gehaltene Tasten (Array) Losgelassene Tasten (Array) Achsen (Array) Gamepad-Zeitstempel (Unixtime) Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Eyetracking Gaze)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulus-Name Stimulus-Info Kameraerfassung-Zeit T Blick-Konfidenz C Koord. + Zeit [X,Y, T] Array Koord. + Zeit + Konfidenz [X,Y, T,C] Array Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Eyetracking Fixation)	Fixationszentroid X Fixationszentroid Y Fixationsdauer Fixationsstartzeit Fixationsendzeit Fixationsstreuung Stimulus-Name Stimulus-Info [X,Y, Dur, Start, Ende, Disp] Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Head Tracking)	Kameraerfassung-Zeit T Facemesh-Datenrahmen Kopfbewegung Kopfwinkel Kopfrolle Kopfposition [X,Y, T] Array Nasenposition [X,Y, T] Array Nasenvektor [X,Y, Z, T] Array Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (On Task Initialization)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (On Frame Init)	VersuchNr Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (on Frame Start)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (On Frame End)	Gesamtzeit des Rahmens Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Variable Value Changed)	Neuer Wert in der Variablen Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Media Object Trigger)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Websocket Trigger)	Nachricht Daten Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (OpenAI Trigger)	Chat GPT-Antwort Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (PostMessage Received)	Nachrichteninhalt Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (Global Experiment Event)	Gesamtzeit des Rahmens Grund für das globale Ereignis Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)
Trigger (User Leaves Experiment)	Verbleibende Teilnehmerzahl Trigger-Zeitstempel (Unixtime) Trigger-Zeit (Von Rahmenbeginn)

Trigger (Maus) Werte

Wenn ein Maus-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Trigger (Tastatur) Werte

Wenn ein Tastatur-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Trigger (Schaltflächenleiste) Werte

Wenn ein Button-Click-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Trigger (Enter bei Eingabe) Werte

Wenn ein Enter bei Eingabe-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Trigger (Scrollen) Werte

Wenn ein Scroll-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Trigger (Gamepad/Joystick) Werte

Wenn ein Gamepad/Joystick trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Trigger (Eyetracking-Gaze) Werte

Wenn ein Eyetracking-Gaze-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Erfahren Sie mehr: Sehen Sie sich die spezielle Eyetracking-Gaze-Trigger Seite an, um Eyetracking zu aktivieren, Blickdaten aufzuzeichnen und praktische Beispiele zu erhalten.

Trigger(Eyetracking-Fixation) Werte

Wenn ein Eyetracking-Fixation-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen verwendet werden:

Mehr erfahren: Siehe die spezielle Eyetracking Fixation Trigger Seite zum Aktivieren der Fixationserkennung, Aufzeichnen von Fixationsdaten und praktischen Beispielen.

Trigger (Kopfverfolgung) Werte

Wenn ein Kopfverfolgung-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Bei Aufgabeninitialisierung) Werte

Wenn ein Aufgabeninitialisierungs-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Bei Frameinitialisierung) Werte

Wenn ein Frameinitialisierungs-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Bei Framebeginn) Werte

Wenn ein Framebeginn-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Bei Frameende) Werte

Wenn ein Frameende-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Wert geändert) Werte

Wenn ein Wert geändert-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Medienobjekt-Trigger) Werte

Wenn ein Medienobjekt-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Websocket-Trigger) Werte

Wenn ein Websocket-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (OpenAI-Trigger) Werte

Wenn ein OpenAI-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (PostMessage empfangen) Werte

Wenn ein PostMessage empfangen-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Globales Experimentereignis) Werte

Wenn ein Experiment pausieren / wieder aufnehmen-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden:

Trigger (Teilnehmer verlässt Experiment) Werte

Wenn ein Teilnehmer hat Multiuser-Studie verlassen-Trigger verwendet wird, können die folgenden spezifischen Werte im Zusammenhang mit dem Trigger für bestimmte Aktionen abgerufen werden: