Documentation

AWS Elemental MediaTailor Integration

Scope of support

AWS Elemental MediaTailor is a channel assembly and personalized ad-insertion service for video providers to create linear over-the-top (OTT) channels using existing video content. The service then lets you monetize those channels—or other live streams—with personalized advertising.

We support AWS Elemental MediaTailor out of the box with Radiant Media Player with HLS or MPEG-DASH streaming for live or on-demand video delivery.

We support Client Side, Server Side and overlays ad insertion.

Requesting a client side stream

MPEG-DASH on-demand example

<script src="https://cdn.radiantmediatechs.com/rmp/9.15.3/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>
  // MPEG-DASH AWS MediaTailor stream
  const src = {
    dash: 'https://your-mpeg-dash-aws-mediatailor-stream.mpd'
  };
  const settings = {
    licenseKey: 'your-license-key',
    src: src,
    width: 640,
    height: 360,
    autoplay: true,
    // Enable AWS MediaTailor stream support in Radiant Media Player
    shakaAWSMediaTailor: true,
    // MediaTailor Ads Params
    shakaAWSMediaTailorAdsParam: {
      assetid: 'test2',
      podduration: '15'
    },
    contentMetadata: {
      poster: [
        'https://www.radiantmediaplayer.com/images/poster-rmp-demo.jpg'
      ]
    }
  };
  const rmp = new RadiantMP('rmp');
  rmp.init(settings);
</script>

Requesting a server side stream

MPEG-DASH live example

<script src="https://cdn.radiantmediatechs.com/rmp/9.15.3/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>
  // MPEG-DASH AWS MediaTailor live stream
  const src = {
    dash: 'https://your-mpeg-dash-aws-mediatailor-stream.mpd'
  };
  const settings = {
    licenseKey: 'your-license-key',
    src: src,
    width: 640,
    height: 360,
    autoplay: true,
    // Enable AWS MediaTailor stream support in Radiant Media Player
    shakaAWSMediaTailor: true,
    contentMetadata: {
      poster: [
        'https://www.radiantmediaplayer.com/images/poster-rmp-demo.jpg'
      ]
    }
  };
  const rmp = new RadiantMP('rmp');
  rmp.init(settings);
</script>

HLS live example

<script src="https://cdn.radiantmediatechs.com/rmp/9.15.3/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>
  // HLS AWS MediaTailor live stream
  const src = {
    dash: 'https://your-hls-aws-mediatailor-stream.mpd'
  };
  const settings = {
    licenseKey: 'your-license-key',
    src: src,
    width: 640,
    height: 360,
    autoplay: true,
    // Enable AWS MediaTailor stream support in Radiant Media Player
    shakaAWSMediaTailor: true,
    hlsEngine: 'shakaplayer',
    contentMetadata: {
      poster: [
        'https://www.radiantmediaplayer.com/images/poster-rmp-demo.jpg'
      ]
    }
  };
  const rmp = new RadiantMP('rmp');
  rmp.init(settings);
</script>

HLS live example with overlay ad insertions

This is the same as for requesting a server side stream, the player will automatically detect non-linear creatives when inserted.

<script src="https://cdn.radiantmediatechs.com/rmp/9.15.3/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>
  // HLS AWS MediaTailor live stream with overlay ad insertions
  const src = {
    dash: 'https://your-hls-aws-mediatailor-stream.mpd'
  };
  const settings = {
    licenseKey: 'your-license-key',
    src: src,
    width: 640,
    height: 360,
    autoplay: true,
    // Enable AWS MediaTailor stream support in Radiant Media Player
    shakaAWSMediaTailor: true,
    hlsEngine: 'shakaplayer',
    contentMetadata: {
      poster: [
        'https://www.radiantmediaplayer.com/images/poster-rmp-demo.jpg'
      ]
    }
  };
  const rmp = new RadiantMP('rmp');
  rmp.init(settings);
</script>

Player ad-related events

The following ad-related player events are available when using a AWS MediaTailor stream. Other player API methods and events should work as expected.

  • adbreakready
  • adloaded
  • adimpression
  • adstarted
  • addurationchange
  • adfirstquartile
  • admidpoint
  • adthirdquartile
  • adcomplete
  • adstopped
  • adclick
  • aduserclose
  • aderror
  • adpaused
  • adresumed
  • adclick
  • advolumemuted
  • advolumechanged
  • adskipped
  • adskippablestatechanged
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.

©2015-2024 Radiant Media Player. All Rights Reserved.