ExpressPlayer Tutorial
This tutorial explains how to use the ExpressPlayer app to validate your ExpressPlay packaged content. The ExpressPlayer app is available at the iOS App Store and soon at the Google Play app store.
Screencast: There is a short video that walks you through the basic steps HERE. (MP4 video)
ExpressPlayer is an Android and iOS application used for validating ExpressPlay packaged content quickly. It can play any ExpressPlay-protected DASH, HLS or MP4 media using ExpressPlay test tokens. The app has two methods for accepting content for validation: the Video tab and the Playlist tab.
If you select the Video tab, you can input the content url and optionally a separate token url in the case of Marlin BB tokens. If you select the Playlist tab, you can input the url to your playlist file which contains a list of all the content you wish to validate. This tutorial will explain the steps to validate your content in each case.
Below is a screen shot of the ExpressPlayer playlist view.
Validate one media item
In the ExpressPlayer app, select the Video tab. You will see two drop menus, one to select a content format and one to select a token format. First you should select the content format matching the content you wish to validate. The choices are: DASH, HLS or MP4.
The second drop menu is where you select the token format you wish to use for playback. You can choose Marlin MS3 or Marlin BB. If you select Marlin BB an additional input box appears immediately under the token format selection. This is because Marlin BB does not include the token within the content URL as Marlin MS3 does, so you will need to provide a separate URL to a text file containing the Marlin BB token.
EXAMPLE MARLIN MS3 TOKEN
https://ms3.test.expressplay.com:8443/hms/ms3/rights/?b=AAwAAwAAAxkAAlRXPGAAECBR0l7K6dxdkxUSrLNplXUAcDb87DeJyouvcWEmW_-VnmUCGj3vNRJP5f3R_455AWnHcflhQYwJ-O1XUvJYJGK_xtVeEXdJ6DFnwSyo5sRo0ewSCcp-S3MDZGtH2KvXzPBawG45q-VUIc9h2qBpjlnbmqzDkSXpNDm8SwKE0v2MzY0AAAAU6O8AXt97WK0NMFGHgfcAidReoRE#http%3A%2F%2Fd31lwto7rjo21l.cloudfront.net%2Fvideo%2FExpressPlayerDASH-BBB%2Fstream.mpd
EXAMPLE MARLIN BB TOKEN
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ActionToken xmlns="urn:marlin:broadband:1-2:nemo:services:action-token" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ConfigurationInfo broadbandServiceId="urn:marlin:organization:seacert:eval-marlin-service:500" configVersion="1">
<ResourceLocation>http://bb.eval.hostedmarlin.com:80/mbs/ConfigurationToken.xml</ResourceLocation>
</ConfigurationInfo>
<LicenseAcquisition>
<Type>personality</Type>
<BusinessToken>ABEAAwAAAzkAB2dpbGRyZWQ/GAAQhbwUuAlKt1qwAW9wfnwlPwBgPt0Wlt7OtQNM+KKjzKavyW1MFNr2HBQhkEqmw6Oky4olJAJw3lbauD/qLG18BIvAILq3JuEDKavsDQynE2xeSkNIbk3xOUV1KVglJptmxkw3ycKAit7davhjqZ2SbN25AAAAFLlCRMijOdxPFgCsA/DMHo4CvQ0T</BusinessToken>
</LicenseAcquisition>
</ActionToken>
EXAMPLE PLAYREADY TOKEN
{"licenseAcquisitionUrl":"https://expressplay-licensing.axprod.net/LicensingService.ashx","token":"AQAAAAOzW5MAAABgHhvu7w8J6Yv1OXLOX_afCzO795jxa7Wyse751oV7yizHHWHmBge7fcuthEZCnQSNLamcN4aAzLKkH6hMe9yuFrDv-m9z7iJfrbxjDgXHUnN1aGqZGxJ6bgYwS7t9law1nAPdX-vor6QYfAOeNgU_IcLuJR8"}
In the input box just below the content format selection, enter the URL of the protected content. If the selected token format is Marlin MS3, you simply use the MS3 token as your content URL. If you do not have packaged content to play, you can retrieve an MS3 Token URL for our example encrypted HLS video from this web page. If the selected token format is Marlin BB, then you should enter the URL to the protected MP4 file, or in the case of DASH and HLS, enter the URL to the manifest file.
Validate multiple media items
You can create a playlist for easy validation of multiple media items. To do this you need to create a playlist file that ExpressPlayer can read and display the itemized media where you can simply tap on each media item to check playback. The playlist file is a JSON file containing an array of media items.
A formal and unambiguous description of the JSON schema used for the playlist list file format can be viewed here. This schema is itself written in JSON, based on the JSON Schema Internet Draft specification found at: http://tools.ietf.org/html/draft-zyp-json-schema-04. A specific playlist file can be checked against this schema for format correctness.
The playlist file can contain as many media items as desired, although each item listed must contain several different types of information. Each media item requires at least a title, container and content URL. This information is grouped into blocks, one block per media item in the playlist. See the example block below for a DASH formatted media item using a Marlin MS3 token.
[
{
"title": "Big Buck Bunny (DASH MS3)",
"container": "DASH",
"url": "https://ms3.test.expressplay.com:8443/hms/ms3/rights/?b=AAwAAwAAAxkAAlRXPGAAECBR0l7K6dxdkxUSrLNplXUAcDb87DeJyouvcWEmW_-VnmUCGj3vNRJP5f3R_455AWnHcflhQYwJ-O1XUvJYJGK_xtVeEXdJ6DFnwSyo5sRo0ewSCcp-S3MDZGtH2KvXzPBawG45q-VUIc9h2qBpjlnbmqzDkSXpNDm8SwKE0v2MzY0AAAAU6O8AXt97WK0NMFGHgfcAidReoRE#http%3A%2F%2Fd31lwto7rjo21l.cloudfront.net%2Fvideo%2FExpressPlayerDASH-BBB%2Fstream.mpd"
}
]
The example above contains a title which will display in the ExpressPlayer playlist once the playlist file is loaded.
The next attribute is the container which is required. The allowed container values are:
- DASH (DASH format using Marlin MS3 token)
- HLS (HLS format using Marlin MS3 token)
- BBTS (MPEG-TS format using Marlin BB token)
- PDCF (MP4 format using Marlin BB token)
- DCF (MP4 format using Marlin BB token)
- M4F (Fragmented MP4 file with common encryption, using Marlin BB token)
The url attribute points to the content url. If DASH MS3 or HLS MS3, then the url is simply the MS3 tokenized content URL which gives you the location of the content and info on how to get the token. If the media type is PDCF, then there should also be a separate token attribute pointing to a url where the token can be found.
Downloadable content such as MP4 (PDCF) requires a Marlin BB token. In such case both the token URL and content URL must be included in the block. As usual, the content URL is placed on the last line of the block. See the example block below for an ExpressPlay-protected PDCF media item using a Marlin BB token.
[
{
"title": "Big Buck Bunny Mobile (MP4)",
"container": "PDCF",
"url": "http://d31lwto7rjo21l.cloudfront.net/video/mobileBBB.mlv",
"token": "http://testtokens.expressplay.com/?type=bb&id=YWN0aW9uVG9rZW5UeXBlPTEmY29udGVudElkPXVybjptYXJsaW46b3JnYW5pemF0aW9uOmhtczo4cHVzbGljOjAwMDAwMDAwMDEwZjUxMDA3MDAwMDAwMDAwMDAwMDAwN2YwMDAwMDAwMDAwMDEwMCZjb250ZW50S2V5PTAwMDEwMjAzMDQwNTA2MDcwODA5MGEwYjBjMGQwZTBmJnJpZ2h0c1R5cGU9QnV5VG9Pd24="
}
]
As before, the last line is where you put the content URL. In this case the content URL points to the protected MP4.
Note: When a Marlin MS3 token is used, the token attribute will be ignored by ExpressPlayer.
Indirect content URLs: When using MS3 tokens, if you want ExpressPlayer to use the response from the content URL as the actual content URL, use the indirect attribute. In such case the content URL is not an MS3 tokenized URL, but instead it is a URL which returns an MS3 tokenized URL. ExpressPlayer will understand this, and fetch the content URL, then use the response as the actual content URL to fetch the content and process the MS3 token. This is very useful as the MS3 tokenized url has an expiration, so you likely don't want to hard code that into the playlist. If you are dynamically generating the JSON playlist, then this may not be as useful. See the example below.
[
{
"title": "Big Buck Bunny (HLS MS3)",
"container": "HLS",
"indirect": true,
"url": "http://mobile-test.intertrust.com/cgi-bin/get-token?BUNNY-MS3HLS"
}
]
Put the playlist on the web
You will need to put your playlist file on a web server which is accessible to the ExpressPlayer app. Make sure your playlist is formatted correctly.
See below for an example of a complete playlist file.
[
{
"title": "Big Buck Bunny (HLS MS3)",
"container": "HLS",
"indirect": true,
"url": "http://mobile-test.intertrust.com/cgi-bin/get-token?BUNNY-MS3HLS"
},
{
"title": "Big Buck Bunny (DASH MS3)",
"container": "DASH",
"indirect": true,
"url": "http://testtokens.expressplay.com/?id=Y29udGVudElkPXVybjptYXJsaW46a2lkOjY3ODk1NDMyOTg3NjIzNDU0NzU2NjU0NzI5MzgyMzQxJmNvbnRlbnRLZXk9NDMyMTA5ODcxMjM0Nzg5MDQzMjEwOTg3MTIzNDA5ODcmbXMzU2NoZW1lPXRydWUmY29udGVudFVSTD1odHRwOi8vZDMxbHd0bzdyam8yMWwuY2xvdWRmcm9udC5uZXQvdmlkZW8vRXhwcmVzc1BsYXllckRBU0gtQkJCL3N0cmVhbS5tcGQ="
},
{
"title": "Big Buck Bunny Mobile (MP4)",
"container": "PDCF",
"url": "http://d31lwto7rjo21l.cloudfront.net/video/mobileBBB.mlv",
"token": "http://testtokens.expressplay.com/?type=bb&id=YWN0aW9uVG9rZW5UeXBlPTEmY29udGVudElkPXVybjptYXJsaW46b3JnYW5pemF0aW9uOmhtczo4cHVzbGljOjAwMDAwMDAwMDEwZjUxMDA3MDAwMDAwMDAwMDAwMDAwN2YwMDAwMDAwMDAwMDEwMCZjb250ZW50S2V5PTAwMDEwMjAzMDQwNTA2MDcwODA5MGEwYjBjMGQwZTBmJnJpZ2h0c1R5cGU9QnV5VG9Pd24="
},
{
"title": "Big Buck Bunny 480p (MP4)",
"container": "PDCF",
"url": "http://d31lwto7rjo21l.cloudfront.net/video/480pBBB.mlv",
"token": "http://testtokens.expressplay.com/?type=bb&id=YWN0aW9uVG9rZW5UeXBlPTEmY29udGVudElkPXVybjptYXJsaW46b3JnYW5pemF0aW9uOmhtczo4cHVzbGljOjAwMDAwMDAwMDEwZjUxMDA3MDAwMDAwMDAwMDAwMDAwN2YwMDAwMDAwMDAwMDEwMCZjb250ZW50S2V5PTAwMDEwMjAzMDQwNTA2MDcwODA5MGEwYjBjMGQwZTBmJnJpZ2h0c1R5cGU9QnV5VG9Pd24="
},
{
"title": "Big Buck Bunny 720p (MP4)",
"container": "PDCF",
"url": "http://d31lwto7rjo21l.cloudfront.net/video/720pBBB.mlv",
"token": "http://testtokens.expressplay.com/?type=bb&id=YWN0aW9uVG9rZW5UeXBlPTEmY29udGVudElkPXVybjptYXJsaW46b3JnYW5pemF0aW9uOmhtczo4cHVzbGljOjAwMDAwMDAwMDEwZjUxMDA3MDAwMDAwMDAwMDAwMDAwN2YwMDAwMDAwMDAwMDEwMCZjb250ZW50S2V5PTAwMDEwMjAzMDQwNTA2MDcwODA5MGEwYjBjMGQwZTBmJnJpZ2h0c1R5cGU9QnV5VG9Pd24="
}
]
This is the default playlist file loaded by the ExpressPlayer app. To load your custom playlist file, open the ExpressPlayer app, make sure Playlist view is selected, input the URL to your playlist in the input box and tap the Go button. If you have any MP4 (PDCF) files in your playlist, ExpressPlayer will attempt to preload the tokens for those items.