Ereignissystem

Beschreibung

Das Ereignissystem ist für jede Studie essenziell. Es ist die Art und Weise, wie Sie Werte aufzeichnen, den Fortschritt des Experiments steuern und Aufgaben erstellen. Benutzer können ein Ereignissystem erstellen, um all Funktionen, Logik und Interaktionen in einer Aufgabe auszuführen. Ein Ereignis fungiert oft als Vermittler zwischen Objekten und Variablen.

• Für eine vollständige Liste der Trigger
• Für die vollständige Liste der Aktionen
• Für mehr Informationen über das Value-Select Menü zur Festlegung von Werten unter Ereignissen

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

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

Erstellung von Ereignissen - Übersicht

Ereignisse werden im Task Editor unter dem Tab "Ereignisse" in der oberen rechten Ecke verwaltet. Neue Ereignisse können durch einen Klick auf + Frame Event für Ereignisse, die in diesem Frame auftreten sollen, oder durch Klicken auf + Trial Event erstellt werden, was das Ereignis auf alle Frames anwendet. Alle bestehenden Ereignisse werden in einer Listenansicht im rechten Seitenpaneel angezeigt. Ereignisse werden auf Frame-Ebene definiert und können für jeden Frame getrennt/spezifisch oder dupliziert/das Gleiche 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. Eine benutzerdefinierte Logik ermöglicht es Benutzern jedoch, Ereignisse nur in bestimmten Versuchen, Bedingungen oder in anderen Umständen auszuführen.

Auswahl eines Triggers

Wenn Sie ein neues Ereignis erstellen, öffnet sich die Trigger-Auswahl als Kachelgitter. Trigger-Typen sind nach Kategorien (Benutzereingabe, Physiologisches Signal, Versuch und Frame, Variable, Medienobjekt, API und Global) organisiert. Eine Suchbox oben lässt Sie Trigger-Typen nach Name 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 -symbol. Um zu einem anderen Trigger zu wechseln, klicken Sie auf die Change trigger-Schaltfläche (Bleistift-Symbol), um das Kachelgitter erneut zu öffnen.

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

Die Ausführungsreihenfolge von Ereignissen kann angepasst werden. Standardmäßig stehen Ereignisse mit demselben Trigger weiter oben in der Liste und werden zuerst ausgeführt. Ereignisse können auch kopiert und gelöscht werden. Wenn ein bestehendes Ereignis ausgewählt wird, werden die Einzelheiten im unteren rechten Bereich (Ereigniseigenschaften) angezeigt. Für eine bessere Übersicht können bestehende Ereignisse auch erneut geöffnet werden (Symbol neben dem Namensfeld).

Trigger

Der Trigger definiert, wann das Ereignis ausgeführt wird. Dies könnte ein Mausklick auf ein bestimmtes Objekt, eine bestimmte Tastenfunktion, 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 Enter bei Eingabe Scroll-Trigger Gamepad/Joytick-Trigger	Benutzereingabe-Trigger beziehen sich auf jeden Trigger, der manuell vom Benutzer/Teilnehmer aktiviert werden kann, indem er zum Beispiel die Maus bewegt, auf ein Tastenelement klickt, scrollt usw.
Physiological Signal Triggers	Eyetracking-Fixation Eyetracking-Fixation Headtracking	Physiologische Signaltrigger treten auf, wenn es einen bestimmten physiologischen Input gibt, wie das Fixieren auf ein bestimmtes Element oder Änderungen der Kopfbewegungen.
Trial and Frame Triggers	Aufgabenstart Frame-Init Frame-Start Frame-Ende	Diese Trigger treten in Bezug auf die experimentellen Versuche und Frames auf, wie zum Beispiel, wenn ein Frame startet oder endet.
Variable Value Changed Trigger	Variable (Wert geändert)	Ein Trigger für das Ereignis tritt auf, wenn es eine Änderung eines bestimmten Variablenwertes gibt.
Media Object Trigger	Media-Objekt-Trigger	Dieser Trigger tritt in Bezug auf Medienobjekte auf, wie beispielsweise eine Pause in einer Video-/Audiodatei, das Abschluss einer Aufnahme usw.
API Triggers	Websocket-Trigger Open AI-Trigger PostMessage empfangen	Dies sind Trigger, die auftreten, wenn eingehende Daten von einer API vorliegen.
Global Triggers	Experiment pausieren / fortsetzen Teilnehmer verlässt Mehrbenutzerstudie	Globale Trigger beziehen sich auf alle wesentlichen Änderungen an einem Experiment, wie wenn es pausiert wird oder ein Teilnehmer aus einer Mehrbenutzerstudie austritt.

Benutzereingabe-Trigger

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

Die folgende Tabelle bietet eine einführende Übersicht über alle in Labvanced verfügbaren Benutzereingabe-Trigger. 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, wie: 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	Jede Tasteneingabe kann als Trigger verwendet werden, um ein Ereignis zu initiieren. Sie können bestimmte Buchstaben oder Zahlen als Trigger festlegen.
Button-Clicks	Schaltflächenobjekte, die in Labvanced erstellt werden, können als Trigger verwendet werden, um Ereignisse zu initiieren.
Enter on Input	Dieser Trigger wird häufig verwendet, wenn ein Teilnehmer während eines Experiments die 'Enter'-Taste drückt, um ihre schriftliche Antwort oder Eingabe in Textfeldern zu übermitteln.
Scroll Trigger	Dieser Trigger tritt auf, wenn der Teilnehmer scrollt. Sie können die x- oder y-Scrollrichtungen sowie über welche Elemente das Scrollen erfolgt spezifizieren, um als Ereignistrigger verwendet zu werden.
Gamepad/ Joystick Trigger	Dieser Trigger ermöglicht es Ihnen, Gamepad- und Joystick-Controller in Ihrem Versuchsdesign als Eingabegerät zur Datenerfassung zu verwenden.

Maus-Trigger

Die Option 'Maus-Trigger' ist ein sehr beliebter Ereignistrigger, da sie ein Ereignis basierend auf jeder Mausinteraktion initiiert, wie: Die Maus nach oben/unten bewegen, klicken, über ein bestimmtes Objekt fahren, ein bestimmtes Objekt verlassen oder jede Bewegung im Allgemeinen!

Das folgende Beispiel zeigt einen 'Maus-Trigger', der auftritt, wenn ein 'Klick' mit dem 'Linken' Mausklick auf das 'Ziel'-Objekt namens 'Bild_1' ausgeführt wird:

Hier ist eine vollständige Übersicht über die Optionen, die Sie beim Arbeiten mit Mausauslösern haben:

Menüpunkt	Menübereich	Optionen und Spezifikationen für Mausauslöser
Action Dropdown-Liste:		Die folgenden Optionen für Mausauslöser sind aus der Dropdown-Liste verfügbar: Klicken: Ausgelöst durch Mausklick Drücken: Ausgelöst durch Mausklick Loslassen: Ausgelöst durch Maus loslassen Hover: Ausgelöst durch Überfahren des Objekts mit der Maus Verlassen: Ausgelöst durch das Verlassen eines Objekts mit der Maus 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 'Bild_1' das Ziel des Mausklicks, der das Ereignis auslösen wird. Mehrere Ziele können hinzugefügt werden, indem Sie die ‘+Add Target’-Option am unteren Ende anklicken.	Bei der Angabe 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 ein beliebiges Element im Rahmen geklickt wird. Ziele hinzufügen: Wählen Sie die spezifischen Elemente aus, die angeklickt werden müssen, um den Auslöser zu aktivieren.

• Hinweis: 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 darauf zuzugreifen.

Tastaturauslöser

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

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

Hier ist eine vollständige Übersicht über die Tasten und Optionen, die Sie beim Arbeiten mit Tastaturauslösern haben:

Menüpunkt	Menübereich	Optionen für Tastaturauslöser
Action Dropdown-Liste:		Dies sind die verfügbaren Optionen für Tastaturaktionen: TasteDrücken: Ausgelöst durch das Drücken der Taste (Taste ist gedrückt) Taste Drücken ODER Halten: Ausgelöst, wenn die Taste gedrückt oder gehalten wird TasteLoslassen: 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		Welches Taste als Auslöser verwendet wird, wird hier ausgewählt, indem Sie die Optionen durch Klicken auf +Add: auswählen Pfeile: die vier Pfeiltasten Zahlen: Zahlen von 0-9 Buchstaben: Alle Buchstaben des englischen Alphabets Sonder: Sondertasten (Enter, Leertaste, Steuerung, Tab, Umschalt) F-Tasten: F1 bis F10 jede Taste: jede dieser Tasten ist akzeptabel Sie können mehrere Tastaturauslöser hinzufügen, indem Sie erneut auf die +Add:-Schaltfläche klicken
Zusatzoptionen		Die Option Ziffernblocktasten aktivieren ermöglicht es, Ziffernblocktasten als Auslöser innerhalb des Experiments zu verwenden. Für die Option Ereignispropagation zulassen, wenn mehrere Ereignisse denselben Tastaturauslöser haben, dann werden alle ohne ihn ausgeführt/ausgelöst. Nur das erste wird ausgeführt und die Ereignisausführung stoppt, nachdem das erste Ereignis abgeschlossen ist.

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

Button-Klick-Auslöser

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

Ein Klick 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 vorgestellten Elemente:

Menüpunkt	Menübereich	Optionen für den Button-Klickauslöser
Ziel: +Set Target		Auswahl eines Schaltflächenelements als Ziel
Button: Option		Geben Sie an, welche spezifische Schaltfläche im Rahmen

• Hinweis: Nach der Auswahl des Button-Klickauslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Button-Klickwerte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Enter bei Eingabe-Auslöser

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

Parameter:

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

• Hinweis: Nach der Auswahl des Enter bei Eingabe-Auslösers im Ereignissystem haben Sie die Möglichkeit, trigger-spezifische Enter bei Eingabe-Werte über verschiedene Aktionen mit dem Wertauswahlmenü zu nutzen und darauf zuzugreifen.

Scrollauslöser

Auslöser bei: Der Scrollbalken, das Scrollen auf dem Trackpad oder das Scrollrad der Maus wird auf einem bestimmten Element verwendet.

Parameter:

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

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

Hinweis: Für langen Text müssen die Overflow-X- und/oder die Overflow-Y-Optionen im Panel „'Objekt Eigenschaften'“ unter dem Abschnitt „Stil“ 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 darauf zuzugreifen.

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 verwenden. Hinweis: Denken Sie daran, diese Option unter dem Settings Tab zu aktivieren.

Erfahren Sie mehr.

Physiologische Signal-Auslöser

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

Eye-Tracking-Blickauslöser

Auslöser bei:

• Insgesamt gilt dieser Auslöser, wenn das Eye-Tracking aktiviert wurde.
• Nur Auslösung, wenn auf spezifische Elemente geschaut wird.

Parameter:

• Wenn Sie ausgewählt haben, dass nur auf spezifische Elemente 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 darauf zuzugreifen.

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

Eye-Tracking-Fixationsauslöser

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

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

Erfahren Sie mehr: Siehe die spezielle Seite Eye-Tracking-Fixationsauslöser zum Aktivieren der Fixationsdetektion, Aufzeichnen von Fixationsdaten und praktischen Beispielen.

Head-Tracking-Auslöser

Auslöser bei:

• Änderungen in der Kopfausrichtung oder Kopfbewegung.

• Hinweis: Nachdem Sie den Headtracking-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Headtracking-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

Trial- und Frame-Trigger

Task Init Trigger

Ausgelöst bei:

• Dem ersten Frame des ersten Versuchs einer Aufgabe. Wird trotz Anzeige im Events-Tab für alle Instanzen dieses Frames nur einmal pro Aufgabe ausgeführt.

Dieser Trigger eignet sich gut für die Shuffle- und Read From-Aktionen. Mit diesen Kombinationen können Sie Array-Einträge oder Daten-Frames beim Start der Aufgabe mischen und Probanden Gruppen von Stimuli zuordnen, ohne mehrere Ereignisse zu erstellen, um Stimuli oder Daten auszulesen.

Parameter: Keine

• Hinweis: Nachdem Sie den Task Init-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Task Init-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

Frame Init Trigger

Ausgelöst bei:

• Der 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, wodurch ein klarer Weg für andere Aktionen geschaffen wird, die beginnen, sobald der Frame startet.

Hinweis: Verwenden Sie den Frame Init-Trigger nicht mit Ereignissen, die eine Variable aufzeichnen oder die Systemvariablen wie Trial Number oder Condition Number betreffen. Dies liegt daran, dass der Frame Init-Trigger zwischen den Trials auftritt, sodass keine vollständig exakte Zählung des Trials oder der Bedingung, die angezeigt werden soll, vorliegt.

Parameter: Keine

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

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

Vergessen Sie nicht, das Kontrollkästchen "Zurücksetzen beim Trial-Start" im Fenster der Variablen-Eigenschaften abzuwählen, wenn Sie nicht möchten, dass die Variablenwerte zurückgesetzt werden.

Frame Start Trigger

Ausgelöst bei:

• Start des Frames

Parameter: Keine

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

Frame End Trigger

Ausgelöst bei:

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

Parameter: Keine

• Hinweis: Nachdem Sie den Frame End-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Frame End-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

Variable Value Changed Trigger

Variable Value Changed

Ausgelöst bei:

• Der Wert einer Variable ändert sich von ihrem Ausgangswert

Parameter:

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

• Hinweis: Nachdem Sie den Variable Value Changed-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Variable Value Changed-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

Media Object Triggers

Media Object Trigger

Früher bekannt als der separate "Control Audio/Video Trigger" und "Control Object"-Trigger.

Ausgelöst bei:

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

Parameter:

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

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

  • Audio- oder Videoobjekt-Optionen:
    • Wiedergabe gestartet: Wird ausgelöst, wenn das Element zu spielen beginnt
    • Wiedergabe gestoppt: Wird ausgelöst, wenn das Element pausiert
    • Wiedergabe beendet: Wird ausgelöst, wenn das Element das Spielen stoppt
  • Video-, Audio- oder Bildschirmaufnahmeobjekt-Optionen:
    • Aufnahme beendet: Wird ausgelöst, wenn die Audioaufnahme gestoppt wurde
    • Upload abgeschlossen: Wird ausgelöst, wenn der Datei-Upload abgeschlossen ist
  • Datei-Upload-Objekt-Optionen:
    • Datei ausgewählt: Wird ausgelöst, wenn eine Datei ausgewählt wird
    • Upload abgeschlossen: Wird ausgelöst, wenn der Datei-Upload abgeschlossen ist
  • Kamera-Snapshot-Objekt-Optionen:
    • Snapshot abgeschlossen: Wird ausgelöst, wenn die Kamera erfolgreich ein Snapshot gemacht hat
    • Upload abgeschlossen: Wird ausgelöst, wenn der Snapshot mit dem Hochladen fertig ist

• Hinweis: Nachdem Sie den Media Object-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische Media Object-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

API Triggers

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

• Websocket Trigger
• OpenAI Trigger
• PostMessage Received

Websocket Trigger

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

Beim Klicken auf diese Option erscheinen die folgenden Elemente.

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

Für ein Beispiel, wie API Triggers / Actions verwendet werden, überprüfen Sie bitte diese Demo https://www.labvanced.com/page/library/51053, indem Sie die Option 'Inspect' im Dialogfeld anklicken.

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

• Hinweis: Nachdem Sie den WebSocket-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische WebSocket-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

OpenAI Trigger

Der 'OpenAI Trigger' kann verwendet werden, um eine Aktion basierend auf eingehenden Informationen von OpenAI einzuleiten.

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

HINWEIS: Beachten Sie auch diese Anleitung, in der wir eine Studie schrittweise aufbauen und ChatGPT in eine Studie integrieren und diesen Trigger nutzen.

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

Wenn Sie auch die ‘Send to OpenAI’-Aktion verwenden, müssen Sie denselben Datenrahmen dort 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 in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

PostMessage Received Trigger

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

Erfahren Sie mehr.

• Hinweis: Nachdem Sie den PostMessage Received-Trigger im Ereignissystem ausgewählt haben, haben Sie die Möglichkeit, trigger-spezifische PostMessage Received-Werte in verschiedenen Aktionen mit dem Wert-Auswahlmenü zu verwenden und darauf zu verweisen.

Globale Trigger

Globale Trigger treten auf, wann immer eine wesentliche Änderung im Experiment erfolgt, d.h. etwas, das "global" ist, wie das Pausieren des Experiments oder das Verlassen eines Teilnehmers in einer Mehrbenutzerstudie! Die folgenden Optionen sind als globale Trigger aufgeführt:

• Experiment Pausieren / Fortsetzen
• Teilnehmer hat die Mehrbenutzerstudie verlassen

Experiment Pausieren/Fortsetzen

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

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

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

• Experiment Fortgesetzt: Der Teilnehmer setzt die Studie fort. Dieser Trigger funktioniert gut bei Blickverfolgungsstudien. Er kann verwendet werden, um den Teilnehmer zu einem vorherigen Versuch oder Frame zurückzuschicken, wenn er seinen virtuellen Kinnstütze verlassen hat.

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

Teilnehmer hat die Mehrbenutzerstudie verlassen

Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, kann dies ebenfalls als Trigger für ein Ereignis verwendet werden. Wenn ein Teilnehmer eine Mehrbenutzerstudie verlässt, hat dies Auswirkungen auf das Experiment auf globaler Ebene, da es anderen Teilnehmern die Fortsetzung der Studie verhindert.

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

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

Aktionen

Aktionen definieren, was passieren soll, wenn das Ereignis ausgeführt wird. Sie können verwendet werden, um Variablen und Objektparameter zu ändern, Daten aufzuzeichnen, Daten von/zu Arrays zu lesen und zu schreiben oder zum nächsten Versuch oder Task 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 verwenden (z. B. eine While-Schleife innerhalb einer If-Anweisung). Daher kann das Ereignissystem als grafische Programmierumgebung angesehen werden. In dieser Ansicht fungieren Trigger als Funktionsaufrufe, während Aktionen die funktionale Logik beschreiben. Dieser Ansatz gewährleistet, dass fast jede experimentelle Logik ohne die Verwendung bestimmter programmatischer/syntaktischer Strukturen implementiert werden kann.

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

Aktionskategorie	Aktionsoptionen	Beschreibung
Object Actions	Objekteigenschaft setzen Medienobjekt steuern Objekt kopieren Für jedes Objekt	Objekthandlungen beziehen sich auf jede Manipulation, die an einem Objekt erfolgt, das innerhalb der Aufgabe existiert.
Variable Actions	Variable setzen / aufzeichnen In die Zwischenablage kopieren Zufallszahl ziehen URL-Parameter abrufen Von / zu Gerät lesen / schreiben Von / zu gemeinsamer Variable lesen / schreiben Mathematik & Statistik Variablen sofort aufzeichnen Gleitender Durchschnittsfilter Variable verteilen	Jede Aktion, die von einer Variablenwert liest oder einen Variable wert aufzeichnet.
Array Actions	Aus Array auswählen (lesen) Arrayeinträge hinzufügen / entfernen Arrayeintrag ändern (ersetzen) Arrayeinträge mischen	Array-Operationen beinhalten das Auswählen, Hinzufügen, Entfernen, Ändern und Mischen von Arrays und deren Einträgen.
Data Frame Operations	Von / zu 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 akzeptieren / beenden Ablehnen / Sitzung beenden Umleiten zu URL	Ermöglicht Ihnen, das Experiment durch Springen zu einem bestimmten Abschnitt zu navigieren, sowie die Abschnitte der Teilnehmer zu akzeptieren und abzulehnen.
Control Actions	Anforderungsaktionen (Wenn...Dann) Wiederholte Aktionen (While-Schleife) Verzögerte Aktionen (Zeit-Callback) Aktionsgruppe	Steueraktionen werden verwendet, um spezielle Ereignisse auszuführen, wie z.B. Wenn/Dann-Logik, Schleifen (z. B. einen wiederholten Ton abspielen oder ein Bild blitzen), sowie um eine Verzögerung einzurichten, wann eine Aktion erfolgt.
API Actions	PostMessage senden An Websocket senden An OpenAI senden	Bezieht sich auf API-spezifische Aktionen, um Daten an eine API zu senden.
Code Actions	JavaScript ausführen Globales CSS setzen	Codeaktionen ermöglichen es Ihnen, mit JavaScript oder CSS zu arbeiten.
Paste Action	Einfügeaktion	Ermöglicht Ihnen, eine Aktion einzufügen, die Sie zuvor kopiert haben.

Objektaktionen

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

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

Objekteigenschaft setzen Aktion

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

Mehr erfahren.

Medienobjekt steuern Aktion

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

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

Parameter:

• Ziel: Ein Medienobjekt auswählen
• Effekt: Eine Unteraktion auswählen
  • Audio- oder Videoobjektoptionen:
    • Wiedergabe starten: Beginnt mit der Wiedergabe der Video- / Audiodatei
    • Wiedergabe stoppen: Stoppt die Video- / Audiodatei
    • Wiedergabe pausieren: Pausiert die Video- / Audiodatei
    • JumpToTime: Erlaubt Ihnen, eine Zeit in Millisekunden anzugeben, zu der in der Audio-/Videodatei gesprungen werden soll
    • Stummschalten: Schaltet den Ton des Objekts aus
    • Stummschaltung aufheben: Stellt den Ton des Objekts wieder her
  • Audio-, Video- oder Bildschirmaufnahmeobjektoptionen:
    • Aufnahme starten: Beginnt mit einer neuen (Audio-)Aufnahme
    • Aufnahme stoppen: Stoppt die (Audio-)Aufnahme
    • Upload starten: Beginnt mit dem Hochladen der Datei
    • Aufnahme löschen: Löscht die (Audio-)Aufnahmedaten.
    • Wiedergabe starten: Beginnt mit der Wiedergabe der aufgenommenen Datei
    • Wiedergabe stoppen: Stoppt die Wiedergabe der aufgenommenen Datei
    • Aufnahme pausieren: Pausiert die Aufnahme des Objekts
    • Aufnahme fortsetzen: Setzt die Aufnahme des Objekts fort
  • 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 auswählen: Ermöglicht dem Teilnehmer, die gewünschte Datei auszuwählen
  • Kamera-Snapshot-Objektoptionen:
    • Kamera starten: Schaltet die Kamera des Teilnehmers ein
    • Kamera stoppen: Schaltet die Kamera des Teilnehmers aus
    • Upload starten: Beginnt mit dem Hochladen des Snapshots in das Experiment
    • Snapshot aufnehmen: Macht ein Bild mit der Kamera des Teilnehmers

Kopiere Objekt Aktion

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

Parameter:

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

Für jede Objekt Aktion

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

Parameter:

• Filter: Wählen Sie den zu zielenden Elementtyp aus.
• Zusätzlichen Namensfilter erlauben: Geben Sie die Namen der zu zielenden Objekte ein. Bei mehreren Objekten in einem Rahmen, bei denen einige identische Namen haben, funktioniert dies gut.
• Aktionsfolge: Ermöglicht die Auswahl (aus der üblichen Aktionsliste), was mit den ausgewählten Elementen passieren wird. Wählen Sie "CurrentObject" als Ziel, um die Aktion auf alle Elemente anzuwenden, die den oben angegebenen Kriterien entsprechen.

Variable Aktionen

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

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

Option der Variablenaktion	Beschreibung
Set / Record Variable	Schreiben oder Festlegen eines Variablenwerts
Copy to Clipboard	Kopiert einen Variablenwert in die interne Zwischenablage des Computers.
Draw Random Number	Zieht eine oder mehrere Zufallszahl(en) und speichert sie in einer Variablen
Get URL Parameter	Speichert einen Wert aus der einzigartigen URL des Teilnehmers
Read from / Write to Device	Liest oder schreibt eine Variable aus/in den 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 über Sitzungen einer Studie geteilt wird. Die Variable kann mit allen Teilnehmern geteilt oder privat für jede Einzelperson sein.
Math & Statistics	Führt eine mathematische Operation mit einer Eingangsvariablen (Array) durch und speichert das Ergebnis in einer Ausgabewariablen.
Record Variables Instantly	Erstellt einen Snapshot aller Variablenwerte und sendet dies an den Labvanced-Server.
Moving Average Filter	Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingangsvariablen 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 einer Variablen Aktion

Die Aktion „Setzen / Aufzeichnen einer Variablen“ wird in jedem Experiment in Labvanced verwendet, da sie dafür sorgt, dass Werte und Verhaltensmaße gespeichert und aufgezeichnet werden.

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

Menüelement	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.
Stift-Symbol		Das Stift-Symbol symbolisiert das Menü zur Wertauswahl, das verwendet wird, um die genauen Werte festzulegen, die der ausgewählten Variable zugewiesen werden sollen (wie im grünen Button links von dem Gleichheitszeichen (=) angegeben).

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

Das folgende Bild zeichnet die X,Y-Koordinaten der Maus auf, um das Maus-Tracking während einer Studie zu erfassen. Das Bild zeigt, wie drei Aktionen verwendet werden, um die Aufzeichnung von Variablenwerten zu ermöglichen. Die Variable (links) wird manuell erstellt, während der Wert auf der rechten Seite des Gleichheitszeichens (=) ein maus-trigger-spezifischer Wert ist, auf den das System verweist und den Sie verwenden können, wenn Sie Werte aufzeichnen.

Hinweis: Die Set / Record VariableAktion wird auch häufig im Kontext von Control Actions verwendet, bei denen Sie Bedingungen mithilfe von „Wenn / Dann“ und „While-Loops“ basierend auf Variablenwerten angeben können.

In die Zwischenablage kopieren Aktion

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

Ziehe Zufallszahl Aktion

Effekt: Zieht eine oder mehrere Zufallszahl(en) und speichert sie in einer Variablen

Parameter:

• Typ: Wählen Sie zwischen kontinuierlichen und diskreten Werten
• Verteilung: Wählen Sie zwischen gaußscher und gleichmäßiger Verteilung
• Mehrere Ziehungen (boolean true/false): Wählen Sie, ob Sie einmal oder mehrfach ziehen möchten.
• 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 gaußsche Verteilung
• Standardabweichung: Definieren Sie die Standardabweichung für die gaußsche Verteilung
• In Variable speichern: Wählen Sie eine Variable, in der die Werte gespeichert werden.

Holen Sie URL-Parameter Aktion

Effekt: Speichert einen Wert aus der einzigartigen 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 kann mit anderen Aktionen kombiniert werden, um einzigartige URLs für Teilnehmer zu erstellen oder Informationen zu extrahieren, die für die Datenanalyse erforderlich sind.

Lesen von/ Schreiben auf dem Gerät Aktion

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

Parameter:

• Wählen Sie „ Lesen von“ oder „ Schreiben auf“ dem lokalen Gerät.
• Wählen Sie die zu lesende oder zu schreibende Variable aus.

Anwendungsfall: Längsschnitt-/Multi-Sitzungsstudien

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

Lesen von/ Schreiben auf die gemeinsame Variable Aktion

Effekt: 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 Einzelperson sein.

Parameter:

• Wählen Sie die Variable aus, die synchronisiert werden soll. Muss entweder skalar oder ein Array sein.
• Erweiterte Optionen
  • Speicher-Schlüssel: Wählen Sie den Namen einer Variablen, die als Schlüssel zur Zugriff auf die synchronisierte Variable dient.
  • Lese- oder Schreibmethode:
    • Liest die Variable, ändert sie und sendet dann die Variable an die Studie.
    • Liest nur den gemeinsamen Wert vom Server: Ruft die Variable ab, die innerhalb der Studie geteilt wird, macht jedoch keine Änderungen.
    • Schreibt nur die Variable auf den Server: nimmt Änderungen an der gemeinsamen Variable vor, zeigt sie jedoch den Teilnehmern nicht an.
    • Teilt Werte zwischen verschiedenen Teilnehmern (nicht nur zwischen Sitzungen): Ermöglicht den Teilnehmern, die synchronisierten Variablenwerte über Sitzungen hinweg zu sehen. Diese Option ist standardmäßig aktiviert, kann jedoch durch Klicken auf das Kontrollkästchen deaktiviert werden.
• Aktionsfolge:
  • Wählen Sie aus, was mit der gemeinsamen/synchronisierten Variablen aus der Liste aller verfügbaren Aktionen passiert.

Use Case: Longitudinal/Multi-Session Studies

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

Math & Statistics Action

Effect: Führt eine mathematische Operation über eine Eingangsvariable (Array) aus und speichert das Ergebnis in einer Ausgangsvariable.

Parameters:

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

Record Variables Instantly Action

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

Parameters: Keine

Moving Average Filter Action

Effect: Berechnet einen gleitenden Durchschnitt (einen ständig aktualisierten Durchschnitt der Daten) einer Eingabe und speichert das Ergebnis in einer neuen Variablen.

Parameters:

• Filtertyp: Wählen Sie den Filtertyp
  • Einfacher gleitender Durchschnitt: Berechnet einen einfachen gleitenden Durchschnitt, bei dem alle Stichproben dasselbe Gewicht haben.
  • Linear gewogener gleitender Durchschnitt: Gewicht herscht über die Stichproben mit abnehmenden Gewichten linear.
  • Exponentieller gleitender Durchschnitt: Gewicht herscht über die Stichproben mit abnehmenden Gewichten exponentiell.
• Anzahl der Stichproben: Bestimmt, wie viele Stichproben 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.

Distribute Variable Action

Die Distribute Variable-Aktion ist entscheidend für Multi-User-Studien in Labvanced. Mit dieser Aktion kann ein Variablenwert zwischen Teilnehmern geteilt werden, was es ermöglicht, dass Informationen (einschließlich Stimuli-Positionen und Ä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 folgende Bild zeigt, wie das funktionale Distribute Variable-Aktionsdialogfeld aussieht, wenn alle Menüelemente ausgefüllt sind. In diesem Beispiel wird die verteilte Variable als Aktion verwendet, um einen Chat zwischen zwei Teilnehmern zu erstellen, indem der Wert einer Variablen aus einem Eingabefeld-Objekt verteilt wird.

Sehen Sie sich diese Demo an, die die Funktion der verteilten Variablen und des Chatfensters hier umfasst: Bildbeschreibung Aufgabe mit Chat-Add-On.

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

Menüelement	Menübereich	Distribute Variable Action Optionen und Beschreibung
Distribute value to		Wählen Sie, an welche anderen Teilnehmer der Wert gesendet werden soll. Alle Teilnehmer: Senden Sie diesen Wert an alle Teilnehmer Ausgewählte Teilnehmer: Senden Sie den Wert an ausgewählte Teilnehmer.
Choose target variable and value		Zielvariable: Wählen Sie eine Zielvariable, in der der Wert gespeichert wird. Wert: Bestimmen Sie den Wert, der an andere Teilnehmer gesendet werden soll.
Block		Wenn aktiviert, kann die Zielvariable nicht geändert werden, bis die aktuelle Wertverteilung abgeschlossen ist.
Rate Limit Strategy		Die Ratenbegrenzungsstrategie ist eine Möglichkeit, Ihr Experiment davor zu schützen, die Server zu überlasten, und dient als Vorsichtsmaßnahme zur Steuerung der Rate, mit der Anfragen (d.h. Aktualisierungen über die verteilte Variable) an den Server gesendet werden. Die folgenden Strategieoptionen stehen zur Verfügung: Debounce: Wenn diese Aktion mehr als einmal innerhalb von 100 ms ausgeführt wird, werden neue Servernachrichten "debounced" (nur die letzte Nachricht wird gesendet, nachdem ein Intervall von 100 ms ohne Ausführung dieser Aktion vergangen ist). Throttle: Wenn diese Aktion mehr als einmal innerhalb von 100 ms ausgeführt wird, werden neue Nachrichten gedrosselt (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 innerhalb von 100 ms ausgeführt wird, werden neue Nachrichten innerhalb dieses 100-ms-Fensters verworfen. Queue: Wenn diese Aktion mehr als einmal innerhalb von 100 ms ausgeführt wird, werden neue Variablenwerte in eine Warteschlange gestellt (bis zu einer maximalen Warteschlangenlänge von 10 Nachrichten).

Array Actions

Select (Read) from Array Action

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

Parameters:

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

Add / Remove Array Entries Action

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

Parameters:

• Array-Variable: Arrayvariable, auf 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 festzulegen, wo die Einträge eingefügt/gelöscht werden sollen.
  • Ende des Arrays: Einfügen/Löschen vom Ende des Arrays.
• Nr. der Einträge zum Löschen: Entfernt die Array-Einträge (vor dem Einfügen neuer Einträge) ab der definierten Indexposition. 0 bedeutet, dass keine Werte entfernt werden.
• Variable(n) zum Einfügen: Wählen Sie eine oder mehrere skalare Variable(n) aus, die an der definierten Indexposition zur Array-Variablen hinzugefügt werden.

Change (Replace) Array Entry Action

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

Parameters:

• Array-Variable: Arrayvariable, in der ein Wert modifiziert 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 festzulegen.
  • Ende des Arrays: Ersetzt den letzten Eintrag im Array.
• Eingangsvariable: Wählen Sie eine (skalare) Variable aus, die den neuen Wert enthält.

Shuffle Array Entries Action

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

Parameters: Keine

Data Frame Operations

Read from / Write to Data Frame Action

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

Parameters:

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

Shuffle Data Frame Entries Action

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

Parameters:

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

Sprungaktionen

Sprung zu Aktion

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 individuelle experimentelle Logik für jeden Teilnehmer zu erstellen.

Parameter:

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

Akzeptieren/Ende der Sitzung Aktion

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

Parameter:

• Versuchsdatenerfassung vor Sitzungsende: Wenn aktiviert, werden die neuesten Versuchsdatensätze gespeichert (an den Server gesendet), bevor die Studie verlassen wird.
• Standard-Endseite anzeigen: Wenn aktiviert, wird der standardmäßige Labvanced-Endbildschirm angezeigt. Wenn dies eine Crowdsourcing-Sitzung ist (Crowdsourcing-Link wurde verwendet), wird der Vergütungscode dem Teilnehmer angezeigt. Wenn deaktiviert, endet das Experiment nach der Anzeige des aktuellen Frames und zeigt den standardmäßigen Endbildschirm mit Vergütungscode nicht an.

Ablehnen/Ende der Sitzung Aktion

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

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

Parameter: Keine

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 AND / OR-Vergleichen, um zu bewerten, ob alle Anforderungen erfüllt sind (Aussage ist wahr) oder nicht (Aussage ist falsch). Wenn die Aussage wahr ist, werden die Aktionen unter "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 auswählen, wie beide Seiten verglichen werden sollen (z. B. gleich, kleiner als, ungleich usw.).
• OR-Gruppe hinzufügen: Nur eine der Anforderungen innerhalb einer OR-Gruppe muss wahr sein, damit die gesamte Gruppe wahr ist. Fügen Sie eine OR-Gruppe hinzu, wenn die Unteraktionen in mehreren Fällen ausgeführt werden sollen.
• AND-Gruppe hinzufügen: Alle Anforderungen innerhalb einer AND-Gruppe müssen wahr sein, damit die gesamte Gruppe wahr ist. Fügen Sie eine AND-Gruppe hinzu, wenn die Unteraktionen nur ausgeführt werden sollen, wenn mehrere Anforderungen erfüllt sind.
• Aktionsfolge: Jede Wenn / Sonst-Wenn-Aussage hat eine Liste von Aktionen, die unter "Dann" definiert sind. Die Aktionsfolge 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 Aktionsfolge wird nur ausgeführt, wenn die Anforderung(en) der zugehörigen Wenn / Sonst-Wenn-Aussage erfüllt sind.
• Sonst-Wenn-Fall hinzufügen: Die Anforderungsaktion kann mehrere separate Wenn / Sonst-Wenn --> Dann Aussagen umfassen. Wenn jedoch nur eine Aussage ausgeführt werden kann. 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- / Fallback-Option 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 aus, entweder sofort oder innerhalb eines definierten Intervalls. Eine Stop-Bedingung kann festgelegt werden, sodass die Schleifenausführung gestoppt wird.

Parameter:

• Ausführungstyp: Wählen Sie zwischen sofortiger Ausführung oder zeitgesteuerter Ausführung
  • Komplette Schleife ausführen: Dies führt die Schleife kontinuierlich aus, bis die Stop-Bedingung erfüllt ist.
  • Führen Sie alle ... ms aus: 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 "Führen Sie alle ... ms aus" ausgewählt ist, haben die Benutzer die Möglichkeit, einen numerischen Ganzzahlwert 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.
• Sofortig starten (wahr / falsch): Wenn aktiviert, wird die Schleife sofort ausgeführt. Wenn deaktiviert, wird die Schleife beim 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 zur selben Zeit 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 dafür anzugeben, wann die Schleifenausführung gestoppt werden soll. Ähnlich wie bei den Wenn / Sonst-Wenn-Aussagen kann man AND-Gruppen, OR-Gruppen und Anforderungen zur logischen Vergleichung kombinieren.
• Aktionsfolge: Die Aktionsfolge 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 fester Verzögerung oder variabler 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).
• Aktionsfolge: Die Aktionsfolge 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 für eine einfachere visuelle Struktur zusammenzufassen, 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 „API-Aktionen“ und „API-Trigger“ verwendet werden. Sie haben die folgenden Aktionen in dieser Kategorie verfügbar:

• PostMessage senden
• An Websocket senden
• An OpenAI senden

Damit diese Aktionen 'verfügbar' oder nutzbar 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 eingebetteten Rahmen, unter Verwendung der postMessage-API des Browsers.

Erfahren Sie mehr.

An Websocket senden Aktion

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

Das obige Beispiel und die vollständige Ereignisstruktur 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 „An OpenAI senden“-Aktion ermöglicht es Ihnen, Informationen, wie z. B. einen Eingabewert, an OpenAI zu senden. Bitte beachten Sie, dass Sie für diese Option Ihren API-Schlüssel im Settings Tab unter Special Features auflisten 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 dieses Feature nutzen und es in Aktion sehen können, kontaktieren Sie uns bitte für eine Demo, indem Sie dieses Kontaktformular ausfüllen.

HINWEIS: Außerdem lesen Sie diesen Leitfaden, in dem wir eine Studie Schritt für Schritt erstellen, ChatGPT in eine Studie integrieren und diese Aktion nutzen.

Hier ist eine tiefere Erklärung der Felder, die unter der 'Send to OpenAI'-Aktion enthalten sind:

Menüpunkt	Menübereich	Optionen der 'Send to OpenAI'-Aktion
Model Type		Gibt das KI-Modell an, das verwendet werden soll.
Chat History Dataframe		Verlinkung zu einer Datenrahmen-Variable mit zwei Spalten. Die erste Spalte bezeichnet die „Rolle“ und die zweite Spalte die „Chat-Nachricht.“ Die Werte aus der Aktion werden automatisch dem hier verlinkten Datenrahmen hinzugefügt. Der Datenrahmen kann auch mit Datenrahmen-Aktionen manipuliert werden. Weitere Informationen finden Sie in den Dokumenten von OpenAI.
Insert Message ‘+’		Wenn Sie darauf klicken, 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 übergeordnete 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 Dokumente von OpenAI für weitere Klarstellungen.

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
• Globales CSS festlegen

JavaScript-Aktion ausführen

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

Wenn die oben genannte „JavaScript ausführen“-Aktion ausgewählt ist, sehen Sie einen Bereich (einen Code-Editor), in dem der JavaScript-Code geschrieben werden sollte, sowie Anweisungen, wie man ihn benutzt:

Globales CSS festlegen

Mit der Aktion „Globales CSS festlegen“ können Sie benutzerdefinierten CSS-Code verwenden, um einen Aspekt der Studie bei einem Trigger zu ändern.

Das folgende Feld öffnet sich, wenn Sie diese Aktion anklicken:

Ein Beispiel für die Verwendung der Aktion „Globales CSS festlegen“ wäre, die Hintergrundfarbe der Studie zu ändern, wenn ein Teilnehmer eine bestimmte Farbe aus einer Multiple-Choice-Frage auswählt.

Einfügeaktion

Diese Option ermöglicht es Ihnen, eine Aktion einzufügen, die Sie zuvor erstellt und kopiert haben. Sie ermöglicht es Ihnen, schneller zu arbeiten, wenn Sie Ihr Experiment entwerfen, sodass Sie nicht ständig dieselben Elemente auswählen müssen. Wenn Sie beispielsweise ein Ereignis haben, das einem bereits vorhandenen ähnlich ist, können Sie es einfach kopieren, einfügen und ändern, anstatt es von Grund auf neu zu erstellen.

Das Wert-Auswahl-Menü

Wenn Sie mit bestimmten Ereignissen arbeiten, wird ein Stiftsymbol angezeigt. Dies wird als Wert-Auswahl-Menü bezeichnet, da es Ihnen ermöglicht, auszuwählen und anzugeben, 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 / Wert-Auswahl-Menü 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.

Durch Klicken auf das Stiftsymbol gelangen Sie zu einem Dropdown-Menü, in dem Sie den Wert angeben, der gelesen oder geschrieben werden soll. Das Dropdown-Menü beginnt immer mit einer trigger-spezifischen Wertoption und geht dann zu den anderen 5 Kategorien (Aktuelle Zeit, Konstantenwert, Variable, Rahmen / Aufgabe / Option und Operationen), die jeweils ihre eigenen Optionen haben. Diese werden weiter unten beschrieben.

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

Menüoptionen

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

Aktuelle Zeitwerte

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

Die folgenden Optionen sind verfügbar:

• UNIX-Zeitstempel
• Zeit seit Beginn des Rahmens

Aktuelle Zeit: UNIX-Zeitstempel

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

Aktuelle Zeit: Zeit seit Beginn des Rahmens

Dieser Wert erfasst die Zeit, die seit dem Beginn des Rahmens vergangen ist. Meistens entspricht dies der Reaktionszeit.

Konstantenwerte

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

Die folgenden Optionen sind verfügbar:

• String
• Numeric
• Boolean
• Categorical
• Date
• Time
• Color

Konstant: String

Weist einen String / Textwert zu.

Konstant: Numeric

Weist einen numerischen / Zahlenwert zu.

Konstant: Boolean

Weist einen Wert von wahr oder falsch zu.

Konstant: Categorical

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

Konstant: Date

Weist einen Datumswert zu.

Konstant: Time

Weist einen Zeitwert zu.

Konstant: Color

Weist einen Farbwert (Hex-String) zu.

Variable Werte

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 sind verfügbar:

• Select Variable
• Select Value from Array
• Select Value from Data Frame

Select Variable

Ermöglicht Ihnen, eine Variable auszuwählen und darauf zu verweisen.

Select Value from Array

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

Select Value from Data Frame

Ermöglicht Ihnen, einen Wert aus einem Data Frame auszuwählen, den Sie erstellt haben.

Rahmen / Aufgabe / Objektwerte

Ermöglicht Ihnen, Werte zu erfassen, die mit Eigenschaften von Objekten, dem Rahmen, der Augenverfolgung (falls aktiviert) und dem Gerät (Bildschirmaktualisierungsrate) verbunden sind.

• Object Property
• Frame
• Eye Tracking
• Device

Objektproperty

Liest eine Objektproperty 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 Strings, sodass sie alle Kleinbuchstaben sind, oder das Durchführen mathematischer Operationen.

Die folgenden Optionen sind verfügbar:

• Arithmetic
• String-Operation
• Math-Operation

Arithmetik

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

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

Beim Auswählen dieser Option wird ein zusätzliches Stiftsymbol (d. h. Wertauswahlmenü) angezeigt, 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 verwendet werden, um eine neue String-Variable (im grünen Knopf) 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 Stringwerten, wie dem Semikolon : und dem Leerzeichen <br> verwendet werden. Diese Aktion erzeugt die Wirkung eines Benutzerchats, der in einer Mehrbenutzerstudie verwendet werden kann.

String-Operation

Math-Operation

Führt eine mathematische Operation auf einem Skalaren Wert aus.

Trigger-spezifische Werte

Trigger-spezifische Werte beziehen sich auf Werte, die mit dem Trigger verbunden sind, der innerhalb eines bestimmten Ereignisses definiert ist. Wenn Ihr Ereignis beispielsweise einen Trigger für die Maus verwendet, können Sie in bestimmten Bereichen, in denen die Aktion angegeben ist (wie beim Verwenden einer Set / Record Variable Aktion oder einer Set Object Property Aktion), auf maus-spezifische Triggerwerte in dem Wertauswahlmenü. verweisen.

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

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

Name	Wertoptionen - Übersicht
Trigger (Mouse)	Maus X Maus Y Maus [X,Y] Array Stimulus Name Stimulus Info Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Keyboard)	Id der Taste Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Button Bar)	Stimulus Name Stimulus Info Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Enter On Input)	Id der Taste Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Scroll)	Stimulus Name Stimulus Info Scrollposition X Scrollposition Y Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Gamepad/ Joystick)	Gamepad-Geräte-ID Gedrückte Tasten (Array) Gedrückte oder gehaltene Tasten (Array) Freigegebene Tasten (Array) Achsen (Array) Gamepad-Zeitstempel (Unixzeit) Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Eyetracking Gaze)	Koordinate X Koordinate Y Koordinate [X,Y] Array Stimulus Name Stimulus Info Zeit T der Kameraaufnahme Gaze Confidence C Koord. + Zeit [X,Y, T] Array Koord. + Zeit + Vertrauen [X,Y, T,C] Array Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Eyetracking Fixation)	Fixationsschwerpunkt X Fixationsschwerpunkt Y Fixationsdauer Fixationsstartzeit Fixationsendzeit Fixationsstreuung Stimulus Name Stimulus Info [X,Y, Dauer, Start, Ende, Streuung] Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Head Tracking)	Zeit T der Kameraaufnahme Facemesh-Datenrahmen Kopfneigung Kopfneigung Kopfroll Kopfposition [X,Y, T] Array Nasenposition [X,Y, T] Array Nasenvector [X,Y, Z, T] Array Trigger-Zeitstempel (Unixzeit) Triggerzeit vom Frame-Start
Trigger (On Task Initialization)	Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (On Frame Init)	TrialNr Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (on Frame Start)	Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (On Frame End)	Gesamte Frame-Zeit Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Variable Value Changed)	Neuer Wert in der Variable Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Media Object Trigger)	Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Websocket Trigger)	Nachricht Daten Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (OpenAI Trigger)	Chat GPT Antwort Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (PostMessage Received)	Nachrichtentext Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (Global Experiment Event)	Gesamte Frame-Zeit Grund für globales Ereignis Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)
Trigger (User Leaves Experiment)	Verbleibende Anzahl der Teilnehmer Trigger-Zeitstempel (Unixzeit) Trigger-Zeit (vom Frame-Start an)

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 (Buttonleiste) Werte

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

Trigger (Enter bei Eingabe) Werte

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

Trigger (Scrollen) Werte

Wenn ein 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 (Augenverfolgung Blick) Werte

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

Erfahren Sie mehr: Siehe die spezielle Augenverfolgung Blick-Trigger Seite zum Aktivieren der Augenverfolgung, Erfassen von Blickdaten und praktischen Beispielen.

Trigger(Augenverfolgung Fixierung) Werte

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

Mehr erfahren: Siehe die dedizierte Eyetracking Fixation Trigger Seite zur Aktivierung der Fixationsdetektion, Aufzeichnung von Fixationsdaten und praktischen Beispielen.

Trigger (Kopfverfolgung) Werte

Wenn ein Kopfverfolgungs-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Bei Aufgabeninitialisierung) Werte

Wenn ein Aufgaben-Init-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Bei Frame-Init) Werte

Wenn ein Frame-Init-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Bei Frame-Beginn) Werte

Wenn ein Frame-Begin-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Bei Frame-Ende) Werte

Wenn ein Frame-End-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Variablenwert geändert) Werte

Wenn ein Variablenwert-Änderungs-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Medienobjekt-Trigger) Werte

Wenn ein Medienobjekt-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Websocket-Trigger) Werte

Wenn ein Websocket-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (OpenAI-Trigger) Werte

Wenn ein OpenAI-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (PostMessage empfangen) Werte

Wenn ein PostMessage empfangen-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Globales Experimentevent) Werte

Wenn ein Pause / Fortsetzen des Experiments-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden:

Trigger (Teilnehmer verlässt Experiment) Werte

Wenn ein Teilnehmer verlässt Multiuser-Studie-Trigger verwendet wird, können die folgenden trigger-spezifischen Werte für bestimmte Aktionen aufgerufen werden: