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 server side stream

MPEG-DASH live example

<script src="https://cdn.radiantmediatechs.com/rmp/10.1.4/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,
    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');

  // Initialization ... and done!
  async function initRmpPlayer() {
    try {
      await rmp.init(settings);
    } catch(error) {
      console.error('Radiant Media Player failed to initialize', error);
    }
  }
  initRmpPlayer();

</script>

HLS live example

<script src="https://cdn.radiantmediatechs.com/rmp/10.1.4/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>

  // HLS AWS MediaTailor live stream
  const src = {
    hls: 'https://your-hls-aws-mediatailor-stream.m3u8'
  };
  const settings = {
    licenseKey: 'your-license-key',
    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');

  // Initialization ... and done!
  async function initRmpPlayer() {
    try {
      await rmp.init(settings);
    } catch(error) {
      console.error('Radiant Media Player failed to initialize', error);
    }
  }
  initRmpPlayer();

</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/10.1.4/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>

  // HLS AWS MediaTailor live stream with overlay ad insertions
  const src = {
    hls: 'https://your-hls-aws-mediatailor-stream.m3u8'
  };
  const settings = {
    licenseKey: 'your-license-key',
    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');

  // Initialization ... and done!
  async function initRmpPlayer() {
    try {
      await rmp.init(settings);
    } catch(error) {
      console.error('Radiant Media Player failed to initialize', error);
    }
  }
  initRmpPlayer();

</script>

Requesting a client side stream

MPEG-DASH on-demand example

<script src="https://cdn.radiantmediatechs.com/rmp/10.1.4/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,
    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');

  // Initialization ... and done!
  async function initRmpPlayer() {
    try {
      await rmp.init(settings);
    } catch(error) {
      console.error('Radiant Media Player failed to initialize', error);
    }
  }
  initRmpPlayer();

</script>

Player settings

shakaAWSMediaTailorTrackingUrl: String

Adds a custom tracking URL for ads delivered with AWS Media Tailor. Default: ''.

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
  • adprogress
  • adbuffering
  • 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-2025 Radiant Media Player. All Rights Reserved.