com.google.android.exoplayer2.source.dash.manifest

Class Representation.MultiSegmentRepresentation

java.lang.Object

com.google.android.exoplayer2.source.dash.manifest.Representation

com.google.android.exoplayer2.source.dash.manifest.Representation.MultiSegmentRepresentation

All Implemented Interfaces:

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.exoplayer2.source.dash.manifest.Representation

Representation.MultiSegmentRepresentation, Representation.SingleSegmentRepresentation

Field Summary

Fields inherited from class com.google.android.exoplayer2.source.dash.manifest.Representation

baseUrl, contentId, format, inbandEventStreams, presentationTimeOffsetUs, REVISION_ID_DEFAULT, revisionId

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

INDEX_UNBOUNDED

Constructor Summary

Constructors

Constructor and Description
MultiSegmentRepresentation(java.lang.String contentId, long revisionId, com.google.android.exoplayer2.Format format, java.lang.String baseUrl, SegmentBase.MultiSegmentBase segmentBase, java.util.List<Descriptor> inbandEventStreams)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getCacheKey() Returns a cache key for the representation if a custom cache key or content id has been provided and there is only single segment.
long	getDurationUs(long segmentIndex, long periodDurationUs) Returns the duration of a segment.
long	getFirstSegmentNum() Returns the segment number of the first segment.
DashSegmentIndex	getIndex() Returns an index if the representation provides one directly, or null otherwise.
RangedUri	getIndexUri() Returns a RangedUri defining the location of the representation's segment index, or null if the representation provides an index directly.
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 segmentIndex) Returns a RangedUri defining the location of a segment.
long	getTimeUs(long 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.exoplayer2.source.dash.manifest.Representation

getInitializationUri, newInstance, 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(java.lang.String contentId,
                                  long revisionId,
                                  com.google.android.exoplayer2.Format format,
                                  java.lang.String baseUrl,
                                  SegmentBase.MultiSegmentBase segmentBase,
                                  java.util.List<Descriptor> inbandEventStreams)

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.

baseUrl - The base URL of the representation.

segmentBase - The segment base underlying the representation.

inbandEventStreams - The in-band event streams in the representation. May be null.

Method Detail

getIndexUri

public RangedUri getIndexUri()

Description copied from class: Representation

Returns a RangedUri defining the location of the representation's segment index, or null if the representation provides an index directly.

Specified by:

getIndexUri in class Representation

getIndex

public DashSegmentIndex getIndex()

Description copied from class: Representation

Returns an index if the representation provides one directly, or null otherwise.

Specified by:

getIndex in class Representation

getCacheKey

public java.lang.String getCacheKey()

Description copied from class: Representation

Returns a cache key for the representation if a custom cache key or content id has been provided and there is only single segment.

Specified by:

getCacheKey in class Representation

getSegmentUrl

public RangedUri getSegmentUrl(long 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 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.

getTimeUs

public long getTimeUs(long 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(long 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.TIME_UNSET if the period's duration is not yet known.

Returns:

The duration of the segment, in microseconds.

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.

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.