DRM on Android

THEOplayer supports FairPlay, PlayReady and Widevine by default. To use these DRM systems, you will need to pass a DRM configuration along with the source object. We are partnered with many multi-DRM vendors to make it as easy as possible to get your DRM streams running.

Integrations

These DRM vendors can be used through an integration. An integration is not part of the SDK: it is added on top of it as a custom DRM integration. Ready-made integrations for many vendors are available in the DRM integration samples repository. Vendors which don't require custom license or certificate requests can be used with a plain key system configuration instead.

• Arris Titanium
• BuyDRM KeyOS
• DoveRunner
• EZDRM
• Intertrust ExpressPlay
• Microsoft Azure
• Uplynk
• Verimatrix MultiRights
• Vimond
• Vualto VuDRM

Pre-integrations

THEOplayer is also pre-integrated with a number of commercial multi-DRM vendors. These pre-integrations are part of the SDK itself: you select the vendor and pass its parameters, and the SDK takes care of the vendor's license and certificate requests. When integrating DRM for the first time or updating your integration, an integration is preferred over a pre-integration.

• Arris Titanium
• Axinom
• BuyDRM KeyOS
• castLabs DRMToday
• Irdeto
• Microsoft Azure
• Nagra Conax Contego
• Vualto VuDRM
• Xstream

Other guides

• Clear Key: how to play a Clear Key protected stream.
• Offline DRM: how to implement playback of downloadable content-protected streams.
• Customizing offline DRM notifications
• Multi-key HLS: how to serve one HLS stream to all key systems.

Custom configuration

Developers can use the generic DRM-functionalities in case in-house DRM-solutions are used, or services from DRM-vendors for which no integration is available.

To configure DRM on the Android SDK, developers can put a DRMConfiguration inside a SourceDescription.

// Map<String, String> headers =  new HashMap<String, String>();
// headers.put("<KEY>", "<VALUE>");
DRMConfiguration drmConfiguration = new DRMConfiguration.Builder()
    .widevine(
        new KeySystemConfiguration.Builder(
            "<LICENSE_KEY_URL_WIDEVINE>"
            )// , headers, <USE_CREDENTIALS>, <QUERY_PARAMETERS>
            .build()
        )
        .build();
TypedSource typedSource = new TypedSource.Builder("<DASH_STREAM_URL>")
    .drm(drmConfiguration)
    .build();
SourceDescription sourceDescription = new SourceDescription.Builder(typedSource)
    .build();
theoplayer.getPlayer().setSource(sourceDescription);

Custom integration

Developers can make their own custom DRM integration for any DRM vendor. This can be done by making use of the DRM integration API repository.

A complete guide on how to create a new integration, and some example integrations can be found in the provided repository.