v1.2.0: Wug

Experiment runner version (change on Lookit to use this release)

2aa08ee6132cd6351eed58abc2253368c14ad184

Changes in this release

• Frame documentation is now at https://lookit.github.io/lookit-frameplayer-docs/modules/frames.html . Links have been updated in the docs and wiki, but if you have this bookmarked you'll want to update it.

• Introduces several new frames:

  • exp-lookit-video - new more general frame replacing the old exp-lookit-video, which
    can still be used but is called exp-lookit-composite-video-trial
  • exp-lookit-calibration - for getting video of a child looking to several locations on
    the screen to calibrate for looking measures
  • exp-lookit-change-detection - for alternation paradigms, where two streams of images
    are displayed
  • exp-lookit-images-audio - general frame for showing images and playing audio, including
    for forced-choice trials
  • exp-lookit-start-recording - utility frame to start session recording
  • exp-lookit-stop-recording - utility frame to stop session recording
  • exp-looking-webcam-display - utility frame to display the participant's webcam (e.g.
    to give a break and let them re-check setup)

• Configuration frame exp-video-config now asks participants to try reloading the webcam,
  to avoid some recent problems in Firefox with permissions not being saved

• Consent frame now has participants review their video to ensure everything worked (they
  can re-record if not). An additional_segments parameter can be passed to add additional
  sections if required by your IRB and approved by Lookit. You have the option to add a
  section prompting all adults present to consent, in case your IRB is concerned about
  use of video with non-consented family members in the background. A new template consent_003
  has a combined "Benefits, risks, and payment" section instead of separating these.

• Session recording overrides individual-frame recording: if there is an active session
  recording in progress, no additional individual frame recording will be created. This avoids
  issues caused by accidentally creating overlapping session and individual-frame recordings.

• frameDuration is recorded on all frames as a convenience for checking how long the frame was
  without calculating it from event data.

• videoId and pipeId are recorded on events only when starting recording, not on every
  single event thereafter, to reduce file size of data downloads

• Other bugfixes and housekeeping:

  • MANY dependency updates for security and functionality improvements
  • Do a better job detecting when participant leaves fullscreen mode and making the
    "return to fullscreen" button visible
  • Leave fullscreen mode upon ctrl-X/F1

• The following frames are deprecated and will not be included in release 2.x.
  These are all bespoke frames for specific studies - if you use them, you can continue to
  use them, but won't be able to update past release 2.x without replacing them:

  exp-exit-survey
exp-lookit-dialogue-page
exp-lookit-geometry-alternation
exp-lookit-geometry-alternation-open
exp-lookit-preview-explanation
exp-lookit-story-page
exp-video-consent
exp-video-preview

Update guide

1. If you currently use an exp-lookit-video frame, change the kind of that frame in your
   study protocol to exp-lookit-composite-video-trial and it will continue to work as expected.

2. IF you currently use the videoId or pipeId fields in the event data you download, adapt
   your analysis workflow as follows:

• If using videoId: look for this field in the most recent setupVideoRecorder event
• If using pipeId: look for this field in the most recent startRecording event
• If using sessionVideoId: look for this field in the most recent setupSessionVideoRecorder event
• If using sessionPipeId: look for this field in the most recent startSessionRecording event