Skip to content

Video Scope Doc

Technical Specs

IMMUTABILITY RULES
12-column grid, same as messaging
Video must work at all breakpoints
Each video will take over its position width (based on ratio) with the adjacent column growing/shrinking
All video defaults will have video on left container
The nested and expansion is NOT (yet) included in XT
Accessible video through close captioning
Must include HLS support
Dark mode support

Flex XL

1-column
Full Bleed
2-column
1:1
7.5

Flex Frame

1-column
Full Bleed
3-column
16:9
2.2.2
1:1
1.2.3, 1.3.2, 2.1.3, 2.3.1, 3.1.2, 3.2.1

Autoplay Rules

Desktop/Mobile FFs autoplay by default. Can be turned off by AP.
Desktop/Mobile FXLs do not autoplay by default. Can be turned on by AP.
All mobile (mweb, iapp) video autoplays in interstitial position, regardless of AP choice.
Autoplay videos start only when 1% in view and autopauses when 99% out of view.
Autopauses when exiting.
No autoplay when in low power or blocked mode or explicitly set by the AP.

Audio Rules

Autoplay video rules:
Autoplay videos start in a muted state.
Unmute rules:
Unmuting a video must be user-initiated through either the audio or play buttons.
NOTE: The audio unmutes on a user-initiated play.
Automute rules:
When clicking out or scrolling to past 99%, video automutes.
When scrolling an autopaused video that resumes play, the video remains in a muted state.

HLS Rules

No HLS on autoplay
Need smooth transition from poster to play

Post Message Rule

Low Power Mode Rules

When in a low power state, autoplay rules are suspended. No autoplay.

Block Rules

When receiving a block pattern, autoplay rules are suspended. No autoplay.

Video Player

Must conform to design.
Must fill container, container size determined by ad param preset.
NEW: Must have progress bar at bottom. NO SCRUBBING.
Must include HLS support.
Three buttons:
play/pause
mute/unmute
close captioning
Video player attributes, events, and actions easily available via customJS.
Must include a poster.
On play, the content must fade out (logo exception applied). On pause or clickout

Accessibility

Accessible video through close captioning, .srt file location.
CC off by default
Second audio option for audio description (low priority).
Player must be tabbable, meaning you must be able to tab through the player.
Buttons must conform to high-contrast color spec’s. (see Shea)
Ensure that the player is ALT tagged.

Special Considerations

All mobile XL video should be 9:16 (1.78) ratio. (waiting on final confirmation)

Events

autoplay/autopause (think about resumeplay)
play/pause
mute/unmute
logo/messaging/cta
quartile- and time-based events
(event broadcaster)

BUILD

[%Autoplay%] should be VideoAutoplay
Sample single Image payload
m3u8 autoplay guard??
OLD MACROS
Presets (preset,ratio)
CustomMarkup
NEW MACROS
VideoSource:url
VideoAutoplay:boolean (true on ff | false on xl)
VideoCaption:url
VideoPoster:url
VideoDuration:number
VideoHideLogoOnPlay:boolean (false)
VideoHideCtaUntilPlay:boolean (false)
RECIPES
Change from object-fit:cover to object-fit:contain
Add new values to percent- and time-based tracking
Hide an element when playing/not playing
Change video player values from custom js
Format Names
[TemplateXT] Video FlexXL: Video (Desktop) – FXL Presets & False Autoplay
[TemplateXT] Video FlexXL: Video (Mobile) – FXL Presets & False Autoplay
[TemplateXT] Video FlexFrame: Video (Desktop) – FF Presets & True Autoplay
[TemplateXT] Video FlexFrame: Video (Mobile) – FF Presets & True Autoplay
Style Names
[TemplateXT] Video FlexXL: Video (Desktop)
[TemplateXT] Video FlexXL: Video (Desktop) (Dev)
[TemplateXT] Video FlexXL: Video (Mobile)
[TemplateXT] Video FlexXL: Video (Mobile) (Dev)
[TemplateXT] Video FlexFrame: Video (Desktop)
[TemplateXT] Video FlexFrame: Video (Desktop) (Dev)
[TemplateXT] Video FlexFrame: Video (Mobile)
[TemplateXT] Video FlexFrame: Video (Mobile) (Dev)

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.