Media
It is a media playback component for audio and video. It uses HTML5 audio and video for browsers that support it and Flash/Silverlight fallbacks for browsers that don’t.
The Media component is one of the more complex components in Adapt, with some of the fields meaning changing depending on the settings in other fields. For a brief overview of the use cases in the Media component, review the Other Components section of the Thinking in Adapt guide.
Using the Select an Asset option will upload a video to the Adapt Authoring system and require that the video/audio be embedded with your course.
Uploading an MP4 or MP3 will quickly exhaust our storage. Do not use this option.
Help & How-to
This provides some guidance on the settings of the Media Component, but is primarily here for documenting the properties used in the component.
If you need a step-by-step guide to adding video or audio, take a look at the following help articles:
- Adding YouTube Video
- Adding Streaming Video
- Adding Audio
The Media component inherits all the settings common to the Presentation Components.
The source for the H.264 MP4 video. You must use the Select an external asset button and enter a URL from a 3rd party service. Note that this option will be ignored depending on other component settings.
In Vimeo, this would be the “Streaming URL.”
This field is to be used to link to an OGV video. This format was required by older Firefox browsers and can be safely ignored.
This field is to be used to link to an WEBM video. This format was required by older Google Chrome browsers and can be safely ignored.
The source for an MP3 audio file. You must use the Select an external asset button and enter a URL from a 3rd party service. Note that this option will be ignored depending on other component settings.
The “share” URL provided by either YouTube or Vimeo. If you add a URL to this field, the other media source fields will be ignored.
Use this field only if you are embedding a URL from a public YouTube or Vimeo video (not a streaming URL).
The type of video (YouTube or Vimeo) specified by the Source URL.
Use this field only if you are embedding a URL from a public YouTube or Vimeo video (not a streaming URL).
An image (typically uploaded to Adapt using Select an Asset) to appear in the video player before the video is loaded. This image must be the same size and aspect ratio as the video.
This section contains a list of the closed caption files in VTT format. Multiple files can be provided in this section but only one caption file per language will be available to the learner.
When you click the Add button, a dialog will slide-out from the right side of the screen allowing you to populate the details of the caption file. The fields in this dialog are:
The language of the closed captions (e.g., en for English). Other acceptable values.
A closed captions .vtt file. This can be safely uploaded to Adapt.
This determines when Adapt will register this component as having been completed by the user. Options are:
| Setting | Description |
|---|---|
| inview | Marks the media component complete when the component is fully displayed within the viewport. |
| play | Marks the media component complete when playback is initiated. |
| ended | Marks the media component complete when the video has reached the end of playback. Note that this option may not function correctly on all browsers. |
Enables use of Closed Captions. The video will require that there is at least one Closed Captions entry.
If using closed captions with multiple languages, use this property to specify which language should be shown by default. The value of this property must match one of the Language Code values.
Will attempt to display a volume control in the control bar of the video. Not supported on all mobile devices.
Will attempt to set the default volume for the video. Required, but not supported on all mobile devices.
Adds the Full Screen button to the video.
Pauses playback if the user scrolls the window while the video is playing.
By default, iPhones will not play videos in the course, instead opening up the default video playback app. Checking this option will play the video in the course on iPhones that support it.
The video player will attempt to prevent the learner from skipping using the duration bar. Does not work with all browsers/platforms.
With this option selected, viewing the transcript will trigger a completion for the Media component.
This option should always be checked; Users with disabilities will need to read the text transcript rather than view the video.
If this option is selected, Adapt will place a button below the video that will toggle viewing a text transcript inline below the video.
If this option is checked Inline Open Button, Inline Close Button, and Inline Transcript are required.
If this option is selected, Adapt will place a button below the video that will download a text transcript and Link Open Button and Transcript Link are required.
The label for the button used to show the transcript. There is no default value and is required if an Inline Transcript is used.
The label for the button used to hide the transcript. There is no default value and is required if an Inline Transcript is used.
The text of the transcript used for the inline transcript.
If the transcript is long, it is preferable to use a downloadable transcript. Long inline transcripts can make it difficult for users attempting to read the transcript along with the video.
The label for the button used to download the transcript. There is no default value and is required if Show Link is used.
The text file to download. As with most fields in Adapt, this should be to a file uploaded to Adapt rather than using an external asset. This file should be a *.txt file and be encoded to work on both OSX and Windows.
Developer Only: This option sets a custom configuration for the video file and can discard some of the options above. Do not alter this block in any way, as improperly formatted JSON can break the video or entire Adapt course.