com.google.android.exoplayer.dash.mpd

Class Representation.MultiSegmentRepresentation

java.lang.Object

com.google.android.exoplayer.dash.mpd.Representation

com.google.android.exoplayer.dash.mpd.Representation.MultiSegmentRepresentation

All Implemented Interfaces:

FormatWrapper, DashSegmentIndex

Enclosing class:

Representation

public static class Representation.MultiSegmentRepresentation
extends Representation
implements DashSegmentIndex

A DASH representation consisting of multiple segments.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.android.exoplayer.dash.mpd.Representation

Representation.MultiSegmentRepresentation, Representation.SingleSegmentRepresentation

Field Summary

Fields inherited from class com.google.android.exoplayer.dash.mpd.Representation

baseUrl, contentId, format, presentationTimeOffsetUs, revisionId

Fields inherited from interface com.google.android.exoplayer.dash.DashSegmentIndex

INDEX_UNBOUNDED

Constructor Summary

Constructors

Constructor and Description
MultiSegmentRepresentation(String contentId, long revisionId, Format format, SegmentBase.MultiSegmentBase segmentBase, String customCacheKey, String baseUrl)

Method Summary

Modifier and Type	Method and Description
long	getDurationUs(int segmentIndex, long periodDurationUs) Returns the duration of a segment.
int	getFirstSegmentNum() Returns the segment number of the first segment.
DashSegmentIndex	getIndex() Gets a segment index, if the representation is able to provide one directly.
RangedUri	getIndexUri() Gets a RangedUri defining the location of the representation's segment index.
int	getLastSegmentNum(long periodDurationUs) Returns the segment number of the last segment, or DashSegmentIndex.INDEX_UNBOUNDED.
int	getSegmentNum(long timeUs, long periodDurationUs) Returns the segment number of the segment containing a given media time.
RangedUri	getSegmentUrl(int segmentIndex) Returns a RangedUri defining the location of a segment.
long	getTimeUs(int segmentIndex) Returns the start time of a segment.
boolean	isExplicit() Returns true if segments are defined explicitly by the index.

Methods inherited from class com.google.android.exoplayer.dash.mpd.Representation

getCacheKey, getFormat, getInitializationUri, newInstance, newInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiSegmentRepresentation

public MultiSegmentRepresentation(String contentId,
                                  long revisionId,
                                  Format format,
                                  SegmentBase.MultiSegmentBase segmentBase,
                                  String customCacheKey,
                                  String baseUrl)

Parameters:

contentId - Identifies the piece of content to which this representation belongs.

revisionId - Identifies the revision of the content.

format - The format of the representation.

segmentBase - The segment base underlying the representation.

customCacheKey - A custom value to be returned from Representation.getCacheKey(), or null.

Method Detail

getIndexUri

public RangedUri getIndexUri()

Description copied from class: Representation

Gets a RangedUri defining the location of the representation's segment index. Null if the representation provides an index directly.

Specified by:

getIndexUri in class Representation

Returns:

The location of the segment index, or null.

getIndex

public DashSegmentIndex getIndex()

Description copied from class: Representation

Gets a segment index, if the representation is able to provide one directly. Null if the segment index is defined externally.

Specified by:

getIndex in class Representation

Returns:

The segment index, or null.

getSegmentUrl

public RangedUri getSegmentUrl(int segmentIndex)

Description copied from interface: DashSegmentIndex

Returns a RangedUri defining the location of a segment.

Specified by:

getSegmentUrl in interface DashSegmentIndex

Parameters:

segmentIndex - The segment number.

Returns:

The RangedUri defining the location of the data.

getSegmentNum

public int getSegmentNum(long timeUs,
                         long periodDurationUs)

Description copied from interface: DashSegmentIndex

Returns the segment number of the segment containing a given media time.

If the given media time is outside the range of the index, then the returned segment number is clamped to DashSegmentIndex.getFirstSegmentNum() (if the given media time is earlier the start of the first segment) or DashSegmentIndex.getLastSegmentNum(long) (if the given media time is later then the end of the last segment).

Specified by:

getSegmentNum in interface DashSegmentIndex

Parameters:

timeUs - The time in microseconds.

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

Returns:

The segment number of the corresponding segment.

getTimeUs

public long getTimeUs(int segmentIndex)

Description copied from interface: DashSegmentIndex

Returns the start time of a segment.

Specified by:

getTimeUs in interface DashSegmentIndex

Parameters:

segmentIndex - The segment number.

Returns:

The corresponding start time in microseconds.

getDurationUs

public long getDurationUs(int segmentIndex,
                          long periodDurationUs)

Description copied from interface: DashSegmentIndex

Returns the duration of a segment.

Specified by:

getDurationUs in interface DashSegmentIndex

Parameters:

segmentIndex - The segment number.

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

Returns:

The duration of the segment, in microseconds.

getFirstSegmentNum

public int 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.

getLastSegmentNum

public int getLastSegmentNum(long periodDurationUs)

Description copied from interface: DashSegmentIndex

Returns the segment number of the last segment, 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:

getLastSegmentNum in interface DashSegmentIndex

Parameters:

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

Returns:

The segment number of the last segment, or DashSegmentIndex.INDEX_UNBOUNDED.

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:

True if segments are defined explicitly by the index. False otherwise.