Customer Sign In

upLynk

Boundaries: Setup and Playback

Setting Up Boundaries

Note: The functionality described in this article requires Live Slicer version 16031400 or higher.

Adhere to these rules when setting up a boundary:

  • The start and end of a boundary must be defined via the boundary method in the Live Slicer API.
  • Any type of boundary (e.g., c3, c7, or halftime) may be defined when creating a boundary.
  • Boundaries cannot overlap.
    • Make sure to mark the end of the previous boundary before starting a new one.
  • A boundary cannot overlap with a pod break.
    • Make sure to mark the end of a pod before starting a boundary.
    • Make sure to mark the end of a boundary before starting a pod.
  • A boundary cannot span multiple assets.
    • Make sure to mark the end of a boundary before the end of an asset.

Playback

The boundary type dynamically defines a segment within a live stream into which ads or slate may be inserted. The manner in which this segment is handled by a media player varies according to whether the viewer is playing back a live stream or on-demand content.

For example, a c3 boundary may be used to identify an ad break within a live stream. Live stream playback and the asset created from this live event will include the commericals in that ad break. However, on-demand playback may either include the ads from the original airing, replace them with new ads, or skip them.

Live Streaming

The manner in which a boundary is handled when viewing a live stream is determined through the boundary.<boundary_name> parameter (e.g., boundary.c3). Valid values for this parameter are described below.

ValueDescription
ignore_as_contentDefault. The content within the boundary will be played normally and treated as standard content.
ignore_as_adThe content within the boundary will be played normally and treated as an advertisement.
replace_as_adThe content within the boundary will be replaced by dynamic advertisement(s) provided that the playback request includes the ad parameter (e.g., &ad=myadcampaign).
skipThe content within the boundary will be replaced with slate.

Example:

URL: http://content.uplynk.com/<asset_id>.m3u8?ad=<ad_config>&boundary.c3=replace_as_ad

On-Demand Streaming

All boundaries defined within a live stream will be retained by the asset created from the live stream. The manner in which a boundary is handled when viewing on-demand content containing boundaries is determined through the boundary.<boundary_name> parameter (e.g., boundary.c3). Valid values for this parameter are described below.

ValueDescription
ignore_as_contentDefault. The content within the boundary will be played normally and treated as standard content.
ignore_as_adThe content within the boundary will be played normally and treated as an advertisement.
replace_as_adThe content within the boundary will be replaced by dynamic advertisement(s) provided that the playback request includes the ad parameter (e.g., &ad=myadcampaign).
skipThe segment defined by the boundary will be omitted. In other words, the viewing experience will be seamless between the slices that occur right before and after the boundary.

Example:

URL: http://content.uplynk.com/<asset_id>.m3u8?ad=<ad_config>&boundary.c3=skip

Use Cases

The use cases described in this section assume:

  • A sporting event was streamed as a live event.
  • Several boundaries of varying types were added as the live stream was sliced. These boundaries are defined below.
Start Time - End TimeBoundary Type (Live Slicer API)Type of Content
0:00 - 12:00No BoundaryLive sporting event
12:00 - 13:00c3An ad that is relevant for up to 3 days after the original airing.
13:00 - 25:00No BoundaryLive sporting event
25:00 - 27:30c7An ad that is relevant for up to 7 days after the original airing.
27:30 - 35:00No BoundaryLive sporting event
35:00 - 45:00halftimeIdentifies special content.
45:00 - 52:00No BoundaryLive sporting event
52:00 - 53:30c7An ad that is relevant for up to 7 days after the original airing.
53:30 - 60:00No BoundaryLive sporting event
60:00 - 62:00c3An ad that is relevant for up to 3 days after the original airing.
62:00 - 75:00No BoundaryLive sporting event

On-Demand Streaming - Ad Replacement (c3)

In this scenario, on-demand playback takes place 5 days after the live stream. The following playback URL will:

  • Replace all of the c3 boundaries with dynamic advertisements.
  • Allow the playback of the original c7 boundaries as advertisements.
  • Skip the halftime boundary.
URL: http://content.uplynk.com/<asset_id>.m3u8?boundary.c3=replace_as_ad&boundary.c7=ignore_as_ad&boundary.halftime=skip
Start Time - End TimeBoundary Type (Live Slicer API)Playback
0:00 - 12:00No BoundaryOriginal sporting event
12:00 - 13:00c3Dynamic advertisement (length may vary)
13:00 - 25:00No BoundaryOriginal sporting event
25:00 - 27:30c7Original advertisement
27:30 - 42:00No BoundaryOriginal sporting event; The content defined by the halftime boundary was skipped.
42:00 - 43:30c7Original advertisement
43:30 - 50:00No BoundaryOriginal sporting event
50:00 - 52:00c3Dynamic advertisement (length may vary)
52:00 - 65:00No BoundaryOriginal sporting event

On-Demand Streaming - Ad Replacement (c7)

In this scenario, on-demand playback takes place 8 days after the live stream. The following playback URLs will:

  • Skip all of the c3 boundaries.
  • Replace the c7 boundaries with dynamic ads.
  • Include the content defined in the halftime boundary and treat it as standard content.
URL: http://content.uplynk.com/<asset_id>.m3u8?boundary.c3=skip&boundary.c7=replace_as_ad&boundary.halftime=ignore_as_content

The following playback URL is also valid since ignore_as_content is set by default.

URL: http://content.uplynk.com/<asset_id>.m3u8?boundary.c3=skip&boundary.c7=replace_as_ad
Start Time - End TimeBoundary Name (given to the slice API)Playback During On-Demand Streaming
0:00 - 24:00No BoundaryOriginal sporting event; The content defined by the c3 boundary was skipped.
24:00 - 26:30c7Dynamic advertisement (length may vary)
26:30 - 34:00No BoundaryOriginal sporting event
34:00 - 44:00halftimeOriginal special content
44:00 - 51:00No BoundaryOriginal sporting event
51:00 - 52:30c7Dynamic advertisement (length may vary)
52:30 - 72:00No BoundaryOriginal sporting event; The content defined by the c3 boundary was skipped.