Show:

Exp-lookit-instruction-video Class

These docs have moved here.

A frame to display video instructions to the user.

A video is displayed to the left, and a transcript or summary in a scrolling box to the right. (The transcript can be omitted if desired, but in that case you must provide complete captioning for the video!)

The participant is required to either scroll to the bottom of the transcript or watch the video to proceed.

Each element of the 'transcriptBlocks' parameter is rendered using Exp-text-block.

"frames": {
    "intro-video": {
       "kind": "exp-lookit-instruction-video",
       "instructionsVideo": [
           {
               "src": "https://raw.github.com/UCDOakeslab/Baby_MR_Lookit/master/Lookit Introduction Part 1_Edited.mp4",
               "type": "video/mp4"
           }
       ],
       "introText": "Welcome to the study! Please watch this video to get started. \n(Or you can read the summary to the right if you prefer.)",
       "transcriptTitle": "Video summary",
       "transcriptBlocks": [
           {
               "title": "Background information about the study",
               "listblocks": [
                   {
                       "text": "Your baby does not need to be with you at this point in the study. We will let you know when it is time to get your baby."
                   },
                   {
                       "text": "Mental rotation, or the ability to manipulate internal representations of objects, is an important spatial ability. Spatial abilities are important for understanding objects, reading maps, mathematical reasoning, and navigating the world. Thus, the development of mental rotation is an important milestone. In the current study, we are interested in examining whether babies in general can mentally rotate simple objects."
                   }
               ]
           },
           {
               "title": "Preview of what your baby will see"
           },
           {
               "listblocks": [
                   {
                       "text": "Your baby will be shown two identical Tetris shapes on the screen; one on the left and one on the right. The shapes appear and disappear, changing their orientation each time they reappear. On one side, the rotation will always be possible. Sometimes, on the other side, a mirror image of the shape will be presented. If babies can mentally rotate objects, they should spend different amounts of time watching these two kinds of stimuli."
                   }
               ]
           },
           {
               "title": "What's next?",
               "listblocks": [
                   {
                       "text": "Because this is an online study, we will check to make sure that your webcam is set up and working properly on the next page, so we can record your baby’s looking behavior during the study."
                   },
                   {
                       "text": "Following that page, you will be given an opportunity to review the consent information and we will ask that you record a short video of yourself giving consent to participate in this study."
                   },
                   {
                       "text": "We will then ask you questions about your baby's motor abilities."
                   },
                   {
                       "text": "After you are finished with the consent page and questions, you will be provided with more detailed information about what to do during the study and how to get started."
                   }
               ]
           }
       ],
       "warningText": "Please watch the video or read the transcript before proceeding.",
       "nextButtonText": "Next",
       "title": "Study instructions",
       "showPreviousButton": false
   }
}

Properties

assetsToExpand

String private

Inherited from Expand-assets (click for formatted description): app/mixins/expand-assets.js:98

Object describing which properties may need expansion

audioTypes

String[]

Inherited from Expand-assets (click for formatted description): app/mixins/expand-assets.js:126

List of audio types to expect for any audio specified just with a string rather than with a list of src/type objects. If audioTypes is ['typeA', 'typeB'] and an audio source is given as intro, the audio source will be expanded out to [ { src: 'baseDir' + 'typeA/intro.typeA', type: 'audio/typeA' }, { src: 'baseDir' + 'typeB/intro.typeB', type: 'audio/typeB' } ]

Default: ['mp3', 'ogg']

baseDir

String

Inherited from Expand-assets (click for formatted description): app/mixins/expand-assets.js:106

Base directory for where to find stimuli. Any image src values that are not full paths will be expanded by prefixing with baseDir + img/. Any audio/video src values provided as strings rather than objects with src and type will be expanded out to baseDir/avtype/[stub].avtype, where the potential avtypes are given by audioTypes and videoTypes. baseDir should include a trailing slash (e.g., http://stimuli.org/myexperiment/); if a value is provided that does not end in a slash, one will be added.

Default: ''

instructionsVideo

Object

The location of the instructions video to play. This can be either an array of {'src': 'https://...', 'type': '...'} objects (e.g. providing both webm and mp4 versions at specified URLS) or a single string relative to baseDir//.

introText

String

Intro text to show at top of frame

Default: 'Welcome! Please watch this video to learn how the study will work. \n You can read through the information to the right if you prefer.'

nextButtonText

String

Text to display on the 'next frame' button

Default: 'Start the videos! \n (You\'ll have a moment to turn around.)'

showPreviousButton

Boolean

Whether to show a 'previous' button

Default: true

title

String

Title to show at top of frame

Default: 'Study instructions'

transcriptBlocks

Object[]

Array of blocks for Exp-text-block, providing a transcript of the video or an overview of what it said. A transcript can be broken down into bullet points to make it more readable.

If you've also provided closed captions throughout the video, you can use this space just to provide key points.

If this is left blank ([]) no transcript is displayed.

Sub-properties:

  • title String

    Title of this section

  • text String

    Paragraph text of this section

  • listblocks Object[]

    Object specifying bulleted points for this section. Each object is of the form: {text: 'text of bullet point', image: {src: 'url', alt: 'alt-text'}}. Images are optional.*

transcriptTitle

String

Title to show above video transcript/overview. Generally this should be either "Video transcript" or "Video summary" depending on whether you're providing a word-for-word transcript or a condensed summary. It may

Default: 'Video transcript'

videoTypes

String[]

Inherited from Expand-assets (click for formatted description): app/mixins/expand-assets.js:154

List of video types to expect for any audio specified just with a string rather than with a list of src/type objects. If videoTypes is ['typeA', 'typeB'] and a video source is given as intro, the video source will be expanded out to [ { src: 'baseDir' + 'typeA/intro.typeA', type: 'video/typeA' }, { src: 'baseDir' + 'typeB/intro.typeB', type: 'video/typeB' } ]

Default: ['mp4', 'webm']

warningText

String

Text to show above Next button if participant has not yet watched video or read transcript

Default: 'Please watch the video or read the transcript before proceeding.'