ExoTrackSelection (ExoPlayer library)

Package com.google.android.exoplayer2.trackselection

Interface ExoTrackSelection

• All Superinterfaces:TrackSelectionAll Known Implementing Classes:AdaptiveTrackSelection, BaseTrackSelection, FakeTrackSelection, FixedTrackSelection, RandomTrackSelection

[@Deprecated](https://developer.android.com/reference/java/lang/Deprecated.html "class or interface in java.lang")public interfaceExoTrackSelectionextends[TrackSelection](TrackSelection.html "interface in com.google.android.exoplayer2.trackselection")

Deprecated. com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.

A TrackSelection that can change the individually selected track as a result of calling updateSelectedTrack(long, long, long, List, MediaChunkIterator[]) or evaluateQueueSize(long, List). This only happens between calls to enable() and disable().

Nested Class Summary

Nested Classes | Modifier and Type | Interface | Description | | --- | --- | --- | | static class | ExoTrackSelection.Definition | Deprecated.

Contains of a subset of selected tracks belonging to a TrackGroup. | | static interface | ExoTrackSelection.Factory | Deprecated.

Factory for ExoTrackSelection instances. |

- 

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.trackselection.TrackSelection

TrackSelection.Type

Field Summary

- 

Fields inherited from interface com.google.android.exoplayer2.trackselection.TrackSelection

TYPE_CUSTOM_BASE, TYPE_UNSET

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods | Modifier and Type | Method | Description | | --- | --- | --- | | void | disable() | Deprecated.

Disables this track selection. | | void | enable() | Deprecated.

Enables the track selection. | | int | evaluateQueueSize​(long playbackPositionUs, List<? extends MediaChunk> queue) | Deprecated.

Returns the number of chunks that should be retained in the queue. | | boolean | excludeTrack​(int index, long exclusionDurationMs) | Deprecated.

Attempts to exclude the track at the specified index in the selection, making it ineligible for selection by calls to updateSelectedTrack(long, long, long, List, MediaChunkIterator[]) for the specified period of time. | | default long | getLatestBitrateEstimate() | Deprecated.

Returns the most recent bitrate estimate utilised for track selection. | | Format | getSelectedFormat() | Deprecated.

Returns the Format of the individual selected track. | | int | getSelectedIndex() | Deprecated.

Returns the index of the selected track. | | int | getSelectedIndexInTrackGroup() | Deprecated.

Returns the index in the track group of the individual selected track. | | Object | getSelectionData() | Deprecated.

Returns optional data associated with the current track selection. | | @com.google.android.exoplayer2.C.SelectionReason int | getSelectionReason() | Deprecated.

Returns the reason for the current track selection. | | boolean | isTrackExcluded​(int index, long nowMs) | Deprecated.

Returns whether the track at the specified index in the selection is excluded. | | default void | onDiscontinuity() | Deprecated.

Called to notify the selection of a position discontinuity. | | void | onPlaybackSpeed​(float playbackSpeed) | Deprecated.

Called to notify the selection of the current playback speed. | | default void | onPlayWhenReadyChanged​(boolean playWhenReady) | Deprecated.

Called to notify when the playback is paused or resumed. | | default void | onRebuffer() | Deprecated.

Called to notify when a rebuffer occurred. | | default boolean | shouldCancelChunkLoad​(long playbackPositionUs, Chunk loadingChunk, List<? extends MediaChunk> queue) | Deprecated.

Returns whether an ongoing load of a chunk should be canceled. | | void | updateSelectedTrack​(long playbackPositionUs, long bufferedDurationUs, long availableDurationUs, List<? extends MediaChunk> queue, MediaChunkIterator[] mediaChunkIterators) | Deprecated.

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

- 

Methods inherited from interface com.google.android.exoplayer2.trackselection.TrackSelection

getFormat, getIndexInTrackGroup, getTrackGroup, getType, indexOf, indexOf, length

Method Detail

- 

enable

void enable()

Deprecated.

Enables the track selection. Dynamic changes via updateSelectedTrack(long, long, long, List, MediaChunkIterator[]), evaluateQueueSize(long, List) or shouldCancelChunkLoad(long, Chunk, List) will only happen after this call.

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

- 

disable

void disable()

Deprecated.

Disables this track selection. No further dynamic changes via updateSelectedTrack(long, long, long, List, MediaChunkIterator[]), evaluateQueueSize(long, List) or shouldCancelChunkLoad(long, Chunk, List) will happen after this call.

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

- 

getSelectedFormat

[Format](../Format.html "class in com.google.android.exoplayer2")getSelectedFormat()

Deprecated.

Returns the Format of the individual selected track.

- 

getSelectedIndexInTrackGroup

int getSelectedIndexInTrackGroup()

Deprecated.

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

- 

getSelectedIndex

int getSelectedIndex()

Deprecated.

Returns the index of the selected track.

- 

getSelectionReason

@com.google.android.exoplayer2.C.SelectionReason int getSelectionReason()

Deprecated.

Returns the reason for the current track selection.

- 

getSelectionData

@Nullable[Object](https://developer.android.com/reference/java/lang/Object.html "class or interface in java.lang")getSelectionData()

Deprecated.

Returns optional data associated with the current track selection.

- 

onPlaybackSpeed

void onPlaybackSpeed​(float playbackSpeed)

Deprecated.

Called to notify the selection of the current playback speed. The playback speed may affect adaptive track selection. Parameters:playbackSpeed - The factor by which playback is sped up.

- 

onDiscontinuity

default void onDiscontinuity()

Deprecated.

Called to notify the selection of a position discontinuity.

This happens when the playback position jumps, e.g., as a result of a seek being performed.

- 

onRebuffer

default void onRebuffer()

Deprecated.

Called to notify when a rebuffer occurred.

A rebuffer is defined to be caused by buffer depletion rather than a user action. Hence this method is not called during initial buffering or when buffering as a result of a seek operation.

- 

onPlayWhenReadyChanged

default void onPlayWhenReadyChanged​(boolean playWhenReady)

Deprecated.

Called to notify when the playback is paused or resumed. Parameters:playWhenReady - Whether playback will proceed when ready.

- 

updateSelectedTrack

void updateSelectedTrack​(long playbackPositionUs,
                         long bufferedDurationUs,
                         long availableDurationUs,[List](https://developer.android.com/reference/java/util/List.html "class or interface in java.util")<? extends[MediaChunk](../source/chunk/MediaChunk.html "class in com.google.android.exoplayer2.source.chunk")> queue,[MediaChunkIterator](../source/chunk/MediaChunkIterator.html "interface in com.google.android.exoplayer2.source.chunk")[] mediaChunkIterators)

Deprecated.

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

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

Parameters: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.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).availableDurationUs - The duration of media available for buffering from the current playback position, in microseconds, or C.TIME_UNSET if media can be buffered to the end of the current period. Note that if not set to C.TIME_UNSET, the position up to which media is available for buffering can be calculated as (playbackPositionUs + availableDurationUs).queue - The queue of already buffered MediaChunks. Must not be modified.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.

- 

evaluateQueueSize

int evaluateQueueSize​(long playbackPositionUs,[List](https://developer.android.com/reference/java/util/List.html "class or interface in java.util")<? extends[MediaChunk](../source/chunk/MediaChunk.html "class in com.google.android.exoplayer2.source.chunk")> queue)

Deprecated.

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(long, long, long, List, MediaChunkIterator[]) 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: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.queue - The queue of buffered MediaChunks. Must not be modified.Returns:The number of chunks to retain in the queue.

- 

shouldCancelChunkLoad

default boolean shouldCancelChunkLoad​(long playbackPositionUs,[Chunk](../source/chunk/Chunk.html "class in com.google.android.exoplayer2.source.chunk")loadingChunk,[List](https://developer.android.com/reference/java/util/List.html "class or interface in java.util")<? extends[MediaChunk](../source/chunk/MediaChunk.html "class in com.google.android.exoplayer2.source.chunk")> queue)

Deprecated.

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

May be called by sources that load media in discrete MediaChunks and support canceling the ongoing chunk load. The ongoing chunk load is either the last MediaChunk in the queue or another type of Chunk, for example, if the source loads initialization or encryption data.

To avoid excessive re-buffering, implementations should normally return false. An example where true might be returned is if a load of a high quality chunk gets stuck and canceling this load in favor of a lower quality alternative may avoid a rebuffer.

The source will call evaluateQueueSize(long, List) after the cancelation finishes to allow discarding of chunks, and updateSelectedTrack(long, long, long, List, MediaChunkIterator[]) before loading a new chunk to allow switching to another quality.

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

Parameters: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.loadingChunk - The currently loading Chunk that will be canceled if this method returns true.queue - The queue of buffered MediaChunks, including the loadingChunk if it's a MediaChunk. Must not be modified.Returns:Whether the ongoing load of loadingChunk should be canceled.

- 

excludeTrack

boolean excludeTrack​(int index,
                     long exclusionDurationMs)

Deprecated.

Attempts to exclude the track at the specified index in the selection, making it ineligible for selection by calls to updateSelectedTrack(long, long, long, List, MediaChunkIterator[]) 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(long, long, long, List, MediaChunkIterator[]).

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

Parameters:index - The index of the track in the selection.exclusionDurationMs - The duration of time for which the track should be excluded, in milliseconds.Returns:Whether exclusion was successful.

- 

isTrackExcluded

boolean isTrackExcluded​(int index,
                        long nowMs)

Deprecated.

Returns whether the track at the specified index in the selection is excluded. Parameters:index - The index of the track in the selection.nowMs - The current time in the timebase of SystemClock.elapsedRealtime().

- 

getLatestBitrateEstimate

default long getLatestBitrateEstimate()

Deprecated.

Returns the most recent bitrate estimate utilised for track selection.

The default behavior is to return Long.MIN_VALUE, indicating that the bitrate estimate was not computed for the track selection decision.