Maus- und Berührungsreaktionen

Mausreaktionen werden mit dem mouse_response-Item erfasst. Das mouse_response ist in erster Linie dafür gedacht, einzelne Mausklicks zu erfassen. Auf Geräten mit Touch-Unterstützung werden Touch-Reaktionen (touch_response-Item) im Allgemeinen auf dieselbe Weise registriert wie Maus-Taste-1-Klicks an den berührten Koordinaten, sodass oft dasselbe Item und dieselbe Logik sowohl für Maus- als auch für Touch-Eingaben verwendet werden können. Wenn Sie Mauszeiger-Trajektorien erfassen möchten, werfen Sie einen Blick auf die mousetrap-Plugins:

• https://osdoc.cogsci.nl/4.1/de/manual/mousetracking

Reaktionsvariablen

Das mouse_response setzt die Standard-Reaktionsvariablen wie hier beschrieben:

• https://osdoc.cogsci.nl/4.1/de/manual/variables

Zusätzlich sind die folgenden Variablen für Maus- und Touch-Reaktionen relevant:

Namen der Maustasten

Maustasten haben sowohl eine Zahl (1 usw.) als auch einen Namen (left_button usw.). Beide können verwendet werden, um korrekte und erlaubte Reaktionen anzugeben, aber die Variable response wird auf eine Zahl gesetzt.

• left_button entspricht 1
• middle_button entspricht 2
• right_button entspricht 3
• scroll_up entspricht 4
• scroll_down entspricht 5

Korrekte Reaktion

Das Feld Correct response gibt an, welche Reaktion als korrekt betrachtet wird. Nach einer korrekten Reaktion wird die Variable correct automatisch auf 1 gesetzt; nach einer inkorrekten Reaktion oder einem Timeout (d. h. allem anderen) wird correct auf 0 gesetzt; wenn keine korrekte Reaktion angegeben ist, wird correct auf 'undefined' gesetzt.

Sie können die korrekte Reaktion auf drei Hauptarten angeben:

• Lassen Sie das Feld leer. Wenn Sie das Feld Correct response leer lassen, prüft OpenSesame automatisch, ob eine Variable namens correct_response definiert wurde, und verwendet diese Variable dann, falls vorhanden, als korrekte Reaktion.
• Geben Sie einen wörtlichen Wert ein. Sie können explizit eine Reaktion eingeben, zum Beispiel 1. Das ist nur nützlich, wenn die korrekte Reaktion fest ist.
• Geben Sie einen Variablennamen ein. Sie können eine Variable eingeben, zum Beispiel '{cr}'. In diesem Fall wird diese Variable als korrekte Reaktion verwendet.

Beachten Sie, dass sich die korrekte Reaktion darauf bezieht, welche Maustaste angeklickt wurde, nicht darauf, welche Region of Interest (ROI) angeklickt wurde. Wenn die Korrektheit von der angeklickten Position statt von der Maustaste abhängt, müssen Sie die Korrektheit selbst anhand von cursor_roi bestimmen; siehe den Abschnitt unten für weitere Informationen über ROIs.

Erlaubte Reaktionen

Das Feld Allowed responses gibt eine Liste der erlaubten Reaktionen an. Alle anderen Reaktionen werden ignoriert, außer 'Escape', wodurch das Experiment pausiert wird. Die erlaubten Reaktionen sollten eine durch Semikola getrennte Liste von Reaktionen sein, z. B. '1;3', um die linke und rechte Maustaste zu erlauben. Um alle Reaktionen zu akzeptieren, lassen Sie das Feld Allowed responses leer.

Beachten Sie, dass sich die erlaubten Reaktionen darauf beziehen, welche Maustaste angeklickt werden kann, nicht darauf, welche Region of Interest angeklickt werden kann (ROI); siehe den Abschnitt unten für weitere Informationen über ROIs.

Zeitüberschreitung

Das Feld Timeout gibt einen Timeout-Wert in Millisekunden an oder "unendlich" für keine Zeitüberschreitung. Wenn eine Zeitüberschreitung auftritt, geschieht Folgendes:

• response_time wird auf den Timeout-Wert gesetzt, oder eher auf die Zeit, die benötigt wird, um eine Zeitüberschreitung zu registrieren, die möglicherweise leicht von dem Timeout-Wert abweicht.
• response wird auf 'None' gesetzt. Das bedeutet, dass Sie 'None' als richtige Antwort angeben können, wenn eine Zeitüberschreitung eintreten soll; dies kann zum Beispiel in einer Go-/No-Go-Aufgabe nützlich sein, wenn der Teilnehmer bei No-Go-Versuchen keine Antwort geben soll.

Coordinates and regions of interest (ROIs)

Die Variablen cursor_x und cursor_y enthalten die Position des Mausklicks.

Wenn Sie ein verknüpftes sketchpad angeben, enthält die Variable cursor_roi eine durch Semikola getrennte Liste der Namen von Elementen, die die angeklickte Koordinate enthalten. Mit anderen Worten: Elemente auf dem sketchpad dienen automatisch als regions of interest für den Mausklick.

Die Variable cursor_roi gibt an, wo der Klick erfolgt ist, während response angibt, welche Maustaste geklickt wurde. Wenn sich mehrere benannte Elemente an der angeklickten Position überlappen, kann cursor_roi mehrere Elementnamen enthalten.

Wenn die Korrektheit einer Antwort davon abhängt, welches ROI angeklickt wurde, können Sie dafür nicht die Variable correct_response verwenden, da sich diese nur darauf bezieht, welche Maustaste geklickt wurde. Stattdessen müssen Sie ein einfaches Skript verwenden, um die Korrektheit auf Grundlage von cursor_roi zu bestimmen, und bei Bedarf correct überschreiben.

In einem Python inline_script können Sie dies wie folgt tun:

clicked_rois = cursor_roi.split(';')
correct_roi = 'my_roi'
if correct_roi in clicked_rois:
    print('correct!')
    correct = 1
else:
    print('incorrect!')
    correct = 0

Mit OSWeb unter Verwendung eines inline_javascript können Sie dies wie folgt tun:

clicked_rois = cursor_roi.split(';')
correct_roi = 'my_roi'
if (clicked_rois.includes(correct_roi)) {
    console.log('correct!')
    correct = 1
} else {
    console.log('incorrect!')
    correct = 0
}

Hier ist 'my_roi' einfach ein Beispielname eines sketchpad-Elements. Ersetzen Sie ihn in einem realen Experiment durch den Namen des ROI, das als korrekt gelten soll. Um Mehrdeutigkeiten zu vermeiden, sollten benannte Elemente innerhalb eines sketchpad eindeutig sein.

Touch-Antworten

Auf Geräten mit Touch-Unterstützung wird jedes Tippen im Allgemeinen als mouse-button-1-Antwort an den berührten Koordinaten registriert. Das bedeutet, dass das mouse_response-Item häufig sowohl für Mausklicks als auch für Touch-Eingaben ohne weitere Anpassung verwendet werden kann.

In der Praxis bedeutet dies, dass sich eine Touch-Antwort wie folgt verhält:

• Die Taste wird typischerweise als 1 registriert
• Die Position der Berührung wird in cursor_x und cursor_y gespeichert
• Wenn ein sketchpad verknüpft ist, können berührte Elemente über cursor_roi identifiziert werden

Dies kann für Experimente nützlich sein, die sowohl auf Desktop- als auch auf Touchscreen-Geräten laufen sollen.

Beispiel: Touch-Antworten mit mouse_response

Betrachten Sie zum Beispiel eine einfache Auswahlaufgabe, bei der zwei große sketchpad-Elemente auf der linken und rechten Seite des Bildschirms angezeigt werden. Wenn der Teilnehmer auf einem Touchscreen auf das linke Element tippt:

• wird response typischerweise auf 1 gesetzt
• enthalten cursor_x und cursor_y die Touch-Koordinaten
• kann cursor_roi den Namen des berührten Elements enthalten, zum Beispiel left_option

Das bedeutet, dass Touch-Eingaben auf die gleiche Weise behandelt werden können wie Maus-Eingaben. Wenn die Korrektheit vom berührten Element statt von der Taste abhängt, können Sie dieselbe oben beschriebene cursor_roi-Logik verwenden.

Beispiel: Verwendung des touch_response-Plug-ins

Für Experimente, bei denen Sie den Bildschirm in diskrete Antwortbereiche unterteilen möchten (z. B. ein Raster aus Schaltflächen), bietet das touch_response-Plug-in einen einfacheren und bequemeren Ansatz als die Arbeit mit Rohkoordinaten. Es unterteilt die Anzeige in ein Raster aus Zeilen und Spalten und kodiert jede Antwort als einzelne Zahl, von links nach rechts und von oben nach unten gezählt.

Bei 2 Spalten und 3 Zeilen wird die Anzeige zum Beispiel wie folgt unterteilt:

Wenn Sie also 2 Spalten und 1 Zeile angeben, wird die Anzeige in zwei Antwortbereiche unterteilt:

In einer einfachen Ja/Nein-Aufgabe könnten Sie Folgendes zuweisen:

• 1 = Ja
• 2 = Nein

Wenn die richtige Antwort Ja ist, setzen Sie das Feld Correct response auf 1. OpenSesame setzt dann automatisch correct auf 1, wenn der Teilnehmer auf die linke Hälfte des Bildschirms tippt.

[!NOTE] Das Plug-in touch_response verwendet keine benannten sketchpad-Elemente oder cursor_roi. Antworten werden nur als Gitterpositionen kodiert.

[!NOTE] Das genaue Verhalten der Touch-Eingabe kann von der Plattform und dem Backend abhängen, die zum Ausführen des Experiments verwendet werden.

[!NOTE] Das Element mouse_response erfasst nur eine einzelne Touch-Antwort. Wenn mehrere Finger gleichzeitig den Bildschirm berühren, wird nur eine Antwort registriert.

Erfassen von Mausantworten in Python

Sie können das Objekt mouse verwenden, um Mausantworten in Python zu erfassen:

• https://osdoc.cogsci.nl/4.1/de/manual/python/mouse