Developing Applications using PlayReady

Devices including a PlayReady Client embedded by the OEM

Many leading OEMs have licensed PlayReady and have implemented a player (based on the PlayReady Porting Kit) into their devices. They then make it available to application developers as part of their SDK.

For example, Microsoft ensures all Windows 10 devices include a PlayReady Client integrated in the Windows OS itself, or in the chip's firmware of the device (TEE), and exposes it through UWP APIs to application developers. But many Android TV device makers do the same. These devices use various APIs to expose the PlayReady Client to applications, including:

• The Universal Windows Platform API on PCs, Xbox
• The Java DrmManagerClient API on Android devices
• Various interfaces on Linux devices
• The Javascript EME API on modern web browsers
• The CE-HTML HbbTV API on old embedded web browsers

On these devices, application developers do not need to license PlayReady, or manipulate the PlayReady code or certificate. They just use the SDK provided by the OEM on the platform and run PlayReady operations from within their app, like AcquireLicense(KID), and so on.

An application developed with this model is not royalty-bearing.

The following table shows the current availability of a PlayReady Client on various devices.

	Embedded in the device	In the application
Windows 10	Yes. Windows SDK. UWP or Web app in Microsoft Edge
Windows 8, 8.1	Yes, Windows SDK	3rd party SDKs possible
Windows 7	Yes, Silverlight	3rd party SDKs possible
MacOS	No	Silverlight and 3rd party SDKs
iOS	No	1st and 3rd party SDKs
Apple TV OS	No	3rd party SDKs
Chrome OS	No
Android Mobile	Yes on some models	3rd party SDKs
Android TV	Yes on all models
Linux TVs	Yes on most models
Consoles	Yes on PlayStations and Xbox
Network Receivers	Yes on most models
Blu Ray Disc Players	Yes on most models

Devices not including a PlayReady Client

Some OEMs have made the choice to not embed a PlayReady Client in their device, or to embed it but not make it available to application developers through their SDK.

On these devices, application developers can still run PlayReady operations from within their app, but they need to integrate the PlayReady Client in their application, including PlayReady code and certificates.

The integration of a PlayReady Client in the application requires the application developer to license PlayReady and use an implementation based on the PlayReady Device Porting Kit in the application. A company that develops using PlayReady source code must hold a PlayReady Device Development and Intermediate Product Distribution License.

This development requires expertise to harden the application, including the PlayReady code and the PlayReady secrets (keys, certificates). Most application developers decide to use a PlayReady SDK developed and maintained by a Microsoft Partner).

Developing Applications using PlayReady on Windows, Xbox

Microsoft develops and distributes a PlayReady Client in every Windows 10, 8.1, 8 unit, and in every Xbox unit. This PlayReady Client is exposed and freely accessible through a high-level API to application developers.

Application developers can create Universal Windows Platform (UWP) applications capable of providing PlayReady content to the user while enforcing the access rules defined by the content provider. An application can freely use this built-in PlayReady Client in Windows 8, 8.1, or 10, without signing any agreement with Microsoft, and without the need of any PlayReady certificate, or any PlayReady fee or royalty due.

Windows 10 PlayReady documentation can be found at PlayReady for Windows 10 and at Windows.​Media.​Protection.​Play​Ready Namespace . Samples of PlayReady Windows 10 applications can be found as part of the UWP Samples collection and at PlayReady sample Universal Windows Apps for Windows 10 (Javascript/C#/EME).

To learn more about designing an application that runs on Xbox, see PlayReady DRM on Xbox.

You can also create PlayReady Windows Store and Web applications for Windows 8.1. Windows 8.1 PlayReady documentation can be found at Developing PlayReady Windows Store and Web Apps. Samples of PlayReady Windows 8.1 applications can be found at PlayReady sample for Windows 8.1 Store apps.

Developing Applications using PlayReady on Windows 7

Some PlayReady Partners provide SDKs to run PlayReady on Windows 7 and Mac OS, based on Electron, Xamarin, or other technologies. You can contact these PlayReady Partners directly for more information.

Silverlight is a deprecated application framework running on Windows 7 and Mac OS that includes a fully functional PlayReady Client. It runs in browsers with limitations, and can also run out of browsers to provide standalone apps on Windows 7 and Mac OS.

Developing Applications using PlayReady on Android

While many Android device models embed a PlayReady Client integrated by the OEM, others do not.

Developing an application for the models which embed one is as simple as using the SDK from these devices. They will typically expose the PlayReady Client through the Java DrmManagerClient class. See the PlayReady Plugin for Android Microsoft Specification for more information.

Developing an application for the models which don't embed a PlayReady Client requires the integration of the PlayReady Client in the application itself.

Microsoft Partners develop PlayReady SDKs for Android from the PlayReady Porting Kit, and make them available to application developers. If you have a project to develop an application using PlayReady on Android, you can directly contact the listed Microsoft Partners for proposals and quotes.

Developing Applications using PlayReady on iOS, AppleTV OS, MacOS

Apple products do not ship with an embedded PlayReady Client. However, it is possible to distribute applications for these platforms that integrate a PlayReady Client in the application itself.

Microsoft Partners can also develop PlayReady SDKs for Apple-based OS platforms from the PlayReady Porting Kit, and make them available to application developers. If you have a project to develop an application using PlayReady on iOS for example, you can directly contact the listed Microsoft Partners for proposals and quotes.

Developing Applications using PlayReady in a Web Browser

A web app running in a modern web browser supporting HTML5 and JavaScript will use the Encrypted Media Extensions (EME) interface to do PlayReady operations.