[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Thu Nov 12 2020

How to Protect Your Content with Bitmovin and Vualto DRM

Introduction Link Icon

As an OTT service provider who wants to monetize content, you need to make sure your valuable content can be only played by authorized users conforming to the rights they bought. Digital Rights Management (DRM) is a commonly used means to protect your content and ensure your revenue.

As your users play back your content on a wide range of devices - from Smart TVs to smartphones, running on different platforms - you will need to use multiple DRM systems to cover all devices that are popular with your users.

Managing multiple DRM systems can be difficult, but service providers like Vualto offer help and facilitate the complex matter.

This tutorial explains how to encode and protect your content using Vualto as your multi-DRM management service.

DRM SystemsLink Icon

When we talk about multiple DRM systems, in this tutorial we mean to cover the most used DRM systems which are:

  • Widevine
    • This DRM system by Google is used for playback on related platforms such as Chrome(cast), Android (TV), or Google TV.
  • Playready
    • This DRM system by Microsoft is used for playback on related platforms such as Edge, IE11, XBox, or Windows Phone.
  • Fairplay
    • This DRM System by Apple is used for playback on related platforms such as Safari, iOS, or Apple TV.

Other platforms that are not directly related to Google, Microsoft or Apple typically support one or more of the above DRM systems.

Please find an elaborate list of platform-DRM compatibility here.

Use Cases in this TutorialLink Icon

In this tutorial, we will focus on a selected list of combinations of adaptive streaming formats and DRM systems.

The content, packaged in these streaming formats and encrypted with the associated DRM systems, will be playable on most market relevant devices.

  • DASH with Widevine, tested with Chrome on the Mac
  • DASH with Playready, tested with Edge and IE11 on Windows 10
  • HLS with Fairplay, tested with Safari on the Mac and with iOS
  • Smooth Streaming with Playready, tested with Edge and IE11 on Windows 10

PrerequisitesLink Icon

To protect your content with Vualto, you need to collect some values that are required to configure encoding and playback.

First, give your content an ID which must be different for each piece of content that you want to encode. In this tutorial, we use somecontentid as the ID of your content.

To get the the remaining required values, you need to have an account with Vualto or at least get the values from your Vualto contact:

Note: Values that are specified for a certain DRM system (Widevine, Playready or Fairplay) are needed for that DRM system only.

  • The Vualto token, called "VU DRM Token". This is a long string divided in four sections, which are separated by a "|". The first section is the name of the Vualto account owner, the second is a date when the token was created. The token looks like yourname|2020-07-02T16:03:55Z|kQI7t+b1Kd51CfzfnQ5qzx==|cb556f86d4453a6abf5381966ec543979fcb656f.
  • The Fairplay Certificate URL, looking like skd://fairplay-license.vudrm.tech/certificate/yourname

The following values will be given to the Bitmovin encoding process during configuration.

  • DRM_KEY: The key which will be used to encrypt your content, looking like B01F8C032F5564B6C81DCD340F480978
  • DRM_FAIRPLAY_IV: The Initialization Vector for Fairplay, looking like 656636323963441663544463864376663
  • DRM_FAIRPLAY_URI: The license URL for Fairplay, looking like skd://fairplay-license.vudrm.tech/v2/license/somecontentid . Note that this URL includes your content's ID, in this example somecontentid.
  • DRM_WIDEVINE_KID: The Key ID for Widevine, looking like E920E5426157291C177F8BBD34026696
  • DRM_WIDEVINE_PSSH: The PSSH data (not the whole box) for Widevine, looking like Ig2zb21lZ37udKVudGfhSOPclZsG
  • DRM_PLAYREADY_PSSH: The PSSH data (not the whole box) for Playready. This is a very long string looking like kAMAAAEAAQCGAzwBVwBSAE1ASABAEFFAR...RQCCAEQARQBTAD3A

Writing your Encoding Script in PHPLink Icon

This section will show you how to write a PHP script which uses the Bitmovin API to configure and run a DRM encrypted encoding for your content.

You will find the full script here: TBD

Like every encoding script, we begin with the main workflow, setting up the API, encoding, input and output.

1$exampleName = 'BitmovinTutorial';
2
3$configProvider = new ConfigProvider();
4
5$bitmovinApi = new BitmovinApi(Configuration::create()
6 ->apiKey($configProvider->getBitmovinApiKey()));
7
8// -- Encoding
9$encoding = createEncoding($exampleName, "Encoding with different DRM systems");
10
11// -- Input
12$input = createHttpsInput($configProvider->getHttpInputHost());
13$inputFilePath = $configProvider->getHttpInputFilePath();
14
15// -- Output
16$output = createS3Output(
17 $configProvider->getS3OutputBucketName(),
18 $configProvider->getS3OutputAccessKey(),
19 $configProvider->getS3OutputSecretKey()
20);

Please note that in this example we use a HTTP input to load your source file from and an S3 output to write the encoded/encrypted data to. You are not bound to these formats, please see this page for all supported input and output storages.

Encoding Link Icon

In the upcoming sections, you will learn how to encode your content.

You will also learn how to package the encoded content for HLS and DASH, and optionally for Smooth Streaming.

And you will learn how to encrypt the packaged content with Widevine, PlayReady and Fairplay DRM.

Setting up Codec Configurations and StreamsLink Icon

Like with every encoding, we first must define what video and audio codecs our content should be encoded into.

For this, we first write two functions to generate a simple H.264 video config and a simple AAC audio config.

1function createH264Config()
2{
3 global $bitmovinApi;
4
5 $h264Config = new H264VideoConfiguration();
6 $h264Config->name("H.264 1080p 1.5 Mbit/s");
7 $h264Config->presetConfiguration(PresetConfiguration::VOD_STANDARD());
8 $h264Config->height(1080);
9 $h264Config->bitrate(1500000);
10
11 return $bitmovinApi->encoding->configurations->video->h264->create($h264Config);
12}
1function createAacConfig(AacChannelLayout $channelLayout)
2{
3 global $bitmovinApi;
4
5 $aacConfig = new AacAudioConfiguration();
6 $aacConfig->name("AAC 128 kbit/s");
7 $aacConfig->bitrate(128000);
8 $aacConfig->channelLayout($channelLayout);
9
10 return $bitmovinApi->encoding->configurations->audio->aac->create($aacConfig);
11}

Then, we write a function to create a Stream. A Stream in this context is an entity that connects an input track (audio or video from the source file) to a codec. By applying a codec to an input track, you tell the Encoder to encode the track with that codec.

1function createStream(Encoding $encoding, Input $input, string $inputPath, CodecConfiguration $codecConfiguration)
2{
3 global $bitmovinApi;
4
5 $streamInput = new StreamInput();
6 $streamInput->inputId($input->id);
7 $streamInput->inputPath($inputPath);
8
9 $stream = new Stream();
10 $stream->inputStreams([$streamInput]);
11 $stream->codecConfigId($codecConfiguration->id);
12
13 return $bitmovinApi->encoding->encodings->streams->create($encoding->id, $stream);
14}

After we have defined these functions, we go back to the main workflow and call them:

1// -- Streams --
2// Add an H.264 video stream to the encoding
3$h264Config = createH264Config();
4$h264Stream = createStream($encoding, $input, $inputFilePath, $h264Config);

The first line creates the video codec configuration we want to use. The second line connects the video codec configuration with the input file.

We specify only the input file because in the scope of this tutorial we assume the input file has one video track and one audio track. As the codec config $h264Config is a video config, the system knows that it should use the video track of the input file.

For audio, the code looks similar.

1// Add an AAC Stereo audio stream to the encoding
2$aacConfig = createAacConfig(AacChannelLayout::CL_STEREO());
3$aacStream = createStream($encoding, $input, $inputFilePath, $aacConfig);

Note: Of course the Bitmovin encoder can handle input files with multiple video and audio tracks, and also specify which ones to encode, but this is out of scope of this tutorial where we focus on DRM.

We now have two Stream variables, $h264Stream and $aacStream, which stand for the encoded - but not yet packaged and encrypted - video and audio tracks.

Muxing (Packaging) the Streams for HLS and DASHLink Icon

In order to write down the encoded streams, we must tell the encoder how to package them.

The packaging of encoded streams is called muxing, and this is also the term for the result of the packaging process. A muxing is therefore a packaged set of streams. A muxing can, for example, be an .mp4 or .ts file with audio and video in it. A muxing can also be a set of segments to support streaming formats like HLS and DASH. Examples for this are a set of .ts segments to support HLS, or a set of Fragmented MP4 files (.m4s) to support DASH and newer versions of HLS. The set of Fragmented MP4 (.m4s) segments is called an fMP4 muxing.

In this tutorial, we will package our Streams into fMP4 muxings to support both DASH and HLS.

First, we write a function that creates an fMP4 Muxing from a Stream.

1function createFmp4Muxing(Encoding $encoding, Output $output, string $outputPath, Stream $stream)
2{
3 global $bitmovinApi;
4
5 $muxingStream = new MuxingStream();
6 $muxingStream->streamId($stream->id);
7
8 $muxing = new Fmp4Muxing();
9 $muxing->outputs([buildEncodingOutput($output, $outputPath)]);
10 $muxing->segmentLength(4.0);
11 $muxing->segmentNaming("segment_".$outputPath."_%number%.m4s");
12 $muxing->streams[] = $muxingStream;
13
14 return $bitmovinApi->encoding->encodings->muxings->fmp4->create($encoding->id, $muxing);
15}

The function connects the Stream (via an intermediate object called MuxingStream) to the actual Muxing. The muxing defines the format (fMP4), the segment length in seconds, the segments' file naming template and the output storage and path where the segments will be written.

Back to the main workflow, we call this function twice: once for video and once for audio.

1$fmp4H264Muxing = createfMp4Muxing($encoding, $output, 'fmp4-h264', $h264Stream);
2$fmp4AacMuxing = createfMp4Muxing($encoding, $output, 'fmp4-aac', $aacStream);

We now have the variables $fmp4H264Muxing and $fmp4AacMuxing who each represent a set of segments, one with encoded video and one with encoded audio. These segments are not yet encrypted.

Note: We are creating two muxings (one video, one audio) from one audio/video source file. The reason for this is that the fMP4 muxing format can only handle one stream. This is not a disadvantage, because for Adaptive Bitrate Streaming cases it is more efficient to have video and audio muxings separated anyway.

Encrypting the Muxings for DRM (Widevine, Playready, Fairplay)Link Icon

Now comes the time to actually encrypt the encoded output streams which are packaged in muxings.

For this, we create a DRM configuration. The DRM configuration will be inserted between the muxing and the output. You can also think of the DRM configuration as an encrypted version of the muxing.

Unencrypted muxings have outputs assigned to the outputs field. Muxings that are to be encrypted don't need to populate the outputs field. Instead, the outputs are assigned to the DRM configuration's outputs field.

The function below takes the unencrypted muxing we created in the previous section, and wraps it into a DRM configuration.

For this, it connects the unencrypted $muxing with a locally created $cencDrm object which encrypts the muxing. The $cencDrm object uses the information given in the Prerequisites section of this tutorial.

1function createDrmCbcConfig(Encoding $encoding, Fmp4Muxing $muxing, Output $output, string $outputPath)
2{
3 global $bitmovinApi, $configProvider;
4
5 $cencWidevine = new CencWidevine();
6 $cencWidevine->pssh($configProvider->getDrmWidevinePssh());
7
8 $cencPlayReady = new CencPlayReady();
9 $cencPlayReady->pssh($configProvider->getDrmPlayreadyPssh());
10
11 $cencFairPlay = new CencFairPlay();
12 $cencFairPlay->iv($configProvider->getDrmFairplayIv());
13 $cencFairPlay->uri($configProvider->getDrmFairplayUri());
14
15 $cencDrm = new CencDrm();
16 $cencDrm->outputs([buildEncodingOutput($output, $outputPath)]);
17 $cencDrm->key($configProvider->getDrmKey());
18 $cencDrm->kid($configProvider->getDrmWidevineKid());
19 $cencDrm->widevine($cencWidevine);
20 $cencDrm->playReady($cencPlayReady);
21 $cencDrm->fairPlay($cencFairPlay);
22 $cencDrm->encryptionMode(EncryptionMode::CBC());
23
24 return $bitmovinApi->encoding->encodings->muxings->fmp4->drm->cenc->create($encoding->id, $muxing->id, $cencDrm);
25}

Again, we go back to the main workflow and call this function, once for our video muxing and once for our audio muxing:

1$cencDrmVideo = createDrmCbcConfig($encoding, $fmp4H264Muxing, $output, 'drm-fmp4-h264');
2$cencDrmAudio = createDrmCbcConfig($encoding, $fmp4AacMuxing, $output, 'drm-fmp4-aac');

$cencDrmVideo stands now for an encrypted video muxing. $cencDrmAudio is the associated audio muxing. These muxings can be played with Widevine, Playready and Fairplay.

Smooth Streaming: Muxing and Encrypting with PlayreadyLink Icon

Note: You can skip this section if you don't plan to use the Smooth Streaming format for your content delivery.

So far, this tutorial has dealt with DASH and HLS delivery methods. In some cases however, Smooth Streaming is still a required delivery option, so we now describe how to do the same for Smooth.

While DASH and HLS can share the same muxing, allowing for cost savings on both storage and CDN, Smooth Streaming requires an extra muxing (packaging) format albeit the same encoded streams are contained.

For this, we create a function that writes the encoded Streams into an MP4 Muxing suitable for Smooth Steaming:

1function createMp4MuxingForSmooth(Encoding $encoding, Output $output, string $outputPath, array $streams, string $filename)
2{
3 global $bitmovinApi;
4
5 $muxing = new Mp4Muxing();
6 $muxing->filename($filename);
7 $muxing->fragmentDuration(4000);
8 $muxing->fragmentedMP4MuxingManifestType(FragmentedMp4MuxingManifestType::SMOOTH());
9 $muxing->outputs([buildEncodingOutput($output, $outputPath)]);
10
11 foreach ($streams as $stream) {
12 $muxingStream = new MuxingStream();
13 $muxingStream->streamId($stream->id);
14 $muxing->streams[] = $muxingStream;
15 }
16
17 return $bitmovinApi->encoding->encodings->muxings->mp4->create($encoding->id, $muxing);
18}

And then, we use Playready to encrypt the Smooth Streaming muxings:

1function createSmoothPlayreadyConfig(Encoding $encoding, Mp4Muxing $muxing, Output $output, string $outputPath)
2{
3 global $bitmovinApi, $configProvider;
4
5 $cencPlayReady = new CencPlayReady();
6 $cencPlayReady->pssh($configProvider->getDrmPlayreadyPssh());
7
8 $cencDrm = new CencDrm();
9 $cencDrm->outputs([buildEncodingOutput($output, $outputPath)]);
10 $cencDrm->key($configProvider->getDrmKey());
11 $cencDrm->kid($configProvider->getDrmWidevineKid());
12 $cencDrm->playReady($cencPlayReady);
13 $cencDrm->encryptionMode(EncryptionMode::CTR());
14 $cencDrm->ivSize(IvSize::IV_8_BYTES());
15
16 return $bitmovinApi->encoding->encodings->muxings->mp4->drm->cenc->create($encoding->id, $muxing->id, $cencDrm);
17}

Note: As Smooth Streaming is a Microsoft technology, it uses Playready which is also by Microsoft. No other DRM systems are supported for Smooth.

Back to the main workflow, you now call these functions to get the encrypted muxings for Smooth Streaming.

1 // Smooth Streaming mp4 muxings
2 // Video H.264
3 $mp4H264MuxingSmooth = createMp4MuxingForSmooth($encoding, $output, 'smooth', [$h264Stream], 'video.ismv');
4 $smoothDrmVideo = createSmoothPlayreadyConfig($encoding, $mp4H264MuxingSmooth, $output, 'smooth-drm');
5 // Audio AAC
6 $mp4AacMuxingSmooth = createMp4MuxingForSmooth($encoding, $output, 'smooth', [$aacStream], 'audio.isma');
7 $smoothDrmAudio = createSmoothPlayreadyConfig($encoding, $mp4AacMuxingSmooth, $output, 'smooth-drm');

The variables $smoothDrmVideo and $smoothDrmAudio now stand for the encrypted Smooth Streaming muxings we created.

Run the EncodingLink Icon

Now that we have everything configured

  • the source file's audio and video tracks connected to the H.264 and AAC configuration as Streams
  • the streams connected to fMP4 (or MP4) configurations as Muxings
  • the muxings connected to DRM configurations and output locations as encrypted Muxings

we can now actually start the encoding, by calling in the main workflow:

1// -- Run the encoding --
2executeEncoding($encoding);

For details of the exectueEncoding() function (which is standard for all kinds of encodings) please see the actual example script.

Creating Manifest for DASHLink Icon

After the encoding is finished, the audio and video segments have been created, but for HLS and DASH playback we also need to create manifests. The manifests tell the player where to get the segments and also where to get the DRM key to decrypt them.

In this section we show how to create the DASH manifest. Because this is much code, we pack it into a function:

1function generateDashDrmManifest(Encoding $encoding, Output $output, string $outputPath, string $streamName,
2 Muxing $videoMuxing, Muxing $audioMuxing, CencDrm $cencDrmVideo, CencDrm $cencDrmAudio)
3{
4 global $bitmovinApi;
5
6 // the manifest itself
7 $dashManifest = new DashManifest();
8 $dashManifest->name($streamName.'.mpd');
9 $dashManifest->description('A DASH manifest');
10 $dashManifest->outputs([buildEncodingOutput($output, $outputPath)]);
11 $dashManifest->profile(DashProfile::LIVE());
12 $dashManifest->manifestName($streamName.'.mpd');
13 $dashManifest = $bitmovinApi->encoding->manifests->dash->create($dashManifest);
14
15 // the period
16 $period = new Period();
17 $period->start(0);
18 $period = $bitmovinApi->encoding->manifests->dash->periods->create($dashManifest->id, $period);
19
20 // the video adaptation set
21 $videoAdaptationSet = new VideoAdaptationSet();
22 $videoAdaptationSet->roles([AdaptationSetRole::MAIN()]);
23 $videoAdaptationSet = $bitmovinApi->encoding->manifests->dash->periods->adaptationsets->video->create(
24 $dashManifest->id, $period->id, $videoAdaptationSet);
25 $contentProtectionAdded = false;
26 // representations - one for each quality
27 if (!$contentProtectionAdded) {
28 $contentProtection = new ContentProtection();
29 $contentProtection->drmId($cencDrmVideo->id);
30 $contentProtection->encodingId($encoding->id);
31 $contentProtection->muxingId($videoMuxing->id);
32 $bitmovinApi->encoding->manifests->dash->periods->adaptationsets->contentprotection->create($dashManifest->id, $period->id, $videoAdaptationSet->id, $contentProtection);
33 $contentProtectionAdded = true;
34 }
35 $dashFMp4RepresentationVideo = new DashFmp4Representation();
36 $dashFMp4RepresentationVideo->encodingId($encoding->id);
37 $dashFMp4RepresentationVideo->muxingId($videoMuxing->id);
38 $dashFMp4RepresentationVideo->type(DashRepresentationType::TEMPLATE());
39 $dashFMp4RepresentationVideo->mode(DashRepresentationTypeMode::TEMPLATE_REPRESENTATION());
40 $dashFMp4RepresentationVideo->segmentPath(basename($cencDrmVideo->outputs[0]->outputPath));
41 $dashFMp4RepresentationVideo =
42 $bitmovinApi->encoding->manifests->dash->periods->adaptationsets->representations->fmp4->create(
43 $dashManifest->id,
44 $period->id,
45 $videoAdaptationSet->id,
46 $dashFMp4RepresentationVideo);
47
48 // audio adaptation set
49 $audioAdaptationSet = new AudioAdaptationSet();
50 $audioAdaptationSet->roles([AdaptationSetRole::MAIN()]);
51 $audioAdaptationSet->lang("en");
52 $audioAdaptationSet = $bitmovinApi->encoding->manifests->dash->periods->adaptationsets->audio->create($dashManifest->id,
53 $period->id, $audioAdaptationSet);
54
55 $contentProtection = new ContentProtection();
56 $contentProtection->drmId($cencDrmAudio->id);
57 $contentProtection->encodingId($encoding->id);
58 $contentProtection->muxingId($audioMuxing->id);
59 $bitmovinApi->encoding->manifests->dash->periods->adaptationsets->contentprotection->create($dashManifest->id,
60 $period->id, $audioAdaptationSet->id, $contentProtection);
61
62 // representation
63 $dashFMp4RepresentationAudio = new DashFmp4Representation();
64 $dashFMp4RepresentationAudio->encodingId($encoding->id);
65 $dashFMp4RepresentationAudio->muxingId($audioMuxing->id);
66 $dashFMp4RepresentationAudio->type(DashRepresentationType::TEMPLATE());
67 $dashFMp4RepresentationAudio->mode(DashRepresentationTypeMode::TEMPLATE_REPRESENTATION());
68 $dashFMp4RepresentationAudio->segmentPath(basename($cencDrmAudio->outputs[0]->outputPath));
69 $dashFMp4RepresentationAudio =
70 $bitmovinApi->encoding->manifests->dash->periods->adaptationsets->representations->fmp4->create(
71 $dashManifest->id,
72 $period->id,
73 $audioAdaptationSet->id,
74 $dashFMp4RepresentationAudio);
75
76 executeDashManifestCreation($dashManifest);
77}

We can see that this function takes a lot of the elements we created so far in the script:

  • the audio and video muxings
  • the encrypted muxings for Widevine and Playready
  • the output
  • and a name for the manifest, called streamName because this will represent the playback stream to players outside.

Note:The DASH manifest re-unites the audio and video muxings in one manifest. The outside player only needs the URL to this manifest to get to the audio and video segments and play back the whole presentation.

Note:The DASH manifest only contains encrypted muxings for Widevine and PlayReady, not for Fairplay. The reason is that Apple devices using Fairplay also use HLS and not DASH.

In the main workflow, we call this function to create the DASH manifest:

1generateDashDrmManifest($encoding, $output, "", "streamDrm",
2 $fmp4H264Muxing, $fmp4AacMuxing, $cencDrmVideo, $cencDrmAudio);

The manifest will be created on the output with the given streamName.

Creating manifests for HLSLink Icon

Like with DASH, the creation of manifests for HLS is packed in a function:

1function generateHlsFairplayManifest(Encoding $encoding, Output $output, string $outputPath, string $streamName,
2 Muxing $videoMuxing, Muxing $audioMuxing,
3 CencDrm $cencDrmVideo, CencDrm $cencDrmAudio)
4{
5 global $bitmovinApi;
6
7 // the manifest itself
8 $hlsManifest = new HlsManifest();
9 $hlsManifest->name($streamName . ".m3u8");
10 $hlsManifest->description('A HLS Fairplay manifest');
11 $hlsManifest->outputs([buildEncodingOutput($output, $outputPath)]);
12 $hlsManifest->manifestName($streamName . ".m3u8");
13 $hlsManifest = $bitmovinApi->encoding->manifests->hls->create($hlsManifest);
14
15 // audio group
16 $audioGroupId = 'audio';
17
18 // add audio media
19 $audioMediaInfo = new AudioMediaInfo();
20 $audioMediaInfo->name('DRM en');
21 $audioMediaInfo->encodingId($encoding->id);
22 $audioMediaInfo->groupId($audioGroupId);
23 $audioMediaInfo->streamId($audioMuxing->streams[0]->streamId);
24 $audioMediaInfo->muxingId($audioMuxing->id);
25 $audioMediaInfo->language('en');
26 $audioMediaInfo->drmId($cencDrmAudio->id);
27 $audioMediaInfo->segmentPath(basename($cencDrmAudio->outputs[0]->outputPath));
28 $audioMediaInfo->uri('audio_' . $streamName . '.m3u8');
29 $audioMediaInfo = $bitmovinApi->encoding->manifests->hls->media->audio->create($hlsManifest->id, $audioMediaInfo);
30
31 // add video variant
32 $streamInfo = new StreamInfo();
33 $streamInfo->encodingId($encoding->id);
34 $streamInfo->streamId($videoMuxing->streams[0]->streamId);
35 $streamInfo->muxingId($videoMuxing->id);
36 $streamInfo->audio($audioGroupId);
37 $streamInfo->segmentPath(basename($cencDrmVideo->outputs[0]->outputPath));
38 $streamInfo->uri('video_' . $streamName . '.m3u8');
39 $streamInfo->drmId($cencDrmVideo->id);
40 $streamInfo = $bitmovinApi->encoding->manifests->hls->streams->create($hlsManifest->id, $streamInfo);
41
42 executeHlsManifestCreation($hlsManifest);
43}

We can see that this function takes a lot of the elements we created so far in the script:

  • the audio and video muxings
  • the encrypted muxings
  • the output
  • and a name for the manifest, called streamName because this will represent the playback stream to players outside.

Note The HLS manifest only uses the Fairplay DRM system, because Apple devices use both in conjunction (HLS and Fairplay are Apple standards). Non-Apple devices will use DASH and non-Fairplay DRM systems.

In the main workflow, we call this function to create the HLS manifests (aka master playlist, audio and video playlists):

1generateHlsFairplayManifest($encoding, $output, "", "streamFmp4Drm",
2 $fmp4H264Muxing, $fmp4AacMuxing, $cencDrmVideo, $cencDrmAudio);

Creating Manifests for SmoothLink Icon

If we use Smooth Streaming, we need to create manifests for it as well. First we write the function to create the manifests:

1function generateSmoothStreamingDrmManifest(Encoding $encoding, Output $output, string $outputPath,
2 Mp4muxing $mp4H264Muxing, Mp4Muxing $mp4AacMuxing,
3 CencDrm $smoothDrmVideo, CencDrm $smoothDrmAudio)
4{
5 global $bitmovinApi;
6
7 $smoothStreamingManifest = new SmoothStreamingManifest();
8 $smoothStreamingManifest->name('Smooth Streaming Manifest with DRM');
9 $smoothStreamingManifest->serverManifestName('stream.ism');
10 $smoothStreamingManifest->clientManifestName('stream.ismc');
11 $smoothStreamingManifest->outputs([buildEncodingOutput($output, $outputPath)]);
12 $smoothStreamingManifest
13 = $bitmovinApi->encoding->manifests->smooth->create($smoothStreamingManifest);
14
15 // add video representation
16 $cencDrm = $smoothDrmVideo;
17 $contentProtectionVideo = new SmoothManifestContentProtection();
18 $contentProtectionVideo->drmId($cencDrm->id);
19 $contentProtectionVideo->muxingId($mp4H264Muxing->id);
20 $contentProtectionVideo->encodingId($encoding->id);
21 $contentProtectionVideo = $bitmovinApi->encoding->manifests->smooth->contentprotection->create(
22 $smoothStreamingManifest->id,
23 $contentProtectionVideo);
24
25 $mp4RepresentationVideo = new SmoothStreamingRepresentation();
26 $mp4RepresentationVideo->encodingId($encoding->id);
27 $mp4RepresentationVideo->muxingId($mp4H264Muxing->id);
28 $mp4RepresentationVideo->mediaFile('video.ismv');
29 $mp4RepresentationVideo->trackName('video');
30 $mp4RepresentationVideo->priority(30);
31 $mp4RepresentationVideo
32 = $bitmovinApi->encoding->manifests->smooth->representations->mp4->create($smoothStreamingManifest->id, $mp4RepresentationVideo);
33
34 // add audio representation
35 $cencDrm = $smoothDrmAudio;
36 $contentProtection = new SmoothManifestContentProtection();
37 $contentProtection->drmId($cencDrm->id);
38 $contentProtection->muxingId($mp4AacMuxing->id);
39 $contentProtection->encodingId($encoding->id);
40 $contentProtection = $bitmovinApi->encoding->manifests->smooth->contentprotection->create(
41 $smoothStreamingManifest->id,
42 $contentProtection);
43
44 $mp4RepresentationAudio = new SmoothStreamingRepresentation();
45 $mp4RepresentationAudio->encodingId($encoding->id);
46 $mp4RepresentationAudio->muxingId($mp4AacMuxing->id);
47 $mp4RepresentationAudio->mediaFile('audio.isma');
48 $mp4RepresentationAudio->language('en');
49 $mp4RepresentationAudio->trackName('audio');
50 $mp4RepresentationAudio->priority(20);
51 $mp4RepresentationAudio
52 = $bitmovinApi->encoding->manifests->smooth->representations->mp4->create($smoothStreamingManifest->id, $mp4RepresentationAudio);
53
54 executeSmoothManifestCreation($smoothStreamingManifest);
55}

and then, back to the main workflow, we call the function:

1generateSmoothStreamingDrmManifest($encoding, $output, "smooth-drm",
2 $mp4H264MuxingSmooth, $mp4AacMuxingSmooth, $smoothDrmVideo, $smoothDrmAudio);

The Output FilesLink Icon

After running this script, all generated files will be on the S3 bucket named in the examples.properties file in the parameter S3_OUTPUT_BUCKET_NAME.

The files are in the main output directory, which is

  • the path written in the S3_OUTPUT_BASE_PATH parameter in examples.properties, plus
  • the $exampleName variable as subdirectory.

The files are:

  • drm-fmp4-h264/ - contains encoded and encrypted video segments for DASH and HLS
  • drm-fmp4-aac/ - contains encoded and encrypted audio segments for DASH and HLS
  • audio_streamFmp4Fairplay.m3u8 - HLS audio playlist
  • video_streamFmp4Fairplay.m3u8 - HLS video playlist
  • streamFmp4Fairplay.m3u8 - HLS master playlist (manifest), works with Fairplay
  • streamDRM.mpd - DASH manifest, works with Widevine and Playready

If you encoded your content also for Smooth Streaming, you will additionally see:

  • smooth-drm/ - contains content and manifest files for Smooth Streaming.

Preparing the Output Files for PlaybackLink Icon

In order to playback the files created by the Bitmovin encoder, you need to place them on a web server. In case of DASH and HLS, this can be any web server. The simplest way is to stream them directly from the S3 bucket. For this, just enable public HTTPS access to the files on the S3 bucket.

The URLs to the manifests will look like:

1https://server.com/path/to/manifest/streamDrm.mpd
2https://server.com/path/to/manifest/streamFmp4Fairplay.m3u8

The Smooth Streaming files cannot be served from an arbitrary web server, they have to be placed on a Microsoft IIS server (Please consult your Microsoft documentation for using a Microsoft IIS server for Smooth Streaming). When the Bitmovin encoded files are stored there, the URL will look like:

1http://microsoft_iis_server.com/path/to/manifest/smooth.ism/Manifest

Playback with Bitmovin PlayerLink Icon

After you have encoded and encrypted the content, you want your users to play it back according to the licenses they bought.

Vualto has prepared a page describing how to play back protected content with the Bitmovin player:

https://docs.vualto.com/projects/vudrm/en/latest/integrations/players/bitmovin.html

Give us feedback