Réponses de souris et tactiles

Les réponses de souris sont collectées avec l’item mouse_response. Le mouse_response est principalement destiné à collecter des clics de souris individuels. Sur les appareils tactiles, les réponses tactiles (item touch_response) sont généralement enregistrées de la même manière que les clics du bouton-1 de la souris aux coordonnées touchées ; le même item et la même logique peuvent donc souvent être utilisés à la fois pour les entrées souris et tactiles. Si vous souhaitez collecter des trajectoires du curseur de la souris, jetez un œil aux plugins mousetrap :

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

Variables de réponse

Le mouse_response définit les variables de réponse standard comme décrit ici :

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

En outre, les variables suivantes sont pertinentes pour les réponses de souris et tactiles :

Noms des boutons de la souris

Les boutons de la souris ont un numéro (1, etc.) ainsi qu’un nom (left_button, etc.). Les deux peuvent être utilisés pour spécifier les réponses correctes et autorisées, mais la variable response sera définie sur un nombre.

• left_button correspond à 1
• middle_button correspond à 2
• right_button correspond à 3
• scroll_up correspond à 4
• scroll_down correspond à 5

Réponse correcte

Le champ Correct response indique quelle réponse est considérée comme correcte. Après une réponse correcte, la variable correct est automatiquement définie sur 1 ; après une réponse incorrecte ou un timeout (c.-à-d. tout le reste), correct est définie sur 0 ; si aucune réponse correcte n’est spécifiée, correct est définie sur 'undefined'.

Vous pouvez indiquer la réponse correcte de trois manières principales :

• Laissez le champ vide. Si vous laissez le champ Correct response vide, OpenSesame vérifiera automatiquement si une variable appelée correct_response a été définie et, si c’est le cas, utilisera cette variable comme réponse correcte.
• Saisissez une valeur littérale. Vous pouvez saisir explicitement une réponse, comme 1. Cela n’est utile que si la réponse correcte est fixe.
• Saisissez un nom de variable. Vous pouvez saisir une variable, telle que '{cr}'. Dans ce cas, cette variable sera utilisée comme réponse correcte.

Notez que la réponse correcte se rapporte au bouton de la souris sur lequel on a cliqué, et non à la région d’intérêt cliquée (ROI). Si la justesse dépend de l’emplacement cliqué plutôt que du bouton de la souris, vous devez déterminer vous-même la justesse sur la base de cursor_roi ; voir la section ci-dessous pour plus d’informations sur les ROI.

Réponses autorisées

Le champ Allowed responses indique une liste de réponses autorisées. Toutes les autres réponses seront ignorées, à l’exception de 'Escape', qui mettra l’expérience en pause. Les réponses autorisées doivent être une liste de réponses séparées par des points-virgules, comme '1;3' pour autoriser les boutons gauche et droit de la souris. Pour accepter toutes les réponses, laissez le champ Allowed responses vide.

Notez que les réponses autorisées se rapportent au bouton de la souris qui peut être cliqué, et non à la région d’intérêt qui peut être cliquée (ROI) ; voir la section ci-dessous pour plus d’informations sur les ROI.

Délai d'attente

Le champ Timeout indique une valeur de délai d'attente en millisecondes, ou 'infini' pour aucun délai d'attente. Lorsqu'un délai d'attente se produit, les actions suivantes se produisent :

• response_time est défini sur la valeur du délai d'attente, ou plutôt sur le temps qu'il faut pour qu'un délai d'attente soit enregistré, ce qui peut varier légèrement par rapport à la valeur du délai d'attente.
• response est défini sur 'None'. Cela signifie que vous pouvez spécifier 'None' comme réponse correcte lorsqu'un délai d'attente doit se produire; cela peut être utile, par exemple, dans une tâche de type go/no-go, lorsque le participant doit retenir une réponse lors des essais de type no-go.

Coordinates and regions of interest (ROIs)

Les variables cursor_x et cursor_y contiennent l’emplacement du clic de souris.

Si vous indiquez un sketchpad lié, la variable cursor_roi contiendra une liste, séparée par des points-virgules, des noms des éléments qui contiennent la coordonnée cliquée. Autrement dit, les éléments du sketchpad servent automatiquement de régions d’intérêt pour le clic de souris.

La variable cursor_roi indique où le clic a eu lieu, tandis que response indique quel bouton de la souris a été cliqué. Si plusieurs éléments nommés se chevauchent à l’emplacement cliqué, cursor_roi peut contenir plusieurs noms d’éléments.

Si la correction d’une réponse dépend du ROI qui a été cliqué, vous ne pouvez pas utiliser la variable correct_response pour cela, car elle renvoie uniquement au bouton de souris qui a été cliqué. À la place, vous devez utiliser un script simple pour déterminer la correction sur la base de cursor_roi et, si nécessaire, remplacer correct.

Dans un Python inline_script, vous pouvez faire ceci comme suit :

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

Avec OSWeb en utilisant un inline_javascript, vous pouvez faire ceci comme suit :

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
}

Ici, 'my_roi' est simplement un nom d’exemple d’un élément de sketchpad. Dans une expérience réelle, remplacez-le par le nom du ROI qui doit être considéré comme correct. Pour éviter toute ambiguïté, les éléments nommés doivent être uniques dans un sketchpad.

Réponses tactiles

Sur les appareils tactiles, chaque appui est généralement enregistré comme une réponse mouse-button-1 aux coordonnées touchées. Cela signifie que l’item mouse_response peut souvent être utilisé à la fois pour les clics de souris et les appuis tactiles sans autre modification.

En pratique, cela signifie qu’une réponse tactile se comporte comme suit :

• Le bouton est généralement enregistré comme 1
• L’emplacement du toucher est stocké dans cursor_x et cursor_y
• Si un sketchpad est lié, les éléments touchés peuvent être identifiés via cursor_roi

Cela peut être utile pour les expériences qui doivent fonctionner à la fois sur des ordinateurs de bureau et sur des appareils à écran tactile.

Exemple : réponses tactiles avec mouse_response

Par exemple, considérons une tâche de choix simple dans laquelle deux grands éléments de sketchpad sont affichés sur les côtés gauche et droit de l’écran. Si le participant touche l’élément de gauche sur un écran tactile :

• response sera généralement défini sur 1
• cursor_x et cursor_y contiendront les coordonnées du toucher
• cursor_roi peut contenir le nom de l’élément touché, par exemple left_option

Cela signifie que l’entrée tactile peut être gérée de la même manière qu’une entrée souris. Si la correction dépend de l’élément touché plutôt que du bouton, vous pouvez utiliser la même logique cursor_roi décrite ci-dessus.

Exemple : utilisation du plug-in touch_response

Pour les expériences où vous souhaitez diviser l’écran en régions de réponse discrètes (par ex. une grille de boutons), le plug-in touch_response offre une approche plus simple et plus pratique que le travail avec des coordonnées brutes. Il divise l’affichage en une grille de lignes et de colonnes, et encode chaque réponse comme un nombre unique, en comptant de gauche à droite et de haut en bas.

Par exemple, avec 2 colonnes et 3 lignes, l’affichage est divisé comme suit :

Ainsi, si vous spécifiez 2 colonnes et 1 ligne, l’affichage est divisé en deux régions de réponse :

Dans une tâche simple oui/non, vous pourriez attribuer :

• 1 = Oui
• 2 = Non

Si la bonne réponse est Oui, définissez le champ Correct response sur 1. OpenSesame définira alors automatiquement correct sur 1 lorsque le participant touche la moitié gauche de l’écran.

[!NOTE] Le plug-in touch_response n’utilise pas d’éléments sketchpad nommés ni cursor_roi. Les réponses sont encodées uniquement comme positions de grille.

[!NOTE] Le comportement exact de l’entrée tactile peut dépendre de la plateforme et du backend utilisés pour exécuter l’expérience.

[!NOTE] L’item mouse_response ne capture qu’une seule réponse tactile. Si plusieurs doigts touchent l’écran simultanément, une seule réponse est enregistrée.

Recueillir les réponses de la souris en Python

Vous pouvez utiliser l’objet mouse pour recueillir les réponses de la souris en Python :

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