Amazon Kinesis Video Streams
Developer Guide

HLSFragmentSelector

Contains the range of time stamps for the requested media, and the source of the time stamps.

Contents

FragmentSelectorType

The source of the time stamps for the requested media.

When FragmentSelectorType is set to PRODUCER_TIMESTAMP and GetHLSStreamingSessionURL: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 GetHLSStreamingSessionURL: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 GetHLSStreamingSessionURL: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.

Type: String

Valid Values: PRODUCER_TIMESTAMP | SERVER_TIMESTAMP

Required: No

TimestampRange

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

This value should not be present if PlaybackType is LIVE.

Type: HLSTimestampRange object

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: