Volume navigation
The AdBreak element
ElementOn this page
Position
A single ad break: timeOffset decides when it fires, breakType decides which ad types it accepts; breakId and repeatAfter are optional.
- Spec section
- §2.3.1
- Parent
- VMAP
- Cardinality
- 0..n
- Children
- AdSource? · TrackingEvents? · Extensions?
Attributes and values
| Attribute | Type | Required | Values | Notes |
|---|---|---|---|---|
| timeOffset | string | Yes | hh:mm:ss[.mmm] | n% | start | end | #m | Break timing, one of four notations; a response may mix notations but position (#m) may then be ignored; two breaks may share an offset (the common linear-then-nonlinear pattern) |
| breakType | string | Yes | linear | nonlinear | display（逗号分隔、无空格，可多值） | Ad types the break accepts, a hint to the player; display maps to VAST companion ads; with multiple values the first is preferred |
| breakId | string | No | — | Optional string identifier for the break |
| repeatAfter | string | No | hh:mm:ss | HH:MM:SS.mmm | Repeat the same break (same AdSource) at intervals equal to this duration; on overlap the earlier-scheduled break wins and the overlapping one is ignored; if the AdSource is a Wrapper, the ads played per repetition may differ |
Children and structure
- AdSource0..1The break's ad source, see the adsource chapter
- TrackingEvents0..1Break-level tracking URI container, see the tracking chapter
- Extensions0..1Extensions container, see the extensions chapter
XML snippet
<AdBreak breakType="linear,nonlinear" breakId="mid1" timeOffset="00:10:23.125"> … </AdBreak>
Player behaviour
- 1The player expects the ad types named by breakType and may ignore any others
- 2The player should execute the break as close to the specified time as its capabilities allow; linear breaks may pause content at their start for precise timing
Invalid forms
- Missing timeOffset or breakType (schema-required)
- A space after the comma in a multi-valued breakType
- Relying on #m positional semantics while mixing offset notations