DRM interface overview

Browser TVSDK provides a DRM interface you can use to play content protected by different DRM solutions, including FairPlay, PlayReady, and Widevine.

The key interface of the DRM workflow is the DRMManager. A reference to the DRMManager instance can be obtained through the MediaPlayer instance:

• var mediaPlayer = new AdobePSDK.MediaPlayer();
• var drmManager = mediaPlayer.drmManager;

Here is a high-level workflow for playback of DRM-protected content:

1. To attach the DRM-system specific data that will be used by Browser TVSDK in the license acquisition process for a protected stream, make the following call before invoking mediaPlayer.replaceCurrentResource:

   var protectionData = {
       "com.adobe.primetime": {
          "serverURL": {
             "individualization-request": "https://individualization.adobe.com/flashaccess/i15n/v5",
             "license-request": "https://example.com:8096/flashaccess/req",
             "license-release": "https://example.com:8096/flashaccess/req"
          },
          "httpRequestHeaders": {
          }
       }
   };
   var drmManager = mediaPlayer.drmManager;
   drmManager.setProtectionData(protectionData);
   

2. If the same content is expected to work with different DRM systems in different browsers, protection data can be specified for multiple DRM systems.

   var protectionData = {
       "com.adobe.primetime": {
           "serverURL": {
               "individualization-request": "https://individualization.adobe.com/flashaccess/i15n/v5",
               "license-request": "https://example.com:8096/flashaccess/req",
               "license-release": "https://example.com:8096/flashaccess/req"
           },
           "httpRequestHeaders": {
           }
       },
       "com.widevine.alpha": {
           "serverURL": "https://wv.service.expressplay.com/hms/wv/rights/?ExpressPlayToken=<token value>",
           "httpRequestHeaders": {
               "dt-custom-data": "eyJ1c2VySWQiOiIxMjM0NS"
           }
       },
       "com.microsoft.playready": {
           "serverURL": "https://pr.test.expressplay.com/playready/RightsManager.asmx?ExpressPlayToken=<token value>",
           "httpRequestHeaders": {
               "http-header-CustomData": "eyJ1c2VySWQiOiIxMjM0NS"
           }
       },
       "com.apple.fps.1_0": {
           "serverURL": "https://fp.service.expressplay.com:80/hms/fp/rights/?ExpressPlayToken=<token value>",
           "certificateURL": "Path_To_certificate.cer",
           "licenseResponseType": "arraybuffer",
           "httpRequestHeaders": {
               "Content-type": "application/octet-stream"
           }
       },
       "org.w3.clearkey": {
           "clearkeys": {
               "H3JbV93QV3mPNBKQON2UtQ": "ClKhDPHMtCouEx1vLGsJsA",
               "IAAAACAAIAAgACAAAAAAAg": "5t1CjnbMFURBou087OSj2w"
           }
       }
   };
   
   var drmManager = mediaPlayer.drmManager;
   drmManager.setProtectionData(protectionData);
   

3. When protection data is not set, necessary information such as the license URL, is retrieved from the PSSH box for DRM systems where applicable.

   TIP

   Specifying protection data overrides the license URL that is specified in the PSSH box.

4. By default, the session type for the DRM license is temporary, which means that the license is not stored after the session is closed.

   You can specify a session type using an API in DRMManager. For backward compatibility, session types include temporary, persistent-license, persistent-usage-record, and persistent.

   var drmManager = mediaPlayer.drmManager;
    drmManager.setEMESessionType(“<YOUR_SESSION_TYPE>”);
   
   

5. When the sessionType used is persistent-license or persistent, the DRM license can be returned by invoking DRMManager.returnLicense.

   var onLicenseReturnFunc = function () {
       console.log("DRM: License Return Complete ");
   },
   
   onLicenseReturnErrorFunc = function (major, minor, errorString/*, errorServerUrl*/) {
      console.log("DRM: License Return Error: " + errorString);
   },
   
   drmManager = mediaPlayer.drmManager;
   
   if (drmManager) {
       var returnLicenseListener = new
           AdobePSDK.DRMReturnLicenseListener(onLicenseReturnFunc, onLicenseReturnErrorFunc);
       drmManager.returnLicense(null, null, null, false, returnLicenseListener, drmLicense.session);
   }