com.google.android.exoplayer.dash.mpd

Class Representation

java.lang.Object

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

All Implemented Interfaces:

FormatWrapper

Direct Known Subclasses:

Representation.MultiSegmentRepresentation, Representation.SingleSegmentRepresentation

public abstract class Representation
extends Object
implements FormatWrapper

A DASH representation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Representation.MultiSegmentRepresentation A DASH representation consisting of multiple segments.
static class	Representation.SingleSegmentRepresentation A DASH representation consisting of a single segment.

Field Summary

Fields

Modifier and Type	Field and Description
String	baseUrl The base URL of the representation.
String	contentId Identifies the piece of content to which this Representation belongs.
Format	format The format of the representation.
long	presentationTimeOffsetUs The offset of the presentation timestamps in the media stream relative to media time.
long	revisionId Identifies the revision of the content.

Method Summary

Modifier and Type	Method and Description
String	getCacheKey() A cache key for the Representation, in the format contentId + "." + format.id + "." + revisionId.
Format	getFormat() Returns the wrapped format.
abstract DashSegmentIndex	getIndex() Gets a segment index, if the representation is able to provide one directly.
abstract RangedUri	getIndexUri() Gets a RangedUri defining the location of the representation's segment index.
RangedUri	getInitializationUri() Gets a RangedUri defining the location of the representation's initialization data.
static Representation	newInstance(String contentId, long revisionId, Format format, String baseUrl, SegmentBase segmentBase) Constructs a new instance.
static Representation	newInstance(String contentId, long revisionId, Format format, String baseUrl, SegmentBase segmentBase, String customCacheKey) Constructs a new instance.

Methods inherited from class java.lang.Object

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

Field Detail

contentId

public final String contentId

Identifies the piece of content to which this Representation belongs.

For example, all Representations belonging to a video should have the same contentId, which should uniquely identify that video.

revisionId

public final long revisionId

Identifies the revision of the content.

If the media for a given (contentId can change over time without a change to the format's Format.id (e.g. as a result of re-encoding the media with an updated encoder), then this identifier must uniquely identify the revision of the media. The timestamp at which the media was encoded is often a suitable.

format

public final Format format

The format of the representation.

presentationTimeOffsetUs

public final long presentationTimeOffsetUs

The offset of the presentation timestamps in the media stream relative to media time.

baseUrl

public final String baseUrl

The base URL of the representation.

Method Detail

newInstance

public static Representation newInstance(String contentId,
                                         long revisionId,
                                         Format format,
                                         String baseUrl,
                                         SegmentBase segmentBase)

Constructs a new instance.

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 - A base URL.

segmentBase - A segment base element for the representation.

Returns:

The constructed instance.

newInstance

public static Representation newInstance(String contentId,
                                         long revisionId,
                                         Format format,
                                         String baseUrl,
                                         SegmentBase segmentBase,
                                         String customCacheKey)

Constructs a new instance.

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 - A segment base element for the representation.

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

Returns:

The constructed instance.

getFormat

public Format getFormat()

Description copied from interface: FormatWrapper

Returns the wrapped format.

Specified by:

getFormat in interface FormatWrapper

getInitializationUri

public RangedUri getInitializationUri()

Gets a RangedUri defining the location of the representation's initialization data. May be null if no initialization data exists.

Returns:

A RangedUri defining the location of the initialization data, or null.

getIndexUri

public abstract RangedUri getIndexUri()

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

Returns:

The location of the segment index, or null.

getIndex

public abstract DashSegmentIndex getIndex()

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

Returns:

The segment index, or null.

getCacheKey

public String getCacheKey()

A cache key for the Representation, in the format contentId + "." + format.id + "." + revisionId.

Returns:

A cache key.