Social Sharing

Sharing module settings

Radiant Media Player provides flexible and customisable options to present social sharing of video content to your audience. This includes in-player sharing on Facebook, LinkedIn, X, Reddit, email or WhatsApp. It also features copying a shareable link or iframe code. The sharing module is in the top right corner of the player. When interacted with this module will show an overlay holding the selected sharing options.

sharing: Boolean

Activate or not the sharing module. When open the sharing module offers various options to share content. Default: false.

sharingUrl: String

Set the URL that should be shared through sharingNetworks and the "copy link" field when the sharing module is displayed. The player uses the page URL as default but this can be overwritten through this setting. Default: ''.

sharingNetworks: Array

Set which social networks to display when sharing module is open. Supported social networks are: Facebook, X, LinkedIn, Reddit & email. Example for all social networks: ['facebook', 'x', 'linkedin', 'reddit', 'email', 'whatsapp']. Default: ['facebook', 'x', 'email'].

sharingCode: String

Set the player code to be provided (iframe) for embedding purposes within the sharing module. It is up to you to generate and host the iframe player code as described here. Default: '' which means the code field is hidden in the sharing module.

Player code example

<script src="https://cdn.radiantmediatechs.com/rmp/10.1.4/js/rmp.min.js"></script>
<div id="rmp"></div>
<script>
  const src = {
    hls: 'https://your-hls-url.m3u8'
  };
  // Player settings
  const settings = {
    licenseKey: 'your-license-key',
    src,
    width: 640,
    height: 360,
    contentMetadata: {
      poster: [
        'https://your-poster-url.jpg'
      ]
    },
    // Our social sharing settings
    sharing: true,
    sharingUrl: 'https://www.radiantmediaplayer.com/docs/latest/social-sharing.html',
    sharingNetworks: ['facebook', 'reddit', 'linkedin'],
    sharingCode: '<iframe width="640" height="360" title="Demo video content" src="https://www.radiantmediaplayer.com/docs/latest/gist/iframe/iframe.html" style="border:none;" allowfullscreen allow="autoplay; fullscreen; picture-in-picture; xr-spatial-tracking; encrypted-media; clipboard-write"></iframe>'
  };
  const rmp = new RadiantMP('rmp');

  // Player initialisation
  async function initRmpPlayer() {
    try {
      await rmp.init(settings);  
      console.log('player ready');
    } catch (error) {
      console.error('Radiant Media Player failed to initialize', error);
    }
  }
  initRmpPlayer();

</script>

You can find an example of player with the sharing module enabled on our home page.

Sharing API

sharingData getter|setter (SharingData)

const sharingData = rmp.sharingData;

rmp.sharingData = { url: 'https://www.your-domain.com/content.html', code: '<iframe width="640" height="360" title="Video content" src="https://www.your-domain.com/iframe-content.html" style="border:none;" allowfullscreen allow="autoplay; fullscreen; picture-in-picture; xr-spatial-tracking; encrypted-media; clipboard-write"></iframe>' };

get|set sharing configuration for the player sharing module.
sharingData getter returns a SharingData Object with url:String and code:String properties.
sharingData setter expects a SharingData Object input with url:String and code:String properties.

Going further with social sharing

Additionally, the following social-related resources should be noted:

• Facebook Instant Articles: we have released guidelines for using Radiant Media Player with Facebook Instant Articles, which may prove useful if this is part of your social strategy.
• Review our best practices for sharing on X and Facebook with X cards and the open graph protocol.