Mouse and eye tracking

Mouse tracking

Magpie can track mouse movements during trials.

You can start collecting mouse tracking data by calling $magpie.mousetracking.start().

After the trial you can retrieve the tracking data using $magpie.mousetracking.getMouseTrack().

For convenience, you can also use MousetrackingStart in your custom screens to start a new mouse track once it is rendered. The component will be invisible to participants.

Eye tracking

Magpie supports WebGazer, a library that can track participants' eye movements via their webcam. Due to licensing issues we cannot bundle WebGazer with magpie, so you need to install it first using the following command in your terminal. (Note that WebGazer is licensed under the GNU Public License.)

npm install webgazer

Before you can record eye tracking data, WebGazer needs to be calibrated using EyetrackingCalibrationScreen. Afterwards, you can optionally test calibration using EyetrackingValidationScreen.

In a trial screen you can start collecting eyetracking data by calling $magpie.eyetracking.start().

After the trial you can retrieve the tracking data using $magpie.eyetracking.getEyeTrack().

For convenience, you may also use EyetrackingStart in your trial screens to start a new eye track once the component is rendered (it is invisible).

Fullscreen

For mouse and eye tracking it can be beneficial for the experiment to take up as much screen estate as possible. To this end you can use FullscreenStart to automatically trigger fullscreen mode. Additionally, you may want to use the full screen width in your experiment, instead of the default box. This can be changed by setting the wide prop of the Experiment component.