Stay organized with collections Save and categorize content based on your preferences.

FakeTrackSelection

@UnstableApi
public final class FakeTrackSelection implements ExoTrackSelection


A fake ExoTrackSelection that only returns 1 fixed track, and allows querying the number of calls to its methods.

Summary

Public fields

int
boolean
int

Public constructors

FakeTrackSelection(TrackGroup rendererTrackGroup)

Public methods

boolean
blacklist(int index, long exclusionDurationMs)

Attempts to exclude the track at the specified index in the selection, making it ineligible for selection by calls to updateSelectedTrack for the specified period of time.

void

Disables this track selection.

void

Enables the track selection.

int
evaluateQueueSize(long playbackPositionUs, List<MediaChunk> queue)

Returns the number of chunks that should be retained in the queue.

Format
getFormat(int index)

Returns the format of the track at a given index in the selection.

int

Returns the index in the track group of the track at a given index in the selection.

Format

Returns the Format of the individual selected track.

int

Returns the index of the selected track.

int

Returns the index in the track group of the individual selected track.

@Nullable Object

Returns optional data associated with the current track selection.

int

Returns the reason for the current track selection.

TrackGroup

Returns the TrackGroup to which the selected tracks belong.

int

Returns an integer specifying the type of the selection, or TYPE_UNSET if not specified.

int
indexOf(Format format)

Returns the index in the selection of the track with the specified format.

int
indexOf(int indexInTrackGroup)

Returns the index in the selection of the track with the specified index in the track group.

boolean
isBlacklisted(int index, long nowMs)

Returns whether the track at the specified index in the selection is excluded.

int

Returns the number of tracks in the selection.

void
onPlaybackSpeed(float playbackSpeed)

Called to notify the selection of the current playback speed.

void
updateSelectedTrack(
    long playbackPositionUs,
    long bufferedDurationUs,
    long availableDurationUs,
    List<MediaChunk> queue,
    MediaChunkIterator[] mediaChunkIterators
)

Updates the selected track for sources that load media in discrete MediaChunks.

Inherited Constants

From androidx.media3.exoplayer.trackselection.TrackSelection
static final int

The first value that can be used for application specific track selection types.

static final int

An unspecified track selection type.

Inherited methods

From androidx.media3.exoplayer.trackselection.ExoTrackSelection
void

Called to notify the selection of a position discontinuity.

void
onPlayWhenReadyChanged(boolean playWhenReady)

Called to notify when the playback is paused or resumed.

void

Called to notify when a rebuffer occurred.

boolean
shouldCancelChunkLoad(
    long playbackPositionUs,
    Chunk loadingChunk,
    List<MediaChunk> queue
)

Returns whether an ongoing load of a chunk should be canceled.

Public fields

enableCount

public int enableCount

isEnabled

public boolean isEnabled

releaseCount

public int releaseCount

Public constructors

FakeTrackSelection

public FakeTrackSelection(TrackGroup rendererTrackGroup)

Public methods

blacklist

public boolean blacklist(int index, long exclusionDurationMs)

Attempts to exclude the track at the specified index in the selection, making it ineligible for selection by calls to updateSelectedTrack for the specified period of time.

Exclusion will fail if all other tracks are currently excluded. If excluding the currently selected track, note that it will remain selected until the next call to updateSelectedTrack.

This method will only be called when the selection is enabled.

Parameters
int index

The index of the track in the selection.

long exclusionDurationMs

The duration of time for which the track should be excluded, in milliseconds.

Returns
boolean

Whether exclusion was successful.

disable

public void disable()

Disables this track selection. No further dynamic changes via updateSelectedTrack, evaluateQueueSize or shouldCancelChunkLoad will happen after this call.

This method may only be called when the track selection is already enabled.

enable

public void enable()

Enables the track selection. Dynamic changes via updateSelectedTrack, evaluateQueueSize or shouldCancelChunkLoad will only happen after this call.

This method may not be called when the track selection is already enabled.

evaluateQueueSize

public int evaluateQueueSize(long playbackPositionUs, List<MediaChunk> queue)

Returns the number of chunks that should be retained in the queue.

May be called by sources that load media in discrete MediaChunks and support discarding of buffered chunks.

To avoid excessive re-buffering, implementations should normally return the size of the queue. An example of a case where a smaller value may be returned is if network conditions have improved dramatically, allowing chunks to be discarded and re-buffered in a track of significantly higher quality. Discarding chunks may allow faster switching to a higher quality track in this case.

Note that even if the source supports discarding of buffered chunks, the actual number of discarded chunks is not guaranteed. The source will call updateSelectedTrack with the updated queue of chunks before loading a new chunk to allow switching to another quality.

This method will only be called when the selection is enabled and none of the MediaChunks in the queue are currently loading.

Parameters
long playbackPositionUs

The current playback position in microseconds. If playback of the period to which this track selection belongs has not yet started, the value will be the starting position in the period minus the duration of any media in previous periods still to be played.

List<MediaChunk> queue

The queue of buffered MediaChunks. Must not be modified.

Returns
int

The number of chunks to retain in the queue.

getFormat

public Format getFormat(int index)

Returns the format of the track at a given index in the selection.

Parameters
int index

The index in the selection.

Returns
Format

The format of the selected track.

getIndexInTrackGroup

public int getIndexInTrackGroup(int index)

Returns the index in the track group of the track at a given index in the selection.

Parameters
int index

The index in the selection.

Returns
int

The index of the selected track.

getSelectedFormat

public Format getSelectedFormat()

Returns the Format of the individual selected track.

getSelectedIndex

public int getSelectedIndex()

Returns the index of the selected track.

getSelectedIndexInTrackGroup

public int getSelectedIndexInTrackGroup()

Returns the index in the track group of the individual selected track.

getSelectionData

public @Nullable Object getSelectionData()

Returns optional data associated with the current track selection.

getSelectionReason

@C.SelectionReason
public int getSelectionReason()

Returns the reason for the current track selection.

getTrackGroup

public TrackGroup getTrackGroup()

Returns the TrackGroup to which the selected tracks belong.

getType

public int getType()

Returns an integer specifying the type of the selection, or TYPE_UNSET if not specified.

Track selection types are specific to individual applications, but should be defined starting from TYPE_CUSTOM_BASE to ensure they don't conflict with any types that may be added to the library in the future.

indexOf

public int indexOf(Format format)

Returns the index in the selection of the track with the specified format. The format is located by identity so, for example, selection.indexOf(selection.getFormat(index)) == index even if multiple selected tracks have formats that contain the same values.

Parameters
Format format

The format.

Returns
int

The index in the selection, or INDEX_UNSET if the track with the specified format is not part of the selection.

indexOf

public int indexOf(int indexInTrackGroup)

Returns the index in the selection of the track with the specified index in the track group.

Parameters
int indexInTrackGroup

The index in the track group.

Returns
int

The index in the selection, or INDEX_UNSET if the track with the specified index is not part of the selection.

isBlacklisted

public boolean isBlacklisted(int index, long nowMs)

Returns whether the track at the specified index in the selection is excluded.

Parameters
int index

The index of the track in the selection.

long nowMs

The current time in the timebase of elapsedRealtime.

length

public int length()

Returns the number of tracks in the selection.

onPlaybackSpeed

public void onPlaybackSpeed(float playbackSpeed)

Called to notify the selection of the current playback speed. The playback speed may affect adaptive track selection.

Parameters
float playbackSpeed

The factor by which playback is sped up.

updateSelectedTrack

public void updateSelectedTrack(
    long playbackPositionUs,
    long bufferedDurationUs,
    long availableDurationUs,
    List<MediaChunk> queue,
    MediaChunkIterator[] mediaChunkIterators
)

Updates the selected track for sources that load media in discrete MediaChunks.

This method will only be called when the selection is enabled.

Parameters
long playbackPositionUs

The current playback position in microseconds. If playback of the period to which this track selection belongs has not yet started, the value will be the starting position in the period minus the duration of any media in previous periods still to be played.

long bufferedDurationUs

The duration of media currently buffered from the current playback position, in microseconds. Note that the next load position can be calculated as (playbackPositionUs + bufferedDurationUs).

long availableDurationUs

The duration of media available for buffering from the current playback position, in microseconds, or TIME_UNSET if media can be buffered to the end of the current period. Note that if not set to TIME_UNSET, the position up to which media is available for buffering can be calculated as (playbackPositionUs + availableDurationUs).

List<MediaChunk> queue

The queue of already buffered MediaChunks. Must not be modified.

MediaChunkIterator[] mediaChunkIterators

An array of MediaChunkIterators providing information about the sequence of upcoming media chunks for each track in the selection. All iterators start from the media chunk which will be loaded next if the respective track is selected. Note that this information may not be available for all tracks, and so some iterators may be empty.