This article describes how to use the server-side API to instruct Wowza media server software to decrypt Microsoft PlayReady encrypted MP4 files before streaming. It's best to install the Wowza IDE and get familiar with how server-side programming works before reading any further.
Note: Wowza Streaming Engine™ software or Wowza Media Server™ software (version 3.5 or later) is required.
package com.wowza.wms.plugin.test.module;
import com.wowza.util.*;
import com.wowza.wms.application.*;
import com.wowza.wms.drm.playready.*;
import com.wowza.wms.mediareader.h264.*;
import com.wowza.wms.module.*;
import com.wowza.wms.stream.*;
public class ModuleMP4PlayReadyKeyProvider extends ModuleBase
{
class MediaReaderListener implements IMediaReaderActionNotify
{
public void onMediaReaderCreate(IMediaReader mediaReader)
{
}
public void onMediaReaderInit(IMediaReader mediaReader, IMediaStream stream)
{
}
public void onMediaReaderOpen(IMediaReader mediaReader, IMediaStream stream)
{
getLogger().info("ModuleMP4PlayReadyKeyProvider#MediaReaderListener.onMediaReaderOpen["+stream.getName()+"]");
if (mediaReader instanceof IMediaReaderEncInfo)
{
PlayReadySampleInfo videoSampleInfo = ((MediaReaderH264)mediaReader).getPlayReadyAudioTrackInfo(((MediaReaderH264)mediaReader).getTrackIndexAudio());
if (videoSampleInfo != null && videoSampleInfo.getKeyID() != null)
getLogger().info("ModuleMP4PlayReadyKeyProvider#MediaReaderListener.onMediaReaderOpen["+stream.getName()+"]: video.keyId:"+BufferUtils.encodeHexString(videoSampleInfo.getKeyID()));
PlayReadySampleInfo audioSampleInfo = ((MediaReaderH264)mediaReader).getPlayReadyAudioTrackInfo(((MediaReaderH264)mediaReader).getTrackIndexAudio());
if (audioSampleInfo != null && audioSampleInfo.getKeyID() != null)
getLogger().info("ModuleMP4PlayReadyKeyProvider#MediaReaderListener.onMediaReaderOpen["+stream.getName()+"]: audio.keyId:"+BufferUtils.encodeHexString(audioSampleInfo.getKeyID()));
MediaReaderEncInfo encInfo = ((IMediaReaderEncInfo)mediaReader).getEncInfo();
PlayReadyKeyInfo decryptorKey = new PlayReadyKeyInfo();
decryptorKey.setContentKey(Base64.decode("Tc2cQBPC/paTkftvaITCSQ=="));
encInfo.setEncMethod(MediaReaderEncInfo.METHOD_SAMPLE_PLAYREADY);
encInfo.addPlayReadyDecryptorKey(decryptorKey);
}
}
public void onMediaReaderExtractMetaData(IMediaReader mediaReader, IMediaStream stream)
{
}
public void onMediaReaderClose(IMediaReader mediaReader, IMediaStream stream)
{
}
}
public void onAppStart(IApplicationInstance appInstance)
{
getLogger().info("ModuleMP4PlayReadyKeyProvider.onAppStart["+appInstance.getContextStr()+"]");
appInstance.addMediaReaderListener(new MediaReaderListener());
}
}
This module only serves as a simple example of how the decryption API works. In real-world usage, this module will most likely be integrated with your PlayReady key server to set decryption keys on a per-file basis.
To add this module to an application, open [install-dir]/conf/[application]/Application.xml in a text editor and add the following module definition:
<Module> <Name>ModuleMP4PlayReadyKeyProvider</Name> <Description>ModuleMP4PlayReadyKeyProvider</Description> <Class>com.wowza.wms.plugin.test.module.ModuleMP4PlayReadyKeyProvider</Class> </Module>
Originally Published: 11-08-2012.
If you're having problems or want to discuss this article, post in our forum.
