Instance Property

schedule

Upcoming ad breaks, sorted by schedule time ascending.

var schedule: [AdBreak] { get }

Discussion

Returns a snapshot at the time of access; the schedule evolves as playback progresses.

Schedule Contents

Includes ad breaks with a resolved schedule time that have not yet started, including breaks queued for playback behind another break.
Excludes the currently-playing ad break.
Excludes ad breaks that have finished or been discarded. Re-playable ad breaks (for example, HLS interstitials without CUE="ONCE") are excluded after playback but re-enter the schedule if playback seeks back past their position.

Sorting

Ad breaks are sorted by schedule time ascending. Ad breaks sharing the same schedule time are not merged; scheduling order (insertion order) is used as a tie-breaker.

Structural Limitations

VMAP is partially supported: the VMAP ad item appears as a single entry at its initial schedule time, but its individual ad breaks are not expanded into separate entries and their metadata may be incomplete.

Timing Limitations

This property may be empty immediately after SourceLoadedEvent for:

Post-roll ad breaks: content duration may not yet be resolved at SourceLoadedEvent time.
HLS interstitial ad breaks: interstitial metadata is parsed asynchronously.

Use AdScheduleChangedEvent for reliable schedule observation in these cases.

Note
Ads scheduled via schedule(adItem:) are cleared when loading a new source; ads from AdvertisingConfig persist in the schedule across source changes.