HlsSettings

class aws_cdk.aws_medialive_alpha.HlsSettings

Bases: object

(experimental) Per-output HLS settings.

Select the variant that matches the output: a standard (video) output, an audio-only rendition, an fMP4 output, or a frame-capture output.

Stability:: experimental
ExampleMetadata:: infused

Example:

# bucket: s3.IBucket
# video: medialive.EncodeConfiguration
# audio: medialive.EncodeConfiguration


medialive.OutputGroupConfiguration.hls(
    name="hls",
    destinations=[medialive.OutputDestination.to_bucket(bucket, "live/stream")],
    outputs=[medialive.HlsOutputDefinition(
        encodes=[video],
        output_name="video",
        hls_settings=medialive.HlsSettings.standard(
            m3u8_settings=medialive.M3u8Settings.of(
                scte35_behavior=medialive.M3u8Scte35Behavior.PASSTHROUGH,
                program_num=1
            )
        )
    ), medialive.HlsOutputDefinition(
        encodes=[audio],
        output_name="audio",
        hls_settings=medialive.HlsSettings.audio_only(
            audio_group_id="program",
            audio_only_image=medialive.FileLocation.from_bucket(bucket, "art/cover.png")
        )
    )
    ]
)

Stability:: experimental

Static Methods

classmethod audio_only(*, audio_group_id=None, audio_only_image=None, audio_track_type=None, segment_type=None)

(experimental) Settings for an audio-only HLS rendition.

Parameters:

audio_group_id (Optional[str]) – (experimental) The group that this audio rendition belongs to. Default: - service default
audio_only_image (Optional[FileLocation]) – (experimental) A .jpg or .png cover-art image embedded in each audio-only segment. Provide a FileLocation referencing an S3 bucket (FileLocation.fromBucket, which auto-grants read access) or a URL (FileLocation.url). Default: - no cover art
audio_track_type (Optional[HlsAudioTrackType]) – (experimental) How the audio rendition is signaled in the HLS manifest. Default: - service default
segment_type (Optional[HlsAudioOnlySegmentType]) – (experimental) The segment container type. Default: - service default

Stability:

experimental

Return type:

HlsSettings

classmethod fmp4(*, audio_rendition_sets=None, nielsen_id3_behavior=None, timed_metadata_behavior=None)

(experimental) Settings for an fMP4 HLS output.

Parameters:

audio_rendition_sets (Optional[str]) – (experimental) The audio GROUP-IDs used with this video output stream, comma-separated. Default: - service default
nielsen_id3_behavior (Optional[M3u8NielsenId3Behavior]) – (experimental) Nielsen ID3 passthrough behavior. Default: - service default
timed_metadata_behavior (Optional[M3u8TimedMetadataBehavior]) – (experimental) Timed-metadata passthrough behavior. Default: - service default

Stability:

experimental

Return type:

HlsSettings

classmethod frame_capture()

(experimental) Settings for a frame-capture output in an HLS output group.

Stability:: experimental
Return type:: HlsSettings

classmethod standard(*, audio_rendition_sets=None, m3u8_settings=None)

(experimental) Settings for a standard (video) HLS output.

Parameters:

audio_rendition_sets (Optional[str]) – (experimental) The audio GROUP-IDs used with this video output stream, comma-separated. Default: - service default
m3u8_settings (Optional[M3u8Settings]) – (experimental) The M3U8 container settings. Default: - service defaults

Stability:

experimental

Return type:

HlsSettings