PallyCon Widevine Android SDK makes it easy to apply Google’s Widevine Modular DRM when developing media service apps for Android. This document describes how to use the libraries and sample project included in the SDK.
Details of PallyCon Multi DRM service integration are provided in License Callback Guide and License Token Guide. For technical questions about using the SDK, please visit our Helpdesk site.
SDK products can be requested when subscribing to PallyCon cloud commercial service. Then SDK can be downloaded from the
Downloadpage of PallyCon Console site.
Site ID and Site Key from the site.This video is a tutorial for playing DRM content using the sample project included in the SDK.
For optimal playback, select ‘1080p’ as the video quality and enable subtitle (Korean or English) before starting playback.
You can apply PallyCon Widevine Android SDK to your development project by following these steps:
Extract downloaded SDK file.
Copy PallyconWVMSDK.jar file to project/module/libs/ folder in your project.
Apply the below configuration in build.gradle (project).
buildscript {
repositories {
jcenter()
google()
flatDir {
dirs 'libs'
}
}
dependencies {
classpath 'com.android.tools.build:gradle:3.1.2'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files }
}
allprojects {
repositories {
jcenter()
google()
}
}
Apply the below configuration in build.gradle (module).
android {
defaultConfig {
minSdkVersion 19
targetSdkVersion 26
multiDexEnabled true
}
}
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
implementation fileTree(dir: 'libs', include: ['*.aar'])
androidTestImplementation('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
exclude group: 'com.google.code.findbugs'
})
implementation 'com.android.support:appcompat-v7:26.1.0'
testImplementation 'junit:junit:4.12'
implementation 'com.google.android.exoplayer:exoplayer:2.8.2'
implementation 'com.android.support:mediarouter-v7:26.1.0'
implementation 'com.google.android.gms:play-services-cast-framework:11.8.0'
implementation group: 'org.bouncycastle', name: 'bcprov-jdk15on', version: '1.59'
implementation group: 'org.bouncycastle', name: 'bcpkix-jdk15on', version: '1.59'
}
Implement PallyconDownloadTask.PallyconDownloadEventListener in MainActivity.(refer to sample project)
private PallyconDownloadTask.PallyconDownloadEventListener eventListener = new PallyconDownloadTask.PallyconDownloadEventListener() {
@Override
public void onPreExecute() {
// called on preparing download
}
@Override
public void onPostExecute() {
// called on download complete
}
@Override
public void onProgressUpdate(String fileName, long downloadedSize, long totalSize, int percent, int downloadIndex) {
// called on progress update : refer to API document
}
@Override
public void onCancelled() {
// called on canceling download : refer to API document
}
@Override
public void onNetworkError(NetworkConnectedException e) {
// called on network error : refer to API document
}
@Override
public void onPallyconDownloadError(PallyconDownloadException e) {
// called on download error : refer to API document
}
};
To use the download callback, implement the callback function and enter it into the PallyconDownloadTask constructor. If you do not use callback, enter null.
DownloadCallbackImpl downloadCallback = new DownloadCallbackImpl(getApplicationContext());
Create PallyconDownloadTask object with content information.
downloadTask = new PallyconDownloadTask(MainActivity.this, content.uri, content.name, listener, eventHandler);
Start downloading content if the content is not previously downloaded.
boolean result = downloadTask.isDownloadCompleted();
if(result == true) {
Uri localUri = downloadTask.getLocalUri(content.uri, content.name);
} else {
downloadTask.execute();
}
After the download is complete, you can issue a license using the following APIs before playback
WVMAgent.downloadLicense(content.drmSchemeUuid, content.drmLicenseUrl, content.uri, content.userId, content.cid, content.oid);
Implement player in PlayerActivity.java using ExoPlayer development guide.
Implement ExoPlayer.EventListener. (refer to sample project)
private ExoPlayer.EventListener playerEventListener = new ExoPlayer.EventListener() {
@Override
public void onTimelineChanged(Timeline timeline, Object manifest){
// refer to API document & sample source
}
@Override
public void onTracksChanged(TrackGroupArray trackGroups, TrackSelectionArray trackSelections) {
// refer to API document & sample source
}
@Override
public void onLoadingChanged(boolean isLoading) {
// refer to API document & sample source
}
@Override
public void onPlayerStateChanged(boolean playWhenReady, int playbackState) {
// refer to API document & sample source
}
@Override
public void onPlayerError(ExoPlaybackException e) {
// refer to API document & sample source
}
@Override
public void onPositionDiscontinuity() {
// refer to API document & sample source
}
};
Implement PallyconStreamingDrmSessionManager.PallyconEventListener. (refer to sample project)
private PallyconStreamingDrmSessionManager.PallyconEventListener eventListener = new PallyconStreamingDrmSessionManager.PallyconEventListener() {
@Override
public void onDrmKeysLoaded(Map<String, String> licenseInfo) {
// refer to API document
}
@Override
public void onDrmSessionManagerError(Exception e) {
// refer to API document
if (e instanceof NetworkConnectedException) {
} else if (e instanceof PallyconDrmException) {
} else if (e instanceof PallyconEncrypterException) {
} else if (e instanceof PallyconServerResponseException) {
} else if (e instanceof KeysExpiredException) {
} else if (e instanceof DetectedDeviceTimeModifiedException) {
// Important : content playback should be prohibited to prevent illegal use of content.
} else {
}
}
};
Get PallyconWVMSDK instance.
PallyconWVMSDK WVMAgent = PallyconWVMSDKFactory.getInstance(this, Global.enableNcgCenc);
Set Site ID and Site Key issued by PallyCon Console Site to PallyconWVMSDK instance.
WVMAgent.init(this, eventHandler, "SITEID", "SITEKEY");
Register a listener to receive events from the object of PallyconWVMSDK.
WVMAgent.setPallyconEventListener(pallyconEventListener);
Create PallyconDrmSessionManager with information for license acquisition.
drmSessionManager = WVMAgent.createDrmSessionManager(drmSchemeUuid, drmLicenseUrl, uri, userId, cid, oid);
If you use license token type integration, set the token information as below.
drmSessionManager = WVMAgent.createDrmSessionManagerByToken(drmSchemeUuid, drmLicenseUrl, uri, userId, cid, token);
Input the above drmSessionManager as a parameter when creating ExoPlayer
player = ExoPlayerFactory.newSimpleInstance(this, trackSelector, new DefaultLoadControl(), drmSessionManager);
Input the playerEventListener when registering Player Listener as well.
player.addListener(playerEventListener);
To prevent content leaks with screen recording apps, you should block the capture function by adding the following code to your application:
SurfaceView view = (SurfaceView)simpleExoPlayerView.getVideoSurfaceView(); view.setSecure(true);
Please refer to the doc/en/api_reference.html file of the SDK zip file for detailed explanation of each API.