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 mapped track information for each renderer.

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
MappingTrackSelector.MappedTrackInfo	getCurrentMappedTrackInfo() Returns the mapping information for the currently active track selection, or null if no selection is currently active.
void	onSelectionActivated(java.lang.Object info) Called by the player when a TrackSelectorResult previously generated by TrackSelector.selectTracks(RendererCapabilities[], TrackGroupArray) is activated.
protected abstract android.util.Pair<RendererConfiguration[],TrackSelection[]>	selectTracks(MappingTrackSelector.MappedTrackInfo mappedTrackInfo, int[][][] rendererFormatSupports, int[] rendererMixedMimeTypeAdaptationSupport) Given mapped track information, returns a track selection and configuration for each renderer.
TrackSelectorResult	selectTracks(RendererCapabilities[] rendererCapabilities, TrackGroupArray trackGroups) Called by the player to perform a track selection.

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

@Nullable
public final MappingTrackSelector.MappedTrackInfo getCurrentMappedTrackInfo()

Returns the mapping information for the currently active track selection, or null if no selection is currently active.

onSelectionActivated

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

Description copied from class: TrackSelector

Called by the player 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 selection.

selectTracks

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

Description copied from class: TrackSelector

Called by the player to perform a track selection.

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.

selectTracks

protected abstract android.util.Pair<RendererConfiguration[],TrackSelection[]> selectTracks(MappingTrackSelector.MappedTrackInfo mappedTrackInfo,
                                                                                            int[][][] rendererFormatSupports,
                                                                                            int[] rendererMixedMimeTypeAdaptationSupport)
                                                                                     throws ExoPlaybackException

Given mapped track information, returns a track selection and configuration for each renderer.

Parameters:

mappedTrackInfo - Mapped track information.

rendererFormatSupports - The result of RendererCapabilities.supportsFormat(com.google.android.exoplayer2.Format) for each mapped track, indexed by renderer, track group and track (in that order).

rendererMixedMimeTypeAdaptationSupport - The result of RendererCapabilities.supportsMixedMimeTypeAdaptation() for each renderer.

Returns:

A pair consisting of the track selections and configurations for each renderer. A null configuration indicates the renderer should be disabled, in which case the track selection will also be null. A track selection may also be null for a non-disabled renderer if RendererCapabilities.getTrackType() is C.TRACK_TYPE_NONE.

Throws:

ExoPlaybackException - If an error occurs while selecting the tracks.