software.amazon.awssdk.services.kinesisvideoarchivedmedia.model

Interface HLSFragmentSelector.Builder

All Superinterfaces:

Buildable, CopyableBuilder<HLSFragmentSelector.Builder,HLSFragmentSelector>, SdkBuilder<HLSFragmentSelector.Builder,HLSFragmentSelector>, SdkPojo

Enclosing class:

HLSFragmentSelector

public static interface HLSFragmentSelector.Builder
extends SdkPojo, CopyableBuilder<HLSFragmentSelector.Builder,HLSFragmentSelector>

Method Summary

Modifier and Type	Method and Description
HLSFragmentSelector.Builder	fragmentSelectorType(HLSFragmentSelectorType fragmentSelectorType) The source of the time stamps for the requested media.
HLSFragmentSelector.Builder	fragmentSelectorType(String fragmentSelectorType) The source of the time stamps for the requested media.
default HLSFragmentSelector.Builder	timestampRange(Consumer<HLSTimestampRange.Builder> timestampRange) The start and end of the time stamp range for the requested media.
HLSFragmentSelector.Builder	timestampRange(HLSTimestampRange timestampRange) The start and end of the time stamp range for the requested media.

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

sdkFields

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

fragmentSelectorType

HLSFragmentSelector.Builder fragmentSelectorType(String fragmentSelectorType)

The source of the time stamps for the requested media.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is ON_DEMAND, the first fragment ingested with a producer time stamp within the specified FragmentSelector$TimestampRange is included in the media playlist. In addition, the fragments with producer time stamps within the TimestampRange ingested immediately following the first fragment (up to the GetHLSStreamingSessionURLInput$MaxMediaPlaylistFragmentResults value) are included.

Fragments that have duplicate producer time stamps are deduplicated. This means that if producers are producing a stream of fragments with producer time stamps that are approximately equal to the true clock time, the HLS media playlists will contain all of the fragments within the requested time stamp range. If some fragments are ingested within the same time range and very different points in time, only the oldest ingested collection of fragments are returned.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is LIVE, the producer time stamps are used in the MP4 fragments and for deduplication. But the most recently ingested fragments based on server time stamps are included in the HLS media playlist. This means that even if fragments ingested in the past have producer time stamps with values now, they are not included in the HLS media playlist.

The default is SERVER_TIMESTAMP.

Parameters:

fragmentSelectorType - The source of the time stamps for the requested media.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is ON_DEMAND, the first fragment ingested with a producer time stamp within the specified FragmentSelector$TimestampRange is included in the media playlist. In addition, the fragments with producer time stamps within the TimestampRange ingested immediately following the first fragment (up to the GetHLSStreamingSessionURLInput$MaxMediaPlaylistFragmentResults value) are included.

Fragments that have duplicate producer time stamps are deduplicated. This means that if producers are producing a stream of fragments with producer time stamps that are approximately equal to the true clock time, the HLS media playlists will contain all of the fragments within the requested time stamp range. If some fragments are ingested within the same time range and very different points in time, only the oldest ingested collection of fragments are returned.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is LIVE, the producer time stamps are used in the MP4 fragments and for deduplication. But the most recently ingested fragments based on server time stamps are included in the HLS media playlist. This means that even if fragments ingested in the past have producer time stamps with values now, they are not included in the HLS media playlist.

The default is SERVER_TIMESTAMP.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

HLSFragmentSelectorType, HLSFragmentSelectorType

fragmentSelectorType

HLSFragmentSelector.Builder fragmentSelectorType(HLSFragmentSelectorType fragmentSelectorType)

The source of the time stamps for the requested media.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is ON_DEMAND, the first fragment ingested with a producer time stamp within the specified FragmentSelector$TimestampRange is included in the media playlist. In addition, the fragments with producer time stamps within the TimestampRange ingested immediately following the first fragment (up to the GetHLSStreamingSessionURLInput$MaxMediaPlaylistFragmentResults value) are included.

Fragments that have duplicate producer time stamps are deduplicated. This means that if producers are producing a stream of fragments with producer time stamps that are approximately equal to the true clock time, the HLS media playlists will contain all of the fragments within the requested time stamp range. If some fragments are ingested within the same time range and very different points in time, only the oldest ingested collection of fragments are returned.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is LIVE, the producer time stamps are used in the MP4 fragments and for deduplication. But the most recently ingested fragments based on server time stamps are included in the HLS media playlist. This means that even if fragments ingested in the past have producer time stamps with values now, they are not included in the HLS media playlist.

The default is SERVER_TIMESTAMP.

Parameters:

fragmentSelectorType - The source of the time stamps for the requested media.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is ON_DEMAND, the first fragment ingested with a producer time stamp within the specified FragmentSelector$TimestampRange is included in the media playlist. In addition, the fragments with producer time stamps within the TimestampRange ingested immediately following the first fragment (up to the GetHLSStreamingSessionURLInput$MaxMediaPlaylistFragmentResults value) are included.

Fragments that have duplicate producer time stamps are deduplicated. This means that if producers are producing a stream of fragments with producer time stamps that are approximately equal to the true clock time, the HLS media playlists will contain all of the fragments within the requested time stamp range. If some fragments are ingested within the same time range and very different points in time, only the oldest ingested collection of fragments are returned.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURLInput$PlaybackMode is LIVE, the producer time stamps are used in the MP4 fragments and for deduplication. But the most recently ingested fragments based on server time stamps are included in the HLS media playlist. This means that even if fragments ingested in the past have producer time stamps with values now, they are not included in the HLS media playlist.

The default is SERVER_TIMESTAMP.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

HLSFragmentSelectorType, HLSFragmentSelectorType

timestampRange

HLSFragmentSelector.Builder timestampRange(HLSTimestampRange timestampRange)

The start and end of the time stamp range for the requested media.

This value should not be present if PlaybackType is LIVE.

Parameters:

timestampRange - The start and end of the time stamp range for the requested media.

This value should not be present if PlaybackType is LIVE.

Returns:

Returns a reference to this object so that method calls can be chained together.

timestampRange

default HLSFragmentSelector.Builder timestampRange(Consumer<HLSTimestampRange.Builder> timestampRange)

The start and end of the time stamp range for the requested media.

This value should not be present if PlaybackType is LIVE.

This is a convenience that creates an instance of the HLSTimestampRange.Builder avoiding the need to create one manually via HLSTimestampRange.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to timestampRange(HLSTimestampRange).

Parameters:

timestampRange - a consumer that will call methods on HLSTimestampRange.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

timestampRange(HLSTimestampRange)