Ereignissystem

Beschreibung

Das Ereignissystem ist für jede Studie unerlässlich. So richten Sie Werte ein, die aufgezeichnet werden sollen, lassen das Experiment fortschreiten und erstellen Aufgaben. Benutzer können ein Ereignissystem erstellen, um alle Funktionen, Logik und Interaktionen in einer Aufgabe auszuführen. Ein Ereignis fungiert häufig als Mediator zwischen Objekten und Variablen.

• Für eine vollständige Liste der Trigger
• Für die vollständige Liste der Aktionen
• Für weitere Informationen zum Value-Select-Menü zum Setzen von Werten unter Ereignissen

Das Ereignissystem besteht aus Triggern und Aktionen. Hier richten Sie Regeln ein, wie "wenn dies passiert" (Trigger), dann "tu 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, beachten Sie bitte dieses kurze Video:

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

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

Einen Trigger auswählen

Wenn Sie ein neues Ereignis erstellen, öffnet sich die Triggerauswahl als Kachelraster. Die Triggerarten sind nach Kategorien organisiert (Benutzereingabe, Physiologisches Signal, Versuch und Frame, Variable, Medienobjekt, API und Global). Ein Suchfeld oben lässt Sie die Triggerarten nach Namen filtern. Klicken Sie auf eine Kachel, um sie als Trigger des Ereignisses festzulegen.

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

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 stehen Ereignisse mit demselben Trigger weiter oben in der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Beim Auswählen eines bestehenden Ereignisses werden die Einzelheiten im unteren rechten (Ereigniseigenschaften) Panel angezeigt. Für eine bessere Übersicht können bestehende 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 Tasteneingabe, eine Änderung einer Variablen, der Beginn einer Videodatei oder viele andere Dinge sein. Alle Trigger und ihre Einstellungen / Parameter werden in der folgenden Liste erklärt:

Trigger-Kategorie	Trigger-Optionen	Beschreibung
User Input Triggers	Maus-Trigger Tastatur-Trigger Button-Klicks Eingabetaste bestätigen Scroll-Trigger Gamepad/Joystick-Trigger	Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der vom Benutzer/Teilnehmer manuell aktiviert werden kann, indem er beispielsweise die Maus bewegt, auf ein Tastenelement klickt, scrollt usw.
Physiological Signal Triggers	Eyetracking-Gaze Eyetracking-Fixierung Kopferkennung	Physiologische Signal-Trigger treten auf, wenn ein bestimmter physiologischer Input vorliegt, wie das Blicken auf ein bestimmtes Element oder Veränderungen in Kopfbewegungen.
Trial and Frame Triggers	Aufgabenbeginn Frame-Beginn Frame-Start Frame-Ende	Diese Trigger treten in Bezug auf die experimentellen Versuche und Frames auf, z. B. wenn ein Frame beginnt oder endet.
Variable Value Changed Trigger	Variable (Wert geändert)	Ein Trigger für das Ereignis tritt auf, wenn sich der Wert einer bestimmten Variablen ändert.
Media Object 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 Triggers	Websocket-Trigger Open AI-Trigger PostMessage empfangen	Dies sind Trigger, die auftreten, wenn Daten von einer API empfangen werden.
Global Triggers	Experiment pausieren / fortsetzen Teilnehmer hat die Multiuser-Studie verlassen	Globale Trigger beziehen sich auf wichtige Änderungen an einem Experiment, z. B. auf eine Pause oder wenn ein Teilnehmer einer Multiuser-Studie die Studie verlässt.

Benutzereingabe-Trigger

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

Die folgende Tabelle bietet eine einführende Übersicht über alle Benutzereingabe-Trigger, die in Labvanced verfügbar sind. Jeder von ihnen wird in den kommenden Abschnitten detaillierter beschrieben.

Benutzereingabe-Trigger-Option	Übersicht
Mouse 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.
Keyboard Trigger	Jeder Tastendruck kann als Trigger verwendet werden, um ein Ereignis zu initiieren. Sie können spezifische Tastaturbuchstaben oder -zahlen als Trigger festlegen.
Button-Clicks	Schaltflächenobjekte, die in Labvanced erstellt wurden, können als Trigger verwendet werden, um Ereignisse zu initiieren.
Enter on Input	Dieser Trigger wird häufig verwendet, wenn ein Teilnehmer während eines Experiments 'Enter' drückt, um seine schriftliche Antwort oder Eingabe in Textfeldbereichen zu übermitteln.
Scroll Trigger	Dieser Trigger tritt auf, wenn der Teilnehmer scrollt. Sie können x- oder y-Scroll-Richtungen festlegen 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 nutzen.

Maus-Trigger

Die Option 'Maus-Trigger' ist ein sehr beliebter Ereignistrigger, da sie ein Ereignis basierend auf jeder Mausinteraktion initiiert, wie z. B.: Mausbewegung nach oben/unten, Klicken, Hovering auf einem bestimmten 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' erfolgt:

Nachfolgend finden Sie eine vollständige Übersicht der Optionen, die Sie bei der Arbeit mit Mausauslösern haben:

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

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

Tastenauslöser

Die Option „Tastenauslöser“ ist eine weitere beliebte Möglichkeit, ein Ereignis auszulösen. Grundsätzlich kann jede Eingabe von der Tastatur als Auslöser verwendet werden. Dazu gehören: Drücken, Halten oder Loslassen einer Taste.

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

Nachfolgend finden Sie eine vollständige Übersicht der Tasten und Optionen, die Sie bei der Arbeit mit Tastenauslösern haben:

Menüpunk	Menübereich	Optionen für Tastenauslöser
Action Dropdown-Liste:		Dies sind die verfügbaren Tastaturaktionsoptionen: PressKey: Ausgelöst durch das Drücken einer Taste (Taste ist unten) Press oder Halte Taste: Ausgelöst, wenn entweder die Taste gedrückt oder gehalten wird ReleaseKey: Ausgelöst durch das Loslassen der Taste Hinweis: Eine Taste muss losgelassen werden, bevor sie erneut als Auslöser „auslösen“ kann.
Keys Welche Taste das Ereignis auslöst		Welche Taste als Auslöser verwendet wird, wird hier angegeben, indem Sie die Optionen auswählen, indem Sie auf +Add: klicken Pfeile: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben des englischen Alphabets Sonder: Sondertasten (Enter, Leerzeichen, Steuerung, Tab, Shift) F-Tasten: F1 bis F10 jede Taste: jede dieser Tasten ist akzeptabel Sie können mehrere Tastenauslöser hinzufügen, indem Sie erneut auf die Schaltfläche +Add: klicken
Zusätzliche Optionen		Die Option Zahlenblocktasten aktivieren ermöglicht es, die Zifferntasten als Auslöser innerhalb des Experiments zu verwenden. Für die Option Ereignisweitergabe zulassen gilt: Wenn mehrere Ereignisse denselben Tastenauslöser haben, dann lösen alle ohne ihn aus. Nur das erste wird ausgelöst, und die Ausführung des Ereignisses stoppt, nachdem das erste Ereignis abgeschlossen ist.

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

Schaltflächenklickauslöser

Wenn Sie ein 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 Auslöser für eine Aktion fungiert.

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

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

Menüpunk	Menübereich	Optionen für den Schaltflächenklickauslöser
Ziel: +Set Target		Auswahl eines Schaltfächen-Elements als Ziel
Button: Option		Geben Sie an, welche spezifische Schaltfläche im Rahmen

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

Drücken der Eingabetaste im Eingabefeld

Auslöser bei: Die Eingabetaste / 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: Nach der Auswahl des Drückens der Eingabetaste im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Eingabewerte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Scrollauslöser

Auslöser bei: Die Bildlaufleiste, das Scrollen auf dem Touchpad oder das Scrollrad an 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 Zielelement fest, auf das der Scrollauslöser angewendet werden soll.

Hinweis: Für langen Text müssen im Panel 'Objekteigenschaften' (/content/learn/de/guide/task-editor/objects.html#object-properties) unter dem Abschnitt 'Stil' die Optionen Overflow-X und/oder Overflow-Y als Auswahl ausgewählt werden.

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

Gamepad/Joystick-AUSLÖSER

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

Erfahren Sie mehr.

Physiologische Signal-Auslöser

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

Eye-Tracking-Blickauslöser

Auslöser bei:

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

Parameter:

• Wenn Sie ausgewählt haben, dass nur auf bestimmten Elementen ausgelöst wird, fügen Sie diese Elemente als Ziele hinzu.

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

Eye-Tracking-Fixationsauslöser

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

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

Kopfverfolgungs-AUSLÖSER

Auslöser bei:

• Änderungen in der Kopfhaltung oder Kopfbewegung.

• Hinweis: Nach der Auswahl des Kopfverfolgungs-AUSLÖSERS im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Kopfverfolgungswerte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

### Test- und Rahmenauslöser

#### Aufgabeninitialisierungsauslöser
Auslöser bei: 
* Dem ersten Rahmen des ersten Versuchs einer Aufgabe. Wird nur einmal pro Aufgabe ausgeführt, obwohl er im Ereignis-Tab für alle Instanzen dieses Rahmens angezeigt wird.

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

Parameter: Keine

* **Hinweis:** Nachdem Sie den Aufgabeninitialisierungsau löser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [augspezifische Aufgabeninitialisierungswerte](#trigger-on-task-initialization-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


#### Rahmeninitialisierungsau löser
Auslöser bei:
* Der Initialisierung des Rahmens, bevor er für den Teilnehmer sichtbar wird. 

Dieser Auslöser passt gut zu den Aktionen "Mischen", "Von lesen" und "Zufallszahl ziehen". Mit diesen Kombinationen können diese Aktionen ausgeführt werden, bevor der Rahmen erscheint, was einen klaren Weg für andere Aktionen schafft, um zu beginnen, wenn der Rahmen startet. 

**Hinweis:** Verwenden Sie den Rahmeninitialisierungsau löser nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Versuchszahl oder Bedingungsnummer beinhalten. Dies liegt daran, dass der Rahmeninitialisierungsau löser zwischen den Versuchen auftritt, sodass keine vollständig genaue Zählung des Versuchs oder der Bedingung angezeigt wird, die gerade dargestellt wird. 

Parameter: Keine

* **Hinweis:** Nachdem Sie den Rahmeninitialisierungsau löser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische Initialisierungswerte](#trigger-on-frame-init-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


**Hinweis zu Aufgaben- und Rahmeninitialisierungsau lösern:** Da die Aufgaben- und Rahmeninitialisierungsau löser vor dem Start der Aufgabe oder des Rahmens auftreten, werden Variablen, die in dieser Zeit erstellt werden, zurückgesetzt, wenn die Aufgabe/der Rahmen tatsächlich beginnt. Eine Warnung wird angezeigt, wenn Sie dieses Ereignis verwenden: 

![rahmeninitialisierungswarnung](/content_imgs/learn/guide/task-editor/frame-init-var-reset.webp)

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

#### Rahmenstartauslöser
Auslöser bei:
* Beginn des Rahmens 

Parameter: Keine

* **Hinweis:** Nachdem Sie den Rahmenstartauslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische Rahmenstartwerte](#trigger-on-frame-start-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


#### Rahmenendau löser
Auslöser bei:
* Ende des Rahmens (nachdem der Rahmen nicht mehr sichtbar ist)

Parameter: Keine

* **Hinweis:** Nachdem Sie den Rahmenendau löser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische Rahmenendwerte](#trigger-on-frame-end-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


### Variablenwerte geändert Auslöser

#### Variablenwerte geändert 
Auslöser bei:
* Der Wert einer Variable ändert sich von ihrem ursprünglichen Wert

Parameter:
* Variablen: Wählen Sie eine oder mehrere Variablen aus, bei denen Sie Änderungen "abhören" möchten. Jede Änderung des Wertes dieser Variablen löst sofort die entsprechende Aktion aus. 

* **Hinweis:** Nachdem Sie den Variablenwerte geändert Auslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische Variablenwerte geändert Werte](#trigger-variable-value-changed-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


### Medienobjektau löser

#### Medienobjektau löser

Früher bekannt als der separate "Audio/Video Steuerelement-Au löser" und "Objektsteuerung" Auslöser.

Auslöser bei:
* Start, Pause oder Stop eines Video- oder Audiodateiformats
* Datei-Upload abgeschlossen, Datei ausgewählt, Aufnahme beendet eines Aufnahmeobjekts 
* Snapshot abgeschlossen oder Upload abgeschlossen eines Kamera-Snapshot-Objekts

Parameter:
* Ziel: Wählen Sie ein Objekteelement aus, das im Rahmen vorhanden ist
* Ausführen bei: Wählen Sie eine Unterart des Auslösers
    * Audio- oder Videoobjektoptionen:
        * Wiedergabe gestartet: Auslöser, wenn das Element zu spielen beginnt
        * Wiedergabe gestoppt: Auslöser, wenn das Element pausiert
        * Wiedergabe beendet: Auslöser, wenn das Element aufhört zu spielen
    * Video-, Audio- oder Bildschirmaufnahmeobjektoptionen:
        * Aufnahme beendet: Auslöser, wenn die Audioaufnahme gestoppt ist
        * Upload abgeschlossen: Auslöser, wenn der Datei-Upload abgeschlossen ist
    * Datei-Upload-Objektoptionen:
        * Datei ausgewählt: Auslöser, wenn eine Datei ausgewählt ist
        * Upload abgeschlossen: Auslöser, wenn der Datei-Upload abgeschlossen ist
    * Kamera-Snapshot-Objektoptionen:
        * Snapshot abgeschlossen: Auslöser, wenn die Kamera erfolgreich einen Snapshot aufgenommen hat
        * Upload abgeschlossen: Auslöser, wenn der Snapshot mit dem Hochladen abgeschlossen ist 

* **Hinweis:** Nachdem Sie den Medienobjektau löser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische Medienobjektwerte](#trigger-media-object-trigger-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


### API-Au löser

Wenn Sie Daten von einem externen Server in Labvanced senden oder kommunizieren müssen, können 'API-Au löser' und [‘API-Aktionen’](/content/learn/de/guide/task-editor/event-system.html#api-actions) verwendet werden. Folgendes kann als Auslöser verwendet werden:
* Websocket-Au löser
* OpenAI-Au löser
* PostMessage empfangen

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


#### Websocket-Au löser

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_trigger.webp" alt="Die Websocket-Au löser-Menüoption." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Bei Auswahl dieser Option erscheinen die folgenden Elemente. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/websocket_dialog.webp" alt="Das Websocket-Au löser-Dialogmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

* **Akzeptieren/Empfangen von:** Erkennt automatisch die IP-Adresse des lokalen Hosts. Kann manuell im Tab [`Settings`](/content/learn/de/guide/settings/) unter `Special Features` geändert werden. 
* **Auslöser/Nachricht:** Geben Sie die Nachricht ein, die als Auslöser dient. Geben Sie 'any' ein, um mehr als eine Nachricht als Auslöser zu akzeptieren.

Für ein Beispiel, wie API-Au löser / Aktionen verwendet werden, überprüfen Sie bitte diese Demo [https://www.labvanced.com/page/library/51053](https://www.labvanced.com/page/library/51053), indem Sie die Option 'Untersuchen' im Dialogfeld anklicken. 

**[Für weitere Informationen zum API-Zugriff besuchen Sie bitte diese Seite.](https://www.labvanced.com/content/learn/de/guide/api-access/)** 

* **Hinweis:** Nachdem Sie den WebSocket-Au löser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische WebSocket-Werte](#trigger-websocket-trigger-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


#### OpenAI-Au löser

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

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

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_dialog.webp" alt="Die OpenAI-Au löser-Menüoptionen." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

**HINWEIS:** Siehe auch [diese Anleitung](/content/learn/de/walkthroughs/2024-09-chatgpt-study-example/), in der wir eine Studie Schritt für Schritt aufbauen und ChatGPT in einer Studie integrieren und diesen Auslöser verwenden. 

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/openai_trigger_example.webp" alt="Ein Beispiel für den OpenAI-Auslöser in Labvanced." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Wenn Sie auch die [‘An OpenAI senden’-Aktion](#send-to-openai-action) verwenden, müssen Sie dort denselben Datenrahmen verwenden, den Sie hier angegeben haben. 

* **Hinweis:** Nachdem Sie den OpenAI-Au löser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische OpenAI-Werte](#trigger-openai-trigger-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren. 


#### PostMessage empfangen Auslöser

Der `PostMessage Received` Auslöser wird ausgelöst, wenn das laufende Experiment eine eingehende Nachricht von einer externen Quelle über die postMessage-API des Browsers empfängt. Er ist nützlich, um ein Experiment mit einer übergeordneten Seite, einer benutzerdefinierten Anwendung oder einer eingebetteten externen Website zu verbinden, die Daten in die Studie sendet.

[Erfahren Sie mehr.](/content/learn/de/guide/events/postmessage-received-trigger.html)

* **Hinweis:** Nachdem Sie den PostMessage empfangen Auslöser im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, [rahmenspezifische PostMessage empfangen Werte](#trigger-postmessage-received-values) in verschiedenen Aktionen mit dem [Wertauswahlmenü](#the-value-select-menu) zu verwenden und zu referenzieren.

Globale Auslöser

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

• Experiment anhalten / fortsetzen
• Teilnehmer hat die Mehrbenutzerstudie verlassen

Experiment anhalten / fortsetzen

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

Beim Auswählen dieses Auslösers erscheint die folgende Ansicht, in der Sie die Art des Auslösers weiter spezifizieren können, ob er beim Anhalten oder Fortsetzen des Experiments ausgeführt werden soll:

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

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

• Hinweis: Nach der Auswahl des Auslösers Anhalten/Fortsetzen des Experiments im Ereignissystem haben Sie die Option, auslöserspezifische Werte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und zu referenzieren.

Teilnehmer hat die Mehrbenutzerstudie verlassen

Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, kann dies ebenfalls als Auslöser für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, wirkt sich das auf globaler Ebene auf das Experiment aus, da es anderen Teilnehmern das Fortsetzen der Studie verweigert.

Durch das Auswählen dieses Auslösers können Sie angeben, welche Art von Aktion erfolgen soll, wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt.

• Hinweis: Nach der Auswahl des Auslösers Teilnehmer hat die Mehrbenutzerstudie verlassen im Ereignissystem haben Sie die Option, auslöserspezifische Werte über verschiedene Aktionen mit dem Wertauswahlmenü 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 Objekt-Eigenschaften zu ändern, Daten aufzuzeichnen, Daten aus Arrays zu lesen und zu schreiben oder zum nächsten Versuch oder zur nächsten Aufgabe zu springen. Oft gibt es mehrere Aktionen pro Ereignis. Mit "ControlActions" kann man logische Operationen (If-Else-Anweisungen), Schleifen, Rückruffunktionen sowie das Verschachteln von Aktionen innerhalb anderer Aktionen verwenden (z.B. eine While-Schleife innerhalb einer If-Anweisung). Daher kann das Ereignissystem als grafische Programmierumgebung angesehen werden. In dieser Sichtweise fungieren Auslöser als Funktionsaufrufe, während Aktionen die funktionale Logik beschreiben. Dieser Ansatz garantiert, dass nahezu jede experimentelle Logik ohne den Einsatz bestimmter programmatischer/syntaktischer Strukturen implementiert werden kann.

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

Aktionskategorie	Aktionsoptionen	Beschreibung
Object Actions	Objekteigenschaft festlegen Medienobjekt steuern Objekt kopieren Für jedes Objekt	Objektactionen beziehen sich auf jede Manipulation, die an einem Objekt vorgenommen wird, das innerhalb der Aufgabe existiert.
Variable Actions	Variable festlegen / aufzeichnen In Zwischenablage kopieren Zufallszahl ziehen URL-Parameter abrufen Von Gerät lesen / Schreiben Von / An gemeinsam genutzte Variable lesen / schreiben Mathematik & Statistik Variablen sofort aufzeichnen Gleitender Durchschnittsfilter Variable verteilen	Jede Aktion, die einen Variablenwert liest oder aufzeichnet.
Array Actions	Aus array auswählen (lesen) 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.
Data Frame Operations	Von / An Datenrahmen lesen / schreiben Datenrahmeneinträge mischen	Diese Aktionen sind relevant, wenn Sie mit .csv-Dateien (Datenrahmen) in Ihrem Experiment arbeiten.
Jump Actions	Springen zu Sitzung annehmen / beenden Sitzung ablehnen / beenden Zu URL umleiten	Ermöglicht es Ihnen, durch das Experiment zu navigieren, indem Sie zu einem bestimmten Abschnitt springen, sowie Teilnehmerabschnitte anzunehmen und abzulehnen.
Control Actions	Anforderungsaktionen (Wenn…Dann) Wiederholte Aktionen (While Schleife) Verzögerte Aktionen (Zeit-Rückruf) Aktionsgruppe	Steueraktionen werden verwendet, um spezifische Abfolgen von Ereignissen auszuführen, wie Wenn/Dann-Logik, Schleifen (wie das wiederholte Abspielen eines Sounds oder das Blitzen eines Bildes) sowie das Einrichten einer Verzögerung, wann eine Aktion erfolgt.
API Actions	Send PostMessage An Websocket senden An OpenAI senden	Bezieht sich auf API-spezifische Aktionen zum Senden von Daten an eine API.
Code Actions	JavaScript ausführen Globales CSS festlegen	Code-Aktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten.
Paste Action	Einfügeaktion	Ermöglicht Ihnen das Einfügen einer zuvor kopierten Aktion.

Objektactionen

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

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

Objekteigenschaft festlegen Aktion

Mit der Aktion „Objekteigenschaft festlegen“ können Sie das Erscheinungsbild eines Objekts nach Belieben ändern, indem Sie das betreffende Objekt, die Eigenschaft, die geändert werden soll, und den neuen Wert angeben.

Erfahren Sie mehr.

Medienobjekt steuern Aktion

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

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

Parameter:

• Ziel: Wählen Sie ein Medienobjekt aus
• Wirkung: Wählen Sie eine Unteraktion aus
  • Audio- oder Videoobjekt-Optionen:
    • Wiedergabe starten: Spielt die Video-/Audio-Datei ab
    • 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
    • Aktivieren: Stellt den Ton des Objekts wieder her
  • Audio-, Video- oder Bildschirmaufnahmeobjekt-Optionen:
    • Aufnahme starten: Startet eine neue (Audio-)Aufnahme
    • Aufnahme stoppen: Stoppt die (Audio-)Aufzeichnung
    • Upload starten: Beginnt mit dem Hochladen der Datei
    • Aufnahme löschen: Löscht die (Audio-)Aufzeichnungsdaten.
    • Wiedergabe starten: Spielt die aufgezeichnete Datei ab
    • Wiedergabe stoppen: Stoppt das Abspielen der aufgezeichneten Datei
    • Aufnahme pausieren: Pausiert die Aufnahme des Objekts
    • Aufnahme fortsetzen: Setzt die Aufnahme des Objekts fort
  • Datei-Upload-Objekt-Optionen:
    • Upload starten: startet den Hochladevorgang 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
  • Kamerasnapshot-Objekt-Optionen:
    • 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

Kopierobjekt-Aktion

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

Parameter:

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

Für Jede Objekt-Aktion

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

Parameter:

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

Variable Aktionen

Variable Aktionen werden verwendet, um Variablenwerte zu setzen oder zu erstellen, Werte zu dokumentieren und zu definieren, einschließlich Werte über Sitzungen hinweg.

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

Variablenaktionsoption	Beschreibung
Set / Record Variable	Schreiben oder Setzen eines Variablenwerts
Copy to Clipboard	Kopieren eines Variablenwerts in die interne Zwischenablage des Computers.
Draw Random Number	Ziehen einer oder mehrerer zufälliger Zahl(en) und Speichern dieser in einer Variablen
Get URL Parameter	Speichern eines Wertes aus der eindeutigen URL des Teilnehmers
Read from / Write to Device	Liest oder schreibt eine Variable aus/in den Speicher des lokalen Geräts. Diese Aktion speichert Daten auf dem Gerät des Teilnehmers, anstatt die Daten an die Labvanced-Server zu senden.
Read from / Write to Shared Variable	Liest von oder schreibt in eine Variable, die in den Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jeden einzelnen sein.
Math & Statistics	Führt eine mathematische Operation eines 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 Eingabe und speichert das Ergebnis in einer neuen Variablen.
Distribute Variable	Sendet einen Wert an andere Teilnehmer. Der Wert wird in einer Variablen gespeichert.

Setzen / Aufzeichnen von Variablenaktionen

Die 'Setzen / Aufzeichnen von Variablen'-Aktion wird in jedem Experiment in Labvanced verwendet, da es sich um die Speicherung und Aufzeichnung von Werten und Verhaltensmaßen handelt.

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
Select		Durch Klicken auf Auswählen geben Sie an, welche Variable den Wert speichern soll. Von hier aus können Sie auch eine neue Variable erstellen.
Stiftsymbol		Das Stiftsymbol symbolisiert das Werteauswahlmenü, das verwendet wird, um die genauen Werte zu definieren und anzugeben, die der ausgewählten Variablen zugewiesen werden sollen (wie im grünen Button links vom Gleichheitszeichen (=) angegeben).

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

Das folgende Bild zeichnet die Maus-X,Y-Koordinaten auf, um das Verfolgen der Maus 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 maus-Trigger-spezifischer Wert ist, auf den das System verweist und den Sie beim Aufzeichnen von Werten verwenden können.

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

In die Zwischenablage kopieren Aktion

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

Ziehen von zufälligen Zahlen Aktion

Wirkung: Zieht eine oder mehrere zufällige Zahl(en) und speichert diese 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 mehrmals gezogen werden soll.
• Nr 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 Variable speichern: Wählen Sie eine Variable aus, in der die Werte gespeichert werden.

URL-Parameter lesen Aktion

Wirkung: Speichert einen Wert aus der eindeutigen URL des Teilnehmers

Parameter:

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

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

Vom Gerät lesen/ins Gerät schreiben 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 die Daten an die Labvanced-Server zu senden.

Parameter:

• Wählen Sie "von dem lokalen Gerät lesen" oder "ins lokale Gerät schreiben".
• Wählen Sie die Variable, die gelesen oder geschrieben werden soll.

Anwendungsfall: Längsschnitt- / Multi-Sitzungsstudien

• Mit dieser Aktion können gerätespezifische Daten von Sitzung zu Sitzung übertragen werden, vorausgesetzt, der gleiche Teilnehmer verwendet dasselbe Gerät für jede Sitzung.
• Zum Beispiel können Sie diese Aktion verwenden, um aufzuzeichnen, welche Bilder jedem Teilnehmer in Sitzung 1 präsentiert wurden, und sicherzustellen, dass ihnen in Sitzung 2 andere Bilder präsentiert werden.
  • Erstellen Sie ein Array von Bildern und wählen Sie einige zufällig aus, um sie in jeder Sitzung zu präsentieren.
  • Schreiben ins Gerät: die Indexnummer der in Sitzung 1 präsentierten Bilder.
  • Lesen vom Gerät: in Sitzung 2 lesen Sie die Indizes der Bilder aus Sitzung 1 aus und schließen Sie eine JavaScript-Aktion ein, die verhindert, dass diese Indizes für die zweite Sitzung ausgewählt werden.

Vom / ins freigegebene Variable lesen/schreiben-Aktion

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

Parameter:

• Wählen Sie die zu synchronisierende Variable. Muss entweder skalare oder ein Array sein.
• Erweiterte Optionen
  • Speicher- Schlüssel: Wählen Sie den Namen einer Variablen, die als Schlüssel zum Zugriff auf die synchronisierte Variable dient.
  • Lese- oder Schreibmethode:
    • Lesen, ändern und dann die freigegebene Variable schreiben: liest die Variable, nimmt eine Änderung vor und sendet dann die Variable an die Studie.
    • Nur den freigegebenen Wert vom Server lesen: ruft die innerhalb der Studie geteilte Variable auf, ändert jedoch nichts.
    • Nur die Variable auf den Server schreiben: nimmt Änderungen an der freigegebenen Variable vor, 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 die 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 der Liste aller verfügbaren Aktionen aus, was mit der freigegebenen/synchronisierten Variablen passiert.

Anwendungsfall: Längsschnitt-/Multi-Session-Studien
* Mit dieser Aktion können teilnehmerbezogene Daten von Sitzung zu Sitzung übertragen und unter den Teilnehmern über Sitzungen hinweg geteilt werden.
* Zum Beispiel können Sie diese Aktion verwenden, um einen Score bei einem Test zu erfassen und dann dem Teilnehmer zu ermöglichen, seinen Score mit dem Durchschnitts-Score der anderen Teilnehmer, die den Test abgeschlossen haben, zu vergleichen.
* Ein weiteres Beispiel (ähnlich der Aktion „Von/Zurück zum Gerät lesen“) besteht darin, dass Teilnehmer 5 Bilder aus einer Auswahl auswählen, eine Aufgabe ausführen und diese 5 Bilder dann in einer späteren Sitzung erneut präsentieren. Der Unterschied besteht darin, dass diese Aktion verwendet werden kann, um anderen Teilnehmern die ausgewählten Bilder zu zeigen oder um diese Bilder von den verfügbaren Optionen eines anderen Teilnehmers auszuschließen. 

#### Mathematik- & Statistik-Aktion
Wirkung: Führt eine mathematische Operation eines Eingangsvariablen (Array) durch und speichert das Ergebnis in einer Ausgangsvariablen.

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

#### Variablen sofort aufzeichnen Aktion
Wirkung: Erstellt einen Snapshot aller Variablenwerte und sendet diesen an den Labvanced-Server.

Parameter: Keine

#### Gleitender Durchschnittsfilter Aktion
Wirkung: Berechnet einen Gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) eines Eingangs und speichert das Ergebnis in einer neuen Variablen.

Parameter:
* Filterform: Wählen Sie den Filtertyp
    * Einfacher Gleitender Durchschnitt: Berechnet einen einfachen gleitenden Durchschnitt, bei dem alle Proben das gleiche Gewicht haben.
    * Linear gewichteter gleitender Durchschnitt: Gewichtete Proben, sodass die Gewichte der Proben linear abnehmen.
    * Exponential gewichteter gleitender Durchschnitt: Gewichtete Proben, sodass die Gewichte der Proben exponentiell abnehmen.
* Anzahl der Proben: Bestimmt, wie viele Proben pro Schritt verwendet werden.
* Eingabe: Wählen Sie eine Eingangsvariable (Array), auf der der gleitende Durchschnitt berechnet wird
* Ausgabe: Wählen Sie eine Ausgangsvariable, in der das Ergebnis gespeichert wird.

#### Variable verteilen Aktion
Die Aktion „Variable verteilen“ ist entscheidend für [Multi-User-Studien in Labvanced.](https://www.labvanced.com/content/technology/de/multi-user-psychology-studies/) Mit dieser Aktion kann ein Variablenwert zwischen Teilnehmern geteilt werden, was es ermöglicht, Informationen (einschließlich Stimulusstandorte und alle Änderungen) auf den Bildschirmen der Teilnehmer anzuzeigen. 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_menu.webp" alt="Die Distribute Variable Aktion im Labvanced-Aktionsmenü." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_example.webp" alt="Die Distribute Variable wird mit allen Menüoptionen als Beispiel verwendet." width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

Schauen Sie sich diese Demo an, die die distribute variable und chatbox-Funktion verwendet: [Bildbeschreibung Aufgabe mit Chat-Add-On.](https://www.labvanced.com/page/library/3008)

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

| Menüelement | Menübereich |  Optionen und Beschreibungen zur Distribute Variable Aktion |
|:-----:|-----| ---------| 
| **`Distribute value to`** | ![Festlegen, an welche Teilnehmer die verteilte Variable gesendet wird](/content_imgs/learn/guide/task-editor/imgs/events/dist_participants.webp) | Wählen Sie, an welche anderen Teilnehmer der Wert gesendet werden soll. <ul><li>**Alle Teilnehmer:** Senden Sie diesen Wert an alle Teilnehmer</li><li>**Ausgewählte Teilnehmer:** Senden Sie den Wert an ausgewählte Teilnehmer. </li></ul> | 
| **`Choose target variable and value`** | ![Festlegen der Zielvariablen und Werte](/content_imgs/learn/guide/task-editor/imgs/events/dist_target.webp) | <ul><li> **Zielvariable:** Wählen Sie eine Zielvariable, in der der Wert gespeichert wird. </li><li>**Wert:** Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.</li> </ul>|
| **`Block`** | ![Blockoption der distribute variable](/content_imgs/learn/guide/task-editor/imgs/events/block_dist_variable.webp) | Wenn aktiviert, kann die Zielvariable nicht geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist. | 
| **`Rate Limit Strategy`**| ![Die Optionen der Ratenlimitstrategie der distribute variable](/content_imgs/learn/guide/task-editor/imgs/events/dist_rate_limit.webp) | Die Ratenlimitstrategie ist eine Möglichkeit, Ihr Experiment vor einer Überlastung des Servers zu schützen und fungiert als vorsorgliche Strategie zur Kontrolle der Rate, mit der Anfragen (d. h. Updates über die distribute variable) an den Server gesendet werden. Die folgenden Strategieoptionen sind verfügbar: <ul><li>**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).</li><li>**Throttle:** Wenn diese Aktion mehr als einmal pro 100 ms-Zeitfenster ausgeführt wird, werden neue Nachrichten gedrosselt (d. h., nachdem 100 ms seit der letzten gesendeten Nachricht vergangen sind, wird nur die neueste Nachricht verteilt).</li><li>**Discard:** Wenn diese Aktion mehr als einmal pro 100 ms-Zeitfenster ausgeführt wird, werden neue Nachrichten innerhalb dieses 100 ms-Fensters verworfen.</li><li>**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 Warteschlangenlänge von 10 Nachrichten).</li></ul> |

### Array-Aktionen 

#### Aus Array lesen (Select) Aktion
Wirkung: Liest eine Variable aus einem Array und speichert diesen Wert in einer skalaren Variablen.

Parameter:
* Array-Variable: Eingangs-Array zum Auslesen des Wertes.
* Indextyp: Bestimmt, welcher 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-basiert).
    * Variabel: Verwenden Sie eine numerische Variable als Index für die Leseoperation. In diesem Fall wählen Sie eine skalare numerische Variable, um die Position des Auslesens zu bestimmen.
    * Ende des Arrays: Vom Ende des Arrays lesen.
* Ausgabevariable: Wählen Sie eine skalare Variable, in der der ausgelesene Wert gespeichert wird.

#### Einträge zum Array hinzufügen / entfernen Aktion
Wirkung: Fügt Einträge zu einem Array hinzu und/oder entfernt sie.

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

#### Arrayeintrag ändern (ersetzen) Aktion
Wirkung: Ersetzt / ändert einen Wert innerhalb eines Arrays.

Parameter:
* Array-Variable: Array-Variable, in der ein Wert geändert werden soll
* Indextyp: Bestimmt, welcher Index verwendet wird.
    * Fest: Verwenden Sie einen festen Index für die Ersetzoperation. Geben Sie in diesem Fall die Array-Position an, die geändert werden soll (1-basiert).
    * Variabel: Verwenden Sie eine numerische Variable als Index für die Ersetzoperation. Wählen Sie in diesem Fall eine skalare numerische Variable aus, um die Position der Ersetzoperation zu bestimmen.
    * Ende des Arrays: Ersetzen Sie den letzten Eintrag im Array. 
* Eingangsvariable: Wählen Sie eine (skalare) Variable, die den neuen Wert hält.

#### Arrayeinträge mischen Aktion
Wirkung: Mischt die Einträge / Reihenfolge innerhalb eines Arrays.

Parameter: Keine

### Datenrahmenoperationen

#### Aus Datenrahmen lesen / In Datenrahmen schreiben Aktion
Wirkung: Liest Werte aus oder schreibt Werte in einen Datenrahmen und speichert sie in einer neuen Array-Variablen.

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

#### Datenrahmeneinträge mischen Aktion
Wirkung: Mischt die Reihenfolge der Einträge im Datenrahmen. 

Parameter:
* Wählen Sie den Datenrahmen zum Mischen aus.
* Wählen Sie aus, ob der Datenrahmen nach Zeilen oder Spalten gemischt werden soll. 

Sprungaktionen

Sprung zu Aktion

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

Parameter:

• Sprung zu: Bestimmt, wohin im Experiment gesprungen werden soll.
  • Nächster Frame: Springt zum nächsten Frame. Wenn keine weiteren Frames in einem Versuch definiert sind, wird zum ersten Frame des nächsten Versuchs gesprungen.
  • Nächster Versuch: Springt zum nächsten Versuch. Wenn keine weiteren Versuche definiert sind, springt es zum ersten Versuch der nächsten Aufgabe.
  • Nächste Aufgabe: Springt zur nächsten Aufgabe. Wenn keine weiteren Aufgaben definiert sind, springt es zur ersten Aufgabe des nächsten Blocks.
  • Nächster Block: Springt zum nächsten Block. Wenn keine weiteren Blöcke definiert sind, endet die Sitzung.
  • Vorheriger Frame: Springt zum vorherigen Frame. Wenn keine vorherigen Frames vorhanden sind, wird die Aktion nicht ausgeführt.
  • Spezifischer Frame: Springt zu einem bestimmten Frame. Benutzer wählen direkt den Frame, zu dem sie springen möchten.
  • Spezifischer Versuch: Springt zu einem bestimmten Versuch. Benutzer wählen direkt die Versuchsnummer, zu der sie springen möchten.
  • Spezifische Aufgabe: Springt zur ersten Instanz der angegebenen Aufgabe im aktuellen Block. Benutzer wählen direkt die Aufgabe, zu der sie springen möchten.
  • Spezifischer Block: Springt zur ersten Instanz des angegebenen Blocks. Benutzer wählen direkt den Block, zu dem sie springen möchten.
• Überprüfen erforderlicher Antworten vorher: Wenn aktiviert, wird das Experiment überprüfen, ob alle erforderlichen Antworten bereits beantwortet wurden. Andernfalls wird die Sprungaktion nicht ausgeführt.

Akzeptieren/Ende Sitzung Aktion

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

Parameter:

• Aufzeichnung der Versuchs-Daten vor Sitzungsende: Wenn aktiviert, werden die neuesten Versuchs-Daten gespeichert (an den Server gesendet), bevor die Studie verlassen wird.
• Standard-Endseite anzeigen: Wenn aktiviert, wird die Standard-Endseite von Labvanced angezeigt. Wenn dies eine Crowdsourcing-Sitzung ist (Crowdsourcing-Link wurde verwendet), wird der Entschädigungscode dem Teilnehmer angezeigt. Wenn deaktiviert, endet das Experiment nach der Anzeige des aktuellen Frames und zeigt nicht die Standard-Endseite mit dem Entschädigungscode an.

Ablehnen/Ende Sitzung Aktion

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

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

Parameter: Keine

Weiterleiten zu URL Aktion

Wirkung: Leitet den Teilnehmer zu einer bestimmten URL weiter.

Hinweis: Die URL muss am Anfang das https:// enthalten, damit diese Aktion funktioniert.

Steueraktionen

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

Wirkung: Bewertet eine Wenn-Dann-Aussage und führt eine Reihe von Aktionen abhängig aus. Jede Wenn / Sonst-Wenn-Aussage besteht aus geschachtelten 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ü erscheint auf beiden Seiten, um einen logischen Vergleich durchzuführen. 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 / Sonst-Wenn-Aussage hat eine Liste von Aktionen, die unter "Dann" definiert sind. Die Aktionssequenz listet alle Aktionen für eine bestimmte Wenn / Sonst-Wenn-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 / Sonst-Wenn-Aussage erfüllt sind.
• Sonst-Wenn-Fall hinzufügen: Die Anforderungsaktion kann aus mehreren separaten Wenn / Sonst-Wenn --> Dann-Aussagen bestehen. Allerdings kann nur eine Aussage ausgeführt werden. Wenn eine Wenn / Sonst-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 Standard-/Ersatzoption zur Anforderungsaktion hinzugefügt. Wenn keine der Wenn / Sonst-Wenn-Aussagen ausgeführt wird (wahr zurückgibt), werden die im Sonst-Fall definierten Aktionen ausgeführt.

Wiederholte Aktionen (While Loop) Aktion

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

Parameter:

• Ausführungstyp: Wählen Sie zwischen unmittelbarer Ausführung oder zeitgesteuerter Ausführung
  • Vollständige Schleife ausführen: Dies führt die Schleife kontinuierlich aus, bis die Stop-Bedingung erfüllt ist.
  • Alle ... ms ausführen: Dies führt die Schleife mit einem definierten Intervall aus (z. B. wird die Schleife alle 50 ms ausgeführt).
• Anzahl der Schleifen festlegen: Wenn "Alle ... ms ausführen" ausgewählt ist, haben die Benutzer die Möglichkeit, einen ganzzahligen Wert für die Anzahl der Male anzugeben, die die Schleife ausgeführt werden soll. Dies ersetzt die Notwendigkeit, eine Stop-Bedingung 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 parallel gestartet werden. Wenn deaktiviert, kann nur eine Schleifeninstanz gleichzeitig ausgeführt werden.
• Stop-Bedingung aktivieren (wahr / falsch): Wenn aktiviert, kann eine Stop-Bedingung für die Schleife festgelegt werden.
• Stop-Bedingung: Die Stop-Bedingung kann verwendet werden, um einen logischen Ausdruck anzugeben, wann die Schleifen-Ausführung gestoppt werden soll. Ähnlich wie bei den Wenn / Sonst-Wenn-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 angegeben ist.
• Verzögerung: Die Länge der Verzögerung in Millisekunden (ms).
• Aktionssequenz: Die Aktionssequenz listet alle Aktionen auf, die nach der angegebenen Zeitverzögerung ausgeführt werden. Eine neue Aktion kann über das Symbol "Aktion hinzufügen" hinzugefügt werden.

Aktionsgruppe

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

Erfahren Sie mehr.

API-Aktionen

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

• PostMessage senden
• An Websocket senden
• An OpenAI senden

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

PostMessage senden Aktion

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

Erfahren Sie mehr.

An Websocket senden Aktion

Beim Auswählen dieser Aktion erscheinen die folgenden Optionen:

Das obige Beispiel und die gesamte Veranstaltungsstruktur können hier aufgerufen werden: https://www.labvanced.com/page/library/51053 durch Klicken auf 'Untersuchen'.

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

An OpenAI senden Aktion

Die Aktion „An OpenAI senden“ ermöglicht es Ihnen, Informationen, wie einen String-Eingabewert, an OpenAI zu senden. Bitte beachten Sie, dass Sie für diese Option Ihren API-Schlüssel im Settings Tab unter Special Features angeben müssen.

Die folgenden Optionen erscheinen, wenn Sie dieses Ereignis anklicken:

Hier ist ein funktionales 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, können Sie uns gerne für eine Demo kontaktieren, indem Sie dieses Kontaktformular ausfüllen.

HINWEIS: Siehe auch diesen Leitfaden, in dem wir eine Studie Schritt für Schritt aufbauen, ChatGPT in eine Studie integrieren und diese Aktion nutzen.

Hier ist eine ausführlichere Erklärung der Felder, die unter der Aktion 'An OpenAI senden' enthalten sind:

Menüelement	Menübereich	Optionen der Aktion 'An OpenAI senden'
Model Type		Gibt das KI-Modell an, das verwendet werden soll.
Chat History Dataframe		Verknüpfung zu einer Data Frame-Variable mit zwei Spalten. Die erste Spalte bezeichnet die 'Rolle' und die zweite Spalte die 'Chat-Nachricht.' Die Werte aus der Aktion werden automatisch an den hier verlinkten Data Frame angefügt. Der Data Frame kann auch mit Data Frame-Aktionen bearbeitet werden. Für weitere Informationen schauen Sie bitte in die Docs von OpenAI.
Insert Message ‘+’		Durch Klicken darauf erscheint das Dialogfeld für Variablen. Sie müssen angeben, welcher 'Variablen'-Wert an OpenAI gesendet wird, sowie die 'Rolle' der zugehörigen Nachricht: system: bezieht sich auf das hochrangige ChatGPT-System user: der Teilnehmer assistant: bezieht sich auf eine spezifische Unterrolle, die innerhalb des Systems erstellt wurde

Da OpenAI sich täglich weiterentwickelt, überprüfen Sie bitte die Docs von OpenAI für weitere Klärungen.

Code-Aktionen

In einigen Fällen kann Ihr Experiment erfordern, dass Sie 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
• Globale CSS festlegen

JavaScript-Aktion ausführen

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

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

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 diese Aktion anklicken:

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 Mehrfachauswahlfrage auswählt.

Einfügen Aktion

Diese Option ermöglicht es Ihnen, eine Aktion, die Sie zuvor erstellt und kopiert haben, einzufügen. Es ermöglicht Ihnen, schneller zu arbeiten, wenn Sie Ihr Experiment entwerfen, sodass Sie nicht immer wieder die gleichen Elemente auswählen müssen. Wenn Sie beispielsweise ein Ereignis haben, das ähnlich ist wie eines, das bereits existiert, können Sie es einfach kopieren, einfügen und modifizieren, anstatt es von Grund auf neu zu erstellen.

Das Wertauswahlmenü

Wenn Sie mit bestimmten Ereignissen arbeiten, wird ein Stiftsymbol angezeigt. Dies wird als Wertauswahlmenü bezeichnet, da es Ihnen ermöglicht, auszuwählen und anzuweisen, welche Art von Werten aufgezeichnet oder verfolgt werden sollen. Es ist eine sehr leistungsstarke und wichtige Option, die Sie für Ihr experimentelles Design und Ihre Einrichtung verwenden werden.

Dieses Stiftsymbol / Wertauswahlmenü erscheint an verschiedenen Stellen für bestimmte Aktionen im Ereignissystem, wie 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 abgerufen oder geschrieben werden soll. Das Dropdown-Menü beginnt immer mit einer trigger-spezifischen Wertoption und fährt dann mit den anderen 5 Kategorien fort (Aktuelle Zeit, Konstantwert, Variable, Rahmen / Aufgabe / Option und Operationen), von denen jede ihre eigenen Optionen hat. Diese werden weiter unten beschrieben.

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

Menüoptionen

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

Aktuelle Zeitwerte

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

Die folgenden Optionen stehen zur Verfügung:

• UNIX-Zeitstempel
• Zeit 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, wie viel Zeit seit dem Beginn des Rahmens vergangen ist. Meistens entspricht dies der Reaktionszeit.

Konstantenwerte

Weisen Sie Konstantenwerte basierend auf dem benötigten Variablentyp zu, wie z.B. Zeichenfolgen oder numerischen Werten. Diese werden manchmal in Kombination mit anderen Optionen wie Arithmetic verwendet, um Zähler zu erstellen.

Die folgenden Optionen stehen zur Verfügung:

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

Konstant: Zeichenfolge

Weist einen Zeichenfolgen-/Textwert zu.

Konstant: Numerisch

Weist einen numerischen/Wert zu.

Konstant: Boolesch

Weist einen Wert von wahr oder falsch zu.

Konstant: Kategorisch

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

Konstant: Datum

Weist einen Datumswert zu.

Konstant: Zeit

Weist einen Zeitwert zu.

Konstant: Farbe

Weist einen Farbwert (Hex-Zeichenfolge) zu.

Variablenwerte

Geben Sie eine Variable an oder verweisen Sie auf eine Variable oder wählen Sie einen Wert aus einem Array oder Data Frame aus. Die folgenden Optionen stehen zur Verfügung:

• Variable auswählen
• Wert aus Array auswählen
• Wert aus Data Frame auswählen

Variable auswählen

Erlaubt es Ihnen, eine Variable auszuwählen und auf sie zu verweisen.

Wert aus Array auswählen

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

Wert aus Data Frame auswählen

Erlaubt es Ihnen, einen Wert aus einem von Ihnen erstellten Data Frame auszuwählen.

Rahmen-/Aufgaben-/Objektwerte

Erlaubt Ihnen, Werte zu ermitteln, die mit Objektattributen, dem Rahmen, der Augenverfolgung (falls aktiviert) und dem Gerät (Bildwiederholfrequenz) verbunden sind.

• Objektattribut
• Rahmen
• Augenverfolgung
• Gerät

Objektattribut

Liest ein Objektattribut aus.

Rahmen

Augenverfolgung

Gerät

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

Operationen

Verwenden Sie Operationen, um festgelegte Ä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 stehen zur Verfügung:

• Arithmetik
• Zeichenfolgen-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 Objektattributen.

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

Nach Auswahl dieser Option erscheint ein zusätzliches Stiftsymbol (d.h. Wertauswahlmenü) 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 zusammen mit einer Kombination zuvor erstellter Variablen (d.h. 'userChatName' und 'chatInput') sowie konstanten Zeichenfolgenwerten, d.h. dem Semikolon : und dem Leerzeichen <br>, verwendet werden. Diese Aktion schafft den Effekt eines Benutzerchats, der in einer Mehrbenutzerstudie verwendet werden kann.

Zeichenfolgen-Operation

Mathematik-Operation

Führt eine mathematische Operation an einem Skalarwert durch.

Auslöser-spezifische Werte

Auslöser-spezifische Werte beziehen sich auf Werte, die mit dem im jeweiligen Ereignis definierten Auslöser verbunden sind. Wenn Ihr Ereignis beispielsweise einen Mausauslöser verwendet, können Sie unter bestimmten Bereichen, in denen die Aktion festgelegt ist (wie bei der Verwendung einer Set / Record Variable-Aktion oder einer Set Object Property-Aktion), auf mausspezifische Werte im Wertauswahlmenü verweisen.

Im folgenden Beispiel werden auslöser-spezifische Werte für einen Mausauslöser verwendet, um x- und y-Werte sowie ein [X,Y]-Array mit einer Set / Record Variable-Aktion zu erfassen.

Unten finden Sie eine Tabelle aller Arten von auslöser-spezifischen Werten, die in Labvanced zu finden sind, gefolgt von einer detaillierten Erklärung jeder Option.

Name	Wertoptionen - Übersicht
Trigger (Mouse)	Maus X Maus Y Maus [X,Y] Array Stimulusname Stimulusinfo Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Keyboard)	Schlüssel-ID Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Button Bar)	Stimulusname Stimulusinfo Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Enter On Input)	Schlüssel-ID Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Scroll)	Stimulusname Stimulusinfo Scrollposition X Scrollposition Y Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Gamepad/ Joystick)	Gamepad-Geräte-ID Gedrückte Tasten (Array) Gedrückte oder gehaltene Tasten (Array) Losgelassene Tasten (Array) Achsen (Array) Gamepad-Zeitstempel (Unixzeit) Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Eyetracking Gaze)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulusname Stimulusinfo Kamerafangzeit T Blickvertraulichkeit C Koord. + Zeit [X,Y, T] Array Koord. + Zeit + Vertraulichkeit [X,Y, T,C] Array Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Eyetracking Fixation)	Fixations-Zentrum X Fixations-Zentrum Y Fixations-Dauer Fixations-Beginnzeit Fixations-Endzeit Fixations-Streuung Stimulusname Stimulusinfo [X,Y, Dauer, Beginn, Ende, Streuung] Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Head Tracking)	Kamerafangzeit T Gesichtsmesh-Datenrahmen Kopf-Drehung Kopf-Neigung Kopf-Drall Kopf-Position [X,Y, T] Array Nasen-Position [X,Y, T] Array Nasen-Vektor [X,Y, Z, T] Array Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (On Task Initialization)	Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (On Frame Init)	VersuchNr Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (on Frame Start)	Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (On Frame End)	Gesamt-Rahmenzeit Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Variable Value Changed)	Neuer Wert in der Variablen Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Media Object Trigger)	Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Websocket Trigger)	Nachricht Daten Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (OpenAI Trigger)	Chat GPT-Antwort Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (PostMessage Received)	Nachrichteninhalt Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (Global Experiment Event)	Gesamt-Rahmenzeit Grund für das globale Ereignis Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)
Trigger (User Leaves Experiment)	Verbleibende Teilnehmerzahl Auslöser-Zeitstempel (Unixzeit) Auslöser-Uhrzeit (Vom Rahmenbeginn)

Trigger (Maus) Werte

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

Trigger (Tastatur) Werte

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

Trigger (Schaltflächenleiste) Werte

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

Trigger (Enter bei Eingabe) Werte

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

Trigger (Scrollen) Werte

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

Trigger (Gamepad/Joystick) Werte

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

Trigger (Eyetracking Blicke) Werte

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

Trigger(Eyetracking Fixierung) Werte

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

Trigger (Kopfbewegung) Werte

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

Trigger (Beim Aufgabeninitialisierung) Werte

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

Trigger (Bei Frame-Init) Werte

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

Trigger (Beim Frame-Start) Werte

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

Trigger (Beim Frame-Ende) Werte

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

Trigger (Variable Wert geändert) Werte

Wenn ein Trigger zur Änderung des Variablenwerts verwendet wird, können die folgenden trigger-spezifischen Werte bei bestimmten Aktionen abgerufen werden:

Trigger (Media-Objekt-Trigger) Werte

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

Trigger (Websocket-Trigger) Werte

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

Trigger (OpenAI Trigger) Werte

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

Trigger (PostMessage Empfangen) Werte

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

Trigger (Globale Experiment Ereignis) Werte

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

Trigger (Benutzer verlässt Experiment) Werte

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