Unified Streaming Live Origin Demo
DASH-IF Live Media Ingest Protocal - Interface 1 (CMAF)

Overview

This demonstration shows a Unified Streaming Origin setup with a Live publishing point and uses the DASH-IF CMAF ingest reference code https://github.com/unifiedstreaming/fmp4-ingest.

The demo consists of two Docker containers which are deployed using Docker Compose.

Disclaimer

This demo utilises software which is still in development and is therefore not intended for production use.

Setup

Install Docker
Install Docker Compose
Download this demo's Compose file

Build cmaf ingest image

This demonstration uses the cmaf ingest/ fmp4 ingest reference software the image for ingest the content should be build locally.

This can be done by running the following command in the directory of this demo's Compose file:

#!/bin/sh
docker-compose build cmaf-ingest-image

Which will create a Docker image called cmaf-ingest-image with the ingest source compiled and test files for ingest.

Test content

CMAF Test files were encoded using FFmpeg and packaged using mp4 split, 0,96 segments are used, 48 khz audio and 25 hz video is used. Timed text based on fragmented webvtt is included.

Usage

You need a license key to use this software. To evaluate you can create an account at Unified Streaming Registration.

The license key is passed to containers using the USP_LICENSE_KEY environment variable.

Start the stack using docker-compose:

#!/bin/sh
export USP_LICENSE_KEY=<your_license_key>
docker-compose up

You can also update the docker-compose file

-CMAF_FILES=<cmaf files to ingest>
-CMD_ARGS=<additional command line arguments, default -r (real time) and --chunked for chunked long running posts --avail arg1 [ms] arg2 [ms] for periodic cue insertion >

note the sample files are 1=0.96 second fragment based for low latency, using short running posts and many streams may results in performance problems in some setups. Please use long running posts when using small fragment sizes.

You can also include splice_insert comments by the option --avail X Y where X a cue is sent every X ms with a duration of y ms. The cue is a splice_insert command with autoreturn set to true and a start time k times X for k=1,2,3 and break duration d.

You can also choose to run it in background (detached mode):

#!/bin/sh
export USP_LICENSE_KEY=<your_license_key>
docker-compose up -d

Now that the stack is running the live stream should be available in all streaming formats at the following URLs:

Streaming Format	Playout URL
MPEG-DASH	http://localhost/cmaf-ingest/cmaf-ingest.isml/.mpd
HLS	http://localhost/cmaf-ingest/cmaf-ingest.isml/.m3u8
Microsoft Smooth Streaming	http://localhost/cmaf-ingest/cmaf-ingest.isml/Manifest
Adobe HTTP Dynamic Streaming	http://localhost/cmaf-ingest/cmaf-ingest.isml/.f4m

test

Watching the stream can be done using your player of choice, for example FFplay.

#!/bin/sh
ffplay http://localhost/cmaf-ingest/cmaf-ingest.isml/.m3u8

broyson/cmaf-ingest-demo