Ereignissystem

Beschreibung

Das Ereignissystem ist für jede Studie unverzichtbar. So können Sie Werte einrichten, die aufgezeichnet werden, das Experiment voranbringen und Aufgaben erstellen. Benutzer können ein Ereignissystem erstellen, um alle Funktionalitäten, Logiken und Interaktionen in einer Aufgabe auszuführen. Ein Ereignis fungiert oft als Vermittler zwischen Objekten und Variablen.

Das Ereignissystem besteht aus Triggern und Aktionen. Hier richten Sie Regeln ein, wie 'wenn dies passiert' (Trigger), dann 'machen Sie dies' (Aktion). Zum Beispiel: Wenn ein Teilnehmer auf ein bestimmtes Bild klickt (Trigger), dann zeigen Sie ein anderes, zufälliges Bild (Aktion).

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

Ereignisse erstellen - Übersicht

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

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

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

Die Ausführungsreihenfolge von Ereignissen kann angepasst werden. Standardmäßig stehen Ereignisse mit demselben Trigger höher auf der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Wenn ein vorhandenes Ereignis ausgewählt wird, werden die Einzelheiten im unteren rechten (Ereigniseigenschaften) Panel angezeigt. Zur besseren Übersicht können vorhandene Ereignisse auch wieder 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 ihre Einstellungen/Parameter werden in der folgenden Liste erläutert:

Triggerkategorie	Triggeroptionen	Beschreibung
Benutzereingabe-Trigger	Maus-Trigger Tastatur-Trigger Button-Klicks Enter bei Eingabe Scroll-Trigger Gamepad/Joystick-Trigger	Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der manuell vom Benutzer/Teilnehmer aktiviert werden kann, indem er etwas wie das Bewegen seiner Maus, Klicken auf ein Tastatur-Element, Scrollen usw. tut.
Physiologische Signal-Trigger	Eyetracking-Gaze Eyetracking-Fixation Headtracking	Physiologische Signal-Trigger treten auf, wenn es ein festgelegtes physiologisches Eingangszeichen gibt, wie das Blicken auf ein bestimmtes Element oder Veränderungen in Kopfbewegungen.
Versuchs- und Frame-Trigger	Aufgabeninit Frame-Init Frame-Start Frame-Ende	Diese Trigger treten in Bezug auf die experimentellen Versuche und Frames auf, wie z.B. wenn ein Frame beginnt oder endet.
Variable Wert geändert Trigger	Variable (Wert geändert)	Ein Trigger für das Ereignis tritt auf, wenn es eine Änderung im Wert einer bestimmten Variablen gibt.
Medienobjekt-Trigger	Medienobjekt-Trigger	Dieser Trigger tritt in Bezug auf Medienobjekte auf, wie z.B. eine Pause in einer Video-/Audiodatei oder das Beenden einer Aufnahme usw.
API-Trigger	Websocket-Trigger Open AI Trigger	Dies sind Trigger, die auftreten, wenn es eingehende Daten von einer API gibt.
Globale Trigger	Experiment pausieren / fortsetzen Teilnehmer hat die Mehrbenutzerstudie verlassen	Globale Trigger beziehen sich auf alle größeren Änderungen an einem Experiment, wie z.B. das Pausieren oder das Verlassen eines Teilnehmers in einer Mehrbenutzerstudie.

Benutzereingabe-Trigger

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

Die Tabelle unten 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 auszulösen, wie z.B.: Scrollen, Klicken, Hovering usw. Sie können auch spezifische Elemente oder Ziele mit einem Trigger verknüpfen. Zum Beispiel wird ein Mausklick nur dann als Trigger verwendet, wenn ein bestimmtes Bild angeklickt wird.
Tastatur-Trigger	Jeder Tastendruck kann als Trigger verwendet werden, um ein Ereignis zu initiieren. Sie können spezifische Buchstaben oder Zahlen von der Tastatur als Trigger festlegen.
Button-Klicks	Schaltflächenobjekte, die in Labvanced erstellt wurden, können als Trigger verwendet werden, um Ereignisse einzuleiten.
Enter bei Eingabe	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 zu übermitteln.
Scroll-Trigger	Dieser Trigger tritt auf, wenn der Teilnehmer scrollt. Sie können die x- oder y-Scroll-Richtungen angeben, sowie über welche Elemente das Scrollen erfolgt, um als Ereignis-Trigger 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 auslöst, wie z.B.: das Bewegen der Maus nach oben / unten, Klicken, Hovering über ein bestimmtes Objekt, Verlassen eines bestimmten Objekts 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:

Unten sehen Sie eine vollständige Übersicht der Optionen, die Sie beim Arbeiten mit Maus-Triggern haben:

Menüpunk	Menübereich	Optionen und Spezifikationen für den Maus-Trigger
Aktion Dropdown-Liste:		Folgende Optionen für Maus-Trigger sind in der Dropdown-Liste verfügbar: Klick: Ausgelöst durch Mausklick Drücken: Ausgelöst durch Mausklick und gedrückt Loslassen: Ausgelöst durch das Loslassen der Maustaste Hover: Ausgelöst durch das Überfahren mit der Maus über das Objekt Verlassen: Ausgelöst durch das Verlassen eines Objekts Bewegen: Ausgelöst durch jede Mausbewegung
Taste 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 Mausklicks, der das Ereignis auslöst. Multiple Ziele können hinzugefügt werden, indem Sie die „+Ziel hinzufügen“-Option am Ende anklicken.	Wenn Sie ein Ziel angeben, stehen folgende Optionen zur Verfügung: Auslösen im Hintergrund des Frames: Der Maus-Trigger kann aktiviert werden, ohne auf ein Objekt oder Element zu klicken. Jedes Element: Der Maus-Trigger kann aktiviert werden, wenn auf jedes Element im Frame geklickt wird. Ziele hinzufügen: Wählen Sie die spezifischen Elemente aus, die angeklickt werden müssen, um den Trigger zu aktivieren.

• Hinweis: Nachdem Sie den Maus-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Mauswerte über verschiedene Aktionen hinweg mithilfe des Wert-Auswahlmenüs zu nutzen und darauf zuzugreifen.

Tastatur-Trigger

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

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

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

Menüpunk	Menübereich	Optionen für Tastatur-Trigger
Aktion Dropdown-Liste:		Dies sind die verfügbaren Optionen für Tastaturaktionen: Taste drücken: Ausgelöst durch das Drücken der Taste (Taste ist gedrückt) Taste drücken oder halten: Trigger tritt ein, wenn die Taste entweder gedrückt oder gehalten wird Taste loslassen: Ausgelöst durch das Loslassen der Taste Hinweis: Eine Taste muss losgelassen werden, bevor sie erneut als Trigger „feuern“ kann.
Tasten welche Taste das Ereignis auslöst		Welche Taste als Trigger verwendet wird, wird hier durch Auswahl der Optionen angegeben, indem Sie auf +Hinzufügen: klicken: Pfeile: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben im englischen Alphabet Spezial: Sondertasten (Enter, Space, Control, Tab, Shift) F-Tasten: F1 bis F10 jede Taste: jede dieser Tasten ist akzeptabel Sie können mehrere Tastatur-Trigger hinzufügen, indem Sie erneut auf die Schaltfläche +Hinzufügen: klicken.
Zusätzliche Optionen		Die Aktivieren der Zifferntasteneingaben-Option ermöglicht es, dass die Zifferntasteneingaben innerhalb des Experiments als Trigger verwendet werden. Für die Erlaubt Ereignisübertragung-Option wird, wenn mehrere Ereignisse denselben Tastatur-Trigger haben, dann feuern/triggers alle ohne es. Nur das erste wird feuern 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 über verschiedene Aktionen hinweg mithilfe des Wert-Auswahlmenüs zu nutzen und darauf zuzugreifen.

Button-Klick-Trigger

Wenn Sie ein Schaltflächen- oder Navigationsobjekt im Editor platziert haben, können Sie diese verwenden, um ein Ereignis auszulösen, bei dem das Klicken auf die Schaltfläche als Trigger für eine Aktion fungiert.

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

Hier ist ein näherer Blick auf die vorgestellten Punkte:

Menüpunk	Menübereich	Optionen für den Button-Klick-Trigger
Ziel: +Ziel festlegen		Auswahl eines Schaltflächenelements als Ziel
Schaltfläche: Option		Geben Sie an, welche spezifische Schaltfläche im Frame

• Hinweis: Nachdem Sie den Button-Klick-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Button-Klick-Werte über verschiedene Aktionen hinweg mithilfe des Wert-Auswahlmenüs zu nutzen und darauf zuzugreifen.

Enter bei Eingabe-Trigger

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

Parameter:

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

• Hinweis: Nachdem Sie den Enter bei Eingabe-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Enter bei Eingabe-Werte über verschiedene Aktionen hinweg mithilfe des Wert-Auswahlmenüs zu nutzen und darauf zuzugreifen.

Scroll-Trigger

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

Parameter:

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

Ziel: Setzen Sie das Ziel-Element, 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 Option festgelegt werden.

• Hinweis: Nachdem Sie den Scroll-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Scroll-Werte über verschiedene Aktionen hinweg mithilfe des Wert-Auswahlmenüs 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 Datenerfassung zu nutzen. Hinweis: Denken Sie daran, diese Option unter dem „Einstellungen“ Tab zu aktivieren.

Beim Auswählen dieses Triggers wird das folgende Dialogfeld angezeigt.

Nach dem Anschließen Ihres Gamepads können Sie angeben, welche spezifischen Tasten als Trigger verwendet werden sollen. Beim Drücken der entsprechenden Taste wird die ID angezeigt.

Im folgenden Beispiel bezieht sich 2 auf die ◎-Taste und 3 auf die ▵-Taste. Hinweis: Es ist wichtig zu erwähnen, dass es einige Variationen zwischen Gamepads in der Funktionsweise der Tasten-ID-Zuordnung gibt.

Als Ergebnis des Drückens einer Taste erscheinen die Live-Daten ebenfalls in der zweiten Hälfte dieses Trigger-Dialogfelds, wo Sie sehen können, wie sich die Werte in Echtzeit basierend darauf ändern, was Sie drücken oder loslassen:

Sehen Sie sich diese Schritt-für-Schritt-Anleitung für weitere Details und ein Beispiel einer Studie, die diesen Trigger nutzt, an.

Die Tabelle unten erklärt diese Optionen im Detail.

Menüpunk	Menübereich	Optionen für Gamepad / Joystick-Trigger
Auf Tasten hören		I.) Geben Sie an, dass der Trigger tastenspezifisch ist und ob er beim Drücken, Halten oder Loslassen der Taste aktiviert werden soll. II.) Geben Sie an, ob der Trigger für jede Taste oder eine spezifische 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 Achsenbewegungen erforderlich sind, können Sie angeben, dass der Trigger jedes Mal auftritt, wenn die Schwelle um einen spezifischen Wert geändert wird. Der Standardwert beträgt 0.01.
Verbindungsstatus		Gibt an, ob ein Gerät verbunden ist oder nicht.
Live-Datenstream		Sobald das Gerät angeschlossen ist und eine Taste gedrückt oder eine Achse bewegt wird, wird der Live-Daten-Feed angezeigt, wo jede Eingabe, die Sie an Ihrem Gerät vornehmen, hier angezeigt wird. Dies ist nützlich für Tests beim Einrichten Ihrer Studie und für die Bestimmung, welche Tasten oder Achsen Sie nutzen möchten.

Hinweis: Nachdem Sie den Gamepad/Joystick-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Physiologische Signal-Trigger

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

Eyetracking-Gaze-Trigger

Trigger auf:

• Insgesamt gilt dieser Trigger, wenn Eyetracking aktiviert wurde.
• Nur Trigger, wenn auf bestimmte Elemente geschaut wird.

Parameter:

• Wenn Sie ausgewählt haben, dass nur Trigger auf bestimmten Elementen festgelegt werden, fügen Sie diese Elemente als Ziele hinzu.

• Hinweis: Nachdem Sie den Eyetracking-Gaze-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Gaze-Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Eyetracking-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 über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Headtracking-Trigger

Trigger auf:

• Ä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 über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Versuchs- und Frame-Trigger

Aufgaben-Init-Trigger

Trigger auf:

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

Dieser Trigger funktioniert gut mit den Aktionen "Mischen" und "Auslesen". Mit diesen Kombinationen können Sie Array-Einträge oder Daten-Frames zu Beginn der Aufgabe mischen und Probanden bestimmten Stimuli zuweisen, ohne mehrere Ereignisse zu erstellen, um Stimuli oder Daten auszulesen.

Parameter: Keine

• Hinweis: Nachdem Sie den Aufgaben-Init-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Aufgaben-Init-Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Frame-Init-Trigger

Trigger auf:

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

Dieser Trigger funktioniert gut mit den Aktionen "Mischen", "Auslesen" und "Zufallszahl zeichnen". Mit diesen Kombinationen können diese Aktionen abgeschlossen werden, bevor der Frame erscheint, was einen klaren Weg für andere Aktionen frei macht, um zu beginnen, wenn der Frame beginnt.

Hinweis: Verwenden Sie den Frame-Init-Trigger nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Versuchsnummer oder Bedingungsnummer betreffen. Das liegt daran, dass der Frame-Init-Trigger zwischen den Versuchen auftritt, sodass es keine vollständig genaue Zählung des Versuchs oder der Bedingung gibt, 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 über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Hinweis zu Aufgaben- und Frame-Init-Triggern: Da die Aufgaben- 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 beginnt. Eine Warnung wird angezeigt, wenn Sie dieses Ereignis verwenden:

Denken Sie daran, das Kontrollkästchen „Zurücksetzen beim Versuchsbeginn“ im Fenster der Variableneigenschaften abzuhaken, 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 über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Frame-Ende-Trigger

Trigger auf:

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

Parameter: Keine

• Hinweis: Nachdem Sie den Frame-Ende-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Frame-Ende-Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Variable Wert geändert Trigger

Variable Wert geändert

Trigger auf:

• Der Wert einer Variable ändert sich von seinem Ausgangswert

Parameter:

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

• Hinweis: Nachdem Sie den Variable Wert geändert-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte für Variable Wert geändert über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Medienobjekt-Trigger

Medienobjekt-Trigger

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

Trigger auf:

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

Parameter:

• Ziel: Wählen Sie ein Objektelement aus, das auf dem Frame existiert

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

  • Audio- oder Videoobjektoptionen:
    • 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 Bildschirmaufnahmeobjektoptionen:
    • Aufnahme abgeschlossen: Ausgelöst, wenn die Audioaufnahme gestoppt wurde
    • Upload abgeschlossen: Ausgelöst, wenn der Datei-Upload abgeschlossen ist
  • Datei-Upload-Objektoptionen:
    • Datei ausgewählt: Ausgelöst, wenn eine Datei ausgewählt wurde
    • Upload abgeschlossen: Ausgelöst, wenn der Datei-Upload abgeschlossen ist
  • Kamerasnapshot-Objektoptionen:
    • Snapshot abgeschlossen: Ausgelöst, wenn die Kamera erfolgreich einen Snapshot gemacht hat
    • Upload abgeschlossen: Ausgelöst, wenn der Snapshot erfolgreich hochgeladen wurde

• Hinweis: Nachdem Sie den Medienobjekt-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Medienobjektwerte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

API-Trigger

Wenn Sie Daten von einem externen Server in Labvanced senden oder kommunizieren müssen, können die „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 dem Websocket/API empfangen wird, die als Trigger für die Aktion verarbeitet wird.

Durch Klicken auf diese Option erscheinen folgende Elemente.

• Akzeptieren/Empfangen von: erkennt automatisch die IP-Adresse des lokalen Hosts. Kann im Einstellungen Tab unter Besondere Funktionen manuell 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 bitte diese Demo https://www.labvanced.com/page/library/51053, indem Sie die Option „Inspektieren“ im Dialogfeld auswählen.

Für weitere Informationen zum API-Zugang 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 über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

OpenAI-Trigger

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

Wenn Sie diese Option auswählen, werden die folgenden Parameter angezeigt:

HINWEIS: Sehen Sie sich auch diese Schritt-für-Schritt-Anleitung an, in der wir eine Studie Schritt für Schritt erstellen und ChatGPT in eine Studie integrieren und diesen Trigger nutzen.

Im folgenden Beispiel wird der zugewiesene Datenrahmen „df“ genannt und das Ergebnis des „OpenAI-Triggers“ wird an diesen Datenrahmen angehängt. Dieser Datenrahmen muss zwei Spalten haben. Die erste Spalte gibt die „Rolle“ und die zweite Spalte die „Chat-Nachricht“ an. Die Werte aus der Aktion werden automatisch an den hier verknüpften Datenrahmen angehängt.

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

• Hinweis: Nachdem Sie den OpenAI-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische OpenAI-Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Globale Trigger

Globale Trigger treten auf, wann immer eine wesentliche Änderung innerhalb des Experiments auftritt, d.h. etwas, das 'global' ist, wie z.B. das Pausieren des Experiments oder das Verlassen eines Teilnehmers in einer Mehrbenutzerstudie! Folgende Optionen werden als globale Trigger aufgelistet:

• Experiment pausieren / fortsetzen
• Teilnehmer hat die Mehrbenutzerstudie verlassen

Pause/Fortsetzen des Experiments

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

Durch die Auswahl dieses Triggers erscheint die folgende Ansicht, in der Sie die Art des Triggers weiter angeben können, ob er bei der Pause oder Fortsetzung des Experiments ausgeführt werden sollte:

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

• Experiment fortgesetzt: Teilnehmer setzt die Studie fort. Dieser Trigger funktioniert gut für Eye-Tracking-Studien. Er kann verwendet werden, um den Teilnehmer zurück zu einem vorherigen Versuch oder Frame zu schicken, wenn er seinen Virtuellen Kinnstütze verlassen hat.

• Hinweis: Nachdem Sie den Pause/Fortsetzen des Experiments-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu verwenden und darauf zuzugreifen.

Teilnehmer hat die Mehrbenutzerstudie verlassen

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, hat dies auf globaler Ebene Auswirkungen auf das Experiment, da es anderen Teilnehmern das Fortfahren der Studie unmöglich macht.

Durch die Auswahl dieses Triggers können Sie angeben, welche Art von Aktion passiert, wenn ein Teilnehmer die Mehrbenutzerstudie verlässt.

• Hinweis: Nachdem Sie den Trigger „Teilnehmer hat die Mehrbenutzerstudie verlassen“ im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü 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 Objekteigenschaften zu ändern, Daten aufzuzeichnen, Daten aus Arrays zu lesen und zu schreiben oder zu dem nächsten Versuch oder der nächsten Aufgabe zu springen. Oft gibt es mehrere Aktionen pro Ereignis. Durch die Verwendung von "ControlActions" kann man logische Operationen (If-Else-Anweisungen), Schleifen, Callback-Funktionen sowie geschachtelte Aktionen (z.B. eine While-Schleife innerhalb einer If-Anweisung) verwenden. Daher kann das Ereignissystem als grafische Programmiersprache betrachtet werden. In dieser Ansicht fungieren Trigger als Funktionsaufrufe, während Aktionen die funktionale Logik beschreiben. Dieser Ansatz garantiert, dass nahezu jede experimentelle Logik implementiert werden kann, ohne bestimmte programmatische/syntaktische Strukturen verwenden zu müssen.

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

Aktionskategorie	Aktionsoptionen	Beschreibung
Objektaktionen	Objekteigenschaft festlegen Medienobjekt steuern Objekt kopieren Für jedes Objekt	Objektaktionen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das in der Aufgabe existiert.
Variablenaktionen	Variable festlegen / aufzeichnen In die Zwischenablage kopieren Zufallszahl ziehen URL-Parameter abrufen Von/zu Gerät lesen/schreiben Von/zu gemeinsamer Variable lesen/schreiben Mathematik & Statistik Variablen sofort aufzeichnen Gleitender Durchschnittsfilter Variable verteilen	Jede Aktion, die von oder zur Aufzeichnung eines Variablenwertes liest.
Arrayaktionen	Aus Array auswählen (lesen) Array-Einträge hinzufügen / entfernen Arrayeintrag ändern (ersetzen) Arrayeinträge mischen	Arrayoperationen beinhalten das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und deren Einträgen.
Datenrahmenoperationen	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 Session annehmen / beenden Session ablehnen / beenden Zur URL umleiten	Ermöglicht Ihnen, im Experiment zu navigieren, indem Sie zu einem bestimmten Abschnitt springen, sowie die Abschnitte der Teilnehmer anzunehmen und abzulehnen.
Kontrollaktionen	Anforderungsaktionen (Wenn...Dann) Wiederholte Aktionen (While-Schleife) Verzögerte Aktionen (Zeit-Callback) Aktionsgruppe	Kontrollaktionen werden verwendet, um spezifische Ereignisfolgen auszuführen, wie z.B. If/Then-Logik, Schleifen (wie das Abspielen eines wiederholten Sounds oder das Aufblitzen eines Bildes) sowie um eine Verzögerung einzurichten, bis eine Aktion ausgeführt wird.
API-Aktionen	An Websocket senden An OpenAI senden	Bezieht sich auf API-spezifische Aktionen, um Daten an eine API zu senden.
Code-Aktionen	JavaScript ausführen Globales CSS festlegen	Codeaktionen 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 vorgenommen wird, das innerhalb der Aufgabe existiert. Es gibt mehrere Optionen für Objektaktionen:

• Objekt-Eigenschaft festlegen
• Medienobjekt steuern
• Objekt kopieren
• Für jedes Objekt

Aktion "Objekteigenschaft festlegen"

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

Im folgenden Beispiel ändert die Aktion zwei Eigenschaften des Zielbildes, indem sie die „sichtbarkeit“ auf „1“ und die „höhe“ auf „400“ festlegt, während gleichzeitig die Zeit, zu der diese Änderung auf dem Bildschirm aufgetreten ist, aufgezeichnet wird, indem der Wert in der numerischen Variablen „Object_Prop_Change_Time“ gespeichert wird.

Im Folgenden finden Sie eine vollständige Übersicht über die Felder, die Sie beim Arbeiten mit der Aktion „Eigenschaft eines Objekts festlegen“ antreffen:

Menüelement	Menübereich	Auslöseroptionen für die 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 Eigenschaft des Objekts geändert werden soll. Eine vollständige Erklärung der verfügbaren Optionen und ihrer Parameter finden Sie in der Tabelle der Objekteigenschaften.
Wert auswählen Menü		Definieren Sie den neuen Wert, d.h. was der Wert der neuen Objekteigenschaft als Ergebnis der Aktion unter Verwendung des Wert auswählen Menüs sein soll.
‘+ Eigenschaft hinzufügen’		Mehrere Eigenschaften können unter der Aktion hinzugefügt und geändert werden, indem Sie auf dieses Symbol klicken.
Checkbox - Zeit aufzeichnen, wenn diese Änderung auf dem Bildschirm angezeigt wird (gemessen in Millisekunden ab 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 präziser den Zeitpunkt aufzeichnen, zu dem die geänderte Eigenschaft beim nächsten Bildschirm-Refresh tatsächlich sichtbar wird. Hinweis: Wenn Sie diese Option auswählen, wird ein Dialogfeld angezeigt, in dem Sie angeben müssen (oder eine neue Variable erstellen), wo dieser erfasste Wert gespeichert werden soll. Die Variable sollte numerisch sein, da der ‚Datentyp‘.

Aktion "Medienobjekt steuern"

Ehemals die separaten Aktionen „Audio/Video steuern“ und „Objekt steuern“.

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

Parameter:

• Ziel: Wählen Sie ein Medienobjekt aus
• Wirkung: 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 Ihnen, eine Zeit in Millisekunden anzugeben, zu der im Audio-/Video-File gesprungen werden soll
    • Stummschalten: Schaltet den Ton des Objekts aus
    • Stummschaltung aufheben: Stellt den Ton des Objekts wieder her
  • Audio-, Video- oder Bildschirmaufnahmeobjektoptionen:
    • Aufnahme starten: Startet eine neue (Audio-)Aufnahme
    • Aufnahme stoppen: Stoppt die (Audio-)Aufnahme
    • Upload starten: Startet den Upload der Datei
    • Aufnahme löschen: Löscht die (Audio-)Aufnahmedaten.
    • Wiedergabe starten: Startet die Wiedergabe der aufgezeichneten Datei
    • Wiedergabe stoppen: Stoppt die Wiedergabe der aufgezeichneten Datei
    • Aufnahme pausieren: pausiert die Aufnahme des Objekts
    • Aufnahme fortsetzen: setzt die Aufnahme des Objekts fort
  • Datei-Upload-Objektoptionen:
    • Upload starten: startet den 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
  • Kamerasnappshot-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 machen: macht ein Bild mit der Kamera des Teilnehmers

Aktion "Objekt kopieren"

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

Parameter:

• Quelle: Wählen Sie das Objekt im Frame, das kopiert werden soll.
• Anzahl der Kopien: Geben Sie die Anzahl der Kopien an, die vom Quellobjekt erstellt werden sollen.
• Neuen Elementnamen festlegen: Wählen Sie aus mehreren Parametern, um die Namen der Kopien zu bestimmen.
• Namen mit inkrementierendem Suffix 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 gewohnten Liste von Aktionen), was mit den Kopien geschehen soll. Wählen Sie „CurrentObject“ als Ziel, um die Aktion auf alle Kopien anzuwenden.

Aktion "Für jedes Objekt"

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

Parameter:

• Filter: Wählen Sie die Art des Elements aus, das angesprochen werden soll.
• Zusätzlichen Namensfilter zulassen: Geben Sie den Namen der Objekte an, die Sie ansprechen möchten. Bei mehreren Objekten in einem Frame, bei denen einige identische Namen haben, funktioniert dies gut.
• Aktionssequenz: Ermöglicht Ihnen die Auswahl (aus der gewohnten 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.

Variablenaktionen

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

Die folgende Tabelle bietet eine Einführung in alle Optionen für Variablenaktionen, die in Labvanced verfügbar sind. Jede von ihnen wird in den kommenden Abschnitten detaillierter beschrieben.

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

Aktion "Set / Record Variable"

Die Aktion „Set / Record Variable“ wird in jedem Experiment in Labvanced verwendet, da hiermit Werte und Verhaltensmaße gespeichert und aufgezeichnet werden.

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

Menüelement	Menübereich	Beschreibung
Wählen		Durch Klicken auf „Wä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 Wert-Auswahlmenü, das verwendet wird, um die genauen Werte zu definieren und anzugeben, die der ausgewählten Variablen (wie im grünen Knopf links vom Gleichheitszeichen (=) angegeben) zugewiesen werden sollen.

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

Das Bild unten zeichnet die X,Y-Koordinaten der Maus auf, um das Maus-Tracking während einer Studie zu erfassen. Das folgende Bild zeigt, wie drei Aktionen verwendet werden, um die Aufzeichnung des Variablenwerts zu ermöglichen. Die Variable (links) wird manuell erstellt, während der Wert auf der rechten Seite des Gleichheitszeichens (=) ein wertspezifischer Wert für den Maus-Trigger ist, auf den das System verweist und den Sie bei der Aufzeichnung von Werten verwenden können.

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

Aktion "Copy to Clipboard"

Wirkung: Kopiert einen Variablenwert in die Zwischenablage des Computers.

Aktion "Draw Random Number"

Wirkung: Zeichnet 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
• Mehrfache Ziehungen (boolescher Wert true/false): Wählen Sie einmal oder mehrmals zu ziehen.
• Nr 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 Variable speichern: Wählen Sie eine Variable aus, in der die Werte gespeichert werden.

Aktion "Get URL Parameter"

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

Parameter:

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

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

Aktion "Read from/Write to Device"

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

Parameter:

• Wählen Sie „aus dem lokalen Gerät lesen“ oder „schreiben“.
• Wählen Sie die zu lesende oder zu schreibende Variable.

Anwendungsbeispiel: Langzeitstudien/Multi-Sitzungsstudien.

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

Aktion "Read from/Write to Shared Variable"

Wirkung: 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 jede einzelne Person sein.

Parameter:

• Wählen Sie die zu synchronisierende Variable aus. Muss entweder skalar oder ein Array sein.
• Erweiterte Optionen
  • Speicher-Schlüssel: Wählen Sie den Namen einer Variablen, die als Schlüssel zur Zugreifung auf die synchronisierte Variable fungiert.
  • Lese- oder Schreibmethode:
    • Gemeinsame Variable lesen, modifizieren und dann schreiben: liest die Variable, nimmt eine Änderung vor und sendet dann die Variable an die Studie.
    • Nur shared value from server lesen: ruft die Variable ab, die innerhalb der Studie geteilt wird, nimmt jedoch keine Änderungen vor.
    • Nur Variable zum Server schreiben: ändert die gemeinsame Variable, zeigt sie jedoch nicht den Teilnehmern an.
    • Werte zwischen verschiedenen Teilnehmern (nicht nur zwischen Sitzungen) teilen: Ermöglicht es den Teilnehmern, die synchronisierten Variablenwerte über Sitzungen hinweg zu sehen. Diese Option ist standardmäßig ausgewählt, kann aber durch Klicken auf das Kontrollkästchen abgewählt werden.
• Aktionssequenz:
  • Wählen Sie aus, was mit der geteilten/synchronisierten Variablen aus der Liste aller verfügbaren Aktionen geschehen soll.

Anwendungsbeispiel: Langzeitstudien/Multi-Sitzungsstudien

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

Aktion "Math & Statistics"

Wirkung: Führt eine mathematische Operation für eine 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, stdev, usw.)
• Eingangs-Array: Wählen Sie eine Eingangsvariable (Array), auf die die Operation ausgeführt wird
• Parameter: Einige Operationen haben zusätzliche Parameter.
• Ausgabe: Wählen Sie eine Ausgangsvariable, in der das Ergebnis gespeichert wird.

Aktion "Record Variables Instantly"

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

Parameter: Keine

Aktion "Moving Average Filter"

Wirkung: Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingabe 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: Gewichtete Proben, so dass die Gewichte der Proben linear abnehmen.
  • Exponentieller gleitender Durchschnitt: Gewichtete Proben, so dass die Gewichte der Proben exponentiell abnehmen.
• Anzahl der Proben: Bestimmt, wie viele Proben pro Schritt verwendet werden.
• Eingabe: Wählen Sie eine Eingangsvariable (Array), auf die der gleitende Durchschnitt berechnet wird
• Ausgabe: Wählen Sie eine Ausgangsvariable, in der das Ergebnis gespeichert wird.

Aktion "Distribute Variable"

Die Aktion „Verteilungsvariable“ 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 Stimuliorte und etwaige Änderungen) auf den Bildschirmen der Teilnehmer abzubilden.

Beim Auswählen 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 funktionsfähige Dialogfeld der Verteilungsvariablenaktion aussieht, wenn alle Menüelemente ausgefüllt sind. In diesem Beispiel wird die Verteilungsvariable als eine Aktion verwendet, um einen Chat zwischen zwei Teilnehmern zu erstellen, indem der Wert einer Variablen von einem Eingabefeldobjekt verteilt wird.

Sie können sich hier eine Demo ansehen, die die Distributionsvariable und die Chatbox-Funktion umfasst: Bildbeschreibungstest mit Chat-Add-On.

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

Menüelement	Menübereich	Optionen und Beschreibungen der Verteilungsvariablenaktion
Wert verteilen an		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.
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.
Rate Limit Strategy		Die Ratenbeschränkungsstrategie ist eine Möglichkeit, Ihr Experiment vor Überflutung des Servers zu schützen und dient als vorsorgliche Strategie zur Steuerung der Rate, mit der Anfragen (d.h. Aktualisierungen über die verteilte Variable) an den Server gesendet werden. Die folgenden Strategieoptionen sind verfügbar: Debounce: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Servernachrichten „debounced“ (nur die aktuellste 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 eingeschränkt (d.h. nachdem 100 ms seit der letzten gesendeten Nachricht vergangen sind, wird nur die neueste Nachricht verteilt). Discard: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Nachrichten innerhalb dieses 100 ms Fensters verworfen. Queue: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Variablenwerte in eine Warteschlange gestellt (bis zu einer maximalen Warteschlangengröße von 10 Nachrichten).

Array-Aktionen

Aktion "Aus Array lesen"

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

Parameter:

• Array-Variable: Eingangs-Array für das Auslesen des Wertes.
• Indextyp: Bestimmt, welche Art von Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für die Leseoperation. In diesem Fall geben Sie die Position ein, von 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.
• Ausgangsvariable: Wählen Sie eine skalare Variable aus, in der der ausgelesene Wert gespeichert wird.

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

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

Parameter:

• Array-Variable: Array-Variable, in der die Hinzufügen- oder Entfernen-Operation ausgeführt werden soll.
• Indextyp: Bestimmt, welche Art von Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für die Einfüge-/Löschoperation. In diesem Fall geben Sie die Array-Position ein, an der die Einträge eingefügt / gelöscht werden sollen. (1-basiert).
  • Variabel: Verwenden Sie eine numerische Variable als Index für die Einfüge-/Löschoperation. In diesem Fall wählen Sie eine skalare numerische Variable 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.
• Nr. der zu löschenden Einträge: Entfernt die Array-Einträge (bevor neue Einträge eingefügt werden) beginnend ab der definierten Indexposition. 0 bedeutet, dass keine Werte entfernt werden.
• Variable(n), die eingefügt werden sollen: Wählen Sie eine oder mehrere skalare Variable(n) aus, die an der definierten Indexposition zur Array-Variable hinzugefügt werden.

Aktion "Array-Eintrag ändern"

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

Parameter:

• Array-Variable: Array-Variable, in der ein Wert geändert werden soll
• Indextyp: Bestimmt, welche Art von Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für die Ersetzungsoperation. In diesem Fall geben Sie die Array-Position an, die geändert werden soll (1-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 enthält.

Aktion "Array-Einträge mischen"

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

Parameter: Keine

Datenrahmenoperationen

Aktion "Aus Datenrahmen lesen / In Datenrahmen schreiben"

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

Parameter:

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

Aktion "Datenrahmeneinträge mischen"

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

Parameter:

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

Sprungaktionen

Aktion "Zu springen"

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

Parameter:

• Zu springen: Bestimmt, wo hin gesprungen werden soll im Experiment.
  • Nächster Frame: Springt zum nächsten Frame. Wenn keine weiteren Frames in einem Versuch definiert sind, springt es zu dem 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, zu dem sie springen möchten.
  • Bestimmter Versuch: Springt zu einem bestimmten Versuch. Benutzer wählen direkt die Versuchsnummer, zu der sie springen möchten.
  • Bestimmte Aufgabe: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Benutzer wählen direkt die Aufgabe, zu der sie springen möchten.
  • Bestimmter Block: Springt zur ersten Instanz des angegebenen Blocks. Benutzer wählen direkt den Block, zu dem sie springen möchten.
• Überprüfen, ob erforderliche Antworten gegeben sind: Wenn aktiviert, überprüft das Experiment, ob alle erforderlichen Antworten bereits beantwortet wurden. Wenn nicht, wird die Sprungaktion nicht ausgeführt.

Aktion "Sitzung akzeptieren/beenden"

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

Parameter:

• Versuchsdaten vor dem Beenden der Sitzung aufzeichnen: Wenn aktiviert, werden die kürzlichsten Versuchsdatensätze gespeichert (an den Server gesendet), bevor die Studie verlassen wird.
• Standardabschlussseite anzeigen: Wenn aktiviert, wird der standardmäßige Labvanced-Endbildschirm angezeigt. Wenn dies eine Crowdsourcing-Sitzung ist (Crowdsourcing-Link wurde verwendet), wird der Entschädigungscode dem Teilnehmer angezeigt. Wenn deaktiviert, wird das Experiment nach der Anzeige des aktuellen Frames beendet und es wird nicht der standardmäßige Endbildschirm mit Entschädigungscode angezeigt.

Aktion "Sitzung ablehnen/enden"

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

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

Parameter: Keine

Aktion "Umleitung zu URL"

Wirkung: Leitet den Teilnehmer zu einer bestimmten URL um.

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

Steueraktionen

Anforderungen (Wenn... Dann... Sonst) Aktion

Wirkung: Bewertet eine Wenn-Dann-Anweisung und führt eine Reihe von Aktionen abhängig aus. Jede Wenn/Wenn-Anweisung 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 "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.).
• 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 dann ausgeführt werden sollen, wenn mehrere Anforderungen erfüllt sind.
• Aktionssequenz: Jede Wenn / Sonst-Anweisung hat eine Liste von Aktionen, die unter "Dann" definiert sind. Die Aktionssequenz listet alle Aktionen für eine bestimmte Wenn / Sonst-Anweisung auf. Eine neue Aktion kann über das Symbol „Aktion hinzufügen“ hinzugefügt werden. Die Aktionssequenz wird nur ausgeführt, wenn die Anforderungen der verbundenen Wenn / Sonst-Anweisung erfüllt sind.
• Sonst-Fall hinzufügen: Die Anforderungsaktion kann aus mehreren separaten Wenn/Wenn -> Dann Aussagen bestehen. Allerdings kann nur eine Aussage ausgeführt werden. Wenn eine Wenn/Wenn Aussage positiv bewertet wird (wahr zurückgibt), werden die Aktionen im Dann-Block ausgeführt und der Rest der Anforderungsaktion wird übersprungen.
• Sonst-Fall hinzufügen (wahr/falsch): Wenn aktiviert, wird eine standardmäßige / Rückfalloption zur Anforderungsaktion hinzugefügt. Wenn keine der Wenn/Wenn Aussagen ausgeführt wird (wahr zurückgeben), werden die Aktionen im Sonst-Fall ausgeführt.

Wiederholte Aktionen (While Loop) Aktion

Wirkung: Führt wiederholt eine Reihe von Aktionen aus, entweder sofort oder innerhalb eines definierten Intervalls. Eine Abbruchbedingung kann festgelegt werden, sodass die Ausführung der Schleife gestoppt wird.

Parameter:

• Ausführungsart: Wählen Sie zwischen sofortiger Ausführung oder zeitgesteuerter Ausführung
  • gesamten Loop ausführen: Dies wird die Schleife kontinuierlich ausführen, bis die Abbruchbedingung erfüllt ist.
  • alle ... ms ausführen: Dies wird die Schleife mit definiertem Intervall ausführen (z.B. die Schleife wird alle 50 ms ausgeführt).
• Definieren Sie die Anzahl der Schleifen: Wenn „alle ... ms ausführen“ ausgewählt ist, haben die Benutzer die Möglichkeit, einen numerischen Ganzzahlwert für die Anzahl der Schleifen zuzuweisen. Dies ersetzt die Notwendigkeit, eine Abbruchbedingung festzulegen.
• Ausführungsintervall: Dies bestimmt das Ausführungsintervall.
• Sofort starten (wahr/falsch): Wenn aktiviert, wird die Schleife sofort ausgeführt. Wenn deaktiviert, wird die Schleife im nächsten Ausführungsintervall gestartet.
• Mehrere Starts zulassen (wahr/falsch): Wenn aktiviert, können mehrere Schleifeninstanzen gleichzeitig gestartet werden. Wenn deaktiviert, kann immer nur eine Schleifeninstanz gleichzeitig ausgeführt werden.
• Abbruchbedingungen aktivieren (wahr/falsch): Wenn aktiviert, kann eine Abbruchbedingung für die Schleife festgelegt werden.
• Abbruchbedingungen: Die Abbruchbedingungen kann verwendet werden, um einen logischen Ausdruck festzulegen, wann die Ausführung der Schleife gestoppt werden soll. Ähnlich wie bei den Wenn/Wenn-Aussagen können Sie UND-Gruppen, ODER-Gruppen und Anforderungen für den logischen Vergleich kombinieren.
• Aktionssequenz: Die Aktionssequenz listet alle Aktionen auf, die bei jedem Durchlauf 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 Reihe von Aktionen nach einer bestimmten Verzö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 festgelegten 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 für eine einfachere visuelle Struktur zu gruppieren, 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-Trigger“ verwendet werden. Sie haben die folgenden Aktionen unter 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 im Tab Einstellungen eingeben.

Aktion "An Websocket senden"

Beim Auswählen dieser Aktion erscheinen die folgenden Optionen:

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

Für mehr Informationen über den API-Zugang besuchen Sie bitte diese Seite.

Aktion "An OpenAI senden"

Die Aktion „An OpenAI senden“ ermöglicht es Ihnen, Informationen, wie z.B. einen Zeichenfolgen-Eingabewert, an OpenAI zu senden. Bitte beachten Sie, dass für diese Option, um verfügbar zu sein, Sie Ihren API-Schlüssel im Tab Einstellungen unter Besondere Funktionen auflisten müssen.

Die folgenden Optionen erscheinen, wenn Sie dieses Ereignis anklicken:

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

Für ein besseres Verständnis, wie Sie diese Funktion verwenden können und sie in Aktion sehen, wenden Sie sich bitte an uns, um eine Demo zu erhalten, indem Sie dieses Kontaktformular ausfüllen.

HINWEIS: Verweisen Sie auch auf diese Anleitung, in der wir eine Studie Schritt für Schritt aufbauen, ChatGPT in eine Studie integrieren und diese Aktion nutzen.

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

Menüelement	Menübereich	Optionen der Aktion "An OpenAI senden"
Modelltyp		Gibt das KI-Modell an, das verwendet werden soll.
Chat-Historie-Datenrahmen		Verlinkt zu einer Datenrahmenvariablen mit zwei Spalten. Die erste Spalte bezeichnet die „Rolle“ und die zweite die „Chat-Nachricht.“ Die Werte aus der Aktion werden automatisch an den hier verlinkten Datenrahmen angehängt. Der Datenrahmen kann auch mit Datenrahmenaktionen manipuliert werden. Für weitere Informationen siehe bitte die Dokumentation von OpenAI.
Nachricht einfügen ‘+’		Durch Klicken darauf wird das Variablen-Dialogfeld angezeigt. 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

Code-Aktionen

In einigen Fällen muss Ihr Experiment möglicherweise benutzerdefinierten Code verwenden. Mit diesen Aktionen können Sie genau das tun! Die folgenden Optionen sind im Menü „Code-Aktionen“ verfügbar:

• JavaScript ausführen
• Globales CSS festlegen

JavaScript-Aktion ausführen

Die Aktion „JavaScript ausführen“ ermöglicht es Ihnen, spezifische Ereignisse zu programmieren und Labvanced-Variablen in Ihrer Studie zu lesen/festzulegen, 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 wurde, sehen Sie einen Bereich (einen Code-Editor), in dem der JavaScript-Code geschrieben werden sollte, sowie Anleitungen zur Verwendung:

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.

Einfügeaktion

Diese Option ermöglicht es Ihnen, eine Aktion einzufügen, die Sie zuvor erstellt und kopiert haben. Sie ermöglicht Ihnen einen schnelleren Arbeitsprozess beim Entwerfen Ihres Experiments, 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 zu erstellen.

Das Wertauswahlmenü

Bei der Arbeit mit bestimmten Ereignissen werden Sie feststellen, dass ein Stiftsymbol erscheint. Dies wird als Wertauswahlmenü bezeichnet, da es Ihnen ermöglicht, auszuwählen und anzuweisen, welche Art von Werten aufgezeichnet oder verfolgt werden sollen. Es ist eine sehr leistungsstarke und wichtige Option, die Sie für Ihr experimentelles Design und Setup verwenden müssen.

Dieses Stiftsymbol / Wertauswahlmenü erscheint an verschiedenen Stellen für bestimmte Aktionen im Ereignissystem, wie z. B. 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 gelesen oder geschrieben werden soll. Das Dropdown-Menü beginnt immer mit einer trigger-spezifischen Wertoption und geht dann zu den anderen 5 Kategorien (Aktuelle Zeit, Konstantwert, Variable, Rahmen / Aufgabe / Option und Operationen), von denen jede ihre eigenen Optionen hat. 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 der erste Menüeintrag links mit einer trigger-spezifischen Kategorie und wechselt dann zu den anderen 5 Kategorien (Aktuelle Zeit usw.).

Menüoptionen

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

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 ab Beginn des Rahmens

Aktuelle Zeit: UNIX-Zeitstempel

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

Aktuelle Zeit: Zeit ab Beginn des Rahmens

Dieser Wert erfasst die verstrichene Zeit seit Beginn des Rahmens. Meistens entspricht dies der Reaktionszeit.

Konstantwerte

Weisen Sie konstante Werte basierend auf dem Typ der benötigten Variable zu, wie z. B. Zeichenfolge 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
• Boolean
• Kategorial
• Datum
• Zeit
• Farbe

Konstant: Zeichenfolge

Weist einen Zeichenfolgen-/Textwert zu.

Konstant: Numerisch

Weist einen numerischen/Zahlenwert zu.

Konstant: Boolean

Weist einen Wert von wahr oder falsch zu.

Konstant: Kategorial

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

Konstant: Datum

Weist einen Datumswert zu.

Konstant: Zeit

Weist einen Zeitwert zu.

Konstant: Farbe

Weist einen Farbwert (Hexadezimalzeichenfolge) 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 sind verfügbar:

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

Variable auswählen

Erlaubt Ihnen, eine Variable auszuwählen und darauf zu verweisen.

Wert aus Array auswählen

Erlaubt Ihnen, einen Wert aus einem Array auszuwählen.

Wert aus Datenrahmen auswählen

Erlaubt Ihnen, einen Wert aus einem Datenrahmen auszuwählen, den Sie erstellt haben.

Rahmen / Aufgabe / Objektwerte

Ermöglicht das Abrufen von Werten, die mit Objekteigenschaften, dem Rahmen, Eye Tracking (falls aktiviert) und dem Gerät (Bildschirmaktualisierungsrate) verknüpft sind.

• Objekteigenschaft
• Rahmen
• Eye Tracking
• Gerät

Objekteigenschaft

Gibt eine Objekteigenschaft aus.

Rahmen

Eye Tracking

Gerät

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

Operationen

Verwenden Sie Operationen, um spezifische Änderungen an Ihren Variablen vorzunehmen, 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.

Essentiell ermöglicht die arithmetische Operation, Operationen an mehreren Werten durchzuführen.

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

Die Werte können mit diesen 5 verschiedenen Operationen manipuliert werden:

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

Das Beispiel unten zeigt, wie arithmetische Operationen genutzt 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 von zuvor erstellten Variablen (z. B. „userChatName“ und „chatInput“) unter Verwendung von konstanten Stringwerten, z. B. dem Semikolon : und dem gebrochenen Raum <br>, verwendet werden. 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 Wert durch.

Trigger-spezifische Werte

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

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

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

Name	Wertoptionen - Übersicht
Trigger (Maus)	Maus X Maus Y Maus [X,Y] Array Stimulusname Stimulusinfo Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Tastatur)	ID der Taste Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Button-Leiste)	Stimulusname Stimulusinfo Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Eingabe bei Betätigung)	ID der Taste Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Scrollen)	Stimulusname Stimulusinfo Scroll-Position X Scroll-Position Y Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Gamepad/Joystick)	Gamepad-Geräte-ID Gedrückte Tasten (Array) Gedrückte oder gehaltene Tasten (Array) Freigegebene Tasten (Array) Achsen (Array) Gamepad-Zeitstempel (Unix-Zeit) Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Eye-Tracking-Blick)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulusname Stimulusinfo Kamerafangzeit T Blickvertrauen C Koord. + Zeit [X,Y,T] Array Koord. + Zeit + Vertrauen [X,Y,T,C] Array Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Eye-Tracking-Fixierung)	Fixations-Zentrum X Fixations-Zentrum Y Fixations-Dauer Fixations-Beginnzeit Fixations-Endzeit Fixations-Streuung Stimulusname Stimulusinfo [X,Y,Dauer,Beginn,Ende,Streuung] Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Kopfverfolgung)	Kamerafangzeit T Kopf drehen Kopf neigen Kopf rollen Kopfposition [X,Y,T] Array Nasenposition [X,Y,T] Array Nasenvektor [X,Y,Z,T] Array Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Bei Aufgabendefinition)	Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Bei Rahmendefinition)	Versuchsnummer Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Bei Beginn des Rahmens)	Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Bei Ende des Rahmens)	Gesamtzeit im Rahmen Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Variablenwert geändert)	Neuer Wert in der Variablen Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Medienobjekt-Trigger)	Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Websocket-Trigger)	Nachricht Daten Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (OpenAI-Trigger)	Chat GPT-Antwort Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Globales Experiment-Ereignis)	Gesamtzeit im Rahmen Grund für globales Ereignis Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)
Trigger (Teilnehmer verlässt Experiment)	Übergebliebene Anzahl der Teilnehmer Trigger-Zeitstempel (Unix-Zeit) Trigger-Zeit (ab Beginn des Rahmens)

Trigger (Maus) Werte

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

Trigger (Tastatur) Werte

Wenn ein Tastatur-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen verwendet 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 verwendet werden:

Trigger (Eingabe bei Betätigung) Werte

Wenn ein Eingabe bei Betätigung-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen verwendet werden:

Trigger (Scroll) Werte

Wenn ein Scroll-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen verwendet 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 verwendet werden:

Trigger (Eye-Tracking-Blick) Werte

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

Trigger(Eye-Tracking-Fixierung) Werte

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

Trigger (Kopfverfolgung) Werte

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

Trigger (Bei Aufgabendefinition) Werte

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

Trigger (Bei Rahmendefinition) Werte

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

Trigger (Bei Beginn des Rahmens) Werte

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

Trigger (Bei Ende des Rahmens) Werte

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

Trigger (Variablenwert geändert) Werte

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

Trigger (Medienobjekt-Trigger) Werte

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

Trigger (Websocket-Trigger) Werte

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

Trigger (OpenAI-Trigger) Werte

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

Trigger (Globales Experiment-Ereignis) Werte

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

Trigger (Teilnehmer verlässt Experiment) Werte

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