About HLS Group Destinations and File Names
HLS output consists of a manifest, one rendition manifest for each output in the output
group, and media files: one set of .ts
files for each output, and
optionally one or more captions files for each output.
For example, one manifest file called curling.m3u8
, one rendition
manifest called curling_high.m3u8
, and many .ts
files
that contain the video and audio (each file contains one segment of a specified number
of
seconds) and three .vtt
files for English, French, and Spanish WebVTT
captions.
Several fields in the HLS group section and the individual outputs control the location of these files:
-
The CDN settings fields in the HLS settings section.
The main field specifies the type of connection to the content delivery network (CDN), which is the downstream system that is the destination for the HLS output. For example, if the destination is AWS Elemental MediaPackage, the CDN is of type hls webdav. The other fields in this section provide connection details.
-
The two URL fields in the HLS group destinations section.
The URL consists of a protocol portion, a path portion, and a base filename portion.
For example, assume that the URL is
https://sports/curling
.The protocol portion is
https://
. The protocol is required and must be correct for the CDN that you specify. For example,https://
is correct if the CDN type is Hls basic put or Hls akamai or Hls webdav:-
http://
orhttps://
if you select Hls basic put in the CDN field and you are sending to a CDN that uses HTTP or HTTPSPUT
-
s3://
ors3ssl://
if you select Hls basic put in the CDN field and you are sending to an Amazon S3 bucket -
mediastoressl://
if you select Hls media store in the CDN field -
http://
orhttps://
if you select Hls akamai in the CDN field -
http://
orhttps://
if you select Hls webdav in the CDN field and you are sending to a server using WebDAV or you are sending to AWS Elemental MediaPackage
The path portion is
sports/
. The path is required and consists of the folders, terminated by a slash. It identifies the location of the manifest and media files.The base file name is
curling
. It is used in the manifest file names and media file names. The base file name is optional. If you omit it, MediaLive uses the name of the input as the base file name. -
-
The Name modifier field in the HLS outputs section.
Required only in output groups with more than one output. For example,
_high
. Used in the rendition manifest file names and in media file names.Following from our example, the manifest file would be
curling
, and the rendition manifest files would becurling_high
andcurling_low
. The media video files would becurling_high.00001.ts
,curling_high.00002.ts
, and so on for output 1, andcurling_medium.00001.ts
,curling_medium.00002.ts
, and so on for output 2. -
The Segment modifier field in the Output settings section of each individual output.
Always optional. For example,
_high
. Used only in the media file names. Typically used instead of Name modifier, when you have only one output in the output group and you want a modifier in the media but not in the manifest.Following from our example, the manifest file would be
curling
, the rendition manifest file would becurling
, and the media video files would becurling_high.00001.ts
andcurling_high.00002.ts
. -
The Base URL manifest field and Base URL field in the Location section.
Optional. These fields are typically used only for non-standard manifests.
-
The Directory structure field in the Location section.
Optional. Used only to create subdirectories for the media files. Creates one subdirectory for each output, and then creates sub-subdirectories according to the Segments per subdirectory field.
For example, the high-resolution media files will go in subdirectories with the same name as each rendition manifest:
curling_high
andcurling_low
. Inside each subdirectory there will be a sub-subdirectory named00001
(for the first set of media files),00002
(for the next set of media files), and so on.