com.google.android.exoplayer2.trackselection

Class MappingTrackSelector

java.lang.Object

com.google.android.exoplayer2.trackselection.TrackSelector

com.google.android.exoplayer2.trackselection.MappingTrackSelector

Direct Known Subclasses:

DefaultTrackSelector

public abstract class MappingTrackSelector
extends TrackSelector

Base class for TrackSelectors that first establish a mapping between TrackGroups and renderers, and then from that mapping create a TrackSelection for each renderer.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MappingTrackSelector.MappedTrackInfo Provides track information for each renderer.
static class	MappingTrackSelector.SelectionOverride A track selection override.

Nested classes/interfaces inherited from class com.google.android.exoplayer2.trackselection.TrackSelector

TrackSelector.InvalidationListener

Constructor Summary

Constructors

Constructor and Description
MappingTrackSelector()

Method Summary

Modifier and Type	Method and Description
void	clearSelectionOverride(int rendererIndex, TrackGroupArray groups) Clears a track selection override for the specified renderer and TrackGroupArray.
void	clearSelectionOverrides() Clears all track selection overrides.
void	clearSelectionOverrides(int rendererIndex) Clears all track selection override for the specified renderer.
MappingTrackSelector.MappedTrackInfo	getCurrentMappedTrackInfo() Returns the mapping information associated with the current track selections, or null if no selection is currently active.
boolean	getRendererDisabled(int rendererIndex) Returns whether the renderer is disabled.
MappingTrackSelector.SelectionOverride	getSelectionOverride(int rendererIndex, TrackGroupArray groups) Returns the override for the specified renderer and TrackGroupArray.
boolean	hasSelectionOverride(int rendererIndex, TrackGroupArray groups) Returns whether there is an override for the specified renderer and TrackGroupArray.
void	onSelectionActivated(java.lang.Object info) Called when a TrackSelectorResult previously generated by TrackSelector.selectTracks(RendererCapabilities[], TrackGroupArray) is activated.
TrackSelectorResult	selectTracks(RendererCapabilities[] rendererCapabilities, TrackGroupArray trackGroups) Performs a track selection for renderers.
protected abstract TrackSelection[]	selectTracks(RendererCapabilities[] rendererCapabilities, TrackGroupArray[] rendererTrackGroupArrays, int[][][] rendererFormatSupports) Given an array of renderers and a set of TrackGroups mapped to each of them, provides a TrackSelection per renderer.
void	setRendererDisabled(int rendererIndex, boolean disabled) Sets whether the renderer at the specified index is disabled.
void	setSelectionOverride(int rendererIndex, TrackGroupArray groups, MappingTrackSelector.SelectionOverride override) Overrides the track selection for the renderer at a specified index.
void	setTunnelingAudioSessionId(int tunnelingAudioSessionId) Enables or disables tunneling.

Methods inherited from class com.google.android.exoplayer2.trackselection.TrackSelector

init, invalidate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MappingTrackSelector

public MappingTrackSelector()

Method Detail

getCurrentMappedTrackInfo

public final MappingTrackSelector.MappedTrackInfo getCurrentMappedTrackInfo()

Returns the mapping information associated with the current track selections, or null if no selection is currently active.

setRendererDisabled

public final void setRendererDisabled(int rendererIndex,
                                      boolean disabled)

Sets whether the renderer at the specified index is disabled.

Parameters:

rendererIndex - The renderer index.

disabled - Whether the renderer is disabled.

getRendererDisabled

public final boolean getRendererDisabled(int rendererIndex)

Returns whether the renderer is disabled.

Parameters:

rendererIndex - The renderer index.

Returns:

Whether the renderer is disabled.

setSelectionOverride

public final void setSelectionOverride(int rendererIndex,
                                       TrackGroupArray groups,
                                       MappingTrackSelector.SelectionOverride override)

Overrides the track selection for the renderer at a specified index.

When the TrackGroupArray available to the renderer at the specified index matches the one provided, the override is applied. When the TrackGroupArray does not match, the override has no effect. The override replaces any previous override for the renderer and the provided TrackGroupArray.

Passing a null override will explicitly disable the renderer. To remove overrides use clearSelectionOverride(int, TrackGroupArray), clearSelectionOverrides(int) or clearSelectionOverrides().

Parameters:

rendererIndex - The renderer index.

groups - The TrackGroupArray for which the override should be applied.

override - The override.

hasSelectionOverride

public final boolean hasSelectionOverride(int rendererIndex,
                                          TrackGroupArray groups)

Returns whether there is an override for the specified renderer and TrackGroupArray.

Parameters:

rendererIndex - The renderer index.

groups - The TrackGroupArray.

Returns:

Whether there is an override.

getSelectionOverride

public final MappingTrackSelector.SelectionOverride getSelectionOverride(int rendererIndex,
                                                                         TrackGroupArray groups)

Returns the override for the specified renderer and TrackGroupArray.

Parameters:

rendererIndex - The renderer index.

groups - The TrackGroupArray.

Returns:

The override, or null if no override exists.

clearSelectionOverride

public final void clearSelectionOverride(int rendererIndex,
                                         TrackGroupArray groups)

Clears a track selection override for the specified renderer and TrackGroupArray.

Parameters:

rendererIndex - The renderer index.

groups - The TrackGroupArray for which the override should be cleared.

clearSelectionOverrides

public final void clearSelectionOverrides(int rendererIndex)

Clears all track selection override for the specified renderer.

Parameters:

rendererIndex - The renderer index.

clearSelectionOverrides

public final void clearSelectionOverrides()

Clears all track selection overrides.

setTunnelingAudioSessionId

public void setTunnelingAudioSessionId(int tunnelingAudioSessionId)

Enables or disables tunneling. To enable tunneling, pass an audio session id to use when in tunneling mode. Session ids can be generated using C.generateAudioSessionIdV21(Context). To disable tunneling pass C.AUDIO_SESSION_ID_UNSET. Tunneling will only be activated if it's both enabled and supported by the audio and video renderers for the selected tracks.

Parameters:

tunnelingAudioSessionId - The audio session id to use when tunneling, or C.AUDIO_SESSION_ID_UNSET to disable tunneling.

selectTracks

public final TrackSelectorResult selectTracks(RendererCapabilities[] rendererCapabilities,
                                              TrackGroupArray trackGroups)
                                       throws ExoPlaybackException

Description copied from class: TrackSelector

Performs a track selection for renderers.

Specified by:

selectTracks in class TrackSelector

Parameters:

rendererCapabilities - The RendererCapabilities of the renderers for which tracks are to be selected.

trackGroups - The available track groups.

Returns:

A TrackSelectorResult describing the track selections.

Throws:

ExoPlaybackException - If an error occurs selecting tracks.

onSelectionActivated

public final void onSelectionActivated(java.lang.Object info)

Description copied from class: TrackSelector

Called when a TrackSelectorResult previously generated by TrackSelector.selectTracks(RendererCapabilities[], TrackGroupArray) is activated.

Specified by:

onSelectionActivated in class TrackSelector

Parameters:

info - The value of TrackSelectorResult.info in the activated result.

selectTracks

protected abstract TrackSelection[] selectTracks(RendererCapabilities[] rendererCapabilities,
                                                 TrackGroupArray[] rendererTrackGroupArrays,
                                                 int[][][] rendererFormatSupports)
                                          throws ExoPlaybackException

Given an array of renderers and a set of TrackGroups mapped to each of them, provides a TrackSelection per renderer.

Parameters:

rendererCapabilities - The RendererCapabilities of the renderers for which TrackSelections are to be generated.

rendererTrackGroupArrays - An array of TrackGroupArrays where each entry corresponds to the renderer of equal index in renderers.

rendererFormatSupports - Maps every available track to a specific level of support as defined by the renderer FORMAT_* constants.

Throws:

ExoPlaybackException - If an error occurs while selecting the tracks.