AWS Elemental MediaPackage
User Guide

Step 2: Ingest Live Content

To ingest a live content stream into MediaPackage and extract a video on demand (VOD) asset from it, create a channel and endpoint. The channel is the entry point to MediaPackage, and the endpoint provides MediaPackage access to the stream so that it can extract the VOD asset. The following sections describe how to use the MediaPackage console to create a channel and endpoint.

Create a Channel

The channel is the first component in AWS Elemental MediaPackage. It represents the input to MediaPackage for incoming live content from an encoder such as AWS Elemental MediaLive.

MediaPackage does not require that you supply any customer data. There are no fields in channels where there is an expectation that you will provide customer data.

To create a channel

  1. On the MediaPackage Channels page, choose Create channel.

  2. For ID, enter a name that describes the channel, such as channelHLS1. The ID is the primary identifier for the channel, and must be unique for your account in the AWS Region. Supported characters are letters, numbers, underscore (_), and dash (-). You can't use spaces in the ID.

  3. Keep the defaults for the remaining fields, and then choose Create channel.

    MediaPackage displays the new channel's details page.

  4. On the channel's details page, note the values for Input URL, Username, and Password. If you're using input redundancy, you need this information for both input URLs. If you're sending only one stream to the channel, you can note the information for either input URL.

    MediaPackage securely generates the WebDAV user names and passwords when it creates the channel. If you need to change these credentials, see Rotating Credentials on an Input URL.

    Provide the information from these fields to the person in charge of the upstream encoder. In the stream configuration in the encoder, this person must enter the destination as the input URL, and the WebDAV credentials as the channel's user name and password. The upstream encoder must use digest authentication and push WebDAV over HTTPS to MediaPackage, and include these credentials. If you're using input redundancy, the input streams to this channel must have identical encoder settings. For more information about setting up source streams for input redundancy, see Live Input Redundancy AWS Elemental MediaPackage Processing Flow.

Create an Endpoint

The endpoint is attached to a channel, and represents the output of the live content. When you create a harvest job to extract a VOD asset from the live content, you have to indicate what endpoint you're extracting from. You can harvest assets from clear (unencrypted) HLS endpoints only, and the endpoint must have a startover window defined. If you have only encrypted endpoints, see the Creating Live-to-VOD Assets with AWS Elemental MediaPackage feature reference.

AWS Elemental MediaPackage does not require that you supply any customer data. There are no fields in endpoints where there is an expectation that you will provide customer data.

To create an endpoint

  1. On the Channels page, choose the channel that the endpoint will be associated with.

  2. On the details page for the channel, choose either Add and edit endpoint or Add endpoints if there are no existing endpoints.

  3. For ID, enter a name that describes the endpoint, such as HLSendpoint1. The ID is the primary identifier for the endpoint, and must be unique for your account in the AWS Region. Supported characters are letters, numbers, underscore (_), and dash (-). You can't use spaces in the ID.

  4. Keep the defaults for the remaining fields, and then choose Save endpoints.

    MediaPackage displays the channel's details page, including the endpoint that you just created.

  5. On the channel's details page, note the value in the URL field for the endpoint. Provide this information to the person in charge of the downstream device (CDN or player). In the downstream device, this person must enter the request destination as the endpoint's URL.