HLS and MPEG-Dash

Every outputs must be set inside the outputs key with each value being a Hash describing the output format and settings.

Examples

Packaging into MPEG-Dash and HLS:

{
  "outputs": {
    "httpstream": {
      "hls": {
        "path": "/hls"
      },
      "dash": {
        "path": "/dash"
      }
    }
  }
}

Customizing the variants:

{
  "outputs": {
    "httpstream": {
      "hls": {
        "path": "/hls"
      },
      "dash": {
        "path": "/dash"
      },
      "variants": [
        "mp4:x:64k",
        "mp4:240p::quality=2",
        "mp4:480p::quality=3,maxrate=1500k",
        "mp4:720p::quality=4,maxrate=3000k"
      ]
    }
  }
}

Packaging into MPEG-Dash and HLS fMP4:

{
  "outputs": {
    "httpstream": {
      "dash": {
        "path": "/dash",
        "hlsfmp4": true
      }
    }
  }
}

Parameters

HLS & MPEG-Dash options

Sample variants:

mp4:x:64k
mp4:240p::quality=4,maxrate=400k
mp4:360p::quality=4,maxrate=1000k
mp4:480p::quality=4,maxrate=1500K
mp4:720p::quality=4,maxrate=2000k
mp4:1080p::quality=4,maxrate=4000k
mp4:2160p::quality=4,maxrate=8000k

// Audio only hls
mp3:64k
mp3:128k
mp3:256k

Video manipulation

Add a watermark and cut the output at 2min:

{
  "outputs": {
    "httpstream": {
      "dash": {
        "path": "/dash",
        "hlsfmp4": true
      },
      "duration": 120,
      "watermark": {
        "url": "https://host/coconut/watermark.png",
        "position": "center"
      }
    }
  }
}

DRM and Encryption

Widevine (Dash only) [ UNIMPLIMENTED ]

Playready (Dash only) [ UNIMPLIMENTED ]

Widevine and Playready example:

{
  "outputs": {
    "httpstream": {
      "dash": {
        "path": "/dash",
        "widevine_pssh": "htb3ZpZVjRG9ubDQHRhPY2NaE65qWBi3cQQs2yGgLI0iZNUjSIQ0gkxEh7mH9WEj3JWbBg==",
        "playready_laurl": "https://playready.ezdrm.com/cency/preauth.aspx?pX=ECD463",
        "encryption_key": "d21875b042cddb98018d7f6b7718ddb2:be02128f059b70c9e6a2e9d02ae64e14"
      }
    }
  }
}

Fairplay (HLS only) [ UNIMPLIMENTED ]

Fairplay example:

{
  "outputs": {
    "httpstream": {
      "hls": {
        "path": "/hls",
        "encryption_mode": "SAMPLE-AES",
        "encryption_key": "d013b7710d187bd8d8d6987f5b42cdb2be260ec912d4e9f020e68e59b7a2a014",
        "encryption_key_uri": "skd://fps.ezdrm.com/;1XXXXXX0-c7ed-4XXX-b15c-XXXXXXXXXa25"
      }
    }
  }
}

Simple HTTP Key Delivery (HLS only)

AES Encryption example:

{
  "outputs": {
    "httpstream": {
      "hls": {
        "path": "/hls",
        "encryption_mode": "AES-128",
        "encryption_key": "ba66aa7334ba85b3bc093db1db3ab931",
        "encryption_key_uri": "http://yoursite.com/hls/aes/key.bin"
      }
    }
  }
}

Cross-Origin Resource Sharing (CORS)

You will need to setup the CORS headers if the playlist and mp4 files are hosted on a different domain, which is most likely the case. Here are the different headers you need to setup:

• Access-Control-Allow-Headers: "origin, range"
• Access-Control-Allow-Methods: "GET, HEAD, OPTIONS"
• Access-Control-Allow-Origin: "*"
• Access-Control-Expose-Headers: "Server,range"

If your files are hosted on Amazon S3, the CORS policy should look like this:

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <MaxAgeSeconds>3000</MaxAgeSeconds>
        <AllowedHeader>*</AllowedHeader>
    </CORSRule>
</CORSConfiguration>