Developer Center

Legacy

NOTE: We’ve recently updated our service. Learn more

If your Service Admin interface looks like this example, we’ve not yet migrated you to the new service.
Click here to see the Legacy Getting Started with ExpressPlay Tutorial

Getting Started with ExpressPlay

These tutorials take you through the step-by-step process on how to package the content and to use the ExpressPlay Service for streaming and download use cases.


Requirements

  • An MP4 file e.g. big_buck_bunny.mp4
  • Download and install the Bento4 tools (available from bento4.com)
  • An HTTP server running on your computer
  • An Android or IOS device connected to the same WiFi and subnet of your HTTP Server e.g. your mobile device can reach your HTTP Server
  • Download the ExpressPlayer application for either iOS or Android
  • An ExpressPlay account that can be obtained at https://portal.expressplay.com
  • The ExpressPlay client test SDK for either iOS or Android or for both

Part A: Play DASH content using the ExpressPlayer app with MS3 token

STEP 1

Fragment your MP4 file

  • MPEG DASH format requires the MP4 files to be fragmented
  • Open the terminal to the folder that has the MP4 file
  • Use the bento4 tool ‘mp4fragment,’ type the name of your MP4 file and the name of the output fragmented MP4 file.
  • For example:
    mp4fragment big_buck_bunny.mp4 big_buck_bunny.mf4

STEP 2

Package and encrypt your content into DASH format

  • Always use the Bento4 tool MP4DASH to encrypt and package your content into DASH format.
  • You can do by typing the following:
    mp4dash --encryption-key=43215678123412341234123412341234:12341234123412341234123412341234 --marlin big_buck_bunny.mf4
  • Notice:
    • – The command option —encryption-key indicates the content encryption key (CK) to use and it is followed by the key-id (KID) . In this case the value of the KID is equal to: 43215678123412341234123412341234 while the KEY is equal to: 12341234123412341234123412341234
    • – The command option —marlin indicates that you want to use Marlin DRM. As MPEG-DASH is a streaming format supported by other DRMs like PlayReady and Widevine, it is possible to use the same MP4DASH tool to signal the use of different DRMs schema within the same stream. For now, we will focus on Marlin.

STEP 3

Copy the whole “output” folder to your HTTP Server working folder

  • Create a folder in your HTTP Web Server working directory.
    • – For example on a Mac:
      mkdir /Library/WebServer/Documents/video/expressplay
  • Copy the content of the output folder into the newly created folder.
    • – For example on a Mac:
      cp -R output/ /Library/WebServer/Documents/video/expressplay
  • Note:
    • – The commands above are just an example, your HTTP Server may have a different folder structure and therefore the folder path may differ from the one provided above.
    • – You must configure the MIME-TYPE of your HTTP Server to handle the mime-type for the DASH manifest descriptor file or mpd files. The mime-type for the mpd file needs to be set to application/DASH+xml

STEP 4

Create an MS3 URL

Create an MS3 URL using the REST API using the following parameters:

  1. customerAuthenticator = Your customer authenticator
  2. contentID = This should be a unique identifier, for example one derived from the keyId from step 2 (urn:marlin:kid:43215678123412341234123412341234)
  3. contentKey = This should be the key from step 2 (12341234123412341234123412341234)
  4. contentURL = This should point the location of the MPD on your HTTP Server from Step 3 ( http://video/expressplay/stream.mpd)

Below is a sample request that generates an MS3 url and stores it in a file.

curl -d "customerAuthenticator=YOUR_CUSTOMER_AUTHENTICATOR_CODE&contentId=urn:marlin:kid:43215678123412341234123412341234&contentKey=12341234123412341234123412341234&ms3Extension=wudo,false,AAAAAA==&contentURL=http://gittahnc.s3-website-us-west-1.amazonaws.com/expressPlay/tutorial1/output/stream.mpd" https://ms3-gen.test.expressplay.com/hms/ms3/token > ms3_token.txt

STEP 5

Play Content using the ExpressPlayer App

  1. Download the ExpressPlayer App from the Google Play Store
  2. Open the ExpressPlayer App
  3. Click on “Video”
  4. Select DASH
  5. Paste the MS3 URL obtained from Step 5
  6. Select MS3
  7. Click “Play”

Part B: Play DASH content using your own iOS app, with MS3 token

STEP 1

Fragment your MP4 file

  • MPEG DASH format requires the MP4 files to be fragmented
  • Open the terminal to the folder that has the MP4 file
  • Use the bento4 tool ‘mp4fragment,’ type the name of your MP4 file and the name of the output fragmented MP4 file.
  • For example:
    mp4fragment big_buck_bunny.mp4 big_buck_bunny.mf4

STEP 2

Package and encrypt your content into DASH format

  • Always use the Bento4 tool MP4DASH to encrypt and package your content into DASH format.
  • You can do by typing the following:
    mp4dash --encryption-key=43215678123412341234123412341234:12341234123412341234123412341234 --marlin big_buck_bunny.mf4
  • Notice:
    • – The command option —encryption-key indicates the content encryption key (CK) to use and it is followed by the key-id (KID) . In this case the value of the KID is equal to: 43215678123412341234123412341234 while the KEY is equal to: 12341234123412341234123412341234
    • – The command option —marlin indicates that you want to use Marlin DRM. As MPEG-DASH is a streaming format supported by other DRMs like PlayReady and Widevine, it is possible to use the same MP4DASH tool to signal the use of different DRMs schema within the same stream. For now, we will focus on Marlin.

STEP 3

Copy the whole “output” folder to your HTTP Server working folder

  • Create a folder in your HTTP Web Server working directory.
    • – For example on a Mac:
      mkdir /Library/WebServer/Documents/video/expressplay
  • Copy the content of the output folder into the newly created folder.
    • – For example on a Mac:
      cp -R output/ /Library/WebServer/Documents/video/expressplay
  • Note:
    • – The commands above are just an example, your HTTP Server may have a different folder structure and therefore the folder path may differ from the one provided above.
    • – You must configure the MIME-TYPE of your HTTP Server to handle the mime-type for the DASH manifest descriptor file or mpd files. The mime-type for the mpd file needs to be set to application/DASH+xml

STEP 4

Create an MS3 URL

Create an MS3 URL using the REST API using the following parameters:

  1. customerAuthenticator = Your customer authenticator
  2. contentID = This should be a unique identifier, for example one derived from the keyId from step 2 (urn:marlin:kid:43215678123412341234123412341234)
  3. contentKey = This should be the key from step 2 (12341234123412341234123412341234)
  4. contentURL = This should point the location of the MPD on your HTTP Server from Step 3 ( http://video/expressplay/stream.mpd)

Below is a sample request that generates an MS3 url and stores it in a file.

curl -d "customerAuthenticator=YOUR_CUSTOMER_AUTHENTICATOR_CODE&contentId=urn:marlin:kid:43215678123412341234123412341234&contentKey=12341234123412341234123412341234&ms3Extension=wudo,false,AAAAAA==&contentURL=http://gittahnc.s3-website-us-west-1.amazonaws.com/expressPlay/tutorial1/output/stream.mpd" https://ms3-gen.test.expressplay.com/hms/ms3/token > ms3_token.txt

STEP 5

SDK Download

  1. Log in to your ExpressPlay account
  2. Select “DRM Services”
  3. Download the test iOS SDK

Note: ExpressPlay provides test and production SDKs and associated cloud service. Development and testing should be done using the test SDK while production SDKs must be used with a commercial service


STEP 6

iOS Sample

  1. Open the ExpressPlayExample project in Xcode
  2. Open the ViewController.m file within the project
  3. Replace the value of the MS3URL variable with the one obtained in step 5
  4. Set the media stream type to WSB_PPMST_DASH
  5. Run your code (you can choose to run it on an emulator or an iOS device)

Part C: How to package and to play your own protected DASH content on a browser with Widevine

Overview

  • This tutorial will cover the following:
    • To package of a video into DASH format with PlayReady, Widevine and Marlin signaling.
    • To request a PlayReady and a Widevine token via command line
    • To play the content from a web browser

Assumptions


STEP 1

Fragment your MP4 file

  • MPEG DASH format requires the MP4 files to be fragmented
  • Open the terminal to the folder that has the MP4 file
  • Use the bento4 tool ‘mp4fragment,’ type the name of your MP4 file and the name of the output fragmented MP4 file.
  • For example:
    mp4fragment video_mango.mp4 video_mango.mf4

STEP 2

Create the DASH content

  • Open the terminal to the folder where you have you MP4 file
  • Use the bento4 tool mp4dash and type the following:
    mp4dash --encryption-key=12341234123412341234123412341234:43215678123412341234123412341234 --marlin --widevine --widevine-header=provider:intertrust#content_id:2a --playready --playready-header=https://pr.service.expressplay.com/playready/RightsManager.asmx video_mango.mf4
  • We do suggest to study documentation of each of the bento4 tool

STEP 3

Copy the “output” folder to your S3 bucket

  • Copy the “output” folder obtained from the previous step into a S3 bucket
  • Ensure that the mime-type of the .mpd file is set to: application/dash+xml
  • Ensure that all the files within the buckets output folder are “made public”

STEP 4

Setting CORS Configurations

  • Set the CORS of your S3 bucket as following:
    <?xml version="1.0" encoding="UTF-8"?>
    <CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
    <AllowedOrigin>*</AllowedOrigin>
    <AllowedMethod>GET</AllowedMethod>
    <AllowedMethod>POST</AllowedMethod>
    <MaxAgeSeconds>3500</MaxAgeSeconds>
    <AllowedHeader>*</AllowedHeader>
    </CORSRule>
    </CORSConfiguration>

STEP 5

Request content licenses

  • Using the command line:
  • Widevine token request:
    curl -k 'https://wv-gen.service.expressplay.com/hms/wv/token?customerAuthenticator=YOUR_CUSTOMER_AUTHENTICATOR_CODE&errorFormat=json&kid=12341234123412341234123412341234&contentKey=43215678123412341234123412341234&securityLevel=1&hdcpOutputControl=0'
  • curl -k 'https://pr-gen.service.expressplay.com/hms/pr/token?customerAuthenticator=YOUR_CUSTOMER_AUTHENTICATOR_CODE&errorFormat=json&kid=12341234123412341234123412341234&contentKey=43215678123412341234123412341234&rightsType=BuyToOwn&analogVideoOPL=100&compressedDigitalAudioOPL=100&compressedDigitalVideoOPL=100&uncompressedDigitalAudioOPL=100&uncompressedDigitalVideoOPL=100'
  • Please refer to the ExpressPlay Service API documentation for: https://www.expressplay.com/developer/restapi/

STEP 6

Playback on Chrome / Shakaplayer and Widevine

  • Using the Shaka Player player from: http://shaka-player-demo.appspot.com/demo/
  • Select “custom asset”
  • Copy the URL of the .mpd file to the first input filed
  • Copy the License Acquisition URL including the token, from the Widevine token request, to second input field.