v3.2.0

New option

• add omit_injury_phrase (default false) to exp-lookit-video-consent template 5

Minor fixes

• adjust Italian translation of consent template 5 language when private_level_only is true
• docs fix in conditional_logic.rst

v3.1.0

Changes to consent templates (important!)

• Reference "Lookit staff" in consent templates rather than hard-coding Kim's name into templates
• Indicate participants can view past recordings at any time on Lookit, but remove "by going to "Studies" -> "Your past studies" due to planned UI improvements that will make this section easier to find

Change to exp-lookit-exit-survey frame

• Prompt participants more explicitly for feedback at end of study ("How did it go? Do you have any suggestions for improving the study?" instead of "Your feedback:"

New frame

• Added frame exp-lookit-survey-consent for ManyBabies-AtHome project which requires a checkbox/multiple-choice consent frame rather than video consent.

New customization options

• Add fullscreenPausedText parameter to pause-unpause mixin to allow custom text when paused due to leaving FS mode
• Add showCursor parameter (default true) to exp-lookit-images-audio
• Add options to restrict privacy level to 'Private' on exp-lookit-video-consent and exp-lookit-exit-survey frames

Minor fixes

• Fix Dutch translation of withdrawal confirmation language
• Dependency updates for security (handlebars, underscore, lodash, hosted-git-info, ws)
• Make it clearer that button in exp-video-config step 2 is a button by formatting differently from audio/video indicators

v3.0.0

Backwards-incompatible change:

• On infant-controlled frames (exp-lookit-video-infant-control, exp-lookit-images-audio-infant-control), the lookawayTone now needs to be either (a) a list of source/type objects saying where to find an audio file parameter is or (b) a string relative to the baseDir. This lets you use custom audio for the lookawayTone, but you will need to make the following changes:

  • If using lookawayTone 'none', change to ''.
  • If using lookawayTone 'noise' or 'tone', either copy those files from https://www.mit.edu/~kimscott/placeholderstimuli/ to your own hosting location (baseDir) OR set lookawayTone to [{"src": "https://www.mit.edu/~kimscott/placeholderstimuli/mp3/noise.mp3", "type": "audio/mp3"}] (similarly for 'tone').

Minor changes

• Bring up exit dialogue upon pressing Esc rather than just F1/ctrl-X (you can now instruct parents to press Escape to exit the study early, which is probably more intuitive than F1)
• Dependency updates for security
• Add Dutch translations of frame text (you can now set language: 'nl' on any frame)
• exp-lookit-stimuli-preview: Add requirePreview option; if set to true then the participant doesn't have the option to skip the preview
• exp-lookit-instruction-video: Center images in transcript of and allow to be at most 75% of transcript width
• Add integration test for one frame as an example

Bug fixes

• Bugfix: camera couldn't be set up on a frame immediately following a video-assent frame that was skipped due to the child's age
• Bugfix: pop_random example function now actually returns a random element (+ tests)

Fix for #226: occasional missing frames in sequence/expData

Bug fix:

• Fixes #226, occasional missing frames in recorded sequence and expData following short-duration frames.

Frame changes:

• Adds 'controls' parameter to exp-lookit-video frame to optionally display controls to participant, to allow pausing/restarting in place.

Fix for "procedures" text not displaying on consent template 5 in 2.3.0

Fixes bug introduced in 2.3.0 where "procedures" text is not displayed in consent template 5

Minor fixes and improvements

Throughout codebase:

• Upgrade from node 8 -> 10
• Prepare for translation of frames using ember-intl; labs that want to test in a language other than English can now provide Lookit with a translation file based on translations/en_us.yaml, then specify the language using a "language" parameter on the first frame.
• Minor fixes to docs
• Remove extra orange box explaining options when the participant tries closing the window to avoid confusion when it disappears - just put directions in the "exit" box.

Specific frame updates and fixes:

• pause-unpause mixin, video-record mixing: Bugfix: Stop audio from pauseVideo and waitForUploadVideo when they're not being displayed (#217)
• infant-controlled-timing mixin: Show optional visual indicator of whether child is looking (showLookawayVisualGuide parameter); allow delaying measurement period relative to stimulus onset (measurementPeriodDelay parameter) (#143)
• exp-lookit-change-detection: Allow use of videos rather than images and allow stream-specific timings (#183)
• exp-lookit-exit-survey: add showDatabraryOptions option that allows removing the Databrary question if ABSOLUTELY forbidden by your IRB
• exp-lookit-images-audio: Pre-load images before displaying any (#206)
• exp-lookit-start-recording: Allow customization of message shown (waitForVideoMessage parameter) (#214)
• exp-lookit-stop-recording: Allow customization of message shown and whether progress bar is shown (showProgressBar and waitForUploadMessage parameters) (#214)
• exp-video-config:
  • Relabel the "refresh webcam" button on exp-video-config so people are less likely to refresh the page or press the refresh button under the webcam view instead (#207)
  • Store screen resolution (screenHeight and screenWidth) (#210)
• exp-lookit-video-consent:
  • add custom alternate headers for most sections and allow providing a summary statement to be displayed at the start (template 5 only, #211)
  • add prompt_only_adults option to collect consent for only the adult (template 5 only, #218)

Bugfix: Fix for consent videos occasionally not being marked as consent

Marks consent videos as consent footage immediately upon recording; fixes lookit/lookit-api#598

Also includes minor dependency updates.

Bugfix: Fix for consent videos occasionally not being marked as consent

Marks consent videos as consent footage immediately upon recording; fixes lookit/lookit-api#598

Bugfix: stimulus placement on full-screen frames

• Fixes bug introduced in v2.2.0 where placement of images/videos was incorrect (shifted down) on full-screen frames (exp-lookit-images-audio, exp-lookit-calibration, exp-lookit-video, exp-lookit-change-detection).

• exp-lookit-exit-survey: Allow specifying debriefing text using exp-text-block syntax rather than one big string

Allow pausing on all test trial frames and save data when navigating back and forth

There are two main changes in this release:

1. All test trial frames support pausing/unpausing

The pause-unpause mixin is now used in frames exp-lookit-calibration, exp-lookit-change-detection, exp-lookit-images-audio, exp-lookit-video, and infant-control versions. This allows you to specify a key the user can press to pause the frame, and to specify what frame they should go to upon resuming; see docs. Changes by frame:

exp-lookit-calibration: Pausing is enabled as described in pause-unpause docs. This can be disabled if desired by setting allowUserPause and pauseWhenExitingFullscreen to false.

exp-lookit-change-detection: Pausing is enabled as described in pause-unpause docs throughout the frame, not only during the announcement phase. There is no separate fsAudio played when pausing happens due to leaving fullscreen mode.

exp-lookit-images-audio and exp-lookit-images-audio-infant-control: Pausing is enabled as described in pause-unpause docs. This can be disabled if desired by setting allowUserPause to false.

exp-lookit-video and exp-lookit-video-infant-control: Pausing was already possible in this frame, but now it is more flexible. There are several minor changes in pausing behavior and how you specify it:

• You now provide pausedText and pausingText which are the entire text to show when paused/pausing, rather than pauseText which was displayed under "Study paused" and in addition to "Press [key] to resume." You will need to supply text like "Study paused \n Press X to resume" if you are using a non-default pauseKey.

• Recording stops upon pausing the study, and a new recording will begin when/if the participant repeats the frame.

• There is no hasBeenPaused data stored about this frame. Instead, pauseStudy and resumeStudy events are stored.

• Instead of just setting restartAfterPause, you have more flexibility to specify the frameOffsetAfterPause (documented here). If you had previously set restartAfterPause to true, nothing will change. If you had set restartAfterPause to false, the study will proceed to the next frame (in order) upon resuming after pausing, ignoring any selectNextFrame function. (This does not change how any studies currently on Lookit will function!)

2. Storage of data when the participant navigates back and forth

Previously, if the participant navigated using "previous" buttons or was sent back to a previous frame via selectNextFrame, the data collected on the last repeat of the frame would replace prior data. Now, repeated experiences of the same frame are denoted with -repeat-N frame IDs, as described here.

Miscellaneous other changes:

exp-lookit-exit-survey

• Added a "additionalVideoPrivacyText" parameter for cases where researchers want to provide additional context about privacy options.