Ereignissystem

Beschreibung

Das Ereignissystem ist für jede Studie unerlässlich. Es ist der Weg, wie Sie Werte festlegen, die aufgezeichnet werden sollen, das Experiment voranbringen 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 oft als Vermittler zwischen Objekten und Variablen.

• Für eine vollständige Liste der Trigger
• Für die vollständige Liste der Aktionen
• Für mehr Informationen über das Value-Select Menü zur Festlegung 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 auf ein bestimmtes Bild klickt (Trigger), dann zeige ein anderes, zufälliges Bild (Aktion).

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

Erstellung von Ereignissen - Übersicht

Ereignisse werden im Aufgaben-Editor unter dem "Ereignisse"-Tab in der oberen rechten Ecke verwaltet. Neue Ereignisse können durch einen Klick auf + Frame Event für Ereignisse, die in diesem Frame auftreten sollen, oder durch Klicken auf + Trial Event erstellt werden, um das Ereignis auf alle Frames anzuwenden. Alle vorhandenen 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 in jedem Frame über einen Versuch sein.

So oder so ist ein Ereignis immer für alle Versuche innerhalb einer Versuchsgruppe für die angegebenen Frame(s) definiert. Benutzerdefinierte Logik ermöglicht es jedoch, Ereignisse nur in bestimmten Versuchen, Bedingungen oder unter anderen Umständen auszuführen.

Auswahl eines Triggers

Wenn Sie ein neues Ereignis erstellen, öffnet sich die Triggerauswahl als Kachelraster. Die Triggerarten sind nach Kategorien organisiert (Benutzereingabe, Physiologisches Signal, Versuch und Frame, Variable, Medienobjekt, API und Global). Ein Suchfeld oben ermöglicht es Ihnen, die Triggerarten nach Namen zu filtern. 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 an. Um zu einem anderen Trigger zu wechseln, klicken Sie auf die Change trigger-Schaltfläche (Bleistift-Symbol), um das Kachelraster erneut zu öffnen.

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

Die Ausführungsreihenfolge von Ereignissen kann angepasst werden. Standardmäßig stehen Ereignisse mit dem gleichen Trigger weiter oben in der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Wenn Sie ein vorhandenes Ereignis auswählen, werden die Einzelheiten im unteren rechten (Ereigniseigenschaften) Panel angezeigt. Zur besseren Übersicht können vorhandene 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 Tasteneingabe, eine Änderung eines Variablenwertes, der Start einer Videodatei oder viele andere Dinge sein. Alle Trigger und ihre Einstellungen / Parameter sind in der folgenden Liste erklärt:

Triggerkategorie	Triggeroptionen	Beschreibung
User Input Triggers	Maus-Trigger Tastatur-Trigger Button-Klicks Enter bei Eingabe Scroll-Trigger Gamepad/Joystick-Trigger	Benutzereingabetrigger beziehen sich auf jeden Trigger, der manuell aktiviert werden kann, indem der Benutzer/Teilnehmer etwas tut, wie z.B. die Maus zu bewegen, ein Tastenfeld zu klicken, zu scrollen usw.
Physiological Signal Triggers	Eyetracking-Blick Eyetracking-Fixation Kopfverfolgung	Physiologische Signaltrigger treten auf, wenn es einen bestimmten physiologischen Input gibt, wie das Blicken auf ein bestimmtes Element oder Änderungen der Kopfbewegungen.
Trial and Frame Triggers	Task Init Frame Init Frame Start Frame End	Diese Trigger stehen im Zusammenhang mit den experimentellen Versuchen und Frames, wie z.B. wann 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. wenn es eine Pause in einer Video-/Audiodatei gibt, eine Aufnahme abgeschlossen ist usw.
API Triggers	Websocket-Trigger Open AI-Trigger PostMessage erhalten	Dies sind Trigger, die auftreten, wenn es eingehende Daten von einer API gibt.
Global Triggers	Pause / Experiment fortsetzen Teilnehmer hat die Mehrbenutzerstudie verlassen	Globale Trigger beziehen sich auf alle wesentlichen Änderungen an einem Experiment, wie z.B. die Pause oder das Verlassen eines Teilnehmers in einer Mehrbenutzerstudie.

Benutzereingabetrigger

Benutzereingabetrigger beziehen sich auf jeden Trigger, der manuell vom Benutzer/Teilnehmer aktiviert werden kann.

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

Option für Benutzereingabetrigger	Übersicht
Mouse Trigger	Jede Mausbewegung kann als Trigger verwendet werden, um ein Ereignis zu initiieren, 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 als Trigger verwendet, wenn ein bestimmtes Bild angeklickt wird.
Keyboard Trigger	Jeder Tastendruck kann als Trigger verwendet werden, um ein Ereignis zu initiieren. 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 initiieren.
Enter on Input	Dieser Trigger wird häufig verwendet, wenn ein Teilnehmer während eines Experiments die 'Enter'-Taste drückt, um seine schriftliche Antwort oder Eingabe in Textfeldern abzuschicken.
Scroll Trigger	Dieser Trigger tritt auf, wenn der Teilnehmer scrollt. Sie können x- oder y-Scrollrichtungen angeben, sowie über welche Elemente gescrollt wird, 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 Ereignis-Trigger, 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 Bewegung überhaupt!

Das Beispiel unten zeigt einen „Mausauslöser“, der auftritt, wenn ein „Klick“ mit dem „linken“ Mausklick auf das Zielobjekt mit dem Namen „Image_1“ ausgeführt wird:

Im Folgenden finden Sie eine vollständige Übersicht der Optionen, die Sie beim Arbeiten mit Mausauslösern haben:

Menüelement	Menübereich	Optionen und Spezifikationen für Mausauslöser
Action Dropdown-Liste:		Die folgenden Optionen für Mausauslöser sind aus der Dropdown-Liste verfügbar: Klick: Ausgelöst durch Mausklick Drücken: Ausgelöst durch Mouse Down Lösen: Ausgelöst durch Mouse Up Schweben: Ausgelöst durch Überfahren des Objekts Verlassen: Ausgelöst durch Verlassen eines Objekts 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’ unten klicken.	Bei der Festlegung eines Ziels stehen die folgenden Optionen zur Verfügung: Trigger im Hintergrund des Rahmens: Der Mausauslöser kann aktiviert werden, ohne auf ein Objekt oder Element zu klicken. 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: Nachdem Sie den Mausauslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Mauswerte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Tastaturtrigger

Die Option „Tastaturtrigger“ 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:

Im Folgenden finden Sie eine vollständige Übersicht der Tasten und Optionen, die Sie beim Arbeiten mit Tastaturtriggern haben:

Menüelement	Menübereich	Optionen für Tastaturtrigger
Action Dropdown-Liste:		Dies sind die verfügbaren Optionen für Tastaturaktionen: Tastendruck: Ausgelöst durch Tastendruck (Taste ist gedrückt) Tastendruck ODER Halte die Taste: Ausgelöst, wenn die Taste entweder gedrückt oder gehalten wird Tasten loslassen: Ausgelöst durch Tastenklick Hinweis: Eine Taste muss losgelassen werden, bevor sie erneut als Auslöser „ausgelöst“ werden kann.
Keys Welche Taste das Ereignis auslöst		Welche Taste als Auslöser verwendet wird, wird hier angegeben, indem Sie die Optionen auswählen, indem Sie auf +Add: klicken Pfeile: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben des englischen Alphabets Sonderzeichen: Sondertasten (Eingabe, Leertaste, Steuerung, Tabulator, Shift) F-Tasten: F1 bis F10 jede Taste: jede dieser Tasten ist akzeptabel Sie können mehrere Tastaturtrigger hinzufügen, indem Sie die +Add:-Taste erneut klicken
Zusätzliche Optionen		Die Option Ziffernblocktasten aktivieren ermöglicht es, die Zifferntasten als Auslöser innerhalb des Experiments zu verwenden. Für die Option Ereignisweiterleitung zulassen gilt: Wenn mehrere Ereignisse denselben Tastaturauslöser haben, werden alle ohne diese ausgelöst. Nur das erste Ereignis wird ausgelöst, und die Ereignisausführung wird gestoppt, nachdem das erste Ereignis abgeschlossen ist.

• Hinweis: Nachdem Sie den Tastaturtrigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Tastaturwerte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Button-Klick-Auslöser

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

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

Hier ist ein näherer Blick auf die dargestellten Elemente:

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

• Hinweis: Nachdem Sie den Button-Klick-Auslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Button-Klickwerte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Drücken der Eingabetaste auf der Eingabeauslöser

Trigger auf: Die Eingabetaste/Return-Taste wird auf der Tastatur gedrückt, während ein spezifisches Element aktiv ist.

Parameter:

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

• Hinweis: Nachdem Sie den Trigger „Eingabetaste auf Eingabe“ im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Werte der Eingabetaste in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Scroll-Trigger

Trigger auf: Die Scroll-Leiste, das Scrollen auf dem Trackpad oder das Scrollrad der Maus wird bei einem bestimmten Element verwendet.

Parameter:

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

Ziel: Legen Sie das Zielelement fest, auf das der Scrollauslöser angewendet wird.

Hinweis: Für langen Text müssen im 'Objekteigenschaften' -Panel unter dem Abschnitt 'Stil' die Optionen Overflow-Xund/oder Overflow-Y ausgewählt sein.

• Hinweis: Nachdem Sie den Scrollauslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Scrollwerte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Gamepad-/Joystick-Ausrüser

Das Gamepad/ Joystick Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimentellen Design als Eingabegerät zur Datenerfassung zu nutzen. Hinweis: Vergessen Sie nicht, diese Option im Settings Tab zu aktivieren.

Erfahren Sie mehr.

Physiologische Signaltrigger

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

Eye-Tracking-Blickauslöser

Trigger auf:

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

Parameter:

• Wenn Sie die Auswahl getroffen haben, nur auf bestimmten Elementen auszulösen, fügen Sie diese Elemente als Ziele hinzu.

• Hinweis: Nachdem Sie den Eye-Tracking-Blickauslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Blickwerte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Erfahren Sie mehr: Siehe die spezielle Seite über den Eye-Tracking-Blickauslöser zum Aktivieren des Eye-Trackings, Aufzeichnen von Blickdaten und praktischen Beispielen.

Eye-Tracking-Fixationsauslöser

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

• Hinweis: Nachdem Sie den Tastaturauslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, spezifische Auslöser-Fixationswerte in verschiedenen Aktionen mit dem Wertauswahlmenü. zu verwenden und darauf zuzugreifen.

Erfahren Sie mehr: Siehe die spezielle Eyetracking Fixation Trigger Seite zum Aktivieren der Fixationsdetektion, zum Aufzeichnen von Fixationsdaten und praktischen Beispielen.

Headtracking Trigger

Auslöser bei:

• Änderungen in der Kopfhaltung oder Kopfbewegung.

• Hinweis: Nachdem Sie den Headtracking-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Headtracking-Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

Versuchs- und Rahmen-Trigger

Task Init Trigger

Auslöser bei:

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

Dieser Trigger passt gut zu den Aktionen Shuffle und Read From. Mit diesen Kombinationen können Sie Array-Einträge oder Datenrahmen beim Start der Aufgabe mischen und Subjekte einer Menge von Stimuli zuweisen, ohne mehrere Ereignisse erstellen zu müssen, um Stimuli oder Daten auszulesen.

Parameter: Keine

• Hinweis: Nachdem Sie den Task Init Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Task Init Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

Frame Init Trigger

Auslöser bei:

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

Dieser Trigger passt gut zu den Aktionen Shuffle, Read From und Draw Random Number. Mit diesen Kombinationen können diese Aktionen abgeschlossen werden, bevor der Rahmen erscheint, und es bleibt ein klarer Weg für andere Aktionen, die beginnen, während der Rahmen startet.

Hinweis: Verwenden Sie den Frame Init Trigger nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Trial Number oder Condition Number betreffen. Dies liegt daran, dass der Frame Init Trigger zwischen den Versuchen auftritt, sodass keine vollständig genaue Anzahl des bevorstehenden Versuchs oder der Bedingung angezeigt wird.

Parameter: Keine

• Hinweis: Nachdem Sie den Frame Init Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Frame Init Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

Hinweis zu Task- und Frame Init-Triggern: Da die Task- und Frame Init-Trigger auftreten, bevor die Aufgabe oder der Rahmen beginnt, werden während dieser Zeit erstellte Variablen zurückgesetzt, wenn die Aufgabe/der Rahmen tatsächlich startet. Eine Warnung wird angezeigt, wenn Sie dieses Ereignis verwenden:

Denken Sie daran, das Kontrollkästchen „Zurücksetzen beim Versuchsstart“ im Fenster der Variablenparameter zu deaktivieren, wenn Sie nicht möchten, dass die Variablenwerte zurückgesetzt werden.

Frame Start Trigger

Auslöser bei:

• Beginn des Rahmens

Parameter: Keine

• Hinweis: Nachdem Sie den Frame Start Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Frame Start Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

Frame End Trigger

Auslöser bei:

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

Parameter: Keine

• Hinweis: Nachdem Sie den Frame End Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Frame End Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

Variablenwert geändert Trigger

Variablenwert geändert

Auslöser bei:

• Der Wert einer Variablen ändert sich von seinem Startwert

Parameter:

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

• Hinweis: Nachdem Sie den Variablenwert geändert Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Variablenwert geändert Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

Medienobjekt Trigger

Medienobjekt Trigger

Früher bekannt als die separaten "Steuerung Audio/Video Trigger" und "Steuerung Objekt" Trigger.

Auslöser bei:

• Beginn, 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 Objekt, das im Rahmen vorhanden ist

• Ausführen bei: Wählen Sie den Untertyp des Triggers

  • Optionen für Audio- oder Videoobjekte:
    • 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
  • Optionen für Video-, Audio- oder Bildschirmaufnahmeobjekte:
    • Aufnahme beendet: Auslöser, wenn die Audioaufnahme gestoppt wurde
    • Upload abgeschlossen: Auslöser, wenn der Datei-Upload abgeschlossen ist
  • Optionen für Datei-Upload-Objekte:
    • Datei ausgewählt: Auslöser, wenn eine Datei ausgewählt wird
    • Upload abgeschlossen: Auslöser, wenn der Datei-Upload abgeschlossen ist
  • Optionen für Kamerasnapshot-Objekte:
    • Snapshot abgeschlossen: Auslöser, wenn die Kamera erfolgreich einen Snapshot aufgenommen hat
    • Upload abgeschlossen: Auslöser, wenn der Snapshot hochgeladen ist

• Hinweis: Nachdem Sie den Medienobjekt-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Medienobjekt-Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

API-Trigger

Wenn Sie Daten von einem externen Server in Labvanced senden oder kommunizieren müssen, können ‚API-Trigger‘ und ‚API-Aktionen‘ verwendet werden. Folgendes kann als Trigger verwendet werden:

• Websocket-Trigger
• OpenAI-Trigger
• PostMessage Empfangen

Websocket Trigger

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

Beim Klicken auf diese Option erscheinen die folgenden Elemente.

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

Für ein Beispiel, wie API-Trigger/Aktionen verwendet werden, sehen Sie sich diese Demo https://www.labvanced.com/page/library/51053 an, indem Sie die Option „Überprüfen“ im Dialogfeld auswählen.

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

• Hinweis: Nachdem Sie den WebSocket-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische WebSocket-Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

OpenAI Trigger

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

Das Auswählen dieser Option führt dazu, dass die folgenden Parameter angezeigt werden:

HINWEIS: Konsultieren Sie auch diesen walkthrough, in dem wir eine Studie Schritt für Schritt aufbauen, ChatGPT in eine Studie integrieren und diesen Trigger nutzen.

Im folgenden Beispiel wird der zugewiesene Datenrahmen als ‚df‘ bezeichnet, und das Ergebnis des ‚OpenAI Trigger‘ wird an diesen Datenrahmen angehängt. Dieser Datenrahmen muss zwei Spalten haben. Die erste Spalte wird die ‚Rolle‘ und die zweite Spalte die ‚Chat-Nachricht‘ angeben. Die Werte aus der Aktion werden automatisch an den hier verlinkten Datenrahmen angehängt.

Wenn Sie auch die ‚Send to OpenAI‘ Aktion, verwenden, müssen Sie denselben Datenrahmen dort verwenden, wie Sie hier angegeben haben.

• Hinweis: Nachdem Sie den OpenAI-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische OpenAI-Werte für verschiedene Aktionen mit dem Wertauswahlmenü. zu nutzen und darauf zu verweisen.

#### PostMessage Empfangen Trigger

Der `PostMessage Received` Trigger wird ausgelöst, wenn das laufende Experiment eine eingehende Nachricht von einer externen Quelle über die PostMessage-API des Browsers erhält. 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.](/content/learn/de/guide/events/postmessage-received-trigger.html)

* **Hinweis:** Nach der Auswahl des PostMessage Empfangen Triggers im Ereignissystem haben Sie die Möglichkeit, [trigger-spezifische PostMessage Empfangen Werte](#trigger-postmessage-received-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü.](#the-value-select-menu) zu verwenden und darauf zuzugreifen.


### Globale Trigger

Globale Trigger treten immer dann auf, wenn eine wesentliche Änderung im Experiment auftritt, d.h. wenn etwas "Globales" passiert, wie das Pausieren des Experiments oder ein Teilnehmer, der eine Mehrbenutzerstudie verlässt! Die folgenden Optionen sind als Globale Trigger aufgelistet:
* Experiment Pause / Fortsetzen
* Teilnehmer Verließ Mehrbenutzerstudie

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

#### Pausieren/Fortsetzen des Experiments

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/pause_trigger.webp" alt="Die Option, das Pausieren des Experiments als Trigger zu verwenden." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>

Nach der Auswahl dieses Triggers erscheint die folgende Ansicht, in der Sie die Art des Triggers weiter angeben können, ob er beim Pausieren oder Fortsetzen des Experiments ausgeführt werden soll:

 <p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_dialog.webp" alt="Dialogmenü für diesen globalen Trigger" width="50%">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_options.webp" alt="Verfügbare Optionen im globalen Trigger-Menü" width="50%">
</p>

* **Experiment Pausiert:** Der Teilnehmer pausiert (verlässt den Vollbildmodus) die Studie.
* **Experiment Fortgesetzt:** Der Teilnehmer setzt die Studie fort. Dieser Trigger funktioniert gut bei Augenverfolgungsstudien. Er kann verwendet werden, um den Teilnehmer zurück zu einem vorherigen Versuch oder Rahmen zu schicken, wenn er seinen virtuellen Kinnhalter verlassen hat.

* **Hinweis:** Nach der Auswahl des Pausieren/Fortsetzen des Experiments Triggers im Ereignissystem haben Sie die Möglichkeit, [trigger-spezifische Werte](#trigger-global-experiment-event-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü.](#the-value-select-menu) zu verwenden und darauf zuzugreifen.

#### Teilnehmer Verließ Mehrbenutzerstudie
Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, kann dies ebenfalls als Trigger für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, wirkt sich dies auf globaler Ebene auf das Experiment aus, da es anderen Teilnehmern verhindert, die Studie fortzusetzen.

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus.webp" alt="Die Option 'Teilnehmer verließ die Mehrbenutzerstudie' als Trigger in Labvanced" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus_dialog.webp" alt="Das Dialogfeld für den Trigger, wenn ein Teilnehmer die Mehrbenutzerstudie verlässt." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p>

* **Hinweis:** Nach der Auswahl des Teilnehmers, der die Mehrbenutzerstudie verlassen hat Trigger im Ereignissystem haben Sie die Möglichkeit, [trigger-spezifische Werte](#trigger-user-leaves-experiment-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü.](#the-value-select-menu) zu verwenden und darauf zuzugreifen.


## 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 aus Arrays zu lesen und zu schreiben 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, Rückruffunktionen verwenden und Aktionen innerhalb anderer (z.B. eine While-Schleife innerhalb einer If-Anweisung) verschachteln. Daher kann das Ereignissystem als grafische Programmierumgebung angesehen werden. In dieser Ansicht agieren Trigger als Funktionsaufrufe, während Aktionen die funktionale Logik beschreiben. Dieser Ansatz gewährleistet, dass fast jede experimentelle Logik ohne den Einsatz bestimmter programmatischer / syntaktischer Strukturen implementiert werden kann.

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

| Aktionskategorie <img width=200/>  | Aktionsoptionen  <img width=500/>| Beschreibung <img width=400/> | 
| :----: | -- | ----- | 
| [`Object Actions`](#object-actions)| <ul><li> [Eigenschaft des Objekts setzen](#set-object-property-action) </li> <li> [Medienobjekt steuern](#control-media-object-action) </li> <li> [Objekt kopieren](#copy-object-action) </li> <li> [Für jedes Objekt](#foreach-object-action) </li> </ul> | Objektaktionen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das innerhalb der Aufgabe existiert. |
| [`Variable Actions`](#variable-actions) | <ul><li> [Variable setzen / aufzeichnen](#set-record-variable-action) </li> <li> [In die Zwischenablage kopieren](#copy-to-clipboard-action) </li> <li>[Zufallszahl ziehen](#draw-random-number-action) </li> <li> [URL-Parameter abrufen](#get-url-parameter-action) </li> <li> [Von/Zum Gerät lesen/schreiben](#read-from-write-to-device-action) </li> <li> [Von/Zu gemeinsamen Variablen lesen/schreiben](#read-from-write-to-shared-variable-action) </li> <li> [Mathematik & Statistik](#math-statistics-action) </li> <li>[Variablen sofort aufzeichnen](#record-variables-instantly-action) </li> <li>[Gleitender Durchschnittsfilter](#moving-average-filter-action) </li> <li> [Variable verteilen](#distribute-variable-action) </li> </ul> | Jede Aktion, die von oder eine Variable aufzeichnet. |
| [`Array Actions`](#array-actions) | <ul><li> [Aus Array auswählen (lesen)](#select-read-from-array-action) </li> <li> [Array-Einträge hinzufügen / entfernen](#add-remove-array-entries-action) </li> <li> [Array-Eintrag ändern (ersetzen)](#change-replace-array-entry-action) </li> <li> [Array-Einträge mischen](#shuffle-array-entries-action)  </li> </ul> | Array-Operationen betreffen das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und deren Einträgen. | 
| [`Data Frame Operations`](#data-frame-operations) | <ul><li> [Von/Zu Datenrahmen lesen/schreiben](#read-from-write-to-data-frame-action) </li> <li> [Datenrahmeneinträge mischen](#shuffle-data-frame-entries-action)  </li> </ul> | Diese Aktionen sind relevant, wenn Sie in Ihrem Experiment mit .csv-Dateien (Datenrahmen) arbeiten. |
| [`Jump Actions`](#jump-actions) | <ul><li> [Springe zu](#jump-to-action) </li> <li> [Akzeptiere / Beende Sitzung](#accept-end-session-action) </li> <li> [Lehne ab / Beende Sitzung](#reject-end-session-action) </li> <li>[Redirect to URL](#redirect-to-url-action)</li></ul> | Ermöglicht es Ihnen, im Experiment zu navigieren, indem zu einem bestimmten Abschnitt gesprungen wird, sowie Teilnehmerabschnitte zu akzeptieren und abzulehnen. | 
| [`Control Actions`](#control-actions) | <ul><li>  [Anforderungsaktionen (If…Then)](#requirement-actions-if-then-else-if-action) </li><li> [Wiederholte Aktionen (While-Schleife)](#repeated-actions-while-loop-action) </li><li> [Verzögerte Aktionen (Zeit-Rückruf)](#delayed-actions-time-callback-action) </li><li> [Aktionsgruppe](#action-group) </li></ul> | Steueraktionen werden verwendet, um spezifische Sequenzen von Ereignissen auszuführen, wie if/then-Logik, Schleifen (wie das Abspielen eines wiederholten Tons oder das Blitzen eines Bildes) sowie um eine Verzögerung festzulegen, wann eine Aktion ausgeführt wird. | 
| [`API Actions`](#api-actions) | <ul><li> [PostMessage senden](#send-postmessage-action) </li><li> [An Websocket senden](#send-to-websocket-action) </li><li> [An OpenAI senden](#send-to-openai-action) </li></ul> | Bezieht sich auf API-spezifische Aktionen zum Senden von Daten an eine API. |
| [`Code Actions`](#code-actions) | <ul><li> [JavaScript ausführen](#run-javascript-action) </li> <li> [Globales CSS setzen](#set-global-css-action) </li></ul> |  Codeaktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten. 
| [`Paste Action`](#paste-action) | Einfügeaktion  | Ermöglicht es Ihnen, eine Aktion einzufügen, die Sie zuvor kopiert haben. |

### Objektaktionen 
Objektaktionen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das innerhalb der Aufgabe existiert. Es gibt mehrere Optionen für Objektaktionen:
* Eigenschaft des Objekts setzen
* Medienobjekt steuern
* Objekt kopieren
* Für jedes Objekt 

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

#### Eigenschaft des Objekts setzen Aktion
Mit der Aktion „Eigenschaft des Objekts 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.  

[Erfahren Sie mehr.](/content/learn/de/guide/events/set-object-property-action.html) 


#### Medienobjekt steuern Aktion

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

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

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-/Audio-Datei
        * Wiedergabe stoppen: Stoppt die Video-/Audio-Datei
        * Wiedergabe pausieren: Pausiert die Video-/Audio-Datei
        * JumpToTime: ermöglicht es, eine Zeit in Millisekunden anzugeben, zu der in der Audio-/Videodatei gesprungen werden soll
        * Stummschalten: schaltet den Ton des Objekts aus
        * Stummschaltung aufheben: stellt den Ton des Objekts wieder her
    * Optionen für Audio-, Video- oder Bildschirmaufnahmeobjekte:
        * Aufnahme starten: Startet eine neue (Audio-)Aufnahme
        * Aufnahme stoppen: Stoppt die (Audio-)Aufnahme
        * Upload starten: Beginnt, die Datei hochzuladen
        * Aufnahme löschen: Löscht die Aufnahme-Daten (Audio).
        * Wiedergabe starten: Beginnt 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
    * Optionen für Datei-Upload-Objekte:
        * Upload starten: startet den Upload-Prozess 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
    * Optionen für Kamerasnapshot-Objekte:
        * Kamera starten: Schaltet die Kamera des Teilnehmers ein
        * Kamera stoppen: Schaltet die Kamera des Teilnehmers aus
        * Upload starten: Beginnt, den Snapshot in das Experiment hochzuladen
        * Snapshot machen: Nimmt ein Bild mit der Kamera des Teilnehmers auf

Copy Object Action

Effekt: Kopiert ein Objekt und ersetzt die Notwendigkeit mehrerer separater Objekte und doppelter Ereignisse.

Parameter:

• Quelle: Wählen Sie das Objekt im Rahmen aus, das kopiert werden soll.
• Anzahl der Kopien: Geben Sie die Anzahl der Kopien des Quellobjekts ein.
• Neuen Elementnamen festlegen: Wählen Sie aus mehreren Parametern, um die Namen der Kopien zu bestimmen.
• Namen mit inkrementierendem Postfix zuweisen: Fügt dem Ende des neuen Elementnamens ein numerisches Tag hinzu, um die Kopien zu unterscheiden.
• Aktionssequenz: Ermöglicht die Auswahl (aus der üblichen Liste von Aktionen), was mit den Kopien geschehen soll. Wählen Sie "CurrentObject" als Ziel, um die Aktion auf alle Kopien anzuwenden.

ForEach Object Action

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

Parameter:

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

Variable Actions

Variable Aktionen werden verwendet, um Variablenwerte festzulegen oder zu erstellen, Werte aufzuzeichnen und zu definieren, inklusive Werte über Sitzungen hinweg.

Die folgende Tabelle bietet einen einführenden Überblick über alle in Labvanced verfügbaren Variablenaktionsoptionen. Jede von ihnen wird in den kommenden Abschnitten detaillierter beschrieben.

Variable Action Option	Beschreibung
Set / Record Variable	Schreiben oder Festlegen eines Variablenwerts
Copy to Clipboard	Kopiert einen Variablenwert in die interne Zwischenablage des Computers.
Draw Random Number	Zieht eine oder mehrere zufällige Zahl(en) und speichert sie in einer Variablen
Get URL Parameter	Speichert einen Wert aus der eindeutigen 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 Variable	Liest aus oder schreibt in eine Variable, die über Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jeden Einzelnen sein.
Math & Statistics	Führt eine mathematische Operation auf einer Eingangsvariable (Array) durch und speichert das Ergebnis in einer Ausgangsvariablen.
Record Variables Instantly	Erstellt eine Momentaufnahme aller Variablenwerte und sendet diese an den Labvanced-Server.
Moving Average Filter	Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) von einigen Eingaben und speichert das Ergebnis in einer neuen Variablen.
Distribute Variable	Sendet einen Wert an andere Teilnehmer. Der Wert wird in einer Variablen gespeichert.

Set / Record Variable Action

Mit der Set / Record Variable-Aktion können Sie einen Wert in eine Variable schreiben, indem Sie die Zielvariable auswählen oder erstellen und den Wert über das Auswahlmenü definieren. Es ist der Kernmechanismus zur Aufzeichnung von Verhaltensmaßnahmen und zur Steuerung von variablenbasierten Logik in Labvanced.

Erfahren Sie mehr.

Copy to Clipboard Action

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

Draw Random Number Action

Effekt: Zieht eine oder mehrere zufällige Zahl(en) und speichert sie in einer Variablen.

Parameter:

• Typ: Wählen Sie zwischen kontinuierlichen und diskreten Werten
• Verteilung: Wählen Sie zwischen normaler und gleichmäßiger Verteilung
• Mehrfache Ziehungen (boolean true/false): Wählen Sie, ob einmal oder mehrfach gezogen werden soll.
• Anzahl der Ziehungen: Wählen Sie die Anzahl der Ziehungen
• Min: Definieren Sie den Minimalwert für die gleichmäßige Verteilung
• Max: Definieren Sie den Maximalwert für die gleichmäßige Verteilung
• Mittelwert: Definieren Sie den Mittelwert für die normale Verteilung
• Standardabweichung: Definieren Sie die Standardabweichung für die normale Verteilung
• In Variablen speichern: Wählen Sie eine Variable aus, in der die Werte gespeichert werden.

Get URL Parameter Action

Effekt: Speichert einen Wert aus der eindeutigen URL des Teilnehmers.

Parameter:

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

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

Read from/Write to Device Action

Effekt: 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 darauf schreiben möchten.
• Wählen Sie die Variable aus, die gelesen oder geschrieben werden soll.

Anwendungsfall: Langzeit-/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.
• Zum Beispiel können Sie diese Aktion verwenden, um aufzuzeichnen, welche Bilder jedem Teilnehmer in Sitzung 1 präsentiert wurden, und sicherzustellen, dass verschiedene Bilder ihnen in Sitzung 2 präsentiert werden.
  • Erstellen Sie ein Array von Bildern und wählen Sie einige zufällig aus, um sie in jeder Sitzung zu präsentieren.
  • Schreiben Sie ins 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 in der zweiten Sitzung ausgewählt werden.

Read from/Write to Shared Variable Action

Effekt: Liest aus oder schreibt in eine Variable, die über Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jeden Einzelnen sein.

Parameter:

• Wählen Sie die Variable zum Synchronisieren aus. Muss entweder skalar oder ein Array sein.
• Erweiterte Optionen
  • Schlüssel für die Speicherung: Wählen Sie den Namen einer Variablen, die als Schlüssel zum Zugriff auf die synchronisierte Variable dient.
  • Lese- oder Schreibmethode:
    • Gelesene, modifizierte und dann geschriebene gemeinsame Variable: Liest die Variable, ändert sie und sendet sie dann an die Studie.
    • Nur den gemeinsamen Wert vom Server lesen: Ruft die innerhalb der Studie geteilte Variable auf, ändert jedoch nichts.
    • Nur Variable auf den Server schreiben: Ändert die gemeinsame Variable, wird jedoch nicht den Teilnehmern angezeigt.
    • Werte zwischen verschiedenen Teilnehmern teilen (nicht nur zwischen Sitzungen): Ermöglicht den Teilnehmern, die synchronisierten Variablenwerte der anderen Teilnehmer ü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 gemeinsamen/synchronisierten Variable aus der Liste aller verfügbaren Aktionen geschieht.

Anwendungsfall: Langzeit-/Multi-Sitzungsstudien

• Mit dieser Aktion können teilnehmerspezifische Daten von Sitzung zu Sitzung übertragen und über Sitzungen hinweg zwischen den Teilnehmern geteilt werden.
• Zum Beispiel können Sie diese Aktion verwenden, um eine Punktzahl in einem Test aufzuzeichnen und dann dem Teilnehmer zu ermöglichen, seine Punktzahl mit dem Durchschnitt der anderen Teilnehmer, die den Test abgeschlossen haben, zu vergleichen.
• Ein weiteres Beispiel (ähnlich der Read from/Write to Device Action) besteht darin, dass Teilnehmer 5 Bilder aus einem Array auswählen, eine Aufgabe ausführen und diese 5 Bilder dann 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.

Math & Statistics Action

Effekt: Führt eine mathematische Operation auf einer Eingangsvariable (Array) durch 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, Standardabweichung 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.

Record Variables Instantly Action

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

Parameter: Keine

Moving Average Filter Action

Effekt: Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) eines bestimmten Inputs 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 das gleiche Gewicht haben.
  • Linear gewichteter gleitender Durchschnitt: Gewichtung der Proben, sodass die Gewichte der Proben linear abnehmen.
  • Exponential gleitender Durchschnitt: Gewichtung der Proben, sodass die Gewichte der Proben exponentiell abnehmen.
• Anzahl der Proben: Bestimmt, wie viele Proben pro Schritt verwendet werden.
• Input: Wählen Sie eine Eingangsvariable (Array), auf der der gleitende Durchschnitt berechnet wird.
• Output: 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 den Teilnehmern geteilt werden, wodurch Informationen (einschließlich Stimuli-Standorte und Änderungen) auf den Bildschirmen der Teilnehmer widergespiegelt werden. Weitere Informationen zur Distribute Variable Action finden Sie in einer speziellen 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 Distribute Variable Action-Dialogfeld aussieht, wenn alle Menüelemente ausgefüllt sind. In diesem Beispiel wird die Distribute Variable-Aktion verwendet, um einen Chat zwischen zwei Teilnehmern zu erstellen, indem der Wert einer Variablen aus einem Eingabefeldobjekt verteilt wird.

Sehen Sie sich diese Demo an, die die Distribute Variable- und Chatbox-Funktionen enthält: Image Description Task with Chat Add-On.

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

Menüelement	Menübereich	Optionen und Beschreibung der Distribute Variable Action
Distribute value to		Wählen Sie, 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, in der der Wert gespeichert wird. Wert: Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.
Block		Wenn aktiviert, kann die Zielvariable geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist.
Rate Limit Strategy		Die Ratenbegrenzungsstrategie ist ein Mittel, um Ihr Experiment vor einer Überlastung des Servers zu schützen, und fungiert als Vorsichtsstrategie zur Steuerung der Rate, mit der Anfragen (z. B. Aktualisierungen über die Distribute Variable) an den Server gesendet werden. Die folgenden Strategieoptionen sind verfügbar: Debounce: Wenn diese Aktion mehr als einmal innerhalb eines Zeitfensters von 100 ms ausgeführt wird, werden neue Servernachrichten „debounced“ (nur die aktuellste Nachricht wird nach einem Intervall von 100 ms ohne Ausführung dieser Aktion gesendet). Throttle: Wenn diese Aktion mehr als einmal innerhalb eines Zeitfensters von 100 ms ausgeführt wird, werden neue Nachrichten gedrosselt (d. h., nachdem 100 ms seit dem letzten Senden der Nachricht vergangen sind, wird nur die aktuellste Nachricht verteilt). Discard: Wenn diese Aktion mehr als einmal innerhalb eines Zeitfensters von 100 ms ausgeführt wird, werden neue Nachrichten innerhalb dieses 100 ms-Fensters verworfen. Queue: Wenn diese Aktion mehr als einmal innerhalb eines Zeitfensters von 100 ms ausgeführt wird, werden neue Variablenwerte in einer Warteschlange angefügt (bis zu einer maximalen Warteschlangengröße von 10 Nachrichten).

Array Actions

Select (Read) from Array Action

Effekt: Liest eine Variable aus einem Array und speichert diesen Wert in einer Skalaren Variablen.

Parameter:

• Array-Variable: Eingangsarray zum Auslesen des Wertes.
• Indextyp: Bestimmt, welcher Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für den Lesevorgang. Geben Sie in diesem Fall die Position an, von der die Informationen ausgelesen werden sollen (1-basiert).
  • Variabel: Verwenden Sie eine numerische Variable als Index für den Lesevorgang. Wählen Sie in diesem Fall eine skalare numerische Variable aus, um die Position des Auslesevorgangs zu bestimmen.
  • Ende des Arrays: Auslesen vom Ende des Arrays.
• Ausgangsvariable: Wählen Sie eine skalare Variable aus, in der der ausgelesene Wert gespeichert wird.

Add / Remove Array Entries Action

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

Parameter:

• Array-Variable: Array-Variable, in der die Hinzufügen- oder Entfernen-Operation ausgeführt werden soll.
• Indextyp: Bestimmt, welcher Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für die Einfüge-/Löschoperation. Geben Sie in diesem Fall die Array-Position an, 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. Wählen Sie in diesem Fall eine skalare numerische Variable aus, um zu bestimmen, wo die Einträge eingefügt/ gelöscht werden sollen.
  • Ende des Arrays: Einfügen/ löschen am Ende des Arrays.
• Nr. der zu löschenden Einträge: Entfernt die Array-Einträge (bevor neue Einträge eingefügt werden) 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) aus, die an der definierten Indexposition zur Array-Variable hinzugefügt werden.

Change (Replace) Array Entry Action

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

Parameter:

• Array-Variable: Array-Variable, in der ein Wert geändert werden soll.
• Indextyp: Bestimmt, welcher Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für die Ersetzungsoperation. Geben Sie in diesem Fall die Array-Position an, die geändert werden soll (1-basiert).
  • Variabel: Verwenden Sie eine numerische Variable als Index für die Ersetzungsoperation. Wählen Sie in diesem Fall 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 enthält.

Shuffle Array Entries Action

Effekt: Mischung der Einträge/Reihenfolge innerhalb eines Arrays.

Parameter: Keine

Data Frame Operations

Read from / Write to Data Frame Action

Effekt: Liest Werte aus einem Datenrahmen oder schreibt Werte in einen Datenrahmen und speichert sie in einer neuen Array-Variablen.

Parameter:

• Datenrahmenvariable: Wählen Sie die Variable des Datenrahmens zum Auslesen aus.
• Lesen oder Schreiben: Wählen Sie, ob aus dem ausgewählten Datenrahmen gelesen oder in den ausgewählten Datenrahmen geschrieben werden soll.
• Zeilen- oder Spaltenweise: Wählen Sie, wie die Daten gelesen werden sollen.
• Indextyp: Wählen Sie den Typ der Indexvariable aus, die verwendet wird, um den Datenrahmen zu lesen. 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.

Shuffle Data Frame Entries Action

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

Parameter:

• Wählen Sie den Datenrahmen, der gemischt werden soll.
• Wählen Sie, ob der Datenrahmen zeilen- oder spaltenweise gemischt werden soll.

Jump Actions

Jump To Action

Effekt: "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:

• Jump To: Bestimmt, wo im Experiment gesprungen werden soll.
  • Nächster 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.
  • Vorheriger Frame: Springt zum vorherigen Frame. Wenn keine vorherigen Frames vorhanden sind, wird die Aktion nicht ausgeführt.
  • Spezifischer Frame: Springt zu einem spezifischen Frame. Benutzer wählen direkt den Frame aus, zu dem gesprungen werden soll.
  • Spezifischer Versuch: Springt zu einem spezifischen Versuch. Benutzer wählen direkt die Versuchszahl aus, zu der gesprungen werden soll.
  • Spezifische Aufgabe: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Benutzer wählen direkt die Aufgabe aus, zu der gesprungen werden soll.
  • Spezifischer 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, überprüft das Experiment, 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 neuesten Versuchsdatensätze gespeichert (an den Server gesendet), bevor die Studie verlassen wird.
• Show default ending page: Wenn aktiviert, wird der standardmäßige Labvanced-Endbildschirm angezeigt. Wenn dies eine Crowdsourcing-Sitzung ist (ein Crowdsourcing-Link verwendet wurde), wird der Entschädigungscode dem Teilnehmer angezeigt. Wenn deaktiviert, wird das Experiment nach dem Anzeigen des aktuellen Frames beendet und zeigt nicht den standardmäßigen Endbildschirm mit Entschädigungscode an.

Reject/End Session Action

Effect: Beendet die Aufzeichnungssitzung, kennzeichnet die Daten des Teilnehmers nicht als vollständig und zeigt nicht den standardmäßigen Endbildschirm mit Entschädigungscode an.

Bei Verwendung dieser Aktion, um die Daten eines Teilnehmers abzulehnen, sollten die Benutzer eine entsprechende Nachricht an die Teilnehmer anzeigen, um den Grund zu erklären, warum sie nicht für ihre Zeit belohnt werden.

Parameters: None

Redirect to URL Action

Effect: Leitet den Teilnehmer zu einer bestimmten URL um.

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. Jedes If / Else-If-Statement besteht aus verschachtelten AND / OR-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 "Then" ausgeführt. Siehe Requirement Action für eine detaillierte Anleitung zu dieser Aktion für sich genommen, einschließlich eines bearbeiteten Role_Id-Beispiels.

Parameters:

• Add Requirement: Fügen Sie eine neue Anforderung zu einer Aussage hinzu. Das "Wert-Auswahl"-Menü wird auf beiden Seiten angezeigt, um einen logischen Vergleich anzustellen. In der Mitte der Aussage können Sie wählen, wie beide Seiten verglichen werden sollen (z. B. gleich, kleiner als, ungleich usw.).
• Add OR Group: Nur eine der 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 "Aktion hinzufügen"-Symbol hinzugefügt werden. Die Aktionssequenz wird nur ausgeführt, wenn die Anforderungen 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 Aussage ausgeführt werden. Wenn eine If / Else-If-Aussage positiv bewertet wird (wahr zurückgibt), werden die Aktionen im Then-Block ausgeführt und der Rest der Anforderungsaktion ü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-Case 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 spezifiziert werden, sodass die Schleifenaufruf gestoppt wird.

Parameters:

• Execution Type: Wählen Sie zwischen sofortiger Ausführung oder zeitgesteuerter Ausführung.
  • Execute complete loop: Dies wird die Schleife kontinuierlich ausführen, bis die Stoppbedingung erfüllt ist.
  • Execute every ... ms: Dies wird die Schleife mit definiertem Intervall ausführen (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 Möglichkeit, einen numerischen Integer-Wert für die Anzahl der Male festzulegen, 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 dies die Schleife sofort ausführen. Wenn deaktiviert, wird die Schleife beim nächsten Ausführungsintervall gestartet.
• Allow multiple starts (true / false): Wenn aktiviert, können mehrere Instanzen der Schleife parallel gestartet werden. Wenn deaktiviert, kann nur eine Instanz der Schleife gleichzeitig ausgeführt werden.
• Enable stop condition (true / false): Wenn aktiviert, kann eine Stoppbedingung für die Schleife spezifiziert werden.
• Stop Condition: Die Stoppbedingung kann verwendet werden, um einen logischen Ausdruck anzugeben, wann die Schleifenaufruf gestoppt werden soll. Ähnlich wie bei den If / Else-If-Anweisungen kann man AND-Gruppen, OR-Gruppen und Anforderungen für den logischen Vergleich kombinieren.
• Action Sequence: Die Aktionssequenz listet alle Aktionen auf, die bei jeder Iteration der Schleife ausgeführt werden. Eine neue Aktion kann über das "Aktion hinzufügen"-Symbol 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 fester Verzögerung oder variabler Verzögerung.
  • Fixed Delay: Die Aktionen werden nach einer festen Verzögerung ausgeführt.
  • Variable Delay: Die Aktionen werden nach einer Verzögerung ausgeführt, die in einer (numerischen) Variablen angegeben ist.
• 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 "Aktion hinzufügen"-Symbol 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 erhalten, aber auch, wenn Sie mehrere Aktionen gleichzeitig 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 verwendbar 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, unter Verwendung der postMessage-API des Browsers.

Learn more.

Send to Websocket Action

Wenn Sie diese Aktion auswählen, erscheinen die folgenden Optionen:

Das obige Beispiel und die vollständige Veranstaltungsstruktur können hier aufgerufen werden: https://www.labvanced.com/page/library/51053, indem Sie auf „Untersuchen“ klicken.

Für weitere Informationen zum 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 für diese Option Ihr API-Schlüssel unter Settings im Tab Special Features aufgeführt sein muss.

Die folgenden Optionen erscheinen, wenn Sie dieses Ereignis auswählen:

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

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

HINWEIS: Bitte beziehen Sie sich auch auf diesen Durchgang, in dem wir eine Studie Schritt für Schritt aufbauen, ChatGPT in eine Studie integrieren und diese Aktion nutzen.

Hier ist eine detailliertere Erklärung der Felder, die unter der Aktion "Send to OpenAI" enthalten sind:

Menüpunkt	Menübereich	Optionen für die Aktion 'Send to OpenAI'
Model Type		Gibt das AI-Modell an, das verwendet wird.
Chat History Dataframe		Verlinkung zu einer Datenrahmenvariable mit zwei Spalten. 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. Der Datenrahmen kann auch mit Datenrahmenaktionen bearbeitet werden. Für weitere Informationen siehe die Dokumentation von OpenAI.
Insert Message ‘+’		Durch Klicken darauf 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 hochrangige ChatGPT-System user: der Teilnehmer assistant: bezieht sich auf eine spezifische Unterrolle, die im System erstellt wurde

Da sich OpenAI 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 stehen im Menü 'Code Aktionen' zur Verfügung:

• 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/setzen, indem Sie benutzerdefiniertes JavaScript eingeben, das als Aktion ausgeführt wird, wenn es ausgelöst wird.

Wenn die oben genannte Aktion 'JavaScript ausführen' ausgewählt wird, sehen Sie einen Bereich (einen Code-Editor), in den der JavaScript-Code geschrieben werden sollte, 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 auswählen:

Ein Beispiel für die Verwendung der Aktion 'Globales CSS festlegen' wäre die Änderung der Hintergrundfarbe der Studie, 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. Es ermöglicht Ihnen, schneller zu arbeiten, wenn Sie Ihr Experiment entwerfen, sodass Sie nicht immer wieder dieselben Elemente auswählen müssen. Wenn Sie beispielsweise ein Ereignis haben, das einem bereits vorhandenen ähnelt, können Sie es einfach kopieren, einfügen und ändern, anstatt es von Grund auf neu aufzubauen.

Das Wertauswahlmenü

Bei der Arbeit mit bestimmten Ereignissen wird ein Stiftsymbol angezeigt. 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 leistungsfähige 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 der Aktion Setzen / Aufzeichnen von Variablen, der Aktion Setzen von Objektattributen und der Anforderung (Wenn... Dann) Aktion, wie unten gezeigt.

Durch Klicken auf das Stiftsymbol wird ein Dropdown-Menü geöffnet, in dem Sie den Wert angeben, der abgerufen 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, Konstante Werte, Variable, Rahmen / Aufgabe / Option und Operationen) fort, die jeweils ihre eigenen Optionen haben. Diese werden weiter unten beschrieben.

Das obige Bild zeigt, wie das Wertauswahlmenü aussieht, wenn ein Maus-Trigger verwendet wird. Wie Sie sehen können, beginnt das erste Menüelement links mit einer trigger-spezifischen Kategorie und geht dann zu den anderen 5 Kategorien (Aktuelle Zeit usw.) über.

Menüoptionen

Die nachstehende Tabelle erklärt die Kategorien und Optionen weiter:

Aktuelle Zeit Werte

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

Die folgenden Optionen stehen zur Verfügung:

• UNIX-Zeitstempel
• Zeit seit Beginn des Rahmens

Aktuelle Zeit: UNIX-Zeitstempel

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

Aktuelle Zeit: Zeit seit Beginn des Rahmens

Dieser Wert erfasst die Menge an Zeit, die seit Beginn des Rahmens vergangen ist. Dies entspricht meist der Reaktionszeit.

Konstante Werte

Weisen Sie konstante Werte basierend auf dem benötigten Variablentyp zu, wie Zeichenfolge oder numerisch. Diese werden manchmal in Kombination mit anderen Optionen wie Arithmetic verwendet, um Zähler zu erstellen.

Die folgenden Optionen stehen zur Verfügung:

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

Konstante: Zeichenfolge

Weist einen Zeichenfolgen- / Textwert zu.

Konstante: Numerisch

Weist einen numerischen / Zahlenwert zu.

Konstante: Boolesch

Weist einen Wert von wahr oder falsch zu.

Konstante: Kategorial

Weist einen Wert für die Ebene zu (hauptsächlich für Faktoren).

Konstante: Datum

Weist einen Datumswert zu.

Konstante: Zeit

Weist einen Zeitwert zu.

Konstante: Farbe

Weist einen Farbwert (hex-String) zu.

Variablenwerte

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 stehen zur Verfügung:

• Variable auswählen
• Wert aus Array auswählen
• Wert aus Datenrahmen auswählen

Variable auswählen

Ermöglicht das Auswählen und Verweisen auf eine Variable.

Wert aus Array auswählen

Ermöglicht das Auswählen eines Wertes aus einem Array.

Wert aus Datenrahmen auswählen

Ermöglicht das Auswählen eines Wertes aus einem Datenrahmen, den Sie erstellt haben.

Rahmen / Aufgabe / Objektwerte

Ermöglicht das Abrufen von Werten, die mit den Eigenschaften von Objekten, dem Rahmen, der Augenverfolgung (sofern 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 angegebene Änderungen an Ihren Variablen vorzunehmen, z. B. um Variablenwerte zu kombinieren, Zeichenfolgen so zu transformieren, dass sie alle in Kleinbuchstaben sind, oder mathematische Operationen auszuführen.

Die folgenden Optionen stehen zur Verfügung:

• Arithmetik
• String-Operation
• Mathematische Operation

Arithmetik

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

Im Wesentlichen ermöglicht die arithmetische Operation das Ausführen von Operationen auf mehreren Werten.

Beim Auswählen dieser Option erscheint ein zusätzliches Stiftsymbol (d. h. Wertauswahlmenü) sowie eine Liste von Operationen, wie z. B. Addition.

Die Werte können durch Verwendung dieser 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.

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

String-Operation

Mathematische Operation

Führt eine mathematische Operation an einem Skalarwert durch.

Trigger-spezifische Werte

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

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

Nachfolgend eine Tabelle aller Arten von trigger-spezifischen Werten, die in Labvanced zu finden sind, gefolgt von einer detaillierten Erläuterung jeder Option.

Name	Wertoptionen - Übersicht
Trigger (Mouse)	Maus X Maus Y Maus [X,Y] Array Stimulusname Stimulusinfo Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Keyboard)	Id der Taste Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Button Bar)	Stimulusname Stimulusinfo Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Enter On Input)	Id der Taste Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Scroll)	Stimulusname Stimulusinfo Scroll-Position X Scroll-Position Y Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Gamepad/ Joystick)	Gamepad-Geräte-ID Gedrückte Tasten (Array) Gedrückte oder gehaltene Tasten (Array) Freigegebene Tasten (Array) Achsen (Array) Gamepad-Zeitstempel (Unixzeit) Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Eyetracking Gaze)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulusname Stimulusinfo Kameraaufnahmezeit T Blickvertrauensniveau C Koord. + Zeit [X,Y, T] Array Koord. + Zeit + Vertrauen [X,Y, T,C] Array Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Eyetracking Fixation)	Fixationszentrum X Fixationszentrum Y Fixationsdauer Fixationsstartzeit Fixationsendzeit Fixationsstreuung Stimulusname Stimulusinfo [X,Y, Dauer, Start, Ende, Streuung] Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Head Tracking)	Kameraaufnahmezeit T Gesichtsmaschendatenrahmen Kopfbewegung Kopfneigung Kopfneigung Kopfposition [X,Y, T] Array Nasenposition [X,Y, T] Array Nasenvektor [X,Y, Z, T] Array Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (On Task Initialization)	Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (On Frame Init)	VersuchNr Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (on Frame Start)	Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (On Frame End)	Gesamtzeit des Rahmens Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Variable Value Changed)	Neuer Wert in der Variablen Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Media Object Trigger)	Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Websocket Trigger)	Nachricht Daten Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (OpenAI Trigger)	Chat GPT Antwort Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (PostMessage Received)	Nachrichteninhalt Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (Global Experiment Event)	Gesamtzeit des Rahmens Grund für globales Ereignis Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)
Trigger (User Leaves Experiment)	Verbleibende Anzahl der Teilnehmer Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (von Rahmenbeginn)

Trigger (Maus) Werte

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

Trigger (Tastatur) Werte

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

Trigger (Schaltflächenleiste) Werte

Wenn ein Schaltflächen-Klick-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen aufgerufen werden:

Trigger (Enter bei Eingabe) Werte

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

Trigger (Scrollen) Werte

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

Trigger (Gamepad/Joystick) Werte

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

Trigger (Eyetracking-Blick) Werte

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

Erfahren Sie mehr: Siehe die spezielle Eyetracking-Blick-Trigger Seite zum Aktivieren des Eyetrackings, Aufzeichnen von Blickdaten und praktischen Beispielen.

Trigger (Eyetracking-Fixation) Werte

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

Mehr erfahren: Siehe die dedizierte Eyetracking Fixation Trigger Seite zum Aktivieren der Fixationsdetektion, Erfassen von Fixationsdaten und praktischen Beispielen.

Trigger (Kopfverfolgung) Werte

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

Trigger (Bei Aufgabeninitialisierung) Werte

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

Trigger (Bei Frame-Initialisierung) Werte

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

Trigger (Bei Frame-Beginn) Werte

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

Trigger (Bei Frame-Ende) Werte

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

Trigger (Wert der Variablen geändert) Werte

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

Trigger (Media Object Trigger) Werte

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

Trigger (Websocket-Trigger) Werte

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

Trigger (OpenAI Trigger) Werte

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

Trigger (PostMessage Received) Werte

Wenn ein PostMessage Received trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen abgerufen werden:

Trigger (Global Experiment Event) Werte

Wenn ein Pause / Resume Experiment Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen abgerufen werden:

Trigger (Teilnehmer verlässt Experiment) Werte

Wenn ein Participant Left Multiuser Study Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen abgerufen werden: