HLSFragmentSelector
Contains the range of timestamps for the requested media, and the source of the timestamps.
Contents
- FragmentSelectorType
-
The source of the timestamps for the requested media.
When
FragmentSelectorType
is set toPRODUCER_TIMESTAMP
and GetHLSStreamingSessionURL:PlaybackMode isON_DEMAND
orLIVE_REPLAY
, the first fragment ingested with a producer timestamp within the specified FragmentSelector:TimestampRange is included in the media playlist. In addition, the fragments with producer timestamps within theTimestampRange
ingested immediately following the first fragment (up to the GetHLSStreamingSessionURL:MaxMediaPlaylistFragmentResults value) are included.Fragments that have duplicate producer timestamps are deduplicated. This means that if producers are producing a stream of fragments with producer timestamps that are approximately equal to the true clock time, the HLS media playlists will contain all of the fragments within the requested timestamp 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 toPRODUCER_TIMESTAMP
and GetHLSStreamingSessionURL:PlaybackMode isLIVE
, the producer timestamps are used in the MP4 fragments and for deduplication. But the most recently ingested fragments based on server timestamps are included in the HLS media playlist. This means that even if fragments ingested in the past have producer timestamps 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 timestamp range for the requested media.
This value should not be present if
PlaybackType
isLIVE
.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: