Interface SourceDescription

One or more media resources for playback.

Remarks

- Multiple media sources should be used to increase platform compatibility. See examples below for important use cases.
- The player will try each source in the provided order.

Example

In this example, the player will first try to play the DASH source. This might fail if the browser does not support the Widevine or PlayReady CDM, for example on Safari. In that case, the player will try to play the HLS source instead.

[{
  src: 'dash-source-with-drm.mpd'
  contentProtection: {
    widevine: {
      licenseAcquisitionURL: 'https://license.company.com/wv'
    },
    playready: {
      licenseAcquisitionURL: 'https://license.company.com/pr'
    }
  }
},{
  src: 'hls-source-with-drm.m3u8',
  contentProtection: {
    fairplay: {
      certificateURL: 'https://license.company.com/fp'
    }
  }
}]
Copy

Example

In this example, the player will first try to play the DASH source. This might fail if the browser does not support the Media Source Extensions API. In that case, the player will try to play the MP4 source instead, though without features such as adaptive bitrate switching.

[{
  src: 'source.mpd'
},{
  src: 'source.mp4'
}]
Copy