Participant activities

Cognitive games

Collect task performance and game-specific records.

Reviewed
On this page

Available game screens

The module includes Jewels A, Jewels B, Cats and Dogs, Pop the Bubbles, and Balloon Risk. A study must connect a game entry point in its screen configuration to expose it to participants. Including the module does not put every game on the default home screen.

Example cognitive game screen from INSPIRE

Source: MD4BD presentation, September 17, 2026, page 14. This is an INSPIRE research-app example.

Performance records

Games construct their own duration, error, score, and detailed result fields. For example, Jewels A has a storage path for a JSON summary under jewelsA_summary. Check each game's implementation for time fields and scoring.

PathMeaning
Game UI completion handlerConstructs actual task results
ExternalMetricRepository familyAccepts external metrics and persists them to Room
external_metricsMetric name, time, value, source, and sync state

Distinguish the sample plugin

The steps/cog_steps path in CognitiveGamesPlugin generates date-based example data. Do not analyze it as a participant's actual steps or cognitive performance. Follow the game screen's completion and persistence path instead.

Before using a game

Verify opening, normal completion, early exit, repeated attempts on the same day, local persistence, and server synchronization in the study app. Clinical meaning and diagnostic accuracy of a score cannot be established from this code alone.

Documentation evidence

Working-tree baseline · source paths · HEAD 8213e6b7

  • plugins/cognitivegames/src/main/java/com/hdil/datacollection/cognitivegames/GameScreens.kt
  • plugins/cognitivegames/src/main/java/com/hdil/datacollection/cognitivegames/CognitiveGamesPlugin.kt
  • plugins/cognitivegames/src/main/java/com/hdil/datacollection/cognitivegames/jewels/JewelsAGame.kt
  • core/db/src/main/java/com/hdil/datacollection/db/entity/external/ExternalMetricEntity.kt
DTRAC AndroidYonsei University · Bongshin Lee’s research team