Ereignissystem

Beschreibung

Das Ereignissystem ist für jede Studie unerlässlich. Es ist die Art und Weise, wie Sie Werte zum Aufzeichnen festlegen, das Experiment vorantreiben und Aufgaben erstellen. Benutzer können ein Ereignissystem erstellen, um alle Funktionalitäten, Logik und Interaktionen in einer Aufgabe auszuführen. Ein Ereignis fungiert oft als Vermittler zwischen Objekten und Variablen.

• Für eine vollständige Liste von Triggern
• Für die vollständige Liste von Aktionen
• Für weitere Informationen zum Wert-Auswahlmenü zum Festlegen von Werten unter Ereignissen

Das Ereignissystem besteht aus Triggern und Aktionen. Hier legen Sie Regeln fest, wie etwa „wenn dies passiert“ (Trigger), dann „tue dies“ (Aktion). Zum Beispiel: Wenn ein Teilnehmer auf ein bestimmtes Bild klickt (Trigger), dann zeige ein anderes, zufälliges Bild (Aktion).

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

Ereignisse erstellen - Übersicht

Ereignisse werden im Aufgaben-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 einen Klick auf + Trial Event, das das Ereignis auf alle Frames anwendet, erstellt werden. Alle vorhandenen Ereignisse werden in einer Listenansicht im rechten Seitenbereich angezeigt. Ereignisse sind auf Frame-Ebene definiert und können für jeden Frame getrennt/spezifisch sein oder in jedem Frame über ein Experiment hinweg dupliziert/dieselbe sein.

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

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

Die Ausführungsreihenfolge der Ereignisse kann angepasst werden. Standardmäßig sind Ereignisse mit demselben Trigger weiter oben in der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Wenn Sie ein vorhandenes Ereignis auswählen, werden die Einzelheiten im unteren rechten (Ereigniseigenschaften) Panel angezeigt. Zur besseren Übersicht können vorhandene Ereignisse auch 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 Veränderung einer Variablen, der Beginn 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 Tasten-Klicks Enter bei Eingabe Scroll-Trigger Gamepad/Joy-Stick-Trigger	Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der manuell vom Benutzer/Teilnehmer aktiviert werden kann, indem er beispielsweise die Maus bewegt, auf ein Tastaturfeld klickt, scrollt usw.
Physiologische Signal-Trigger	Eyetracking-Gaze Eyetracking-Fixation Headtracking	Physiologische Signal-Trigger treten auf, wenn ein spezifizierter physiologischer Input vorhanden ist, wie etwa das Ansehen eines bestimmten Elements oder Veränderungen in Kopfbewegungen.
Versuchs- und Frame-Trigger	Aufgaben-Init Frame-Init Frame-Start Frame-Ende	Diese Trigger treten in Bezug auf die experimentellen Versuche und Frames auf, z.B. wenn ein Frame beginnt oder endet.
Trigger bei geänderten Variablenwerten	Variable (Wert geändert)	Ein Trigger für das Ereignis tritt auf, wenn es eine Änderung eines spezifischen Variablenwertes gibt.
Medienobjekt-Trigger	Medienobjekt-Trigger	Dieser Trigger tritt in Bezug auf Medienobjekte auf, 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 es eingehende Daten von einer API gibt.
Globale Trigger	Experiment pausieren / fortsetzen Teilnehmer hat Multiuser-Studie verlassen	Globale Trigger beziehen sich auf alle wesentlichen Änderungen an einem Experiment, z.B. wenn es pausiert wird oder ein Teilnehmer in einer Multiuser-Studie verlässt.

Benutzereingabe-Trigger

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

Die folgende Tabelle bietet einen einführenden Überblick über alle Benutzer Eingabe-Trigger, die in Labvanced verfügbar sind. Jeder von ihnen wird in den kommenden Abschnitten detaillierter beschrieben.

Benutzer Eingabe-Trigger-Option	Übersicht
Maus-Trigger	Jede Mausbewegung kann als Trigger verwendet werden, um ein Ereignis zu initiieren, 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 als Trigger festlegen.
Tasten-Klicks	Schaltflächenobjekte, die in Labvanced erstellt werden, können als Trigger verwendet werden, um Ereignisse zu initiieren.
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 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, festlegen.
Gamepad/Joy-Stick-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 er ein Ereignis basierend auf irgendeiner Mausinteraktion initiiert, wie z.B.: Bewegung der Maus nach oben/unten, Klicken, Überfahren eines bestimmten Objekts, Verlassen eines bestimmten Objekts oder jede Bewegung überhaupt!

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

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

Menüpunkte	Menübereich	Maus-Trigger-Optionen und -Spezifikationen
Aktion Dropdown-Liste:		Die folgenden Maus-Trigger-Optionen sind in der Dropdown-Liste verfügbar: Klick: Ausgelöst durch Mausklick PressDown: Ausgelöst durch Mausklick PressUp: Ausgelöst durch das Loslassen der Maus Hover: Ausgelöst, wenn die Maus über ein Objekt fährt Leave: Ausgelöst, wenn die Maus von einem Objekt weggeht Bewege: Ausgelöst durch eine beliebige 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 Klicks auf die Schaltfläche, der das Ereignis auslösen wird. Mehrere Ziele können hinzugefügt werden, indem Sie die Option ‘+Ziel hinzufügen’ unten klicken.	Bei der Festlegung eines Ziels stehen die folgenden Optionen zur Verfügung: Trigger im Frame-Hintergrund: Der Maus-Trigger kann aktiviert werden, ohne auf ein Objekt oder Element zu klicken. Jedes Element: Der Maus-Trigger kann ausgelöst werden, wenn auf jedes Element im Frame geklickt wird. Ziele hinzufügen: Wählen Sie das spezifische Element(e), das(e) angeklickt werden muss, 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 mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

Tastatur-Trigger

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

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

Im Folgenden finden Sie eine vollständige Übersicht der Tasten und Optionen, die Sie bei der Verwendung von Tastatur-Triggern have:

Menüpunkte	Menübereich	Tastatur-Trigger-Optionen
Aktion Dropdown-Liste:		Dies sind die verfügbaren Tastaturaktionsoptionen: PressKey: Ausgelöst durch das Drücken der Taste (Taste ist gedrückt) Taste drücken oder gehalten: Auslöst, wenn die Taste entweder gedrückt oder gehalten wird ReleaseKey: Ausgelöst durch das Loslassen der Taste Hinweis: Eine Taste muss losgelassen werden, bevor sie erneut als Trigger „ausgelöst“ werden kann.
Tasten Welche Taste das Ereignis auslöst		Welche Taste als Trigger verwendet wird, kann hier angegeben werden, indem Sie die Optionen durch Klicken auf +Hinzufügen: auswählen: Pfeile: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben des englischen Alphabets Spezial: Sondertasten (Enter, Leertaste, Steuerung, 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 Option Ziffernblocktasten aktivieren ermöglicht die Verwendung von Ziffernblocktasten als Trigger innerhalb des Experiments. Für die Option Erlaubt Ereignisweitergabe wird, wenn mehrere Ereignisse denselben Tastatur-Trigger haben, dennoch alles ausgelöst/triggeriert. 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 mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

Tasten-Klick-Trigger

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

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

Hier ist ein genauerer Blick auf die dargestellten Elemente:

Menüpunkte	Menübereich	Optionen des Tasten-Klick-Triggers
Ziel: +Ziel festlegen		Auswahl eines Schaltflächenelements als Ziel
Schaltfläche: Option		Geben Sie an, welche spezifische Schaltfläche im Frame ausgewählt wird.

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

Enter bei Eingabe-Trigger

Trigger bei: Die Enter/Rücktaste 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 mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

Scroll-Trigger

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

Parameter:

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

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

Hinweis: Für langen Text muss im Panel 'Objekteigenschaften' im Abschnitt 'Stil' die Optionen Overflow-X und/oder Overflow-Y die Auswahl scroll haben.

• Hinweis: Nachdem Sie den Scroll-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Scrollwerte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

Gamepad/Joystick-Trigger

Der Gamepad/Joy-Stick-Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem experimentellen Design als Eingabegerät zur Aufzeichnung von Daten zu nutzen. Hinweis: Vergessen Sie nicht, diese Option unter dem Einstellungen Tab zu aktivieren.

Erfahren Sie mehr.

Physiologische Signal-Trigger

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

Eyetracking-Gaze-Trigger

Trigger bei:

• Insgesamt wird dieser Trigger aktiviert, wenn das Eyetracking aktiviert wurde.
• Nur auslösen, wenn auf spezifische Elemente geschaut wird.

Parameter:

• Wenn Sie ausgewählt haben, dass nur Trigger bei spezifischen Elementen auftreten, 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 nutzen und zu referenzieren.

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 nutzen und zu referenzieren.

Headtracking-Trigger

Trigger bei:

• Änderungen in der Kopfposition oder Kopfbewegungen.

• 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 nutzen und zu referenzieren.

Versuchs- und Frame-Trigger

Aufgaben-Init-Trigger

Trigger bei:

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

Dieser Trigger eignet sich gut für die Shuffle- und Read From-Aktionen. Mit diesen Kombinationen können Sie Array-Einträge oder Datenrahmen beim Start der Aufgabe mischen und Teilnehmer Gruppen von Stimuli zuweisen, ohne mehrere Ereignisse erstellen zu müssen, 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 nutzen und zu referenzieren.

Frame-Init-Trigger

Trigger bei:

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

Dieser Trigger eignet sich gut für die 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 ebnet, um zu beginnen, während der Frame startet.

Hinweis: Verwenden Sie den Frame-Init-Trigger nicht mit Ereignissen, die eine Variable aufzeichnen oder die systemvariable wie die Versuchsnummer oder die Bedingungsnummer betreffen. Dies 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 als nächstes 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 nutzen und zu referenzieren.

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, beim tatsächlichen Start der Aufgabe/des Frames zurückgesetzt. Es wird eine Warnung angezeigt, wenn Sie dieses Ereignis verwenden:

Denken Sie daran, das Kontrollkästchen "Zurücksetzen beim Versuchsstart" im Variablen-Eigenschaftsfenster abzuwählen, wenn Sie nicht möchten, dass die Variablenwerte zurückgesetzt werden.

Frame-Start-Trigger

Trigger bei:

• 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 nutzen und zu referenzieren.

Frame-Ende-Trigger

Trigger bei:

• 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 nutzen und zu referenzieren.

Trigger bei geänderten Variablenwerten

Trigger bei geänderten Variablenwerten

Trigger bei:

• Der Wert einer Variablen ändert sich von seinem Ausgangswert

Parameter:

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

• Hinweis: Nachdem Sie den Trigger bei geänderten Variablenwerten im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Trigger bei geänderten Variablenwerten-Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

Medienobjekt-Trigger

Medienobjekt-Trigger

Früher bekannt als separate "Audio/Video-Steuerungs-Trigger" und "Steuerobjekt"-Trigger.

Trigger bei:

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

Parameter:

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

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

  • Audio- oder Videoobjektoptionen:
    • Wiedergabe gestartet: Ausgelöst, wenn das Element beginnt zu spielen
    • Wiedergabe gestoppt: Ausgelöst, wenn das Element pausiert
    • Wiedergabe beendet: Ausgelöst, wenn das Element aufhört zu spielen
  • Video-, Audio- oder Bildschirmaufnahmeobjektoptionen:
    • Aufnahme beendet: 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
  • Kamera-Snapshot-Objektoptionen:
    • Snapshot beendet: 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 nutzen und zu referenzieren.

API-Trigger

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

• Websocket-Trigger
• OpenAI-Trigger

Websocket-Trigger

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

Beim Klicken auf diese Option erscheinen die folgenden Elemente.

• Akzeptieren/Empfangen von: Erkennt automatisch die IP-Adresse des lokalem Hosts. Kann manuell im Einstellungen Tab unter Besondere Funktionen geändert werden.
• Trigger/Nachricht: Geben Sie die Nachricht ein, die als Trigger dienen soll. Geben Sie „any“ ein, um mehr als eine Nachricht als Trigger zu akzeptieren.

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

Für weitere Informationen zum 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 über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

OpenAI-Trigger

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

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

HINWEIS: Siehe auch diesen Leitfaden, in dem wir eine Studie Schritt für Schritt erstellen, ChatGPT in die Studie integrieren und diesen Trigger nutzen.

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

Wenn Sie auch die „Senden an OpenAI“-Aktion verwenden, müssen Sie 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 nutzen und zu referenzieren.

Globale Trigger

Globale Trigger treten immer dann auf, wenn innerhalb des Experiments eine wesentliche Änderung auftritt, d.h. etwas, das „global“ ist, wie das Pausieren des Experiments oder ein Teilnehmer, der eine Multiuser-Studie verlässt! Folgende Optionen werden als globale Trigger aufgeführt:

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

Pause/Fortsetzen des Experiments

Der „Pausieren/Fortsetzen des Experiments“-Trigger ist eine Option, die es Ihnen ermöglicht, ein Ereignis basierend darauf auszuführen, ob das Experiment pausiert oder fortgesetzt wird.

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

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

• Experiment fortgesetzt: Teilnehmer setzt die Studie wieder fort. Dieser Trigger funktioniert gut bei Eyetracking-Studien. Er kann verwendet werden, um den Teilnehmer zu einem vorherigen Versuch oder Frame zurückzuschicken, wenn er sein virtuelles Kinnstütz 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 nutzen und zu referenzieren.

Teilnehmer hat Multiuser-Studie verlassen

Wenn ein Teilnehmer eine Multiuser-Studie verlässt, kann dies ebenfalls als Trigger für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Multiuser-Studie verlässt, wirkt sich dies auf globaler Ebene auf das Experiment aus, weil es anderen Teilnehmern das Fortfahren der Studie verweigert.

Mit der Auswahl dieses Triggers können Sie angeben, welche Art von Aktion passiert, wenn ein Teilnehmer eine Multiuser-Studie verlässt.

• Hinweis: Nachdem Sie den Teilnehmer hat Multiuser-Studie verlassen-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Werte über verschiedene Aktionen hinweg mit dem Wert-Auswahlmenü zu nutzen und zu referenzieren.

Aktionen

Aktionen definieren, was passieren soll, wenn das Ereignis ausgeführt wird. Sie können verwendet werden, um Variablen und Objekteigenschaften zu ändern, Daten aufzuzeichnen, Daten von/zu Arrays zu lesen und zu schreiben oder zum nächsten Versuch oder zur nächsten Aufgabe zu springen. Oft gibt es mehrere Aktionen pro Ereignis. Mit "ControlActions" kann man logische Operationen (If-Else-Anweisungen), Schleifen, Callback-Funktionen sowie das Verschachteln von Aktionen innerhalb anderer Aktionen (z.B. eine while-Schleife innerhalb einer if-Anweisung) verwenden. Daher kann das Ereignissystem als grafische Programmierumgebung angesehen werden. In dieser Sichtweise 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 Aktionen, die in Labvanced verfügbar sind:

Aktionskategorie	Aktionsoptionen	Beschreibung
Objektaktionen	Objekteigenschaft festlegen Medienobjekt steuern Objekt kopieren Für jedes Objekt	Objektaktionen beziehen sich auf jede Manipulation, die an einem Objekt durchgeführt wird, das innerhalb der Aufgabe existiert.
Variablenaktionen	Variable festlegen / aufzeichnen In die Zwischenablage kopieren Zufallszahl ziehen URL-Parameter abrufen Von/zu Gerät lesen/schreiben Von/zu geteilten Variablen lesen/schreiben Mathematik & Statistik Variablen sofort aufzeichnen Gleitender Durchschnittsfilter Variable verteilen	Jede Aktion, die aus oder eine Variablenwert aufzeichnet.
Array-Aktionen	Aus Array auswählen (lesen) Array-Einträge hinzufügen/entfernen Array-Eintrag ändern (ersetzen) Array-Einträge mischen	Array-Operationen umfassen das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und deren Einträgen.
Datenrahmennoperationen	Von/zu Datenrahmen lesen/schreiben Datenrahmeneinträge mischen	Diese Aktionen sind relevant, wenn Sie .csv-Dateien (Datenrahmen) in Ihrem Experiment verwenden.
Sprungaktionen	Sprung zu Akzeptieren / Sitzung beenden Ablehnen / Sitzung beenden Umleitung zur URL	Ermöglicht es Ihnen, im Experiment zu navigieren, indem Sie zu einem bestimmten Abschnitt springen, sowie die Abschnitte der Teilnehmer zu akzeptieren und abzulehnen.
Kontrollaktionen	Anforderungsaktionen (Wenn…Dann) Wiederholte Aktionen (While-Schleife) Verzögerte Aktionen (Zeit-Callback) Aktionsgruppe	Kontrollaktionen werden verwendet, um spezifische Sequenzen von Ereignissen auszuführen, wie z.B. Wenn/Dann-Logik, Schleifen (wie das wiederholte Abspielen eines Sounds oder das Blitzen eines Bildes) sowie um eine Verzögerung festzulegen, wann eine Aktion eintritt.
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 Globales CSS festlegen	Code-Aktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten.
Einfüge-Aktion	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, das innerhalb der Aufgabe existiert, durchgeführt wird. 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 Belieben ändern, indem Sie das betreffende Objekt, die zu ändernde Eigenschaft und den neuen Wert angeben.

Mehr erfahren.

Aktion „Medienobjekt steuern“

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

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

Parameter:

• Ziel: Wählen Sie ein Medienobjekt aus
• Effekt: Wählen Sie eine Unteraktion aus
  • Audio- oder Videoobjektoptionen:
    • Wiedergabe starten: Beginnt mit dem Abspielen der Video-/Audio-Datei
    • Wiedergabe stoppen: Stoppt die Video-/Audio-Datei
    • Wiedergabe pausieren: Pausiert die Video-/Audio-Datei
    • JumpToTime: ermöglicht es Ihnen, eine Zeit in Millisekunden anzugeben, zu der in der Audio-/Videodatei gesprungen werden soll
    • Stummschalten: Schaltet den Ton des Objekts aus
    • Wiederherstellen: Stellt den Ton des Objekts wieder her
  • Audio-, Video- oder Bildschirmaufnahmeobjektoptionen:
    • Aufnahme starten: Startet 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 dem Abspielen der aufgenommenen Datei
    • Wiedergabe stoppen: Stoppt das Abspielen der aufgenommenen Datei
    • Aufnahme pausieren: pausiert die Aufnahme des Objekts
    • Aufnahme fortsetzen: setzt die Aufnahme des Objekts fort
  • Datei-Upload-Objektoptionen:
    • Upload starten: beginnt den Upload-Prozess für die ausgewählte Datei
    • Datei löschen: Löscht die ausgewählte Datei
    • Datei wählen: erlaubt 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, den Snapshot ins Experiment hochzuladen
    • Snapshot aufnehmen: macht ein Bild mit der Kamera des Teilnehmers

Aktion „Objekt kopieren“

Wirkung: Kopiert ein Objekt und ersetzt damit 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, um die Namen der Kopien zu bestimmen.
• Namen mit inkrementierendem Postfix zuweisen: Fügt dem Ende des neuen Elementnamens ein numerisches Etikett hinzu, um die Kopien zu unterscheiden.
• Aktionssequenz: Ermöglicht Ihnen die Auswahl (aus der üblichen Liste von Aktionen), was mit den Kopien geschehen soll. Wählen Sie "CurrentObject" als Ziel aus, 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, das angesteuert werden soll.
• Zusätzlichen Namensfilter zulassen: Geben Sie den Namen des/der zu steuernden Objekte ein. Bei mehreren Objekten in einem Frame, von denen einige identische Namen haben, funktioniert dies gut.
• Aktionssequenz: Ermöglicht Ihnen die Auswahl (aus der üblichen Liste von Aktionen), was mit den ausgewählten Elementen geschehen soll. Wählen Sie "CurrentObject" als Ziel aus, um die Aktion auf alle Elemente anzuwenden, die die oben angegebenen Kriterien erfüllen.

Variablenaktionen

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

Die folgende Tabelle bietet eine einführende Übersicht über alle in Labvanced verfügbaren Variablenaktionsoptionen. Jede von ihnen wird in den folgenden Abschnitten näher erläutert.

Variablenaktionsoption	Beschreibung
Set / Record Variable	Schreib oder lege einen Variablenwert fest
Copy to Clipboard	Kopiert einen Variablenwert in die interne Zwischenablage des Computers.
Draw Random Number	Zieht eine oder mehrere zufällige Zahlen 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 Speicher des lokalen Geräts. Diese Aktion speichert Daten auf dem Gerät des Teilnehmers, anstatt sie 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 auf einigen Eingangsvariablen (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 bestimmten Eingabe und speichert das Ergebnis in einer neuen Variablen.
Distribute Variable	Wird verwendet, um einen Wert an andere Teilnehmer zu senden. Der Wert wird in einer Variablen gespeichert.

Set / Record Variable-Aktion

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

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

Menüpunkte	Menübereich	Beschreibung
Select		Durch Klicken auf "Auswählen" geben Sie an, welche Variable den Wert speichern soll. Hier können Sie auch eine neue Variable erstellen.
Stiftsymbol		Das Stiftsymbol symbolisiert das Werteauswahlmenü, das verwendet wird, um die genauen Werte festzulegen 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 namens counter erstellt und eine arithmetische Option aus dem Werteauswahlmenü verwendet, um den Variablenwert um 1 zu erhöhen (basierend auf dem im vorherigen Schritt definierten Trigger).

Das Bild unten zeichnet die Maus-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 der Variablenwerte zu ermöglichen. Die Variable (links) wird manuell erstellt, während der Wert auf der rechten Seite des Gleichheitszeichens (=) ein Mausauslöserspezifischer Wert ist, auf den das System zugreift, wenn Werte aufgezeichnet werden.

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

Copy to Clipboard-Aktion

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

Draw Random Number-Aktion

Wirkung: Zieht eine oder mehrere zufällige Zahlen und speichert sie in einer Variablen

Parameter:

• Typ: Wählen Sie zwischen kontinuierlichen und diskreten Werten
• Verteilung: Wählen Sie zwischen normaler und gleichmäßiger Verteilung
• Mehrfache Ziehungen (boolean true/false): Wählen Sie, ob einmal oder mehrfach gezogen werden soll.
• Anzahl der Ziehungen: Wählen Sie die Anzahl der Ziehungen aus
• 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 der Variablen speichern: Wählen Sie eine Variable aus, in der die Werte gespeichert werden.

Get URL Parameter-Aktion

Wirkung: Speichert einen Wert aus der einzigartigen URL des Teilnehmers

Parameter:

• Parametername: Geben Sie den Namen des gewünschten Parameters ein
• In der Variablen 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, die für die Datenanalyse notwendig sind, zu extrahieren.

Read from/Write to Device-Aktion

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

Parameter:

• Wählen Sie aus, ob vom lokalen Gerät gelesen oder darauf geschrieben werden soll.
• Wählen Sie die Variable aus, die gelesen oder geschrieben werden soll.

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

• Mit dieser Aktion können gerätespezifische Daten über Sitzungen hinweg übertragen werden, sofern der gleiche Teilnehmer für jede Sitzung dasselbe Gerät verwendet.
• Zum Beispiel kann diese Aktion verwendet werden, um aufzuzeichnen, welche Bilder jedem Teilnehmer in Sitzung 1 angezeigt wurden, und sicherzustellen, dass ihnen in Sitzung 2 andere Bilder angezeigt werden.
  • Erstellen Sie ein Array von Bildern und wählen Sie einige zufällig aus, die in jeder Sitzung präsentiert werden sollen.
  • Schreiben Sie auf das Gerät: die Indexnummer der in Sitzung 1 präsentierten Bilder.
  • Lesen von Gerät: In Sitzung 2 die Indizes der Bilder aus Sitzung 1 auslesen und eine JavaScript-Aktion einfügen, die verhindert, dass diese Indizes für die zweite Sitzung ausgewählt werden.

Read from/Write to Shared Variable-Aktion

Wirkung: Liest von oder schreibt in eine Variable, die über 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 für den Zugriff auf die synchronisierte Variable dient.
  • Lese- oder Schreibmethode:
    • Read, modify, then write shared variable: liest die Variable, ändert sie und sendet dann die Variable an die Studie.
    • Only read shared value from server: ruft die innerhalb der Studie geteilte Variable ab, ändert jedoch nichts.
    • Only write variable to server: ändert die geteilte Variable, zeigt sie jedoch nicht den Teilnehmern an.
    • Werte zwischen verschiedenen Teilnehmern teilen (nicht nur zwischen Sitzungen): Ermöglicht Teilnehmern, die synchronisierten Variablenwerte über Sitzungen hinweg zu sehen. Diese Option ist standardmäßig ausgewählt, kann jedoch durch Klicken auf das Kontrollkästchen abgewählt werden.
• Aktionssequenz:
  • Wählen Sie aus, was mit der geteilten/synchronisierten Variablen aus der Liste aller verfügbaren Aktionen passiert.

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

• Mit dieser Aktion können teilnehmerspezifische Daten über Sitzungen hinweg übertragen und unter den Teilnehmern über Sitzungen hinweg geteilt werden.
• Zum Beispiel können Sie diese Aktion verwenden, um eine Punktzahl in einem Test aufzuzeichnen und es dann dem Teilnehmer ermöglichen, seine Punktzahl mit der Durchschnittspunktzahl der anderen Teilnehmer, die den Test abgeschlossen haben, zu vergleichen.
• Ein weiteres Beispiel (ähnlich der Aktion Read from/Write to Device) wäre, dass 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 zu zeigen oder diese Bilder von den verfügbaren Optionen eines anderen Teilnehmers auszuschließen.

Math & Statistics-Aktion

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

Parameter:

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

Record Variables Instantly-Aktion

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

Parameter: Keine

Moving Average Filter-Aktion

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

Distribute Variable-Aktion

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

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

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

Sehen Sie sich diese Demo an, die die Distribute Variable- und Chatbox-Funktion hier integriert: Bildbeschreibungstest mit Chat-Erweiterung.

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

Menüpunkte	Menübereich	Optionen und Beschreibung der Distribute Variable-Aktion
Distribute value to		Wählen Sie aus, an welche anderen Teilnehmer der Wert gesendet werden soll. Alle Teilnehmer: Senden Sie diesen Wert an alle Teilnehmer Ausgewählte Teilnehmer: Senden Sie den Wert an ausgewählte Teilnehmer.
Choose target variable and value		Zielvariable: Wählen Sie eine Zielvariable aus, in der der Wert gespeichert wird. Wert: Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.
Block		Wenn aktiviert, kann die Zielvariable nicht geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist.
Rate Limit Strategy		Die Ratenbegrenzungsstrategie ist ein Weg, um Ihr Experiment vor einer Überlastung des Servers zu schützen, und fungiert als vorbeugende Strategie zur Steuerung der Rate, mit der Anforderungen (d.h. Updates über die verteilte Variable) an den Server gesendet werden. Die folgenden Strategiewahlen sind verfügbar: Debounce: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Servernachrichten „debounced“ (nur die letzte Nachricht wird nach einem Intervall von 100 ms ohne Ausführung dieser Aktion gesendet). Throttle: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Nachrichten throttled (d.h., nachdem 100 ms seit der letzten gesendeten Nachricht vergangen sind, wird nur die letzte Nachricht verteilt). Discard: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Nachrichten innerhalb dieses 100 ms Fensters verworfen. Queue: Wenn diese Aktion mehr als einmal pro 100 ms Zeitfenster ausgeführt wird, werden neue Variablenwerte in eine Warteschlange eingereiht (bis zu einer maximalen Warteschlangenlänge von 10 Nachrichten).

Array-Aktionen

Aktion „Von Array auswählen (lesen)“

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

Parameter:

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

Aktion „Einträge zum Array hinzufügen/entfernen“

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

Parameter:

• Array-Variable: Array-Variable, in der die Hinzufügungs- oder Entfernungsoperation ausgeführt werden soll.
• Indextyp: Bestimmt, welche Art von Index verwendet wird.
  • Fest: Verwenden Sie einen festen Index für die Einfügungs-/Löschoperation. In diesem Fall geben Sie die Position im Array an, an der die Einträge eingefügt/gelöscht werden sollen. (1 basierend).
  • Variabel: Verwenden Sie eine numerische Variable als Index für die Einfügungs-/Löschoperation. In diesem Fall wählen Sie eine skalar 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 (bevor neue Einträge eingefügt werden) ab der definierten Indexposition. 0 gibt an, dass keine Werte entfernt werden.
• Zu hinzufügende(n) Variable(n): Wählen Sie eine oder mehrere skalar Variable(n) aus, die an der definierten Indexposition zur Array-Variable hinzugefügt werden.

Aktion „Array-Eintrag ändern (ersetzen)“

Wirkung: Wird verwendet, um einen Wert innerhalb eines Arrays zu ersetzen/zu ändern.

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 Position im Array an, die geändert werden soll (1 basierend).
  • Variabel: Verwenden Sie eine numerische Variable als Index für die Ersetzungsoperation. In diesem Fall wählen Sie eine skalar 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 (skalar) Variable aus, die den neuen Wert enthält.

Aktion „Array-Einträge mischen“

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

Parameter: Keine

Datenrahmenoperationen

Aktion „Von/bis Datenrahmen lesen/schreiben“

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

Parameter:

• Datenrahmenvariable: Wählen Sie die Variable des Datenrahmens zum Lesen aus.
• Lesen oder Schreiben: Wählen Sie aus, ob vom ausgewählten Datenrahmen gelesen oder in den ausgewählten Datenrahmen geschrieben werden soll.
• Nach Zeile oder Spalte: Wählen Sie aus, wie die Daten gelesen werden sollen.
• Indextyp: Wählen Sie den Typ der Indexvariablen aus, die zum Lesen des Datenrahmens verwendet wird. Kann fest, variabel oder die letzte Zeile sein.
• Indexvariable: Wählen Sie die Variable aus, die als Index zum Lesen des Datenrahmens verwendet wird.
• Ausgabewert: Wählen Sie die Variable aus, 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 Datenrahmen aus, der gemischt werden soll.
• Wählen Sie aus, ob der Datenrahmen nach Zeilen oder Spalten gemischt werden soll.

Sprungaktionen

Aktion „Springen zu“

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:

• Springen zu: Bestimmt, wohin im Experiment gesprungen werden soll.
  • Nächstes Frame: Springt zum nächsten Frame. Wenn im Versuch keine weiteren Frames definiert sind, springt es zum ersten Frame des nächsten Versuchs.
  • Nächster Versuch: Springt zum nächsten Versuch. Wenn keine weiteren Versuche definiert sind, springt es zum ersten Versuch der nächsten Aufgabe.
  • Nächste Aufgabe: Springt zur nächsten Aufgabe. Wenn keine weiteren Aufgaben definiert sind, springt es zur ersten Aufgabe des nächsten Blocks.
  • Nächster Block: Springt zum nächsten Block. Wenn keine weiteren Blöcke definiert sind, endet die Sitzung.
  • Vorheriges Frame: Springt zum vorherigen Frame. Wenn es keine vorherigen Frames gibt, wird die Aktion nicht ausgeführt.
  • Bestimmtes Frame: Springt zu einem bestimmten Frame. Benutzer wählen direkt das Frame aus, zu dem gesprungen werden soll.
  • Bestimmter Versuch: Springt zu einem bestimmten Versuch. Benutzer wählen direkt die Versuchsnummer aus, zu der gesprungen werden soll.
  • Bestimmte Aufgabe: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Benutzer wählen direkt die Aufgabe aus, zu der gesprungen werden soll.
  • Bestimmter Block: Springt zur ersten Instanz des angegebenen Blocks. Benutzer wählen direkt den Block aus, zu dem gesprungen werden soll.
• Erforderliche Antworten überprüfen, bevor: Wenn aktiviert, prüft das Experiment, ob alle erforderlichen Antworten bereits beantwortet wurden. Andernfalls wird die Sprungaktion nicht ausgeführt.

Aktion „Session akzeptieren/beenden“

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

Parameter:

• Versuchsdaten aufzeichnen, bevor die Sitzung abgeschlossen wird: Wenn aktiviert, werden die neuesten Versuchsdaten gespeichert (an den Server gesendet), bevor das Studium verlassen wird.
• Standardabschlussseite anzeigen: Wenn aktiviert, wird die Standard-Endseite von Labvanced angezeigt. Wenn es sich um eine Crowdsourcing-Sitzung handelt (Crowdsourcing-Link wurde verwendet), wird der Entschädigungscode dem Teilnehmer angezeigt. Wenn dies deaktiviert ist, endet das Experiment, nachdem das aktuelle Frame angezeigt wurde, und es wird nicht die Standardabschlussseite mit dem Entschädigungscode angezeigt.

Aktion „Session ablehnen/beenden“

Wirkung: Beendet die Aufzeichnungssitzung, markiert die Daten des Teilnehmers jedoch NICHT als abgeschlossen und zeigt NICHT die Standardabschlussseite mit dem Entschädigungscode an.

Bei Verwendung dieser Aktion zur Ablehnung der Daten eines Teilnehmers sollten die Benutzer eine angemessene Nachricht an die Teilnehmer anzeigen, die den Grund erklärt, warum sie nicht für ihre Zeit 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.

Steuerungsaktionen

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

Wirkung: Bewertet eine Wenn-Dann-Aussage und führt eine Reihe von Aktionen abhängig aus. Jede Wenn/Else-If-Aussage besteht aus geschachtelten UND/ODER-Vergleichen, um zu überprüfen, 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 „Werteauswahl“-Menü wird auf beiden Seiten erscheinen, 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 ausgeführt werden sollen, wenn mehrere Anforderungen erfüllt sind.
• Aktionssequenz: Jede Wenn/Else-If-Aussage hat eine Liste von Aktionen, die unter „Dann“ definiert sind. Die Aktionssequenz listet alle Aktionen für eine bestimmte Wenn/Else-If-Aussage auf. Eine neue Aktion kann über das Symbol „Aktion hinzufügen“ hinzugefügt werden. Die Aktionssequenz wird nur ausgeführt, wenn die Anforderungen der zugehörigen Wenn/Else-If-Aussage erfüllt sind.
• Else-If-Fall hinzufügen: Die Anforderungsaktion kann aus mehreren separaten Wenn/Else-If --> Dann-Aussagen bestehen. Allerdings kann nur eine Aussage ausgeführt werden. Wenn eine Wenn/Else-If-Aussage positiv bewertet wird (wahr zurückgibt), werden die Aktionen im Dann-Block ausgeführt und der Rest der Anforderungsaktion übersprungen.
• Else-Fall hinzufügen (wahr/falsch): Wenn aktiviert, wird eine Standard-/Fallback-Option zur Anforderungsaktion hinzugefügt. Wenn keine der Wenn/Else-If-Aussagen ausgeführt wird (wahr zurückgibt), werden die in dem Else-Fall definierten Aktionen ausgeführt.

Wiederholte Aktionen (While Loop) Aktion

Wirkung: Führt wiederholt eine Reihe von Aktionen entweder sofort oder in einem definierten Intervall aus. Eine Stop-Bedingung kann angegeben werden, damit die Schleifen-Ausführung gestoppt wird.

Parameter:

• Ausführungstyp: Wählen Sie zwischen sofortiger Ausführung oder zeitgesteuerter Ausführung
  • Vollständige Schleife ausführen: Diese Schleife wird ununterbrochen ausgeführt, bis die Stopp-Bedingung erfüllt ist.
  • Alle ... ms ausführen: Diese Schleife wird im definierten Intervall ausgeführt (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 Male, die die Schleife ausgeführt werden soll, zuzuweisen. Dies ersetzt die Notwendigkeit, eine Stopp-Bedingung zu definieren.
• 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 parallel gestartet werden. Wenn deaktiviert, kann immer nur eine Schleifeninstanz zur selben Zeit ausgeführt werden.
• Stopp-Bedingung aktivieren (wahr/falsch): Wenn aktiviert, kann eine Stopp-Bedingung für die Schleife angegeben werden.
• Stopp-Bedingung: Die Stopp-Bedingung kann verwendet werden, um einen logischen Ausdruck anzugeben, wann die Ausführung der Schleife gestoppt werden soll. Ähnlich wie bei den Wenn/Else-If-Aussagen kann man UND-Gruppen, ODER-Gruppen und Anforderungen für den logischen Vergleich kombinieren.
• 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 Reihe 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 Dauer 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 zusammenzufassen, um eine einfachere visuelle Struktur zu schaffen, aber auch, wenn Sie mehrere Aktionen gleichzeitig kopieren, duplizieren oder löschen möchten.

Mehr erfahren.

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. Ihnen stehen 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 aufgerufen werden: https://www.labvanced.com/page/library/51053 indem Sie auf „Untersuchen“ klicken.

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

Aktion „An OpenAI senden“

Die Aktion „An OpenAI senden“ ermöglicht es Ihnen, Informationen, wie z.B. einen Zeichenfolgenwerte, an OpenAI zu senden. Bitte beachten Sie, dass Sie für diese Option Ihren API-Schlüssel im Tab Einstellungen unter Sonderfunktionen angeben müssen.

Die folgenden Optionen erscheinen, wenn Sie dieses Ereignis klicken:

Hier ist ein funktionsfähiges Beispiel, wie dieses Ereignis aussieht, wenn alle notwendigen Informationen bereitgestellt werden:

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

HINWEIS: Schauen Sie sich auch diesen Walkthrough an, in dem wir eine Studie Schritt für Schritt aufbauen und ChatGPT in eine Studie integrieren und diese Aktion verwenden.

Hier ist eine näher erläuterte Erklärung der Felder, die in der Aktion „An OpenAI senden“ enthalten sind:

Menüpunkte	Menübereich	Optionen der Aktion „An OpenAI senden“
Model Type		Gibt das KI-Modell an, das verwendet werden soll.
Chat History Dataframe		Verlinken zu einer Datenrahmenvariablen mit zwei Spalten. Die erste Spalte bezeichnet die „Rolle“ und die zweite Spalte die „Chatnachricht“. Die Werte der Aktion werden automatisch zu dem hier verlinkten Datenrahmen hinzugefügt. Der Datenrahmen kann auch mit Datenrahmenaktionen manipuliert werden. Für weitere Informationen siehe bitte die Dokumentation von OpenAI.
Insert Message ‘+’		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 High-Level-ChatGPT-System user: der Teilnehmer assistant: Bezieht sich auf eine spezifische Unterrolle, die im System erstellt wurde

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

Code-Aktionen

In einigen Fällen kann es erforderlich sein, dass Ihr Experiment benutzerdefinierten Code verwendet. Mit diesen Aktionen können Sie genau das tun! Die folgenden Optionen sind im Menü der „Code-Aktionen“ verfügbar:

• JavaScript ausführen
• Globales CSS festlegen

Aktion „JavaScript ausführen“

Die Aktion „JavaScript ausführen“ ermöglicht es Ihnen, spezifische Ereignisse zu programmieren und Labvanced-Variablen in Ihrer Studie durch Eingabe von benutzerdefiniertem JavaScript zu lesen/zu setzen, das als Aktion ausgeführt wird, wenn es ausgelöst wird.

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

Globale CSS-Aktion festlegen

Mit der Aktion „Globale 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 auf diese Aktion klicken:

Ein Beispiel für die Verwendung der Aktion „Globale 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. Es ermöglicht Ihnen, schneller zu arbeiten, während Sie Ihr Experiment entwerfen, damit Sie nicht ständig die gleichen Elemente erneut auswählen müssen. Wenn Sie beispielsweise ein Ereignis haben, das einem bereits vorhandenen ähnelt, können Sie es einfach kopieren, einfügen und anpassen, anstatt es von Grund auf neu zu erstellen.

Das Wertenwahlmenü

Bei der Arbeit mit bestimmten Ereignissen wird ein Stiftsymbol erscheinen. Dies wird als Wertenwahlmenü bezeichnet, da es Ihnen ermöglicht, auszuwählen und anzuweisen, welche Art von Werten erfasst oder verfolgt werden soll. Es ist eine sehr leistungsstarke und wichtige Option, die Sie für Ihr experimentelles Design und Setup nutzen werden.

Dieses Stiftsymbol / Wertenwahlmenü erscheint an verschiedenen Stellen für bestimmte Aktionen im Ereignissystem, wie die Aktion „Variable festlegen / aufzeichnen“, die Aktion „Objekteigenschaft festlegen“ und die Anforderung (Wenn ... Dann) Aktion, wie unten gezeigt.

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

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

Menüoptionen

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

Aktuelle Zeitwerte

Mit der Option „Aktuelle Zeit“ können Sie Werte im Zusammenhang mit der Zeit erfassen oder darauf verweisen.

Die folgenden Optionen sind verfügbar:

• UNIX-Zeitstempel
• Zeit seit dem Beginn des Frames

Aktuelle Zeit: UNIX-Zeitstempel

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

Aktuelle Zeit: Zeit seit dem Beginn des Frames

Dieser Wert erfasst die Zeit, die seit dem Beginn des Frames vergangen ist. Dies entspricht häufig der Reaktionszeit.

Konstantwerte

Weisen Sie Konstantwerte basierend auf dem Typ der erforderlichen Variablen zu, wie 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 Zeichenfolge- / Textwert zu.

Konstant: Numerisch

Weist einen numerischen / Zahlenwert zu.

Konstant: Boolean

Weist einen Wert von true oder false zu.

Konstant: Kategorial

Weist einen Niveau-Wert zu (hauptsächlich für Faktoren).

Konstant: Datum

Weist einen Datumswert zu.

Konstant: Zeit

Weist einen Zeitwert zu.

Konstant: Farbe

Weist einen Farbwert (Hex-Zeichenfolge) zu.

Variablenwerte

Gibt eine Variable an oder verweist darauf oder wählt 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 Ihnen, eine Variable auszuwählen und darauf zu verweisen.

Wert aus Array auswählen

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

Wert aus Datenrahmen auswählen

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

Frame / Aufgabe / Objekte Werte

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

• Objekteigenschaft
• Frame
• Augenverfolgung
• Gerät

Objekteigenschaft

Gibt eine Objekteigenschaft aus.

Frame

Augenverfolgung

Gerät

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

Operationen

Verwenden Sie Operationen, um spezifizierte Änderungen an Ihren Variablen vorzunehmen, wie 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
• Mathe-Operation

Arithmetik

Arithmetische Operationen sind für viele verschiedene Zwecke nützlich, einschließlich des Kombinierens von Zeichenfolgen und sogar des Modifizierens von Objekteigenschaften.

Grundsätzlich ermöglicht die arithmetische Operation, Operationen an mehreren Werten durchzuführen.

Nach Auswahl dieser Option erscheint ein zusätzliches Stiftsymbol (dh. Wertenwahlmenü) sowie eine Liste von Operationen, wie z. B. Addition.

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

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

Das folgende Beispiel 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 in Verbindung mit einer Kombination aus zuvor erstellten Variablen (z. B. 'userChatName' und 'chatInput') sowie konstanten Zeichenfolgenwerten, z. B. dem Semikolon : und dem brechenden Abstand <br>, verwendet werden. Diese Aktion erzeugt den Effekt eines Benutzerchats, der in einer Multi-User-Studie verwendet werden kann.

String-Operation

Mathe-Operation

Führt eine mathematische Operation an 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 spezifiziert wird (wie bei der Verwendung einer Set / Record Variable Aktion oder einer Set Object Property Aktion), auf maus-spezifische Werte im Wertenwahlmenü 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 Set / Record Variable Aktion aufzuzeichnen.

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

Name	Überblick über Wertoptionen
Trigger (Maus)	Maus X Maus Y Maus [X,Y] Array Stimulus-Name Stimulus-Info Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Tastatur)	Id der Taste Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn) li>
Trigger (Button-Leiste)	Stimulus-Name Stimulus-Info Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Eingabe bei Drücken der Eingabetaste)	Id der Taste Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Scrollen)	Stimulus-Name Stimulus-Info Scrollposition X Scrollposition Y Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Gamepad/Joystick)	Gamepad-Geräte-ID Gedrückte Tasten (Array) Gedrückte oder gehaltene Tasten (Array) Freigegebene Tasten (Array) Achsen (Array) Zeitstempel des Gamepads (Unixtime) Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Augenverfolgung Gaze)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulus-Name Stimulus-Info Zeit des Kamerafangs T Vertraulichkeit des Blicks C Koord. + Zeit [X,Y,T] Array Koord. + Zeit + Vertraulichkeit [X,Y,T,C] Array Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Augenverfolgung Fixierung)	Fixierungssensor X Fixierungssensor Y Fixierungsdauer Startzeit der Fixierung Endzeit der Fixierung Dispersion der Fixierung Stimulus-Name Stimulus-Info [X,Y,Dauer,Start,Ende,Disp] Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Kopfverfolgung)	Zeit des Kamerafangs T Kopfneigung Kopfneigung Kopfroll Kopfposition [X,Y,T] Array Nasenposition [X,Y,T] Array Nasenvektor [X,Y,Z,T] Array Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Bei Aufgabeninitialisierung)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Bei Frame-Init)	TrialNr Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (bei Framebeginn)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Bei Frame-Ende)	Gesamtzeit im Frame Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Variable Wert geändert)	Neuer Wert in der Variablen Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Medienobjekt-Trigger)	Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Websocket-Trigger)	Nachricht Daten Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (OpenAI-Trigger)	Chat GPT-Antwort Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Globale Experimentereignis)	Gesamtzeit im Frame Grund für das globale Ereignis Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)
Trigger (Benutzer verlässt das Experiment)	Verbleibende Anzahl der Teilnehmer Trigger-Zeitstempel (Unixtime) Trigger-Zeit (seit Framebeginn)

Trigger (Maus) Werte

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

Trigger (Tastatur) Werte

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

Trigger (Button-Leiste) Werte

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

Trigger (Eingabe bei Drücken der Eingabetaste) Werte

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

Trigger (Scrollen) Werte

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

Trigger (Augenverfolgung Gaze) Werte

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

Trigger (Augenverfolgung Fixierung) Werte

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

Trigger (Kopfverfolgung) Werte

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

Trigger (Bei Aufgabeninitialisierung) Werte

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

Trigger (Bei Frame-Init) Werte

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

Trigger (bei Framebeginn) Werte

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

Trigger (Bei Frame-Ende) Werte

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

Trigger (Variable Wert geändert) Werte

Wenn ein Variable-Wert-geändert-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte bei der Arbeit mit bestimmten Aktionen aufgerufen werden:

Trigger (Medienobjekt-Trigger) Werte

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

Trigger (Websocket-Trigger) Werte

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

Trigger (OpenAI-Trigger) Werte

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

Trigger (Globale Experimentereignis) Werte

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

Trigger (Benutzer verlässt das Experiment) Werte

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