DASH (Google Widevine DRM and Microsoft PlayReady) DRM

• Google Widevine: Use this DRM solution primarily for Android, Chrome browsers, and Chromecast devices.
• Microsoft PlayReady: Use this DRM solution primarily for Roku, Xbox, and the Microsoft Edge browser.

Quick Start #

1. Contact your account manager to enable Studio DRM.
2. Verify that the “Require studio approved DRM for playback” and “Require a token for playback” options have been enabled on the desired live event, live channel, or CMS asset.
3. Re-ingest the slate that was encoded prior to Studio DRM activation. Use the cleardash parameter and turn off digital signatures to ensure optimal playback performance. Learn more.
4. Re-encode existing CMS assets that were encoded before Studio DRM activation. Only assets encoded after Studio DRM activation can be secured via Studio DRM. Use the Slicer, Slicebot, or the Cloud Slicer for re-encoding.
5. Construct the playback URL for the desired live event, live channel, or CMS asset.
   • Find the DASH version of the playback URL corresponding to the desired live event, live channel, or CMS asset.
   • Define the desired set of Studio DRM policies by adding either a Studio DRM policy configuration or the desired individual policies to the playback URL’s query string:
     plaintext

     Copy

     1https://content.uplynk.com/ea10fa402fec4bbe996019a0827e6c37.mpd?&drm_policy_name=wvpolicy1

     Use a Studio DRM policy configuration and/or the parameter expansion capability to obfuscate your Studio DRM policies.
   • Sign the playback URL.
6. Update your player/client to submit a license request to our license server via one of the following license acquisition URLs:
   License acquisition URL for Google Widevine: https://content.uplynk.com/wv
   License acquisition URL for Microsoft PlayReady: https://content.uplynk.com/pr
   Request a license from the region where the manifest file was generated to avoid being redirected. (#license-acquisition).
7. Point your player to the signed playback URL generated in step 5.
8. Optional. Configure Exoplayer to support key rotation. Exoplayer Only (Widevine)
   "drm_multi_session": true

• Learn more about ExoPlayer (Widevine).
• Learn how to set up Google Shaka player for use with Widevine.

License Acquisition #

Unencrypted DASH Content #

Google Shaka Player (Widevine) #

1. Follow the instructions provided within the Shaka Player tutorial to perform the following actions:
   • Get the source by cloning the following Git repository:

     1https://github.com/google/shaka-player

   • Compile the Google Shaka player library.
   • Create an HTML page with a video element.
   • Create a JavaScript file (e.g., myapp.js).
   • Update the JavaScript file created in the previous step to:
     • Reference a signed playback URL that points to the desired content:
       JavaScript

       Copy

       1var manifestUri =
       2    'https://content.uplynk.com/ea1...c38.mpd?tc=1&exp=1553273704&rn=1234&ct=a&cid=ea1...c38&drm_policy_name=wvpolicy1&sig=ecd...cbf';

     • Reference our license server:
       JavaScript

       Copy

       1var licenseServer =
       2    'https://content.uplynk.com/wv';

     • Configure the player to use our license server before it loads the manifest. Learn more.
2. Host the following assets on your web server:
   • Compiled Google Shaka player library (e.g., dist/shaka-player.compiled.js)
   • HTML page created earlier.
   • JavaScript file created earlier.

ExoPlayer (Widevine) #

1. Reference a signed playback URL that points to the desired content.
   Sample configuration (media.exolist.json):
   JSON

   Copy

   1{
   2    "uri": "https://content.uplynk.com/ea1...c38.mpd?tc=1&exp=1553273704&rn=1234&ct=a&cid=ea1...c38&drm_policy_name=wvpolicy1&sig=ecd...cbf"
   3}

2. Set the DRM scheme to “widevine.”
   Sample configuration (media.exolist.json):
   JSON

   Copy

   1{
   2    "drm_scheme": "widevine"
   3}

3. Set the DRM license URL to:
   Sample configuration (media.exolist.json):
   JSON

   Copy

   1{
   2    "drm_license_url": "https://content.uplynk.com/wv"
   3}

4. Enable multi-session DRM to support key rotation.
   Sample configuration (media.exolist.json):
   JSON

   Copy

   1{
   2    "drm_multi_session": true
   3}

   Initial playback will work regardless of this setting. However, if this setting is not defined, playback will fail upon key rotation. This setting is especially important for streaming live content, since all keys will not be available when the license is generated.
5. Optional. Offline Playback (Rental) Only
   If VOD content will be played offline, request all keys up front by including the following setting:
   Sample configuration (media.exolist.json):
   JSON

   Copy

   1{
   2    "drm_key_request_properties": {"X-DASH-SEND-ALL-KEYS":"1"}
   3}

Sample Configurations #

1[{
2    "name": "Widevine DASH",
3    "uri": "https://content.uplynk.com/ea1...c38.mpd?tc=1&exp=1553273704&rn=1234&ct=a&cid=ea1...c38&drm_policy_name=wvpolicy1&sig=ecd...cbf",
4    "drm_scheme": "widevine",
5    "drm_license_url": "https://content.uplynk.com/wv",
6    "drm_multi_session": true
7}, {
8    // additional configuration objects
9}]

1[{
2    "name": "Widevine DASH",
3    "uri": "https://content.uplynk.com/ea1...c38.mpd?tc=1&exp=1553273704&rn=1234&ct=a&cid=ea1...c38&drm_policy_name=wvpolicy1&sig=ecd...cbf",
4    "drm_scheme": "widevine",
5    "drm_license_url": "https://content.uplynk.com/wv",
6    "drm_multi_session": true,
7    "drm_key_request_properties": {"X-DASH-SEND-ALL-KEYS":"1"}
8}, {
9    // additional configuration objects
10}]

Playback without Studio DRM Protection #

1. Disable Studio DRM by performing either of the following:
   • Clear the Require studio approved DRM for playback option on the desired CMS asset.
   • Pass the drm_optional parameter in the playback URL. Learn more.
2. Pass the ck parameter in the playback URL:

• For all players: &ck=1
• Exoplayer only: &ck=4

3. Update your player to request a cleartext key via the following URL: https://content.uplynk.com/ck

Microsoft Playready #

More Information #

• Studio DRM Policy Configuration
• Studio DRM API