Timer-Objekt

Das Timer-Objekt zeigt während eines Versuchs einen sichtbaren Countdown- oder Zähler-Timer auf dem Bildschirm an. Es integriert sich vollständig in das Labvanced-Ereignissystem: Sie steuern den Timer mit StartTimer, PauseTimer und ResetTimer-Aktionen, und es werden Trigger ausgelöst, wenn er startet, pausiert, endet oder eine ganze Sekunde überschreitet. Der aktuelle Zeitwert ist als lesbare und schreibbare Variable verfügbar, was es einfach macht, die Experimentlogik basierend auf der verstrichenen oder verbleibenden Zeit zu verzweigen.

Hinzufügen des Timer-Objekts

Öffnen Sie in der Symbolleiste des Aufgabeneditors die Gruppe Buttons & Navigation und wählen Sie Timer aus, um ein Timer-Objekt zu dem aktuellen Rahmen hinzuzufügen.

Symbolleiste des Labvanced-Aufgabeneditors mit dem Timer-Objekt, das in der Gruppe Schaltflächen & Navigation hervorgehoben ist

Wenn Sie das Element hinzufügen, öffnet sich automatisch ein Timer-Setup-Assistent. Sie können den Assistenten abschließen, um den Timer vorzustellen und häufige Ereignisse in einem Schritt hinzuzufügen, oder auf Skip klicken, um alles manuell zu konfigurieren.

Timer-Setup-Assistent

Der Setup-Assistent behandelt die häufigsten Konfigurationsoptionen und kann optional Starterereignisse für Sie hinzufügen.

Option	Beschreibung
Timer-Dauer (Sekunden)	Legt fest, wie lange der Timer läuft. Geben Sie eine positive ganze Zahl ein. Standard ist 60 Sekunden.
Richtung	`Count down` beginnt bei der Dauer und zählt auf 0. `Count up` beginnt bei 0 und zählt auf die Dauer.
Zehntel Sekunde anzeigen	Wenn aktiviert, zeigt der Timer im MM:SS.T-Format statt MM:SS an.
Timer beim Rahmenstart starten	Fügt ein Ereignis hinzu, das `StartTimer` automatisch auslöst, wenn der Rahmen beginnt.
Zum nächsten Rahmen springen, wenn der Timer endet	Fügt ein Ereignis hinzu, das `Jump to Next Frame` auslöst, wenn der `TimerEnded`-Trigger ausgelöst wird.

Sie können jede der automatischen Ereignisse überspringen und sie stattdessen manuell im Ereignis-Editor konfigurieren.

Objekteigenschaften

Alle untenstehenden Einstellungen finden Sie im Objekteigenschaften -Panel, wenn das Timer-Objekt ausgewählt ist.

Timer-Einstellungen

Eigenschaft	Standard	Beschreibung
`Duration (seconds)`	60	Die Gesamtdauer, für die der Timer läuft, in Sekunden.
`Directionality`	Countdown	`Count down` beginnt bei der Dauer und zählt auf 0. `Count up` beginnt bei 0 und zählt auf die Dauer.
`Show tenths of a second`	Aus	Wenn aktiviert, wird der Timer im MM:SS.T-Format angezeigt. Wenn er ausgeschaltet ist, wird er im MM:SS-Format angezeigt. Nicht zur Laufzeit über Ereignisse änderbar.

Note: Current Time (seconds) erscheint nicht im Eigenschaften-Panel, ist jedoch zur Laufzeit über die Set Object Property -Aktion im Ereignissystem lesbar und schreibbar. Siehe Aktuelle Zeit als Variable verwenden.

Objekteigenschaften-Panel für ein Timer-Objekt, das Felder für Dauer, aktuelle Zeit und zählt hoch anzeigt

Stil

Eigenschaft	Steuerung
`Visibility`	Opazität von 0 (unsichtbar) bis 1 (vollständig sichtbar).
`Border-Size`	Randbreite in Pixeln. Standard ist 0 (kein Rand).
`Border-Color`	Randfarbe. Hat keine sichtbare Wirkung, wenn `Border-Size` 0 ist.
`BG-Color`	Hintergrundfüllung des umschließenden Rechtecks. Aktivieren Sie `Transparent`, um die Füllung zu entfernen.
`Roundness`	Rundung der Ecken von 0 (scharfe Ecken) bis 1 (maximale Rundung: eine Ellipse auf rechteckigen Elementen, ein Kreis auf quadratischen Elementen).

Benutzerdefiniertes CSS

Aktivieren Sie Change CSS Properties im Abschnitt Stil, um das CSS-Textfeld anzuzeigen. Schreiben Sie dort Standard-CSS-Regeln. Labvanced scope automatisch jede Regel auf das ausgewählte Objekt, sodass Ihre Selektoren nur das interne DOM dieses Elements betreffen.

Styling der Zeitansicht

Zielgerichtet span, um die Schriftart, Farbe, Größe oder Gewicht der Zeitdarstellung zu ändern:

span {
  font-size: 3em;
  color: #c0392b;
  font-family: "Courier New", monospace;
  font-weight: bold;
  letter-spacing: 0.05em;
}

Timer-Objekt mit angewendetem benutzerdefinierten CSS, das eine stilisierte Schriftart und einen Container zeigt

Änderungen am Stil des Timer-Objekts über CSS mit dem Objekteigenschaften-Panel.

Hinweis zu Priorität von Eigenschaften

Hintergrundfarbe, Rand und Randradius, die im Stil-Panel festgelegt sind, werden als Inline-Stile auf dem Element angewendet, was Vorrang vor benutzerdefinierten CSS-Regeln hat. Wenn Sie benutzerdefiniertes CSS benötigen, um einen Wert aus dem Stil-Panel zu überschreiben, fügen Sie !important zu Ihrer Regel hinzu. Für diese drei Eigenschaften ist es im Allgemeinen einfacher, die Steuerungen im Stil-Panel zu verwenden.

Steuerung des Timers mit Aktionen

Verwenden Sie die Control Element-Aktion im Ereignissystem, um den Timer programmgesteuert zu steuern.

Aktion	Was sie tut
`StartTimer`	Startet den Timer von seiner aktuellen Position. Wenn der Timer pausiert war, wird er von dort fortgesetzt, wo er gestoppt wurde.
`PauseTimer`	Pausiert den Timer an seiner aktuellen Position, ohne ihn zurückzusetzen.
`ResetTimer`	Stoppt den Timer und setzt `Current Time` auf seine Ausgangsposition zurück: Dauer für den Countdown, 0 für den Zähler.

Beispiel: Starten Sie den Timer automatisch, wenn der Rahmen beginnt

Trigger: On Frame Start
Aktion: Control Element → Set Target: Ihr Timer-Objekt → StartTimer

Beispiel: Pausieren Sie den Timer, wenn auf eine Schaltfläche geklickt wird

Trigger: On Mouse Click → Set Target: Ihre Pausenschaltfläche
Aktion: Control Element → Set Target: Ihr Timer-Objekt → PauseTimer

Auslösen von Ereignissen aus dem Timer

Das Timer-Objekt löst die folgenden Trigger aus, die Sie als "wann" Bedingung in jedem Ereignis verwenden können.

Trigger	Wann er ausgelöst wird
`TimerStarted`	Wenn `StartTimer` aufgerufen wird und der Timer zu laufen beginnt.
`TimerPaused`	Wenn `PauseTimer` aufgerufen wird und der Timer stoppt.
`TimerEnded`	Wenn der Timer sein Ende erreicht: 0 für den Countdown oder die Dauer für den Zähler.
`TimerThreshold`	Wird jedes Mal ausgelöst, wenn der Timer eine ganze Sekunde überschreitet, während er läuft. Verwenden Sie dies, um Logik in regelmäßigen Ein-Sekunden-Intervallen auszuführen.

Beispiel: Zum nächsten Rahmen wechseln, wenn der Timer endet

Trigger: Media Object Trigger → Set Target: Ihr Timer-Objekt → Execute on: TimerEnded
Aktion: Jump to Next Frame

Beispiel: Eine Variable jede Sekunde aufzeichnen

Trigger: Media Object Trigger → Set Target: Ihr Timer-Objekt → Execute on: TimerThreshold
Aktion: Set / Record Variable → Ihre Aufzeichnungsvariable

Aktuelle Zeit als Variable verwenden

Die Current Time (seconds)-Eigenschaft ist ein lesbarer und schreibbarer Laufzeitwert. Sie können die Set Object Property-Aktion verwenden, um die aktuelle Zeit in eine andere Variable zu lesen oder um den Timer an eine bestimmte Position zu verschieben.

Dies macht es möglich:

Die genaue verbleibende Zeit zu speichern, wenn ein Teilnehmer antwortet
Den Fluss des Experiments basierend auf der verstrichenen Zeit zu verzweigen
Zwei Timer zu synchronisieren, indem Sie denselben Wert in beide schreiben

Beispiel: verbleibende Zeit bei der Antwort speichern

Trigger: On Key Press → Set Target: Ihre Zieltaste
Aktion 1: Set / Record Variable → Erstellen Sie eine Variable (z. B. time_at_response), Wertquelle: Object Property → Set Target: Ihr Timer-Objekt → Current Time (seconds)
Aktion 2: Jump to Next Frame