FNAME

A Face–Name–Occupation associative memory task. Participants learn face–name and face–occupation pairs, then must infer name↔occupation associations without seeing faces, and finally recognize correct pairings after a configurable delay.

• Duration: ~180 s
• Source: Papp et al., 2021 · Rentz et al., 2010 — custom implementation
• Launch URL: https://andreifoldes.github.io/m2c2-assessments/assessments/fname/

Example URL commands

# Plain launch (debug mode: results shown on-screen)
https://andreifoldes.github.io/m2c2-assessments/assessments/fname/

# Suppress the completion screen
https://andreifoldes.github.io/m2c2-assessments/assessments/fname/?show_end_screen=false

# With camera recording
https://andreifoldes.github.io/m2c2-assessments/assessments/fname/?webcam=1

# With eye tracking
https://andreifoldes.github.io/m2c2-assessments/assessments/fname/?webgazer=1

# Customized assessment parameters (values shown are the defaults)
https://andreifoldes.github.io/m2c2-assessments/assessments/fname/?number_of_pairs=6&number_of_distractors=2&learning_duration_ms=5000

# Production: submit results to your server
https://andreifoldes.github.io/m2c2-assessments/assessments/fname/?token=<TOKEN>&callback_url=<CALLBACK_URL>

Session parameters

Handled by the launch wrapper (results submission and optional sensors), not by the assessment itself.

Parameter	Type	Default	Description
callback_url	string	—	URL to POST results to when the assessment ends.
face_source	string	bundled	Set to api to fetch random faces from the 100k-faces API instead of using the bundled curated face set.
number_of_faces_to_prefetch	number	—	How many face images to prefetch before the task starts (only relevant with face_source=api).
pid	string	—	Optional participant identifier. Echoed verbatim into the results: top-level pid next to token in the callback POST, inside data, and in the embed-mode postMessage. Useful when the callback endpoint does not mint per-participant tokens, or to link multi-session designs (e.g. FNAME-Pairs learning vs. delayed) from the URL alone.
show_end_screen	string	true	Set to false or 0 to suppress the green "Assessment Complete" screen after results are submitted. A Telegram WebView closes immediately instead of showing the confirmation.
token	string	—	Authentication token for results submission. When absent (along with callback_url), the assessment runs in debug mode and displays results on-screen instead of submitting them.
webcam	string	—	Set to 1 or true to enable optional camera recording. Participants see a consent prompt; if they accept, the front camera records and the video is saved locally to their device at session end.
webgazer	string	—	Set to 1 or true to enable browser-based eye tracking via WebGazer.js. Participants see a consent prompt, then a 5-point gaze calibration. Gaze coordinates are recorded throughout the task and exported as a CSV file at session end. Can be combined with webcam=1.

Assessment parameters

Parameters marked URL can be set as URL query parameters; the rest are fixed deployment defaults.

Parameter	Type	Default	URL	Description
number_of_pairs	number	6	✅	Number of face-name-occupation triplets to learn
number_of_distractors	number	2	✅	Number of wrong options in inference/recognition phases
learning_duration_ms	number	5000	✅	Display duration per item in learning phase (ms)
delay_seconds	number	10	✅	Countdown delay between inference and recognition (s)
show_tutorial	boolean	true	✅	Show instruction screens before each phase
grayscale_faces	boolean	true	✅	Display face images in grayscale to reduce skin tone bias
face_image_pool	string	[]	—	JSON array of {id, dataUrl} objects for face images (set by index.js after pre-fetch)
show_trials_complete_scene	boolean	false (site override; package default true)	—	Show completion screen at end

---

Generated from assessments/fname/fname.js and assessments/fname/index.js. Do not edit by hand.