logo

How to use THEOplayer with KeyOS BuyDRM

This guide explains how you set-up THEOplayer in combination with the KeyOS BuyDRM, a partnered multi-DRM vendor. THEOplayer is pre-integrated with KeyOS and provides a user-friendly API to connect to their Widevine and PlayReady DRM solutions.

If you are already comfortable with the THEOplayer API, you can go straight over to DRM Pre-Integration API

The following topics will be covered:

Table of Contents

Prerequirements

There are two prerequirements in order to continue with this guide:

  1. This guide expects that you have a THEOplayer license. If you aren't using THEOplayer yet, you can start your free trial here.
  2. This guide expects that you are a client of KeyOS's BuyDRM, and that you are integrated with their streaming infrastructure. Information on BuyDRM can be found at https://www.buydrm.com/keyosplayer.

If you can place a checkmark next to these two fields, you are good to go.

You will need a valid THEOplayer set-up. If you have no experience with setting up our player, we have an excellent getting started guide.

Integrating KeyOS BuyDRM

Starting from the basic template above, you only need to add your BuyDRM token (=customdata) to your source configuration, and tell THEOplayer that you are using KeyOS.

Web SDK
player.source = {
    sources : {
        src : 'your.mpd',
        type : 'application/dash+xml',
        drm : {
                integration : 'keyos',
                customdata : 'PEtleU9T...blhNTD4=',
                playready: {
                 licenseAcquisitionURL: '<LICENSE_KEY_URL_PLAYREADY>'
                },
                 widevine: {
                 licenseAcquisitionURL: '<LICENSE_KEY_URL_WIDEVINE>'
                }
        }
    }
}

Your updated starting template would now look like this:

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>THEOplayer 2.X: Getting Started</title>
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <link rel="stylesheet" type="text/css" href='/path/to/ui.css'> <!-- ads THEOplayer CSS -->
    </head> 
    <body>

        <div class="theoplayer-container video-js theoplayer-skin theo-seekbar-above-controls"></div>
        
        <script type='text/javascript' src='/path/to/THEOplayer.js'></script> <!-- ads THEOplayer library -->
    
    <script>

    var element = document.querySelector('.theoplayer-container'); 
    var player = new THEOplayer.Player(element);

    player.source = {
    sources : [{
        src : 'your.mpd',
        type : 'application/dash+xml',
        drm: {
            integration: 'keyos',
            customdata: 'PEtleU9T...blhNTD4=',
            playready: {
                 licenseAcquisitionURL: '<LICENSE_KEY_URL_PLAYREADY>'
            },
                 widevine: {
                 licenseAcquisitionURL: '<LICENSE_KEY_URL_WIDEVINE>'
            }
        }
    }]
    };

    </script>

    </body>
</html>
iOS SDK

A KeyOS DRM integration is added to the source configuration by adding the keyOsDrm() parameter to drm as such:

public static var buyDRMkeyOS: SourceDescription {
    let licenseAcquisitionURL: String = "<LICENSE_KEY_URL_FAIRPLAY>"
    let certificateURL: String = "<CERTIFICATE_URL_FAIRPLAY>"
    let token: String = "<TOKEN_FAIRPLAY>"
    let type: String = "application/x-mpegURL"
    let src = "<HLS_STREAM_URL>"
    let drm: KeyOSDRMConfiguration = KeyOSDRMConfiguration(licenseAcquisitionURL: licenseAcquisitionURL, certificateURL: certificateURL, customdata: token)
    let typedSource: TypedSource = TypedSource(src: src, type: type, drm: drm)
    let source: SourceDescription = SourceDescription(source: typedSource)
    return source
}

// Configure the player's source to initilaise playback
        THEOplayer.source = buyDRMkeyOS

Where: token for customdata is the Authentication XML generated from the their platform.

Note: BuyDRM KeyOS iOS Pre-integration is only available from version 2.64.0 and above

Android SDK

A KeyOS DRM integration is added to the source configuration by adding the keyOsDrm() parameter to drm as such:

SourceDescription dashWithDRM = sourceDescription()
        .sources(
            typedSource("//sourceUrl")
                .drm(
                        keyOsDrm()
                            .customdata("//token")
                            .playready("//playReadyKeyServer")
                            .widevine("//widevineKeyServer")
                            .build()
                ).build()
        ).build();

Where: token for customdata is the Authentication XML generated from the their platform.

Conclusion

THEOplayer partnered with KeyOS to fully pre-integrate their BuyDRM solution, saving you tons of time. This pre-integration brings along multiple advantages.

  • Firstly, it's very simple to set-up KeyOS BuyDRM through THEOplayer.
  • Secondly, no surprises - you know that we are compatible with each other. We also regularly validate our integration, and are the first to know about changes to KeyOS.
  • Thirdly, it offers extra maintainability. Even if the KeyOS infrastructure changes, we attempt to be backwards compatible.
  • Lastly, it just works!

Extra resources:

  1. DRM Pre-Integration API
  2. THEOplayer Getting Started Guide
  3. KeyOS BuyDRM
github
Make sure to follow us on GitHub!
THEO-logo-white
twitter
facebook
linkedin
Copyright © 2020. All Rights Reserved.
Leuven
New York
San Francisco
Singapore
Barcelona