FakeTrackSelection

public int enableCount

public boolean isEnabled

public int releaseCount

public final int selectedIndex

public FakeTrackSelection(TrackGroup rendererTrackGroup)

public FakeTrackSelection(TrackGroup rendererTrackGroup, int selectedIndex)

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.

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.

public boolean equals(@Nullable Object o)

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.

public boolean excludeTrack(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.

public Format getFormat(int index)

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

public int getIndexInTrackGroup(int index)

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

public Format getSelectedFormat()

Returns the Format of the individual selected track.

public int getSelectedIndex()

Returns the index of the selected track.

public int getSelectedIndexInTrackGroup()

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

public @Nullable Object getSelectionData()

Returns optional data associated with the current track selection.

@C.SelectionReason
public int getSelectionReason()

Returns the reason for the current track selection.

public TrackGroup getTrackGroup()

Returns the TrackGroup to which the selected tracks belong.

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.

public int hashCode()

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.

public int indexOf(int indexInTrackGroup)

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

public boolean isTrackExcluded(int index, long nowMs)

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

public int length()

Returns the number of tracks in the selection.

public void onPlaybackSpeed(float playbackSpeed)

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

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.