com.google.android.exoplayer2.source.dash

Class DashWrappingSegmentIndex

java.lang.Object

com.google.android.exoplayer2.source.dash.DashWrappingSegmentIndex

All Implemented Interfaces:

DashSegmentIndex

public final class DashWrappingSegmentIndex
extends java.lang.Object
implements DashSegmentIndex

An implementation of DashSegmentIndex that wraps a ChunkIndex parsed from a media stream.

Field Summary

Fields inherited from interface com.google.android.exoplayer2.source.dash.DashSegmentIndex

INDEX_UNBOUNDED

Constructor Summary

Constructors

Constructor and Description
DashWrappingSegmentIndex(com.google.android.exoplayer2.extractor.ChunkIndex chunkIndex, long timeOffsetUs)

Method Summary

Modifier and Type	Method and Description
long	getDurationUs(long segmentNum, long periodDurationUs) Returns the duration of a segment.
long	getFirstSegmentNum() Returns the segment number of the first segment.
int	getSegmentCount(long periodDurationUs) Returns the number of segments in the index, or DashSegmentIndex.INDEX_UNBOUNDED.
long	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(long segmentNum) Returns a RangedUri defining the location of a segment.
long	getTimeUs(long segmentNum) Returns the start time of a segment.
boolean	isExplicit() Returns true if segments are defined explicitly by the index.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DashWrappingSegmentIndex

public DashWrappingSegmentIndex(com.google.android.exoplayer2.extractor.ChunkIndex chunkIndex,
                                long timeOffsetUs)

Parameters:

chunkIndex - The ChunkIndex to wrap.

timeOffsetUs - An offset to subtract from the times in the wrapped index, in microseconds.

Method Detail

getFirstSegmentNum

public long getFirstSegmentNum()

Description copied from interface: DashSegmentIndex

Returns the segment number of the first segment.

Specified by:

getFirstSegmentNum in interface DashSegmentIndex

Returns:

The segment number of the first segment.

getSegmentCount

public int getSegmentCount(long periodDurationUs)

Description copied from interface: DashSegmentIndex

Returns the number of segments in the index, or DashSegmentIndex.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.

Specified by:

getSegmentCount in interface DashSegmentIndex

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 DashSegmentIndex.INDEX_UNBOUNDED.

getTimeUs

public long getTimeUs(long segmentNum)

Description copied from interface: DashSegmentIndex

Returns the start time of a segment.

Specified by:

getTimeUs in interface DashSegmentIndex

Parameters:

segmentNum - The segment number.

Returns:

The corresponding start time in microseconds.

getDurationUs

public long getDurationUs(long segmentNum,
                          long periodDurationUs)

Description copied from interface: DashSegmentIndex

Returns the duration of a segment.

Specified by:

getDurationUs in interface DashSegmentIndex

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

public RangedUri getSegmentUrl(long segmentNum)

Description copied from interface: DashSegmentIndex

Returns a RangedUri defining the location of a segment.

Specified by:

getSegmentUrl in interface DashSegmentIndex

Parameters:

segmentNum - The segment number.

Returns:

The RangedUri defining the location of the data.

getSegmentNum

public long getSegmentNum(long timeUs,
                          long periodDurationUs)

Description copied from interface: DashSegmentIndex

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.

Specified by:

getSegmentNum in interface DashSegmentIndex

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.

isExplicit

public boolean isExplicit()

Description copied from interface: DashSegmentIndex

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.

Specified by:

isExplicit in interface DashSegmentIndex

Returns:

Whether segments are defined explicitly by the index.