Ereignissystem

Beschreibung

Das Ereignissystem ist entscheidend für jede Studie. Es ist die Möglichkeit, Werte festzulegen, die aufgezeichnet werden, das Experiment fortschreiten zu lassen und Aufgaben zu erstellen. Benutzer können ein Ereignissystem erstellen, um alle Funktionen, Logik und Interaktionen in einer Aufgabe auszuführen. Ein Ereignis fungiert oft als Mediator zwischen Objekten und Variablen.

Das Ereignissystem besteht aus Triggern und Aktionen. Hier legen Sie Regeln fest, wie "wenn dies geschieht" (Trigger), dann "tu dies" (Aktion). Zum Beispiel: Wenn ein Teilnehmer auf ein bestimmtes Bild klickt (Trigger), dann zeigen Sie ein anderes, zufälliges Bild an (Aktion).

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

Ereignis erstellen - Überblick

Ereignisse werden im Task-Editor 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 auftreten sollen, oder durch Klicken auf + Trial Event, welches das Ereignis auf alle Frames anwendet, erstellt werden. Alle bestehenden Ereignisse werden in einer Listenansicht im rechten Seitenbereich angezeigt. Ereignisse werden auf Frame-Ebene definiert und können für jeden Frame separat/spezifisch oder dupliziert/dasselbe auf jedem Frame über einen Versuch hinweg sein.

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

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 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 wird, werden die Einzelheiten im unteren rechten Bereich (Ereigniseigenschaften) angezeigt. Für eine bessere Ü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 Tastatureingabe, eine Änderung einer Variablen, der Start einer Videodatei oder viele andere Dinge sein. Alle Trigger und deren Einstellungen / Parameter werden in der folgenden Liste erklärt:

Trigger-Kategorie	Trigger-Optionen	Beschreibung
Benutzereingabe-Trigger	Maus-Trigger Tastatur-Trigger Button-Klicks Eingabe mit Enter Scroll-Trigger Gamepad-/Joystick-Trigger	Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der manuell durch den Benutzer/Teilnehmer aktiviert werden kann, indem er etwas wie das Bewegen der Maus, das Klicken auf ein Tastaturelement, Scrollen usw. tut.
Physiologische Signal-Trigger	Augenverfolgung-Blick Augenverfolgung-Fixation Kopfverfolgung	Physiologische Signal-Trigger treten auf, wenn ein spezifisches physiologisches Eingangsereignis erfasst wird, wie das Blicken auf ein bestimmtes Element oder Veränderungen der Kopfbewegungen.
Versuchs- und Frame-Trigger	Task Init Frame Init Frame Start Frame End	Diese Trigger treten bezüglich der experimentellen Versuche und Frames auf, wie z.B. wenn ein Frame beginnt oder endet.
Änderung des Variablenwerts Trigger	Variable (Wert geändert)	Ein Trigger für das Ereignis tritt auf, wenn sich der Wert einer bestimmten Variablen ändert.
Medienobjekt-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-Trigger	Websocket-Trigger Open AI Trigger	Dies sind Trigger, die auftreten, wenn Daten von einer API empfangen werden.
Globale Trigger	Experiment pausieren / fortsetzen Teilnehmer hat Multiuser-Studie verlassen	Globale Trigger beziehen sich auf größere Änderungen an einem Experiment, wie z.B. wenn es pausiert wird oder ein Teilnehmer eine Multiuser-Studie verlässt.

Benutzereingabe-Trigger

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

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

Benutzereingabe-Trigger-Option	Übersicht
Maus-Trigger	Jede Mausbewegung kann als Trigger verwendet werden, um ein Ereignis zu initiieren, wie z.B.: Scrollen, Klicken, Schweben usw. Sie können auch bestimmte Elemente oder Ziele mit einem Trigger verknüpfen. Zum Beispiel wird ein Mausklick nur als Trigger verwendet, wenn auf ein bestimmtes Bild geklickt wird.
Tastatur-Trigger	Jeder Tastendruck kann als Trigger verwendet werden, um ein Ereignis zu initiieren. Sie können bestimmte Buchstaben oder Zahlen der Tastatur als Trigger festlegen.
Button-Klicks	Schaltflächenobjekte, die in Labvanced erstellt wurden, können als Trigger verwendet werden, um Ereignisse zu initiieren.
Eingabe mit Enter	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 Textfeldbereichen einzureichen.
Scroll-Trigger	Dieser Trigger tritt auf, wenn der Teilnehmer scrollt. Sie können die x- oder y-Richtungen des Scrollens sowie über welche Elemente das Scrollen erfolgt, um als Ereignis-Trigger verwendet zu werden, angeben.
Gamepad-/Joystick-Trigger	Dieser Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimentellen Design als Eingabegerät zur Aufzeichnung von Daten zu verwenden.

Maus-Trigger

Die Option „Maus-Trigger“ ist ein sehr beliebter Ereignis-Trigger, da sie ein Ereignis basierend auf jeder Mausinteraktion auslöst, z.B.: die Maus nach oben / unten bewegen, klicken, über ein bestimmtes Objekt schweben, ein bestimmtes Objekt verlassen oder jede Bewegung!

Das folgende Beispiel zeigt einen „Maus-Trigger“, der auftritt, wenn ein „Klick“ durch den „Linken“ Mausklick auf das „Ziel“-Objekt namens „Image_1“ ausgeführt wird:

Im Folgenden finden Sie eine vollständige Übersicht über die Optionen, die Sie beim Arbeiten mit Maus-Triggern haben:

Menüpunk	Menübereich	Maus-Trigger-Optionen und -Spezifikationen
Aktion Dropdown-Liste:		Die folgenden Maus-Trigger-Optionen sind aus der Dropdown-Liste verfügbar: Klick: Ausgelöst durch einen Mausklick PressDown: Ausgelöst durch die Maustaste nach unten PressUp: Ausgelöst durch die Maustaste nach oben Hover: Ausgelöst, indem man über ein Objekt fährt Leave: Ausgelöst, indem man von einem Objekt wegfährt Move: Ausgelöst durch jede Mausbewegung
Schaltfläche Dropdown-Liste:		Links: Ausgelöst durch die linke Maustaste Rechts: Ausgelöst durch die rechte Maustaste
Ziele Optionen:	Im obigen Beispiel ist „Image_1“ das Ziel des Button-Klicks, das das Ereignis auslösen wird. Mehrere Ziele können hinzugefügt werden, indem Sie auf die Option ‘+Add Target’ am Ende klicken.	Wenn Sie ein Ziel angeben, sind die folgenden Optionen verfügbar: Trigger auf Frame-Hintergrund: Der Maus-Trigger kann aktiviert werden, ohne auf ein Objekt oder Element zu klicken. Beliebiges Element: Der Maus-Trigger kann aktiviert werden, wenn auf irgendein Element im Frame geklickt wird. Ziele hinzufügen: Wählen Sie die spezifischen Elemente aus, die angeklickt werden müssen, um den Trigger zu aktivieren.

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

Tastatur-Trigger

Die Option „Tastatur-Trigger“ ist eine weitere beliebte Möglichkeit, ein Ereignis auszulösen. Im Wesentlichen kann jeder Eingabe von der Tastatur als Trigger verwendet werden. Dazu gehören: Drücken, Halten oder Loslassen einer Taste.

Im folgenden Beispiel wird der Trigger als Tastaturdruck festgelegt, der auftritt, wenn die angegebenen Zielnumerischen Werte (0, 2 oder 6) gedrückt werden:

Im Folgenden finden Sie eine vollständige Übersicht über die Tasten und Optionen, die Sie beim Arbeiten mit Tastatur-Triggern haben:

Menüpunk	Menübereich	Tastatur-Trigger-Optionen
Aktion Dropdown-Liste:		Dies sind die verfügbaren Tastaturaktionsoptionen: PressKey: Ausgelöst durch das Drücken einer Taste (Taste ist gedrückt) Press ODER Halte die Taste: Auslöst, wenn entweder die Taste gedrückt oder gehalten wird ReleaseKey: Ausgelöst durch das Loslassen der Taste Hinweis: Eine Taste muss losgelassen werden, bevor sie erneut als Trigger „auslösen“ kann.
Tasten welche Taste das Ereignis auslöst		Welche Taste als Trigger verwendet wird, wird festgelegt, indem Sie hier die Optionen auswählen, indem Sie +Add: klicken Pfeile: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben des englischen Alphabets Sonder: Sondertasten (Enter, Leertaste, Steuerung, Tab, Umschalt) F-Tasten: F1 bis F10 Beliebige Taste: jede dieser Tasten ist akzeptabel Sie können mehrere Tastatur-Trigger hinzufügen, indem Sie erneut auf die Schaltfläche +Add: klicken.
Zusätzliche Optionen		Die Option NumPad-Tasten aktivieren ermöglicht es, dass die Zifferntasten als Trigger innerhalb des Experiments verwendet werden können. Für die Option erlaubt Ereignisweitergabe: Wenn mehrere Ereignisse denselben Tastatur-Trigger haben, dann lösen alle aus, ohne dass es passiert. Nur das erste wird ausgelöst, und die Ereignisausführung wird gestoppt, nachdem das erste Ereignis abgeschlossen ist.

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

Button-Klick-Trigger

Wenn Sie ein Button- oder Navigationsobjekt im Editor platziert haben, können Sie diese als Teil eines Ereignisses nutzen, wobei das Klicken auf den Button als Trigger für eine Aktion fungiert.

Wenn Sie diesen Trigger auswählen, wird folgendes Menü angezeigt, in dem Sie angeben können, welcher spezifische Button als Trigger fungieren soll:

Hier ist ein genauerer Blick auf die enthaltenen Elemente:

Menüpunk	Menübereich	Button-Klick-Trigger-Optionen
Ziel: +Set Target		Auswahl eines Schaltflächenelements als Ziel
Button: Option		Geben Sie an, welcher spezifische Button im Frame verwendet wird

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

Eingabe mit Enter-Trigger

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

Parameter:

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

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

Scroll-Trigger

Trigger auf: Die Bildlaufleiste, das Scrollen auf dem Trackpad oder das Scrollrad der Maus wird auf ein bestimmtes Element angewendet.

Parameter:

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

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

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

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

Gamepad-/Joystick-Trigger

Der Gamepad-/Joystick-Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimentellen Design als Eingabegerät zur Aufzeichnung von Daten zu verwenden. Hinweis: Denken Sie daran, diese Option unter dem Tab Studien Einstellungen in der ‘Experiment Funktionen’ Spalte zu aktivieren.

Nach der Auswahl dieses Trigger wird folgendes Dialogfeld angezeigt.

Nachdem Sie Ihr Gamepad angeschlossen haben, können Sie angeben, welche spezifischen Tasten als Trigger verwendet werden sollen. Bei Drücken der bestimmten Taste wird deren ID angezeigt.

Im folgenden Beispiel bezieht sich die 2 auf die ◎ Taste und 3 auf die ▵ Taste. Hinweis: Es ist wichtig zu erwähnen, dass es einige Unterschiede zwischen Gamepads gibt, wie die Zuweisung von Tasten-IDs funktioniert.

Als Folge des Drückens einer Taste wird auch die Echtzeitdaten im zweiten Teil dieses Trigger-Dialogfelds angezeigt, wo Sie sehen können, wie sich die Werte in Echtzeit basierend auf dem, was Sie drücken oder loslassen, ändern:

Sehen Sie sich dieses Tutorial für weitere Details und Beispiele für eine Studie an, die diesen Trigger verwendet.

Die folgende Tabelle erklärt diese Optionen im Detail.

Menüpunk	Menübereich	Gamepad-/Joystick-Trigger-Optionen
Auf Tasten hören		I.) Geben Sie an, dass der Trigger tastenspezifisch ist und ob es sich um Drücken, Halten oder Loslassen der Taste handelt. II.) Geben Sie an, ob der Trigger für jede Taste oder eine bestimmte Taste gilt. Wenn die spezifische Option ausgewählt ist, werden Sie aufgefordert, die Tasten auf Ihrem Gamepad zu drücken.
Auf Achsen hören		Wenn Bewegungen der Achsen erforderlich sind, können Sie angeben, dass der Trigger immer dann auftritt, wenn die Schwelle um einen bestimmten Wert geändert wird. Der Standardwert beträgt 0,01.
Verbindungsstatus		Gibt an, ob ein Gerät verbunden ist oder nicht.
Echtzeitdatenstream		Nachdem Sie das Gerät verbunden und eine Taste gedrückt oder eine Achse bewegt haben, wird der Echtzeitdatenstream angezeigt, in dem jede Eingabe, die Sie auf Ihrem Gerät machen, hier angezeigt wird. Dies ist nützlich für Tests, wenn Sie Ihre Studie einrichten und bestimmen, welche Tasten oder Achsen Sie verwenden möchten.

Hinweis: Nachdem Sie den Gamepad-/Joystick-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, seine trigger-spezifischen Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Physiologische Signal-Trigger

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

Augenverfolgung-Blick-Trigger

Trigger auf:

• Insgesamt wird dieser Trigger angewendet, wenn die Augenverfolgung aktiviert wurde.
• Nur triggern, wenn auf bestimmte Elemente geschaut wird.

Parameter:

• Wenn Sie ausgewählt haben, nur auf bestimmten Elementen zu triggern, fügen Sie diese Elemente als Ziele hinzu.

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

Augenverfolgung-Fixation-Trigger

Dieser Trigger befindet sich noch in der BETA-Phase.

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

Kopfverfolgungs-Trigger

Trigger auf:

• Änderungen in der Kopfposition oder Kopfbewegung.

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

Versuchs- und Frame-Trigger

Task Init-Trigger

Trigger auf:

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

Dieser Trigger passt gut zu den Shuffle- und Read From-Aktionen. Mit diesen Kombinationen können Sie Einträge im Array oder Daten-Frames beim Start der Aufgabe mischen und die Probanden Stimuli-Sets 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 in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Frame Init-Trigger

Trigger auf:

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

Dieser Trigger passt gut zu den Shuffle-, Read From- und Draw Random Number-Aktionen. Mit diesen Kombinationen können diese Aktionen abgeschlossen werden, bevor der Frame erscheint, was einen klaren Weg für andere Aktionen lässt, die beginnen, wenn der Frame startet.

Hinweis: Verwenden Sie den Frame Init-Trigger nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Versuchsnummer oder Bedingungsnummer betreffen. Dies liegt daran, dass der Frame Init-Trigger zwischen den Versuchen auftritt, sodass keine vollständig genaue Zählung der Versuchs- oder Bedingung durchgeführt wird, die angezeigt werden soll.

Parameter: Keine

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

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

Denken Sie daran, das Kontrollkästchen "Zurücksetzen beim Versuchsbeginn" im Variablen Eigenschaftenfenster zu deaktivieren, wenn Sie nicht möchten, dass die Variablenwerte zurückgesetzt werden.

Frame Start-Trigger

Trigger auf:

• Beginn des Frames

Parameter: Keine

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

Frame End-Trigger

Trigger auf:

• Ende des Frames (nachdem der Frame 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 in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Trigger für die Änderung des Variablenwerts

Wertänderung der Variablen

Trigger auf:

• Der Wert einer Variablen ändert sich von seinem Startwert.

Parameter:

• Variablen: Wählen Sie eine oder mehrere Variablen, für die Sie "auf" Änderungen hören möchten. Jede Änderung des Wertes dieser Variablen wird die entsprechende Aktion sofort auslösen.

• Hinweis: Nachdem Sie den Trigger für die Änderung des Variablenwerts im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte für die Änderung des Variablenwerts in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Medienobjekt-Trigger

Medienobjekt-Trigger

Ehemals bekannt als die separaten „Steuerung Audio/Video“-Trigger und „Steuerung Objekt“-Trigger.

Trigger auf:

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

Parameter:

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

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

  • Audio- oder Video-Objektoptionen:
    • Wiedergabe gestartet: Ausgelöst, wenn das Element zu spielen beginnt
    • Wiedergabe gestoppt: Ausgelöst, wenn das Element pausiert
    • Wiedergabe beendet: Ausgelöst, wenn das Element aufhört zu spielen
  • Video-, Audio- oder Bildschirmaufnahme-Objektoptionen:
    • Aufnahme abgeschlossen: Ausgelöst, wenn die Audioaufnahme beendet wurde
    • Upload abgeschlossen: Ausgelöst, wenn der Datei-Upload abgeschlossen ist
  • Datei-Upload-Objektoptionen:
    • Datei ausgewählt: Ausgelöst, wenn eine Datei ausgewählt wird
    • Upload abgeschlossen: Ausgelöst, wenn der Datei-Upload abgeschlossen ist
  • Kamerasnapshot-Objektoptionen:
    • Snapshot abgeschlossen: Ausgelöst, wenn die Kamera erfolgreich einen Snapshot aufgenommen hat
    • Upload abgeschlossen: Ausgelöst, wenn der Snapshot-Upload abgeschlossen ist

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

API-Trigger

Wenn Sie Daten von einem externen Server an 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

Websocket-Trigger

Der Websocket-Trigger wird verwendet, wenn eine Nachricht von der Websocket/API empfangen wird, die als Trigger für die Aktion verarbeitet wird.

Beim Klicken auf diese Option erscheinen die folgenden Elemente.

• Akzeptieren/Empfangen von: Automatisch die IP-Adresse des lokalen Hosts erkennen. Kann manuell im Tab ‘Studien Einstellungen’ unter der Spalte „Experiment Funktionen“ geändert werden.
• Trigger/Nachricht: Geben Sie die Nachricht ein, die als Trigger dienen wird. Geben Sie 'any' ein, um mehr als eine Nachricht als Trigger zu akzeptieren.

Für ein Beispiel, wie API-Trigger / Aktionen verwendet werden, überprüfen Sie diese Demo https://www.labvanced.com/page/library/51053, indem Sie die Option „Untersuchen“ im Dialogfeld klicken.

Für weitere Informationen über den 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 in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

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: Verweisen Sie auch auf diesen Tutorial, in dem wir eine Studie Schritt für Schritt aufbauen, ChatGPT in eine Studie integrieren und diesen Trigger nutzen.

Im folgenden Beispiel wird der Datenrahmen, der zugewiesen wurde, „df“ genannt und das Ergebnis des „OpenAI-Triggers“ wird in diesem Datenrahmen hinzugefügt. Dieser Datenrahmen muss zwei Spalten haben. Die erste Spalte gibt die „Rolle“ an und die zweite Spalte die „Chatnachricht.“ Die Werte aus der Aktion werden automatisch in den hier verknüpften Datenrahmen eingefügt.

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 in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Globale Trigger

Globale Trigger treten auf, wenn eine wesentliche Änderung innerhalb des Experiments eintritt, d.h. etwas, das „global“ ist, wie z.B. das Pausieren des Experiments oder das Verlassen eines Teilnehmers aus einer Multiuser-Studie! Die folgenden Optionen werden als globale Trigger aufgeführt:

• Experiment pausieren / fortsetzen
• Teilnehmer hat die Multiuser-Studie verlassen

Pause/Fortsetzen des Experiments

Der „Pause / Fortsetzen des Experiments“-Trigger ist eine Option, die es Ihnen ermöglicht, ein Ereignis basierend auf der Pause oder der Fortsetzung des Experiments auszuführen.

Nachdem Sie diesen Trigger ausgewählt haben, erscheint die folgende Ansicht, in der Sie weiter angeben können, wie der Trigger gestaltet sein soll, ob er bei der Unterbrechung des Experiments oder beim Fortsetzen ausgeführt werden soll:

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

• Experiment fortgesetzt: Teilnehmer setzt die Studie fort. Dieser Trigger funktioniert gut für Augenverfolgungsstudien. Er kann verwendet werden, um den Teilnehmer zu einem vorherigen Versuch oder Frame zurückzuleiten, wenn er seinen virtuellen Kinnstützen verlassen hat.

• Hinweis: Nachdem Sie den Trigger „Pause/Fortsetzen des Experiments“ im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Teilnehmer hat die Multiuser-Studie verlassen

Wenn ein Teilnehmer die Multiuser-Studie verlässt, kann dies ebenfalls als Trigger für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Multiuser-Studie verlässt, hat dies globale Auswirkungen auf das Experiment, da es anderen Teilnehmern verbietet, mit der Studie fortzufahren.

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

• Hinweis: Nachdem Sie den Trigger „Teilnehmer hat die Multiuser-Studie verlassen“ im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte in verschiedenen Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Aktionen

Aktionen definieren, was geschehen soll, wenn das Ereignis ausgeführt wird. Sie können verwendet werden, um Variablen und Objekteigenschaften zu ändern, Daten aufzuzeichnen, Daten zu lesen und zu schreiben von/nach Arrays oder zum nächsten Versuch oder zur nächsten Aufgabe zu springen. Oft gibt es mehrere Aktionen pro Ereignis. Mit "ControlActions" kann man logische Operationen (If-Else-Anweisungen), Schleifen, Rückruffunktionen sowie das Verschachteln von Aktionen innerhalb anderer verwenden (z.B. eine While-Schleife innerhalb einer If-Anweisung). 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 garantiert, dass fast jede experimentelle Logik ohne Verwendung bestimmter programmatischer / syntaktischer Strukturen implementiert werden kann.

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

Aktionskategorie	Aktionsoptionen	Beschreibung
Objekt-Aktionen	Objekteigenschaft setzen Medienobjekt steuern Objekt kopieren Für jedes Objekt	Objektaktionen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das innerhalb der Aufgabe existiert.
Variablenaktionen	Variable setzen / aufzeichnen In Zwischenablage kopieren Zufallszahl zeichnen URL-Parameter abrufen Von Gerät lesen / Schreiben Von / zu gemeinsam genutzten Variablen lesen / schreiben Mathematik & Statistik Variablen sofort aufzeichnen Gleitender Durchschnitt Filter Variable verteilen	Jede Aktion, die von einer Variablenwert liest oder diese aufzeichnet.
Array-Aktionen	Aus Array auswählen (lesen) Einträge zum Array hinzufügen / entfernen Array-Eintrag ändern (ersetzen) Array-Einträge mischen	Array-Operationen beziehen sich auf das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und deren Einträgen.
Data Frame-Operationen	Von / zu Datenrahmen lesen / schreiben Datenrahmeneinträge mischen	Diese Aktionen sind relevant, wenn Sie mit .csv-Dateien (Datenrahmen) in Ihrem Experiment arbeiten.
Sprungaktionen	Sprung zu Akzeptieren / Sitzung beenden Ablehnen / Sitzung beenden Weiterleitung zur URL	Ermöglicht es Ihnen, im Experiment zu navigieren, indem Sie zu einem bestimmten Abschnitt springen, sowie Teilnehmerabschnitte zu akzeptieren oder abzulehnen.
Steuerungsaktionen	Anforderungsaktionen (Wenn…Dann) Wiederholte Aktionen (While-Schleife) Verzögerte Aktionen (Zeit-Rückruf) Aktionsgruppe	Steuerungsaktionen werden verwendet, um spezifische Sequenzen von Ereignissen auszuführen, wie z.B. If/Then-Logik, Schleifen (z.B. wiederholtes Abspielen eines Sounds oder Blitzen eines Bildes) sowie einzurichten, wann eine Aktion ausgeführt wird.
API-Aktionen	An Websocket senden An OpenAI senden	Bezieht sich auf API-spezifische Aktionen zum Senden von Daten an eine API.
Code-Aktionen	JavaScript ausführen Globale CSS festlegen	Code-Aktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten.
Einfügeaktion	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 innerhalb der Aufgabe erfolgen wird. Es gibt mehrere Optionen für Objektaktionen:

• Objekteigenschaft festlegen
• Media-Objekt steuern
• Objekt kopieren
• Für jedes Objekt

Objekteigenschaft festlegen-Aktion

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

Im folgenden Beispiel wird die Aktion zwei Eigenschaften des Zielbildes ändern, indem die „Sichtbarkeit“ auf „1“ und die „Höhe“ auf „400“ gesetzt wird, während gleichzeitig die Zeit, zu der diese Änderung auf dem Bildschirm erfolgte, durch die Speicherung des Wertes in der numerischen Variablen „Object_Prop_Change_Time“ erfasst wird.

Nachfolgend finden Sie eine vollständige Übersicht über die Felder, die Sie bei der Arbeit mit der Aktion „Objekteigenschaft festlegen“ antreffen:

Menüelement	Menübereich	Optionen für den Auslöser „Objekteigenschaft festlegen“
Ziel Objekt-Auswahl-Dropdown-Liste:		Die erste Dropdown-Liste zeigt die Objekte an, die Sie in diesem Frame haben, aus denen Sie auswählen können. Dies gibt an, auf welches spezifische Objekt die Aktion angewendet wird.
Ziel Eigenschaft-Auswahl-Dropdown-Liste:		Das zweite Dropdown-Menü gibt an, welche Objekteigenschaft geändert werden soll. Für eine vollständige Erklärung der verfügbaren Optionen und ihrer Parameter siehe die Tabelle zu Objekteigenschaften.
Wertauswahlmenü		Definieren Sie den neuen Wert, das heißt, was der Wert der neuen Objekteigenschaft als Ergebnis der Aktion unter Verwendung des Wertauswahlmenüs sein sollte.
‘+ Eigenschaft hinzufügen’		Mehrere Eigenschaften können durch Klicken auf dieses Symbol hinzugefügt und unter der Aktion geändert werden.
Checkbox - Zeit aufzeichnen, wenn diese Änderung auf dem Bildschirm sichtbar wird (gemessen in Millisekunden ab dem Frame-Beginn).		Wenn eine Eigenschaft geändert wird, dauert es eine kurze Zeit (ca. ~10 ms), bis die Änderungen sichtbar sind. Mit dieser Option können Sie die Zeit, zu der die geänderte Eigenschaft wirklich sichtbar ist, bei der nächsten Anzeigeaktualisierung präziser aufzeichnen. Hinweis: Wenn Sie diese Option auswählen, wird ein Dialogfeld angezeigt, das Sie auffordert, anzugeben (oder eine neue Variable zu erstellen), wo dieser erfasste Wert gespeichert werden soll. Die Variable sollte als „Datentyp“ numerisch sein.

Media-Objekt steuern-Aktion

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

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

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-/Audio-Datei
    • Wiedergabe stoppen: Stoppt die Video-/Audio-Datei
    • Wiedergabe pausieren: Pausiert die Video-/Audio-Datei
    • JumpToTime: Ermöglicht die Angabe eines Zeitpunkts in Millisekunden, zu dem im Audio-/Video-Datei gesprungen werden soll
    • Stumm: Schaltet den Ton des Objekts aus
    • Laut: Stellt den Ton des Objekts wieder her
  • Audio-, Video- oder Bildschirmaufnahmeobjektoptionen:
    • Aufnahme starten: Beginnt eine neue (Audio-)Aufnahme
    • Aufnahme stoppen: Stoppt die (Audio-)Aufnahme
    • Upload starten: Beginnt mit dem Hochladen der Datei
    • Aufnahme löschen: Löscht die (Audio-)Aufnahmedaten.
    • 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
  • Dateiupload-Objektoptionen:
    • Upload starten: beginnt den Upload-Prozess 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
    • Upload starten: Beginnt mit dem Hochladen des Schnappschusses in das Experiment
    • Schnappschuss aufnehmen: 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 aus, das kopiert werden soll.
• Anzahl der Kopien: Geben Sie die Anzahl der Kopien an, die vom Quellobjekt erstellt werden sollen.
• Neuen Elementnamen festlegen: Wählen Sie aus mehreren Parametern aus, um die Namen der Kopien zu bestimmen.
• Namen mit fortlaufendem Postfix zuweisen: Fügt dem Ende des neuen Elementnamens ein numerisches Tag hinzu, um die Kopien zu unterscheiden.
• Aktionssequenz: Ermöglicht Ihnen die Auswahl (aus der üblichen Liste von Aktionen), was mit den Kopien passieren wird. Wählen Sie „AktuellesObjekt“ als Ziel aus, um die Aktion auf alle Kopien anzuwenden.

Für jedes Objekt-Aktion

Wirkung: Wendet eine Aktion auf mehrere Objekte des gleichen Typs an.

Parameter:

• Filter: Wählen Sie den Typ des zu zielenden Elements.
• Zusätzlichen Namensfilter zulassen: Geben Sie den Namen der zu zielenden Objekt(e) ein. Dies funktioniert gut für mehrere Objekte auf einem Frame, bei denen einige identische Namen haben.
• Aktionssequenz: Ermöglicht Ihnen die Auswahl (aus der üblichen Liste von Aktionen), was mit den ausgewählten Elementen passieren wird. Wählen Sie „AktuellesObjekt“ 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 Werten über Sitzungen hinweg.

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

Option zur Variablenaktion	Beschreibung
Variable festlegen / aufzeichnen	Schreiben oder Festlegen eines Variablenwertes
In die Zwischenablage kopieren	Kopiert einen Variablenwert in die interne Zwischenablage des Computers.
Zufallszahl ziehen	Zieht eine oder mehrere Zufallszahlen und speichert sie in einer Variablen
URL-Parameter abrufen	Speichert einen Wert aus der einzigartigen URL des Teilnehmers
Von / zum Gerät lesen / schreiben	Liest oder schreibt eine Variable in/von dem lokalen Speichergerät. Diese Aktion speichert Daten auf dem Gerät des Teilnehmers, anstatt die Daten an die Labvanced-Server zu senden.
Von / zu geteilter Variable lesen / schreiben	Liest von oder schreibt in eine Variable, die über Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder jedem Einzelnen privat sein.
Mathematik & Statistiken	Führt eine mathematische Operation mit einer Eingangsvariablen (Array) durch und speichert das Ergebnis in einer Ausgabevariablen.
Variablen sofort aufzeichnen	Erstellt einen Schnappschuss aller Variablenwerte und sendet diesen an den Labvanced-Server.
Gleitender Durchschnittsfilter	Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingangsvariablen und speichert das Ergebnis in einer neuen Variablen.
Variable verteilen	Sendet einen Wert an andere Teilnehmer. Der Wert wird in einer Variablen gespeichert.

Variable festlegen / aufzeichnen-Aktion

Die Aktion „Variable festlegen / aufzeichnen“ wird in jedem Experiment in Labvanced verwendet, da sie so funktioniert, dass Werte und Verhaltensmaße gespeichert und aufgezeichnet werden.

Beim Klicken auf diese Aktion wird das folgende Dialogfeld angezeigt, in dem Sie angeben können, welche Variable aufgezeichnet werden soll und welchen interessierenden Wert:

Menüelement	Menübereich	Beschreibung
Auswählen		Beim Klicken auf Auswählen geben Sie an, welche Variable den Wert speichern soll. Von hier aus können Sie auch eine neue Variable erstellen.
Stiftsymbol		Das Stiftsymbol symbolisiert das Wertauswahlmenü, das verwendet wird, um die genauen Werte zu definieren und anzugeben, die der ausgewählten Variablen zugewiesen werden sollen (wie im grünen Button links vom 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 Auslöser, der im vorherigen Schritt definiert wurde).

Das Bild unten zeichnet die Mouse-X,Y-Koordinaten 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 Wertauslöser ist, den das System bereitstellt und auf den Sie sich beim Aufzeichnen von Werten beziehen können.

Hinweis: Die Aktion „Variable festlegen / aufzeichnen“ wird auch häufig im Kontext von Steueraktionen verwendet, bei denen Sie Bedingungen mithilfe von „wenn / dann“ und „während-Schleifen“ basierend auf Variablenwerten festlegen können.

In die Zwischenablage kopieren-Aktion

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

Zufallszahl ziehen-Aktion

Wirkung: Zieht eine oder mehrere Zufallszahlen 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
• Mehrfachziehungen (boolescher Wert true/false): Wählen Sie, ob einmal oder mehrmals gezogen werden soll.
• Anzahl der Ziehungen: Wählen Sie die Anzahl der Ziehungen
• Min: Legen Sie den Mindestwert für die gleichmäßige Verteilung fest
• Max: Legen Sie den Höchstwert für die gleichmäßige Verteilung fest
• Mittelwert: Legen Sie den Mittelwert für die normale Verteilung fest
• Standardabweichung: Legen Sie die Standardabweichung für die normale Verteilung fest
• In der Variable speichern: Wählen Sie eine Variable aus, in der die Werte 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 der Variablen speichern: Wählen Sie die Variable aus, in der der Parameterwert gespeichert werden soll.

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

Von / zum Gerät lesen / schreiben-Aktion

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

Parameter:

• Wählen Sie, ob vom lokalen Gerät gelesen oder auf das lokale Gerät geschrieben werden soll.
• Wählen Sie die zu lesende oder schreibende Variable aus.

Anwendungsfall: Längsschnitt-/Multi-Sitzungsstudien

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

Von / zu geteilter Variable lesen / schreiben-Aktion

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

Parameter:

• Wählen Sie die Variable aus, die synchronisiert werden soll. Muss entweder skalare oder ein Array sein.
• Erweiterte Optionen
  • Speicher-Schlüssel: wählen Sie den Namen einer Variablen, die als Schlüssel zum Zugriff auf die synchronisierte Variable dient.
  • Lese- oder Schreibmethode:
    • Lesen, ändern und dann die gemeinsame Variable schreiben: Lies die Variable, änder sie und sende sie dann an die Studie.
    • Nur den gemeinsamen Wert vom Server lesen: Ruft die Variable ab, die innerhalb der Studie geteilt wird, ändert jedoch nichts.
    • Nur die Variable an den Server schreiben: ändert die gemeinsame Variable, zeigt sie jedoch nicht den Teilnehmern an.
    • Werte zwischen verschiedenen Teilnehmern teilen (nicht nur zwischen Sitzungen): Ermöglicht es den Teilnehmern, die synchronisierten Variablenwerte der anderen Teilnehmer über Sitzungen hinweg zu sehen. Diese Option wird standardmäßig ausgewählt, kann jedoch abgewählt werden, indem das Kontrollkästchen deaktiviert wird.
• Aktionssequenz:
  • Wählen Sie, was mit der gemeinsamen/synchronisierten Variablen aus der Liste aller verfügbaren Aktionen passiert.

Anwendungsfall: Längsschnitt-/Multi-Sitzungsstudien

• Mit dieser Aktion können teilnehmerspezifische Daten von Sitzung zu Sitzung übertragen und zwischen Teilnehmern über Sitzungen hinweg geteilt werden.
• Beispielsweise können Sie diese Aktion verwenden, um eine Punktzahl in einem Test aufzuzeichnen und dann dem Teilnehmer zu ermöglichen, seine Punktzahl mit der Durchschnittswertung der anderen Teilnehmer, die den Test abgeschlossen haben, zu vergleichen.
• Ein weiteres Beispiel (ähnlich der Aktion „Von / zum Gerät lesen / schreiben“) ist, dass die Teilnehmer 5 Bilder aus einem Array auswählen, eine Aufgabe ausführen und dann diese 5 Bilder in einer späteren Sitzung erneut präsentieren. Der Unterschied besteht darin, dass diese Aktion verwendet werden kann, um anderen Teilnehmern die ausgewählten Bilder anzuzeigen oder diese Bilder von den verfügbaren Optionen eines anderen Teilnehmers auszuschließen.

Mathe & Statistik-Aktion

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

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 Ausgabevariable, in der das Ergebnis gespeichert wird.

Variablen sofort aufzeichnen-Aktion

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

Parameter: Keine

Gleitender Durchschnittsfilter-Aktion

Wirkung: Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingangsvariablen 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: Gewichtet die Proben so, dass das Gewicht der Proben linear abnimmt.
  • Exponentieller gleitender Durchschnitt: Gewichtet die Proben so, dass das Gewicht der Proben exponentiell abnimmt.
• 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 Ausgabevariable, in der das Ergebnis gespeichert wird.

Variable verteilen-Aktion

Die Aktion „Variable verteilen“ ist entscheidend für Multi-User-Studien in Labvanced. Mit dieser Aktion kann ein Variablenwert zwischen Teilnehmern geteilt werden, was es im Wesentlichen ermöglicht, Informationen (einschließlich Stimulusstandorte und Änderungen) auf den Bildschirmen der Teilnehmer widerzuspiegeln.

Beim Auswählen dieser Aktion wird das folgende Dialogfeld angezeigt, in dem Sie angeben können, welcher Variablenwert zwischen den Teilnehmern verteilt wird.

Das Bild unten zeigt, wie das funktionale Dialogfeld von „Variable verteilen“ aussieht, wenn alle Menüelemente ausgefüllt sind. In diesem Beispiel ist die verteilte Variable eine Aktion, die verwendet wird, um einen Chat zwischen zwei Teilnehmern zu erstellen, indem der Wert einer Variablen aus einem Eingabefeldobjekt verteilt wird.

Sehen Sie sich dieses Demovideo an, das die verteilte Variable und die Chatbox-Funktion hier beinhaltet: Aufgaben zur Bildbeschreibung mit Chat-Erweiterung.

Eine vollständige Erklärung der Menüelemente des Dialogfelds finden Sie unten:

Menüelement	Menübereich	Optionen und Beschreibung zur Aktion „Variable verteilen“
Wert verteilen an		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.
Zielvariable und Wert auswählen		Zielvariable: Wählen Sie eine Zielvariable, in der der Wert gespeichert wird. Wert: Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.
Blockieren		Wenn aktiviert, kann die Zielvariable nicht geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist.
Ratenbegrenzungsstrategie		Die Ratenbegrenzungsstrategie dient zur Absicherung Ihres Experiments gegen eine Überlastung des Servers und wirkt als Vorsichtsmaßnahme zur Steuerung der Rate, mit der Anfragen (d.h. Aktualisierungen über die verteilte Variable) an den Server gesendet werden. Folgende Strategien stehen zur Verfügung: Debounce: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Servernachrichten „abgebrochen“ (nur die zuletzt gesendete 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. nach 100 ms, die seit der letzten gesendeten Nachricht vergangen sind, wird nur die zuletzt gesendete Nachricht verteilt). Discard: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Nachrichten innerhalb dieses 100 ms Fensters verworfen. Queue: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Variablenwerte in Warteschlange gestellt (bis zu einer maximalen Warteschlangenlänge von 10 Nachrichten).

Array-Aktionen

Aus Array lesen-Aktion

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

Parameter:

• Array-Variable: Eingangs-Array zum Auslesen des Wertes.
• Indextyp: Bestimmt, welcher Indextyp verwendet wird.
  • Fix: 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-basiert).
  • 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 vom Ende des Arrays.
• Ausgabewert: Wählen Sie eine skalare Variable, in der der ausgelesene Wert gespeichert wird.

Einträge zum Array hinzufügen / entfernen-Aktion

Wirkung: 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 Indextyp verwendet wird.
  • Fix: Verwenden Sie einen festen Index für die Einfüge-/Löschoperation. In diesem Fall geben Sie 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. 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: Einfügen/Löschen vom Ende des Arrays.
• Anzahl der zu löschenden Einträge: Entfernt die Array-Einträge (vor dem Einfügen neuer Einträge), beginnend bei der definierten Indexposition. 0 bedeutet, dass keine Werte gelöscht werden.
• Variablen, die eingefügt werden sollen: Wählen Sie eine oder mehrere skalare Variablen aus, die an der definierten Indexposition zur Array-Variablen hinzugefügt werden.

Eintrag im Array ändern-Aktion

Wirkung: Ersetzt / ändert einen Wert in einem Array.

Parameter:

• Array-Variable: Array-Variable, in der ein Wert geändert werden soll.
• Indextyp: Bestimmt, welcher Indextyp verwendet wird.
  • Fix: Verwenden Sie einen festen Index für die Ersetzungsoperation. In diesem Fall geben Sie die Array-Position an, die geändert werden soll (1-basiert).
  • 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/Befehle innerhalb eines Arrays.

Parameter: Keine

Datenrahmenoperationen

Aus / in Datenrahmen lesen / schreiben-Aktion

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

Parameter:

• Datenrahmen-Variable: 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.
• Zeile oder Spalte: Wählen Sie aus, wie die Daten gelesen werden sollen.
• Indextyp: Wählen Sie den Typ des Index, der verwendet wird, um den Datenrahmen zu lesen. Kann fest, variabel oder die letzte Zeile sein.
• Indexvariable: Wählen Sie die Variable, die als Index zum Lesen des Datenrahmens verwendet wird.
• Ausgabewert: Wählen Sie die Variable aus, in der die gelesenen/geschriebenen Daten als Ausgabe gespeichert werden. Muss eine Array-Variable sein.

Datenrahmeneinträge mischen-Aktion

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

Parameter:

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

Sprungaktionen

Zu Aktion springen

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

Parameter:

• Zu: Bestimmt, wohin 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 es keine vorherigen Frames gibt, wird die Aktion nicht ausgeführt.
  • Bestimmter Frame: Springt zu einem bestimmten Frame. Benutzer wählen direkt den Frame aus, zu dem gesprungen werden soll.
  • Bestimmter Versuch: Springt zu einem bestimmten Versuch. Benutzer wählen direkt die zu springende Versuchsnummer aus.
  • Bestimmte Aufgabe: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Benutzer wählen direkt die Aufgabe aus, zu der gesprungen werden soll.
  • Bestimmter Block: Springt zur ersten Instanz des angegebenen Blocks. Benutzer wählen direkt den Block aus, zu dem gesprungen werden soll.
• Überprüfen, ob erforderliche Antworten beantwortet wurden: Wenn aktiviert, überprüft das Experiment, ob alle erforderlichen Antworten bereits beantwortet wurden. Wenn nicht, wird die Sprungaktion nicht ausgeführt.

Sitzung akzeptieren/beenden-Aktion

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

Parameter:

• Versuchsdaten vor Abschluss der Sitzung aufzeichnen: Wenn aktiviert, werden die aktuellsten Versuchsdaten gespeichert (an den Server gesendet), bevor die Studie verlassen wird.
• Standard-Ending-Seite anzeigen: Wenn aktiviert, erscheint der Standard-Endbildschirm von Labvanced. Wenn dies eine Crowdsourcing-Sitzung ist (Crowdsourcing-Link wurde verwendet), wird der Entschädigungscode dem Teilnehmer angezeigt. Wenn deaktiviert, wird das Experiment abgeschlossen, nachdem der aktuelle Frame angezeigt wurde, und der Standard-Endbildschirm mit dem Entschädigungscode wird nicht angezeigt.

Sitzung ablehnen/enden-Aktion

Wirkung: Beendet die Aufzeichnungssitzung, markiert die Daten des Teilnehmers jedoch NICHT als vollständig und zeigt NICHT den Standard-Endbildschirm mit dem Entschädigungscode an.

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

Parameter: Keine

Zu URL umleiten-Aktion

Wirkung: Leitet den Teilnehmer zu einer bestimmten URL um.

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

Steueraktionen

Anforderungsaktionen (Wenn... Dann... Sonst Wenn) Aktion

Wirkung: Bewertet eine Wenn-Dann-Aussage und führt eine Reihe von Aktionen abhängig aus. Jede If / 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.

Parameter:

• Anforderung hinzufügen: Fügen Sie eine neue Anforderung zu einer Aussage hinzu. Das „Wertauswahl“-Menü wird auf beiden Seiten angezeigt, um einen logischen Vergleich durchzuführen. In der Mitte der Aussage können Sie wählen, wie die beiden Seiten verglichen werden sollen (z.B. gleich, kleiner als, ungleich, usw.).
• ODER-Gruppe hinzufügen: 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.
• UND-Gruppe hinzufügen: 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.
• Aktionssequenz: Jede If / Else-If-Aussage hat eine Liste von Aktionen, die unter „Dann“ definiert sind. Die Aktionssequenz listet alle Aktionen für eine bestimmte If / 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 Anforderungen der zugehörigen If / Else-If-Aussage erfüllt sind.
• Fügen Sie den Else-If-Fall hinzu: Die Anforderungsaktion kann aus mehreren separaten If / Else-If --> Dann-Aussagen bestehen. Es kann jedoch nur eine Aussage ausgeführt werden. Wenn eine If / Else-If-Aussage positiv bewertet wird (true zurückgibt), werden die Aktionen im Dann-Block ausgeführt und der Rest der Anforderungsaktion wird übersprungen.
• Fügen Sie den Else-Fall hinzu (wahr/falsch): Wenn aktiviert, wird eine Standard-/Fallback-Option zur Anforderungsaktion hinzugefügt. Wenn keine der If / Else-If-Aussagen ausgeführt werden (true zurückgibt), werden die im Else-Fall definierten Aktionen ausgeführt.

Wiederholte Aktionen (While-Schleife) Aktion

Wirkung: Führt wiederholt eine Reihe von Aktionen aus, entweder sofort oder innerhalb eines definierten Intervalls. Es kann eine Stoppbedingung festgelegt werden, damit die Schleifenaufführung gestoppt wird.

Parameter:

• Ausführungstyp: Wählen Sie zwischen sofortiger Ausführung oder zeitgesteuerter Ausführung
  • Vollständige Schleife ausführen: Dies führt die Schleife kontinuierlich aus, bis die Stoppbedingung erfüllt ist.
  • Jedes ... ms ausführen: Dies führt die Schleife mit festgelegtem Intervall aus (z.B. die Schleife wird alle 50 ms ausgeführt).
• Definieren Sie die Anzahl der Schleifen: Wenn „Jedes ... ms ausführen“ ausgewählt ist, haben die Benutzer die Möglichkeit, einen numerischen Ganzzahlwert für die Anzahl der Male zuzuweisen, die die Schleife ausgeführt werden soll. Dies ersetzt die Notwendigkeit, eine Stoppbedingung festzulegen.
• Ausführungsintervall: Dies bestimmt das Ausführungsintervall.
• Sofort starten (true / false): Wenn aktiviert, wird die Schleife sofort ausgeführt. Wenn deaktiviert, wird die Schleife im nächsten Ausführungsintervall gestartet.
• Mehrere Starts zulassen (true / false): Wenn aktiviert, können mehrere Schleifeninstanzen parallel gestartet werden. Wenn deaktiviert, kann nur eine Schleifeninstanz gleichzeitig ausgeführt werden.
• Stoppbedingung aktivieren (true / false): Wenn aktiviert, kann eine Stoppbedingung für die Schleife festgelegt werden.
• Stoppbedingung: Die Stoppbedingung kann verwendet werden, um einen logischen Ausdruck anzugeben, wann die Schleifenaufführung gestoppt werden soll. Ähnlich wie bei den If / Else-If-Aussagen können Gruppen (UND-Gruppen, ODER-Gruppen und Anforderungen) für den logischen Vergleich kombiniert werden.
• Aktionssequenz: Die Aktionssequenz listet alle Aktionen auf, die bei jeder Iteration der Schleife ausgeführt werden. Eine neue Aktion kann über das Symbol „Aktion hinzufügen“ hinzugefügt werden.

Verzögerte Aktionen (Zeit-Callback) Aktion

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

Parameter:

• Verzögerungstyp: Wählen Sie zwischen einer festen Verzögerung oder einer variablen Verzögerung
  • Feste Verzögerung: Die Aktionen werden nach einer festen Verzögerung ausgeführt.
  • Variable Verzögerung: Die Aktionen werden nach einer Verzögerung ausgeführt, die in einer (numerischen) Variablen festgelegt ist.
• Verzögerung: Die Länge der Verzögerung in Millisekunden (ms).
• Aktionssequenz: Die Aktionssequenz listet alle Aktionen auf, die nach der angegebenen Zeitverzögerung ausgeführt werden. Eine neue Aktion kann über das Symbol „Aktion hinzufügen“ hinzugefügt werden.

Aktionsgruppe

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. Um eine Aktionsgruppe hinzuzufügen, finden Sie die Option unter Benutzerdefinierte Aktionen:

API-Aktionen

Wenn Sie Daten von einem externen Server in Labvanced senden oder kommunizieren müssen, können „API-Aktionen“ und „API-Auslöser“ verwendet werden. Sie haben die folgenden Aktionen in dieser Kategorie zur Verfügung:

• An Websocket senden
• An OpenAI senden

Damit diese Aktionen „verfügbar“ oder verwendbar sind, müssen Sie einen API-Schlüssel in den Studieneinstellungen unter der „Experimentfunktionen“-Spalte eingeben. Sobald der API-Schlüssel dort bereitgestellt wurde, werden diese Aktionen im Menü nicht mehr ausgegraut.

An Websocket senden-Aktion

Beim Auswählen dieser Aktion erscheinen die folgenden Optionen:

Das obige Beispiel und die vollständige Ereignisstruktur können hier abgerufen werden: https://www.labvanced.com/page/library/51053 durch Klicken auf „Untersuchen“.

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

An OpenAI senden-Aktion

Die Aktion „An OpenAI senden“ ermöglicht es Ihnen, Informationen, z. B. einen Zeichenfolgen-Eingabewert, an OpenAI zu senden. Bitte beachten Sie, dass für diese Option der API-Schlüssel in den „Studieneinstellungen“ unter der „Experimentfunktionen“-Spalte aufgeführt sein muss.

Die folgenden Optionen erscheinen beim Klicken auf dieses Ereignis:

Hier ist ein funktionales Beispiel, wie dieses Ereignis aussieht, wenn alle erforderlichen Informationen bereitgestellt werden:

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

HINWEIS: Verweisen Sie auch auf diese Schritt-für-Schritt-Anleitung, in der wir eine Studie Schritt für Schritt erstellen, in die wir ChatGPT integrieren und diese Aktion verwenden.

Hier ist eine genauere Erklärung der Felder, die unter der Aktion „An OpenAI senden“ enthalten sind:

Menüelement	Menübereich	Optionen zur „An OpenAI senden“-Aktion
Modelltyp		Gibt das zu verwendende KI-Modell an. Hinweis: Um die ChatGPT-Version anzugeben, siehe die „Studieneinstellungen“ unter der „Experimentfunktionen“-Spalte.
Chat-Verlauf-Datenrahmen		Verlinken Sie zu einer Datenrahmenvariable mit zwei Spalten. Die erste Spalte gibt die „Rolle“ an und die zweite Spalte die „Chat-Nachricht“. Die Werte aus der Aktion werden automatisch dem hier verlinkten Datenrahmen hinzugefügt. Der Datenrahmen kann auch mit Datenrahmenaktionen manipuliert werden. Für weitere Referenz siehe die Dokumentation von OpenAI.
Nachricht einfügen ‘+’		Durch Klicken darauf erscheint das Variablen-Dialogfeld. 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 spezifisch innerhalb des Systems geschaffene Teilrolle

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

Code-Aktionen

In einigen Fällen erfordert Ihr Experiment den Einsatz benutzerdefinierter Codes. 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, bestimmte Ereignisse zu programmieren und Labvanced-Variablen in Ihrer Studie zu lesen/festzulegen, indem Sie benutzerdefiniertes JavaScript eingeben, das als Aktion ausgeführt wird, wenn es ausgelöst wird.

Wenn die obige Aktion 'JavaScript ausführen' ausgewählt wird, sehen Sie einen Bereich (einen Code-Editor), in dem der JavaScript-Code geschrieben werden sollte, sowie Anweisungen, wie er verwendet wird:

Globales CSS-Aktion 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 Aktion 'Globales CSS festlegen' 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 entwerfen, sodass Sie nicht immer wieder dasselbe Element 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 zu erstellen.

Das Wertauswahl-Menü

Wenn Sie mit bestimmten Ereignissen arbeiten, wird ein Stiftsymbol angezeigt. Dies wird als Wertauswahl-Menü 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 verwenden werden.

Dieses Stiftsymbol / Wertauswahl-Menü erscheint an verschiedenen Stellen für bestimmte Aktionen im Ereignissystem, wie z. B. bei der Aktion 'Variable festlegen / aufzeichnen', der Aktion 'Objekteigenschaft festlegen' und der 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ü wird immer mit einer trigger-spezifischen Wertoption beginnen und dann zu den anderen 5 Kategorien (Aktuelle Zeit, Konstantenwert, Variable, Rahmen / Aufgabe / Option und Operationen) fortfahren, von denen jede ihre eigenen Optionen hat. Diese werden weiter unten beschrieben.

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

Menüoptionen

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

Aktuelle Zeitwerte

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

Die folgenden Optionen sind verfügbar:

• UNIX-Zeitstempel
• Zeit seit Rahmenbeginn

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 Rahmens vergangen ist. Meistens entspricht dies der Reaktionszeit.

Konstante Werte

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

Die folgenden Optionen sind verfügbar:

• Zeichenfolge
• Numerisch
• Boolesch
• Kategorisch
• Datum
• Zeit
• Farbe

Konstant: Zeichenfolge

Weist einen Zeichenfolgen-/Textwert zu.

Konstant: Numerisch

Weist einen numerischen/Wert zu.

Konstant: Boolesch

Weist einen Wert von wahr oder falsch zu.

Konstant: Kategorisch

Weist einen Levelwert zu (hauptsächlich für Faktoren).

Konstant: Datum

Weist einen Datumswert zu.

Konstant: Zeit

Weist einen Zeitwert zu.

Konstant: Farbe

Weist einen Farbwert (Hex-String) zu.

Variablenwerte

Geben Sie eine Variable an oder verweisen Sie darauf 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 / Objektwerte

Ermöglicht es Ihnen, Werte zu extrahieren, die mit Objekteigenschaften, 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 Bildschirmaktualisierungswert des Geräts des Teilnehmers.

Operationen

Verwenden Sie Operationen, um bestimmte Ä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 des Kombinierens von Zeichenfolgen und sogar des Modifizierens von Objekteigenschaften.

Im Wesentlichen ermöglicht es die arithmetische Operation, Operationen an mehreren Werten durchzuführen.

Bei Auswahl dieser Option erscheint ein zusätzliches Stiftsymbol (d.h. Wertauswahl-Menü) sowie eine Liste von Operationen, wie z. B. 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 anwendet, um eine neue Zeichenfolgenvariable (im grünen Button) mit dem Namen 'intermediateVar' zu erstellen.

Der neue Variablenwert (von 'intermediateVar') wird durch die Verwendung mehrerer arithmetischer Operationen zusammen mit einer Kombination aus zuvor erstellen Variablen (d.h. 'userChatName' und 'chatInput') sowie konstanten Zeichenfolgenwerten, d.h. dem Semikolon : und dem Trennzeichen <br> definiert. Diese Aktion erzeugt den Effekt eines Nutzerchats, der in einer Multi-User-Studie verwendet werden kann.

String-Operation

Mathematik-Operation

Führt eine mathematische Operation auf einem Skalaren aus.

Trigger-spezifische Werte

Trigger-spezifische Werte beziehen sich auf Werte, die mit dem im jeweiligen Ereignis definierten Trigger verbunden sind. Wenn Ihr Ereignis beispielsweise einen Maus-Trigger verwendet, können Sie in bestimmten Bereichen, in denen die Aktion angegeben ist (z. B. bei Verwendung einer Variable festlegen / aufzeichnen oder Objekteigenschaft festlegen Aktion), auf trigger-spezifische Mauswerte im Wertauswahlmenü verweisen.

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 Variable festlegen / aufzeichnen Aktion aufzuzeichnen.

Unten steht eine Tabelle aller Typen von trigger-spezifischen Werten, die in Labvanced zu finden sind, gefolgt von einer ausführlichen Erklärung jeder Option.

Name	Wertoptionen - Übersicht
Trigger (Maus)	Maus X Maus Y Maus [X,Y] Array Stimulusname Stimulusinfo Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Tastatur)	ID der Taste Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Button-Leiste)	Stimulusname Stimulusinfo Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Eingabetaste)	ID der Taste Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Scrollen)	Stimulusname Stimulusinfo Scroll-Position X Scroll-Position Y Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit 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 (seit Rahmenbeginn)
Trigger (Augenverfolgungsgaze)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulusname Stimulusinfo Kamerafangzeit T Blickvertraulichkeit C Koordinate + Zeit [X,Y, T] Array Koordinate + Zeit + Vertraulichkeit [X,Y, T,C] Array Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Augenverfolgungsfixation)	Fixationszentrums X Fixationszentrums Y Fixationsdauer Fixationsstartzeit Fixationsendzeit Fixationsstreuung Stimulusname Stimulusinfo [X,Y, Dur, Start, Ende, Disp] Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Kopfverfolgung)	Kamerafangzeit T Kopfdrehung Neigung des Kopfes Kopfrichtung Kopfposition [X,Y, T] Array Nasenposition [X,Y, T] Array Nasenvektor [X,Y, Z, T] Array Trigger-Zeitstempel (Unixtime) Trigger-Zeit seit Rahmenbeginn
Trigger (Bei Aufgabeninitialisierung)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Bei Rahmeninitialisierung)	VersuchNr Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (bei Rahmenbeginn)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Bei Rahmenende)	Gesamtzeit auf dem Rahmen Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Wert der Variable geändert)	Neuer Wert in der Variablen Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Medienobjekt-Trigger)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (WebSocket-Trigger)	Nachricht Daten Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (OpenAI-Trigger)	Chat GPT-Antwort Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Globales Experimentereignis)	Gesamtzeit auf dem Rahmen Grund für das globale Ereignis Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)
Trigger (Benutzer verlässt Experiment)	Verbleibende Anzahl der Teilnehmer Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Rahmenbeginn)

Trigger (Maus) Werte

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

Trigger (Tastatur) Werte

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

Trigger (Button-Leiste) Werte

Wenn ein Button-Klick-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen abgerufen werden:

Trigger (Eingabetaste) Werte

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

Trigger (Scrollen) Werte

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

Trigger (Gamepad/Joystick) Werte

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

Trigger (Augenverfolgungs-Gaze) Werte

Wenn ein Augenverfolgungs-Gaze-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen abgerufen werden:

Trigger(Augenverfolgung Fixation) Werte

Wenn ein Augenverfolgung-Fixation-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen abgerufen werden:

Trigger (Kopfverfolgung) Werte

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

Trigger (Bei Aufgabeninitialisierung) Werte

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

Trigger (Bei Rahmeninitialisierung) Werte

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

Trigger (bei Rahmenbeginn) Werte

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

Trigger (Bei Rahmenende) Werte

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

Trigger (Wert der Variablen geändert) Werte

Wenn ein Trigger für geänderten Variablenwert verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen abgerufen werden:

Trigger (Medienobjekt-Trigger) Werte

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

Trigger (WebSocket-Trigger) Werte

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

Trigger (OpenAI-Trigger) Werte

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

Trigger (Globales Experimentereignis) Werte

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

Trigger (Benutzer verlässt Experiment) Werte

Wenn ein Teilnehmer, der eine Multiuser-Studie verlässt-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen abgerufen werden: