Defining Content Replacement slots

🚧

REDONDANT AVEC "HANDLING CONTENT REPLACEMENT SLOT". A SUPPRIMER

A time slot is defined by a MediaPoint (specific point of interest in the media) and a duration.

When creating a Content Replacement service through the web app, you can create a single slot for demo or testing.
This time slot is optional and cannot be viewed or edited afterwards as it is mainly for demonstration and testing.

Time slots should generally be created through the time slot management API (see API section).

Here are sample API calls that you can make through the ESNI SCTE 224 API to create:

a one-minute slot on August 18, 2021 at 4.00 p.m. UTC for all users (i.e. unconditional) with the default live source as replacement content:

<Media href="YourServiceName">
  <MediaPoint id="YourMediaPointName" matchTime="2021-08-18T16:00:00Z" expectedDuration="PT0H1M">
    <Apply>
      <Policy id="1">
        <ViewingPolicy id="1">
          <action:Content>urn:scte:224:action:blackout</action:Content>
        </ViewingPolicy>
      </Policy>
    </Apply>
  </MediaPoint>
</Media>

a one-minute slot on August 18, 2021 at 4.00 p.m. UTC for Audience "area 1" defined as list of zips 25267, 26311 and 20984, with ESPN_Alt_1 live source as replacement content:

<Media href="YourServiceName">
    <MediaPoint id="YourMediaPointName" matchTime="2021-08-18T16:00:00Z" expectedDuration="PT0H1M">
        <Apply>
            <Policy id="1">
                <ViewingPolicy id="1">
                   <Audience id="area 1">
                        <audience:zip>25267</audience:zip>
                        <audience:zip>26311</audience:zip>
                        <audience:zip>20984</audience:zip>                     
                    </Audience>
                    <action:Content>ESPN_Alt_1</action:Content>
                </ViewingPolicy>
            </Policy>
        </Apply>
    </MediaPoint>
</Media>

Once provisioned, you can check the metadata for:

  • The slot associated with the Mediapoint by sending a GET request for this specific MediaPoint Id
  • All slots associated with a specific Content Replacement service by sending this GET request /!\

📘

Notes

  • The Policy Id can be provisioned but is not used. A GET call will return /policy/unknown
  • The Viewing Policy Id can be provisioned but is not used. A GET call will return /vp/unknown