SingleSampleMediaChunk


@UnstableApi
public final class SingleSampleMediaChunk extends BaseMediaChunk


A BaseMediaChunk for chunks consisting of a single raw sample.

Summary

Public constructors

SingleSampleMediaChunk(
    DataSource dataSource,
    DataSpec dataSpec,
    Format trackFormat,
    @C.SelectionReason int trackSelectionReason,
    @Nullable Object trackSelectionData,
    long startTimeUs,
    long endTimeUs,
    long chunkIndex,
    @C.TrackType int trackType,
    Format sampleFormat
)

Public methods

void

Cancels the load.

boolean

Returns whether the chunk has been fully loaded.

void

Performs the load, returning on completion or cancellation.

Inherited fields

From androidx.media3.exoplayer.source.chunk.BaseMediaChunk
final long

The time from which output will end, or TIME_UNSET if output will end at the end of the chunk.

final long

The time from which output will begin, or TIME_UNSET if output will begin from the start of the chunk.

@MonotonicNonNull BaseMediaChunkOutput
From androidx.media3.exoplayer.source.chunk.Chunk
final StatsDataSource
final DataSpec

The DataSpec that defines the data to be loaded.

final long

The end time of the media contained by the chunk, or TIME_UNSET if the data being loaded does not contain media samples.

final long

Identifies the load task for this loadable.

final long

The start time of the media contained by the chunk, or TIME_UNSET if the data being loaded does not contain media samples.

final Format

The format of the track to which this chunk belongs.

final @Nullable Object

Optional data associated with the selection of the track to which this chunk belongs.

final int

One of the selection reasons if the chunk belongs to a track.

final int

The data type of the chunk.

From androidx.media3.exoplayer.source.chunk.MediaChunk
final long

The chunk index, or INDEX_UNSET if it is not known.

Inherited methods

From androidx.media3.exoplayer.source.chunk.BaseMediaChunk
final int
getFirstSampleIndex(int trackIndex)

Returns the index of the first sample in the specified track of the output that will originate from this chunk.

final BaseMediaChunkOutput

Returns the output most recently passed to init.

void

Initializes the chunk for loading, setting the BaseMediaChunkOutput that will receive samples as they are loaded.

From androidx.media3.exoplayer.source.chunk.Chunk
final long

Returns the number of bytes that have been loaded.

final long

Returns the duration of the chunk in microseconds.

final Map<StringList<String>>

Returns the response headers associated with the last open call.

final Uri

Returns the Uri associated with the last open call.

From androidx.media3.exoplayer.source.chunk.MediaChunk
long

Returns the next chunk index or INDEX_UNSET if it is not known.

Public constructors

SingleSampleMediaChunk

public SingleSampleMediaChunk(
    DataSource dataSource,
    DataSpec dataSpec,
    Format trackFormat,
    @C.SelectionReason int trackSelectionReason,
    @Nullable Object trackSelectionData,
    long startTimeUs,
    long endTimeUs,
    long chunkIndex,
    @C.TrackType int trackType,
    Format sampleFormat
)
Parameters
DataSource dataSource

The source from which the data should be loaded.

DataSpec dataSpec

Defines the data to be loaded.

Format trackFormat

See trackFormat.

@C.SelectionReason int trackSelectionReason

See trackSelectionReason.

@Nullable Object trackSelectionData

See trackSelectionData.

long startTimeUs

The start time of the media contained by the chunk, in microseconds.

long endTimeUs

The end time of the media contained by the chunk, in microseconds.

long chunkIndex

The index of the chunk, or INDEX_UNSET if it is not known.

@C.TrackType int trackType

The track type of the chunk.

Format sampleFormat

The Format of the sample in the chunk.

Public methods

cancelLoad

public void cancelLoad()

Cancels the load.

Loadable implementations should ensure that a currently executing load call will exit reasonably quickly after this method is called. The load call may exit either by returning or by throwing an IOException.

If there is a currently executing load call, then the thread on which that call is being made will be interrupted immediately after the call to this method. Hence implementations do not need to (and should not attempt to) interrupt the loading thread themselves.

Although the loading thread will be interrupted, Loadable implementations should not use the interrupted status of the loading thread in load to determine whether the load has been canceled. This approach is not robust [Internal ref: b/79223737]. Instead, implementations should use their own flag to signal cancelation (for example, using ).

isLoadCompleted

public boolean isLoadCompleted()

Returns whether the chunk has been fully loaded.

load

public void load()

Performs the load, returning on completion or cancellation.

Throws
java.io.IOException

If the input could not be loaded.