Chromecast (JW Platform)
Integrate Studio DRM with your JW Platform and Chromecast
The Google Cast framework enables a viewer to stream content to a compatible TV or sound system. By enabling the Google Cast framework in your app, a viewer can use a cast button to stream your content to a Cast-enabled device on a shared network.
This article explains two integrations:
- Enabling the Google Cast framework for the JW web player
- Casting video content protected by Studio DRM with the JW Platform
VUDRM was rebranded as Studio DRM following JW Player’s acquisition of Vualto. Any references to VUDRM in this document or in the Studio DRM Admin portal refer to Studio DRM.
Requirements
Integrating Studio DRM with JW Platform and Chromecast has several requirements.
| Item | Notes |
|---|---|
| Application Registration | Registration allows you to test your custom receiver. Specifically, you will be able to connect to the custom receiver with your custom Cast implementation. |
| Cast App | A Cast app enables DRM-protected content to be streamed on a Cast-enabled device.
A Cast app consists of two components:
|
| Content URLs | Through a signed URL, the license URL and streaming URL for each media ID are retrieved.
Use the following steps to retrieve the content URLs:
|
Configure the Cast app
For DRM playback, deploy your custom web receiver.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Studio DRM Custom Chromecast Receiver</title>
<link rel="stylesheet" href="main.css" media="screen" />
<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
</head>
<body>
<cast-media-player></cast-media-player>
</body>
<footer>
<script src="receiver.js"></script>
</footer>
</html>
(() => {
const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
var laurl;
// Wait until the cast player is loaded, get the laurl from the media request and use it in the player config
playerManager.setMessageInterceptor(cast.framework.messages.MessageType.LOAD, loadRequestData => {
let customData = loadRequestData.media.customData;
// Check all content source fields for asset URL or ID
let source = loadRequestData.media.contentUrl || loadRequestData.media.entity || loadRequestData.media.contentId;
if (!source || source == "") {
let error = new cast.framework.messages.ErrorData(
cast.framework.messages.ErrorType.LOAD_FAILED
);
error.reason = cast.framework.messages.ErrorReason.INVALID_REQUEST;
return error;
}
loadRequestData.media.contentUrl = source;
if (customData) {
if (customData["laurl"]) {
laurl = customData["laurl"];
} else if (customData["drm"]["widevine"]["url"]) {
laurl = customData["drm"]["widevine"]["url"];
}
}
playerManager.setPlaybackConfig(createPlaybackConfig(playerManager));
return loadRequestData;
});
context.start();
function createPlaybackConfig(playerManager) {
let playbackConfig = (Object.assign(new cast.framework.PlaybackConfig(), playerManager.getPlaybackConfig()));
playbackConfig.licenseUrl = laurl;
playbackConfig.protectionSystem = cast.framework.ContentProtection.WIDEVINE;
return playbackConfig;
}
})();
Enable casting for a viewer
Once you set up your custom receiver, you will be able to cast DRM content from the JW web player. For reference, you may see our Studio DRM integration with JW Player.
- Add the cast object to your setup.
- In the JW Player studiodrm-jwplayer.js file, define
dash-stream-urlwith your signed streaming URL. - Define
widevine-license-urlwith the signed license URL. - Define
your-receiver-application-idwith your registered custom receiver app ID from the Google Cast developer console.
(function() {
// Set the mpeg-dash stream URL.
var dashStreamURL = "<dash-stream-url>"
// Set the hls stream URL.
var hlsStreamURL = "<hls-stream-url>";
// Set the URL to retrieve the fairplay certificate from.
var fairplayCertURL = "<fairplay-cert-url>";
// setup jwplayer, passing the stream URLs and DRM configurations.
jwplayer("studiodrm-container").setup({
"playlist": [{
"sources": [{
"file": dashStreamURL,
"drm": {
"widevine": {
"url": "<widevine-license-url>"
},
"playready": {
"url": "https://playready-license.vudrm.tech/rightsmanager.asmx",
}
}
},
{
"file": hlsStreamURL,
"drm": {
"fairplay": {
"certificateUrl": fairplayCertURL,
"processSpcUrl": function (initData) {
return "https://" + initData.split("skd://").pop();
},
"licenseRequestHeaders": [
{
"name": "Content-type",
"value": "arraybuffer"
}
]
}
}
}]
}],
"cast": {
"appid": "<your-receiver-application-id>"
}
});
})();
You can now cast DRM-protected video content onto a Chromecast device.
FAQ
How do I implement Airplay with DRM media?
Airplay will automatically be implemented by the Apple OS with DRM Media.
If an Airplay session is initiating after 10 minutes or longer of playback on the sending device, playback on the receiving device will fail. The user will need to restart the video in the Airplay session. This occurs because the Airplay receiver is using the existing authorization which has timed out.
Updated 5 months ago