PlayReady UWP SDK Guide

DoveRunner PlayReady UWP SDK makes it easy to apply Microsoft’s PlayReady DRM when developing media service apps for Universal Windows Platform (UWP). This document describes how to use the libraries and sample projects included in the SDK.

Details of DoveRunner Multi DRM service integration are provided in License Token Guide. For technical questions about using the SDK, please visit our Helpdesk site.

Note

This SDK product can be downloaded from DoveRunner Github repository. In the trial account, you can freely test SDK products within the trial limit on the number of licenses issued. However, in order to apply the SDK to commercial services, you must apply for a plan that includes SDK usage rights when subscribing to DoveRunner commercial plans.

Supported Environments

• Windows 10 1809 version or later
• XBox One 10 or later

Prerequisites

• This SDK is developed and tested on Visual Studio 2017(version 15).

• You need to sign up on DoveRunner Console Site to get Site ID and Site Key, and prepare DASH content using DoveRunner Packager.

• You cannot test DoveRunner PlayReady UWP SDK Sample to play DASH content until the above is done.

PlayReady license acquisition method

PlayReady UWP SDK supports two DRM license acquisition methods:

Proactive license acquisition

A method of pre-acquiring a license with an explicit request before the client starts playing the DRM content. This method is typically used in offline playback scenarios.

Note

If you want to apply a different URL such as a proxy server instead of the LA (License Acquisition) URL entered during the content packaging process, you can acquire a license from any LA URL using the Proactive license acquisition API parameter provided by the SDK.

Reactive license acquisition

In this approach, the client application does not explicitly acquire a license prior to playing the content. Instead, at the start of playback of DRM content, the PlayReady media player internally requests and acquires the license required for playback from the server. You would typically use this approach in streaming playback scenarios.

Note

Unlike the proactive method, you cannot apply arbitrary LA URLs when requesting a license in the reactive method. In this case, changing the LA URL requires re-packaging the content. (Input new LA URL during packaging process)

Configuring your project

You can apply DoveRunner PlayReady UWP SDK by following steps:

1. Extract downloaded SDK zip file.
2. Add the PallyConPRSDK.dll file provided in lib folder to your UWP application project.
3. Declare and implement the followings: using PallyConPRSDK;, using PallyConSDK.DownloadTask; using PallyConSDK.DownloadTask.ProxyServer;

For details on how to play DRM content using the PlayReady UWP SDK, please refer to the SDK sample code in the GitHub repository. (See PallyConPRSDKWrapper.cs source code)

PlayReady Hardware DRM

Hardware-based PlayReady DRM is supported on a variety of devices, including Windows 10 PCs, Smart TVs, XBOX game consoles and tablets. Windows PCs must be running Windows 10 and include a supported hardware configuration in order to support PlayReady hardware DRM. Please check Microsoft PlayReady Hardware DRM webpage for more information.