com.google.android.exoplayer2.source.dash

Interface DashSegmentIndex

All Known Implementing Classes:

DashWrappingSegmentIndex, Representation.MultiSegmentRepresentation

public interface DashSegmentIndex

Indexes the segments within a media stream.

Field Summary

Fields

Modifier and Type	Field and Description
static int	INDEX_UNBOUNDED

Method Summary

Modifier and Type	Method and Description
long	getDurationUs(int segmentNum, long periodDurationUs) Returns the duration of a segment.
int	getFirstSegmentNum() Returns the segment number of the first segment.
int	getSegmentCount(long periodDurationUs) Returns the number of segments in the index, or INDEX_UNBOUNDED.
int	getSegmentNum(long timeUs, long periodDurationUs) Returns getFirstSegmentNum() if the index has no segments or if the given media time is earlier than the start of the first segment.
RangedUri	getSegmentUrl(int segmentNum) Returns a RangedUri defining the location of a segment.
long	getTimeUs(int segmentNum) Returns the start time of a segment.
boolean	isExplicit() Returns true if segments are defined explicitly by the index.

Field Detail

INDEX_UNBOUNDED

static final int INDEX_UNBOUNDED

See Also:

Constant Field Values

Method Detail

getSegmentNum

int getSegmentNum(long timeUs,
                  long periodDurationUs)

Returns getFirstSegmentNum() if the index has no segments or if the given media time is earlier than the start of the first segment. Returns getFirstSegmentNum() + getSegmentCount() - 1 if the given media time is later than the end of the last segment. Otherwise, returns the segment number of the segment containing the given media time.

Parameters:

timeUs - The time in microseconds.

periodDurationUs - The duration of the enclosing period in microseconds, or C.TIME_UNSET if the period's duration is not yet known.

Returns:

The segment number of the corresponding segment.

getTimeUs

long getTimeUs(int segmentNum)

Returns the start time of a segment.

Parameters:

segmentNum - The segment number.

Returns:

The corresponding start time in microseconds.

getDurationUs

long getDurationUs(int segmentNum,
                   long periodDurationUs)

Returns the duration of a segment.

Parameters:

segmentNum - The segment number.

periodDurationUs - The duration of the enclosing period in microseconds, or C.TIME_UNSET if the period's duration is not yet known.

Returns:

The duration of the segment, in microseconds.

getSegmentUrl

RangedUri getSegmentUrl(int segmentNum)

Returns a RangedUri defining the location of a segment.

Parameters:

segmentNum - The segment number.

Returns:

The RangedUri defining the location of the data.

getFirstSegmentNum

int getFirstSegmentNum()

Returns the segment number of the first segment.

Returns:

The segment number of the first segment.

getSegmentCount

int getSegmentCount(long periodDurationUs)

Returns the number of segments in the index, or INDEX_UNBOUNDED.

An unbounded index occurs if a dynamic manifest uses SegmentTemplate elements without a SegmentTimeline element, and if the period duration is not yet known. In this case the caller must manually determine the window of currently available segments.

Parameters:

periodDurationUs - The duration of the enclosing period in microseconds, or C.TIME_UNSET if the period's duration is not yet known.

Returns:

The number of segments in the index, or INDEX_UNBOUNDED.

isExplicit

boolean isExplicit()

Returns true if segments are defined explicitly by the index.

If true is returned, each segment is defined explicitly by the index data, and all of the listed segments are guaranteed to be available at the time when the index was obtained.

If false is returned then segment information was derived from properties such as a fixed segment duration. If the presentation is dynamic, it's possible that only a subset of the segments are available.

Returns:

Whether segments are defined explicitly by the index.