# TrackSelector

Artifact: [androidx.media3:media3-exoplayer](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/exoplayer/trackselection/TrackSelector.java+class:androidx.media3.exoplayer.trackselection.TrackSelector)

*** ** * ** ***


```
@UnstableApi
public abstract class TrackSelector
```

<br />

Known direct subclasses [MappingTrackSelector](https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/MappingTrackSelector)

|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/MappingTrackSelector` | Base class for `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector`s that first establish a mapping between `https://developer.android.com/reference/androidx/media3/common/TrackGroup`s and `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer`s, and then from that mapping create a `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/ExoTrackSelection` for each renderer. |

Known indirect subclasses [DefaultTrackSelector](https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/DefaultTrackSelector), [FakeTrackSelector](https://developer.android.com/reference/androidx/media3/test/utils/FakeTrackSelector)

|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/DefaultTrackSelector` | A default `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector` suitable for most use cases. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeTrackSelector` | A fake `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/MappingTrackSelector` that returns `https://developer.android.com/reference/androidx/media3/test/utils/FakeTrackSelection`s. |

*** ** * ** ***

The component of an `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlayer` responsible for selecting tracks to be consumed by each of the player's `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer`s. The `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/DefaultTrackSelector` implementation should be suitable for most use cases.

## Interactions with the player

The following interactions occur between the player and its track selector during playback.

- When the player is created it will initialize the track selector by calling `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#init(androidx.media3.exoplayer.trackselection.TrackSelector.InvalidationListener,androidx.media3.exoplayer.upstream.BandwidthMeter)`.
- When the player needs to make a track selection it will call `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)`. This typically occurs at the start of playback, when the player starts to buffer a new period of the media being played, and when the track selector invalidates its previous selections.
- The player may perform a track selection well in advance of the selected tracks becoming active, where active is defined to mean that the renderers are actually consuming media corresponding to the selection that was made. For example when playing media containing multiple periods, the track selection for a period is made when the player starts to buffer that period. Hence if the player's buffering policy is to maintain a 30 second buffer, the selection will occur approximately 30 seconds in advance of it becoming active. In fact the selection may never become active, for example if the user seeks to some other period of the media during the 30 second gap. The player indicates to the track selector when a selection it has previously made becomes active by calling `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#onSelectionActivated(java.lang.Object)`.
- When the track selector's configuration changes (for example, if it now wishes to prefer audio tracks in a particular language) or its previous selections become invalid, it can trigger invalidation by calling `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#invalidate(androidx.media3.common.TrackSelectionParameters)`. This invokes `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener#onTrackSelectionsInvalidated(androidx.media3.common.TrackSelectionParameters)` on the `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener` that was passed to `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#init(androidx.media3.exoplayer.trackselection.TrackSelector.InvalidationListener,androidx.media3.exoplayer.upstream.BandwidthMeter)`. When handling this callback, if `parameters` is not `null`, the listener must call `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#onParametersActivated(androidx.media3.common.TrackSelectionParameters)` to activate the updated parameters before triggering the player to make new track selections. Note that the player will have to re-buffer if the new track selection for the currently playing period differs from the one that was invalidated.
- When the player is `https://developer.android.com/reference/androidx/media3/common/Player#release()`, it will release the track selector by calling `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#release()`.

## Track selection parameters

Track selection parameters can be retrieved and modified on the application thread by calling `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#getParameters()` and `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#setParameters(androidx.media3.common.TrackSelectionParameters)` respectively (if supported, as indicated by `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#isSetParametersSupported()`). Modifying parameters on the application thread triggers the invalidation flow described above, ensuring that the updated parameters are activated and applied on the playback thread.

## Renderer configuration

The `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult` returned by `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)` contains not only `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelection`s for each renderer, but also `https://developer.android.com/reference/androidx/media3/exoplayer/RendererConfiguration`s defining configuration parameters that the renderers should apply when consuming the corresponding media. Whilst it may seem counter- intuitive for a track selector to also specify renderer configuration information, in practice the two are tightly bound together. It may only be possible to play a certain combination tracks if the renderers are configured in a particular way. Equally, it may only be possible to configure renderers in a particular way if certain tracks are selected. Hence it makes sense to determine the track selection and corresponding renderer configurations in a single step.

## Threading model

All methods must be called on the same playback thread, except for those specifically documented to be called on a separate application thread.

## Summary

| ### Nested types |
|---|
| `public interface https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.Factory` Factory for creating `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector` from `https://developer.android.com/reference/android/content/Context.html`. |
| `public interface https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener` Notified when selections previously made by a `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector` are no longer valid. |

| ### Protected fields |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/upstream/BandwidthMeter` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#bandwidthMeter()` |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#TrackSelector()()` |

| ### Public methods |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#getParameters()()` Returns the current parameters for track selection. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#getRendererCapabilitiesListener()()` Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener` that the concrete instance uses to listen to the renderer capabilities changes. |
| `void` | `@https://developer.android.com/reference/androidx/annotation/CallSuper https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#init(androidx.media3.exoplayer.trackselection.TrackSelector.InvalidationListener,androidx.media3.exoplayer.upstream.BandwidthMeter)( https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener listener, https://developer.android.com/reference/androidx/media3/exoplayer/upstream/BandwidthMeter bandwidthMeter )` Called by the player to initialize the selector. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#isSetParametersSupported()()` Returns if this `TrackSelector` supports `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#setParameters(androidx.media3.common.TrackSelectionParameters)`. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#onParametersActivated(androidx.media3.common.TrackSelectionParameters)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters)` Called by the player when track selection parameters become active for subsequent track selections made by `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)`. |
| `abstract void` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#onSelectionActivated(java.lang.Object)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html info)` Called by the player when a `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult` previously generated by `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)` is activated. |
| `void` | `@https://developer.android.com/reference/androidx/annotation/CallSuper https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#release()()` Called by the player to release the selector. |
| `abstract https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)( RendererCapabilities[] rendererCapabilities, https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroups, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId periodId, https://developer.android.com/reference/androidx/media3/common/Timeline timeline )` Called by the player to perform a track selection. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#setAudioAttributes(androidx.media3.common.AudioAttributes)(https://developer.android.com/reference/androidx/media3/common/AudioAttributes audioAttributes)` Called by the player to set the `https://developer.android.com/reference/androidx/media3/common/AudioAttributes` that will be used for playback. |
| `void` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#setParameters(androidx.media3.common.TrackSelectionParameters)(https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters)` Called by the player to provide parameters for track selection. |

| ### Protected methods |
|---|---|
| `final https://developer.android.com/reference/androidx/media3/exoplayer/upstream/BandwidthMeter` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#getBandwidthMeter()()` Returns a bandwidth meter which can be used by track selections to select tracks. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#invalidate(androidx.media3.common.TrackSelectionParameters)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters)` Calls `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener#onTrackSelectionsInvalidated(androidx.media3.common.TrackSelectionParameters)` to invalidate all previously generated track selections. |
| `final void` | `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#invalidateForRendererCapabilitiesChange(androidx.media3.exoplayer.Renderer)(https://developer.android.com/reference/androidx/media3/exoplayer/Renderer renderer)` Calls `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener#onRendererCapabilitiesChanged(androidx.media3.exoplayer.Renderer)` to invalidate all previously generated track selections because a renderer's capabilities have changed. |

## Protected fields

### bandwidthMeter

```
protected @Nullable BandwidthMeter bandwidthMeter
```

## Public constructors

### TrackSelector

```
public TrackSelector()
```

## Public methods

### getParameters

```
public TrackSelectionParameters getParameters()
```

Returns the current parameters for track selection.

This method must be called from the application thread.

### getRendererCapabilitiesListener

```
public @Nullable RendererCapabilities.Listener getRendererCapabilitiesListener()
```

Returns the `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities.Listener` that the concrete instance uses to listen to the renderer capabilities changes. May be `null` if the implementation does not listen to the renderer capabilities changes.

### init

```
@CallSuper
public void init(
    TrackSelector.InvalidationListener listener,
    BandwidthMeter bandwidthMeter
)
```

Called by the player to initialize the selector.

This method must be called from the application thread.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener listener` | An invalidation listener that the selector can call to indicate that selections it has previously made are no longer valid. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/BandwidthMeter bandwidthMeter` | A bandwidth meter which can be used by track selections to select tracks. |

### isSetParametersSupported

```
public boolean isSetParametersSupported()
```

Returns if this `TrackSelector` supports `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#setParameters(androidx.media3.common.TrackSelectionParameters)`.

The same value is always returned for a given `TrackSelector` instance.

This method must be called from the application thread.

### onParametersActivated

```
public void onParametersActivated(@Nullable TrackSelectionParameters parameters)
```

Called by the player when track selection parameters become active for subsequent track selections made by `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)`.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters` | The activated track selection parameters, or `null` if no new parameters need to be activated. |

### onSelectionActivated

```
public abstract void onSelectionActivated(@Nullable Object info)
```

Called by the player when a `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult` previously generated by `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#selectTracks(androidx.media3.exoplayer.RendererCapabilities[],androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.common.Timeline)` is activated.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html info` | The value of `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult#info()` in the activated selection. |

### release

```
@CallSuper
public void release()
```

Called by the player to release the selector. The selector cannot be used until `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#init(androidx.media3.exoplayer.trackselection.TrackSelector.InvalidationListener,androidx.media3.exoplayer.upstream.BandwidthMeter)` is called again.

### selectTracks

```
public abstract TrackSelectorResult selectTracks(
    RendererCapabilities[] rendererCapabilities,
    TrackGroupArray trackGroups,
    MediaSource.MediaPeriodId periodId,
    Timeline timeline
)
```

Called by the player to perform a track selection.

| Parameters |
|---|---|
| `RendererCapabilities[] rendererCapabilities` | The `https://developer.android.com/reference/androidx/media3/exoplayer/RendererCapabilities` of the renderers for which tracks are to be selected. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroups` | The available track groups. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId periodId` | The `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` of the period for which tracks are to be selected. |
| `https://developer.android.com/reference/androidx/media3/common/Timeline timeline` | The `https://developer.android.com/reference/androidx/media3/common/Timeline` holding the period for which tracks are to be selected. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult` | A `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelectorResult` describing the track selections. |

| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/ExoPlaybackException` | If an error occurs selecting tracks. |

### setAudioAttributes

```
public void setAudioAttributes(AudioAttributes audioAttributes)
```

Called by the player to set the `https://developer.android.com/reference/androidx/media3/common/AudioAttributes` that will be used for playback.

### setParameters

```
public void setParameters(TrackSelectionParameters parameters)
```

Called by the player to provide parameters for track selection.

Only supported if `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#isSetParametersSupported()` returns true.

This method must be called from the application thread.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters` | The parameters for track selection. |

## Protected methods

### getBandwidthMeter

```
protected final BandwidthMeter getBandwidthMeter()
```

Returns a bandwidth meter which can be used by track selections to select tracks. Must only be called when the track selector is `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector#init(androidx.media3.exoplayer.trackselection.TrackSelector.InvalidationListener,androidx.media3.exoplayer.upstream.BandwidthMeter)`.

### invalidate

```
protected final void invalidate(@Nullable TrackSelectionParameters parameters)
```

Calls `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener#onTrackSelectionsInvalidated(androidx.media3.common.TrackSelectionParameters)` to invalidate all previously generated track selections.

This method can be called from both the application and the playback thread.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/common/TrackSelectionParameters parameters` | The track selection parameters, or `null` to re-evaluate selections without applying new parameters. |

### invalidateForRendererCapabilitiesChange

```
protected final void invalidateForRendererCapabilitiesChange(Renderer renderer)
```

Calls `https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/TrackSelector.InvalidationListener#onRendererCapabilitiesChanged(androidx.media3.exoplayer.Renderer)` to invalidate all previously generated track selections because a renderer's capabilities have changed.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/Renderer renderer` | The renderer whose capabilities changed. |