Class BaseTrackSelection
- java.lang.Object
-
- com.google.android.exoplayer2.trackselection.BaseTrackSelection
-
- All Implemented Interfaces:
ExoTrackSelection,TrackSelection
- Direct Known Subclasses:
AdaptiveTrackSelection,FixedTrackSelection,RandomTrackSelection
@Deprecated public abstract class BaseTrackSelection extends Object implements ExoTrackSelection
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.An abstract base class suitable for mostExoTrackSelectionimplementations.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.google.android.exoplayer2.trackselection.ExoTrackSelection
ExoTrackSelection.Definition, ExoTrackSelection.Factory
-
Nested classes/interfaces inherited from interface com.google.android.exoplayer2.trackselection.TrackSelection
TrackSelection.Type
-
-
Field Summary
Fields Modifier and Type Field Description protected TrackGroupgroupDeprecated.The selectedTrackGroup.protected intlengthDeprecated.The number of selected tracks within theTrackGroup.protected int[]tracksDeprecated.The indices of the selected tracks ingroup, in order of decreasing bandwidth.-
Fields inherited from interface com.google.android.exoplayer2.trackselection.TrackSelection
TYPE_CUSTOM_BASE, TYPE_UNSET
-
-
Constructor Summary
Constructors Constructor Description BaseTrackSelection(TrackGroup group, int... tracks)Deprecated.BaseTrackSelection(TrackGroup group, int[] tracks, @com.google.android.exoplayer2.trackselection.TrackSelection.Type int type)Deprecated.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voiddisable()Deprecated.Disables this track selection.voidenable()Deprecated.Enables the track selection.booleanequals(Object obj)Deprecated.intevaluateQueueSize(long playbackPositionUs, List<? extends MediaChunk> queue)Deprecated.Returns the number of chunks that should be retained in the queue.booleanexcludeTrack(int index, long exclusionDurationMs)Deprecated.Attempts to exclude the track at the specified index in the selection, making it ineligible for selection by calls toExoTrackSelection.updateSelectedTrack(long, long, long, List, MediaChunkIterator[])for the specified period of time.FormatgetFormat(int index)Deprecated.Returns the format of the track at a given index in the selection.intgetIndexInTrackGroup(int index)Deprecated.Returns the index in the track group of the track at a given index in the selection.FormatgetSelectedFormat()Deprecated.Returns theFormatof the individual selected track.intgetSelectedIndexInTrackGroup()Deprecated.Returns the index in the track group of the individual selected track.TrackGroupgetTrackGroup()Deprecated.Returns theTrackGroupto which the selected tracks belong.intgetType()Deprecated.Returns an integer specifying the type of the selection, orTrackSelection.TYPE_UNSETif not specified.inthashCode()Deprecated.intindexOf(int indexInTrackGroup)Deprecated.Returns the index in the selection of the track with the specified index in the track group.intindexOf(Format format)Deprecated.Returns the index in the selection of the track with the specified format.booleanisTrackExcluded(int index, long nowMs)Deprecated.Returns whether the track at the specified index in the selection is excluded.intlength()Deprecated.Returns the number of tracks in the selection.voidonPlaybackSpeed(float playbackSpeed)Deprecated.Called to notify the selection of the current playback speed.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.google.android.exoplayer2.trackselection.ExoTrackSelection
getLatestBitrateEstimate, getSelectedIndex, getSelectionData, getSelectionReason, onDiscontinuity, onPlayWhenReadyChanged, onRebuffer, shouldCancelChunkLoad, updateSelectedTrack
-
-
-
-
Field Detail
-
group
protected final TrackGroup group
Deprecated.The selectedTrackGroup.
-
length
protected final int length
Deprecated.The number of selected tracks within theTrackGroup. Always greater than zero.
-
tracks
protected final int[] tracks
Deprecated.The indices of the selected tracks ingroup, in order of decreasing bandwidth.
-
-
Constructor Detail
-
BaseTrackSelection
public BaseTrackSelection(TrackGroup group, int... tracks)
Deprecated.- Parameters:
group- TheTrackGroup. Must not be null.tracks- The indices of the selected tracks within theTrackGroup. Must not be null or empty. May be in any order.
-
BaseTrackSelection
public BaseTrackSelection(TrackGroup group, int[] tracks, @com.google.android.exoplayer2.trackselection.TrackSelection.Type int type)
Deprecated.- Parameters:
group- TheTrackGroup. Must not be null.tracks- The indices of the selected tracks within theTrackGroup. Must not be null or empty. May be in any order.type- The type that will be returned fromTrackSelection.getType().
-
-
Method Detail
-
getType
public final int getType()
Deprecated.Description copied from interface:TrackSelectionReturns an integer specifying the type of the selection, orTrackSelection.TYPE_UNSETif not specified.Track selection types are specific to individual applications, but should be defined starting from
TrackSelection.TYPE_CUSTOM_BASEto ensure they don't conflict with any types that may be added to the library in the future.- Specified by:
getTypein interfaceTrackSelection
-
getTrackGroup
public final TrackGroup getTrackGroup()
Deprecated.Description copied from interface:TrackSelectionReturns theTrackGroupto which the selected tracks belong.- Specified by:
getTrackGroupin interfaceTrackSelection
-
length
public final int length()
Deprecated.Description copied from interface:TrackSelectionReturns the number of tracks in the selection.- Specified by:
lengthin interfaceTrackSelection
-
getFormat
public final Format getFormat(int index)
Deprecated.Description copied from interface:TrackSelectionReturns the format of the track at a given index in the selection.- Specified by:
getFormatin interfaceTrackSelection- Parameters:
index- The index in the selection.- Returns:
- The format of the selected track.
-
getIndexInTrackGroup
public final int getIndexInTrackGroup(int index)
Deprecated.Description copied from interface:TrackSelectionReturns the index in the track group of the track at a given index in the selection.- Specified by:
getIndexInTrackGroupin interfaceTrackSelection- Parameters:
index- The index in the selection.- Returns:
- The index of the selected track.
-
indexOf
public final int indexOf(Format format)
Deprecated.Description copied from interface:TrackSelectionReturns 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)) == indexeven if multiple selected tracks have formats that contain the same values.- Specified by:
indexOfin interfaceTrackSelection- Parameters:
format- The format.- Returns:
- The index in the selection, or
C.INDEX_UNSETif the track with the specified format is not part of the selection.
-
indexOf
public final int indexOf(int indexInTrackGroup)
Deprecated.Description copied from interface:TrackSelectionReturns the index in the selection of the track with the specified index in the track group.- Specified by:
indexOfin interfaceTrackSelection- Parameters:
indexInTrackGroup- The index in the track group.- Returns:
- The index in the selection, or
C.INDEX_UNSETif the track with the specified index is not part of the selection.
-
getSelectedFormat
public final Format getSelectedFormat()
Deprecated.Description copied from interface:ExoTrackSelectionReturns theFormatof the individual selected track.- Specified by:
getSelectedFormatin interfaceExoTrackSelection
-
getSelectedIndexInTrackGroup
public final int getSelectedIndexInTrackGroup()
Deprecated.Description copied from interface:ExoTrackSelectionReturns the index in the track group of the individual selected track.- Specified by:
getSelectedIndexInTrackGroupin interfaceExoTrackSelection
-
enable
public void enable()
Deprecated.Description copied from interface:ExoTrackSelectionEnables the track selection. Dynamic changes viaExoTrackSelection.updateSelectedTrack(long, long, long, List, MediaChunkIterator[]),ExoTrackSelection.evaluateQueueSize(long, List)orExoTrackSelection.shouldCancelChunkLoad(long, Chunk, List)will only happen after this call.This method may not be called when the track selection is already enabled.
- Specified by:
enablein interfaceExoTrackSelection
-
disable
public void disable()
Deprecated.Description copied from interface:ExoTrackSelectionDisables this track selection. No further dynamic changes viaExoTrackSelection.updateSelectedTrack(long, long, long, List, MediaChunkIterator[]),ExoTrackSelection.evaluateQueueSize(long, List)orExoTrackSelection.shouldCancelChunkLoad(long, Chunk, List)will happen after this call.This method may only be called when the track selection is already enabled.
- Specified by:
disablein interfaceExoTrackSelection
-
onPlaybackSpeed
public void onPlaybackSpeed(float playbackSpeed)
Deprecated.Description copied from interface:ExoTrackSelectionCalled to notify the selection of the current playback speed. The playback speed may affect adaptive track selection.- Specified by:
onPlaybackSpeedin interfaceExoTrackSelection- Parameters:
playbackSpeed- The factor by which playback is sped up.
-
evaluateQueueSize
public int evaluateQueueSize(long playbackPositionUs, List<? extends MediaChunk> queue)Deprecated.Description copied from interface:ExoTrackSelectionReturns the number of chunks that should be retained in the queue.May be called by sources that load media in discrete
MediaChunksand 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
ExoTrackSelection.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
MediaChunksin the queue are currently loading.- Specified by:
evaluateQueueSizein interfaceExoTrackSelection- 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 bufferedMediaChunks. Must not be modified.- Returns:
- The number of chunks to retain in the queue.
-
excludeTrack
public boolean excludeTrack(int index, long exclusionDurationMs)Deprecated.Description copied from interface:ExoTrackSelectionAttempts to exclude the track at the specified index in the selection, making it ineligible for selection by calls toExoTrackSelection.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
ExoTrackSelection.updateSelectedTrack(long, long, long, List, MediaChunkIterator[]).This method will only be called when the selection is enabled.
- Specified by:
excludeTrackin interfaceExoTrackSelection- 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
public boolean isTrackExcluded(int index, long nowMs)Deprecated.Description copied from interface:ExoTrackSelectionReturns whether the track at the specified index in the selection is excluded.- Specified by:
isTrackExcludedin interfaceExoTrackSelection- Parameters:
index- The index of the track in the selection.nowMs- The current time in the timebase ofSystemClock.elapsedRealtime().
-
-