com.google.android.exoplayer2.trackselection

Class DefaultTrackSelector

java.lang.Object

com.google.android.exoplayer2.trackselection.TrackSelector

com.google.android.exoplayer2.trackselection.MappingTrackSelector

com.google.android.exoplayer2.trackselection.DefaultTrackSelector

public class DefaultTrackSelector
extends MappingTrackSelector

A MappingTrackSelector that allows configuration of common parameters. It is safe to call the methods of this class from the application thread. See Parameters#Parameters() for default selection parameters.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultTrackSelector.Parameters Holder for available configurations for the DefaultTrackSelector.

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

MappingTrackSelector.MappedTrackInfo, MappingTrackSelector.SelectionOverride

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

TrackSelector.InvalidationListener

Constructor Summary

Constructors

Constructor and Description
DefaultTrackSelector() Constructs an instance that does not support adaptive track selection.
DefaultTrackSelector(BandwidthMeter bandwidthMeter) Constructs an instance that supports adaptive track selection.
DefaultTrackSelector(TrackSelection.Factory adaptiveTrackSelectionFactory) Constructs an instance that uses a factory to create adaptive track selections.

Method Summary

Modifier and Type	Method and Description
protected static boolean	formatHasLanguage(Format format, java.lang.String language)
DefaultTrackSelector.Parameters	getParameters() Gets the current selection parameters.
protected static boolean	isSupported(int formatSupport, boolean allowExceedsCapabilities)
protected TrackSelection	selectAudioTrack(TrackGroupArray groups, int[][] formatSupport, java.lang.String preferredAudioLanguage, boolean exceedRendererCapabilitiesIfNecessary, boolean allowMixedMimeAdaptiveness, TrackSelection.Factory adaptiveTrackSelectionFactory)
protected TrackSelection	selectOtherTrack(int trackType, TrackGroupArray groups, int[][] formatSupport, boolean exceedRendererCapabilitiesIfNecessary)
protected TrackSelection	selectTextTrack(TrackGroupArray groups, int[][] formatSupport, java.lang.String preferredTextLanguage, java.lang.String preferredAudioLanguage, boolean exceedRendererCapabilitiesIfNecessary)
protected 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.
protected TrackSelection	selectVideoTrack(RendererCapabilities rendererCapabilities, TrackGroupArray groups, int[][] formatSupport, int maxVideoWidth, int maxVideoHeight, int maxVideoBitrate, boolean allowNonSeamlessAdaptiveness, boolean allowMixedMimeAdaptiveness, int viewportWidth, int viewportHeight, boolean orientationMayChange, TrackSelection.Factory adaptiveTrackSelectionFactory, boolean exceedConstraintsIfNecessary, boolean exceedRendererCapabilitiesIfNecessary)
void	setParameters(DefaultTrackSelector.Parameters params) Atomically sets the provided parameters for track selection.

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

clearSelectionOverride, clearSelectionOverrides, clearSelectionOverrides, getCurrentMappedTrackInfo, getRendererDisabled, getSelectionOverride, hasSelectionOverride, onSelectionActivated, selectTracks, setRendererDisabled, setSelectionOverride, setTunnelingAudioSessionId

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

DefaultTrackSelector

public DefaultTrackSelector()

Constructs an instance that does not support adaptive track selection.

DefaultTrackSelector

public DefaultTrackSelector(BandwidthMeter bandwidthMeter)

Constructs an instance that supports adaptive track selection. Adaptive track selections use the provided BandwidthMeter to determine which individual track should be used during playback.

Parameters:

bandwidthMeter - The BandwidthMeter.

DefaultTrackSelector

public DefaultTrackSelector(TrackSelection.Factory adaptiveTrackSelectionFactory)

Constructs an instance that uses a factory to create adaptive track selections.

Parameters:

adaptiveTrackSelectionFactory - A factory for adaptive TrackSelections, or null if the selector should not support adaptive tracks.

Method Detail

setParameters

public void setParameters(DefaultTrackSelector.Parameters params)

Atomically sets the provided parameters for track selection.

Parameters:

params - The parameters for track selection.

getParameters

public DefaultTrackSelector.Parameters getParameters()

Gets the current selection parameters.

Returns:

The current selection parameters.

selectTracks

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

Description copied from class: MappingTrackSelector

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

Specified by:

selectTracks in class MappingTrackSelector

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.

selectVideoTrack

protected TrackSelection selectVideoTrack(RendererCapabilities rendererCapabilities,
                                          TrackGroupArray groups,
                                          int[][] formatSupport,
                                          int maxVideoWidth,
                                          int maxVideoHeight,
                                          int maxVideoBitrate,
                                          boolean allowNonSeamlessAdaptiveness,
                                          boolean allowMixedMimeAdaptiveness,
                                          int viewportWidth,
                                          int viewportHeight,
                                          boolean orientationMayChange,
                                          TrackSelection.Factory adaptiveTrackSelectionFactory,
                                          boolean exceedConstraintsIfNecessary,
                                          boolean exceedRendererCapabilitiesIfNecessary)
                                   throws ExoPlaybackException

Throws:

ExoPlaybackException

selectAudioTrack

protected TrackSelection selectAudioTrack(TrackGroupArray groups,
                                          int[][] formatSupport,
                                          java.lang.String preferredAudioLanguage,
                                          boolean exceedRendererCapabilitiesIfNecessary,
                                          boolean allowMixedMimeAdaptiveness,
                                          TrackSelection.Factory adaptiveTrackSelectionFactory)

selectTextTrack

protected TrackSelection selectTextTrack(TrackGroupArray groups,
                                         int[][] formatSupport,
                                         java.lang.String preferredTextLanguage,
                                         java.lang.String preferredAudioLanguage,
                                         boolean exceedRendererCapabilitiesIfNecessary)

selectOtherTrack

protected TrackSelection selectOtherTrack(int trackType,
                                          TrackGroupArray groups,
                                          int[][] formatSupport,
                                          boolean exceedRendererCapabilitiesIfNecessary)

isSupported

protected static boolean isSupported(int formatSupport,
                                     boolean allowExceedsCapabilities)

formatHasLanguage

protected static boolean formatHasLanguage(Format format,
                                           java.lang.String language)