TVSDK provides API elements that are useful when implementing blackouts, including methods, metadata, and notifications.
You can use the following when implementing a blackout solution in your player.
registerCurrentItemAsBackgroundItem Saves the currently loaded resource as the background resource. If
replaceCurrentResource is called after this method, TVSDK continues to download the background item’s manifest until you call
unregisterCurrentBackgroundItem Clears the currently set background resource and stops fetching and parsing the background manifest.
BlackoutMetadata A Metadata type that is specific to blackouts.
This allows you to set nonseekable ranges (an additional
TimeRange attribute called
nonseekableRange) on TVSDK. TVSDK checks for these ranges (whether the desired seek position falls within a
nonseekableRange) every time the user seeks. If it is set and the user seeks into a nonseekable range, TVSDK forces the viewer to the end time of the
START HERE NEXT DefaultMetadataKeys Enable or disable preroll on a live stream by setting
ENABLE_LIVE_PREROLL to true or false. If false, TVSDK does not make an explicit ad server call for pre-roll ads before the content playback and so does not play the pre-roll. This has no impact on the mid-rolls. The default is true.
TIMED_METADATA_IN_BACKGROUND_AVAILABLEevent subtype - Dispatched when TVSDK detects a subscribed tag in the background manifest.
SeekEvent.SEEK_POSITION_ADJUSTED Dispatched when a seek is attempted in a nonseekable range.