DefaultTrackSelector.ParametersBuilder

public ParametersBuilder(Context context)

Creates a builder with default initial values.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder addOverride(TrackSelectionOverride override)

Adds an override, replacing any override for the same TrackGroup.

public DefaultTrackSelector.Parameters build()

Builds a Parameters instance with the selected values.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearOverride(TrackGroup trackGroup)

Removes the override for the provided media TrackGroup, if there is one.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearOverrides()

Removes all overrides.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearOverridesOfType(@C.TrackType int trackType)

Removes all overrides of the provided track type.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearSelectionOverride(int rendererIndex, TrackGroupArray groups)

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

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearSelectionOverrides()

Clears all track selection overrides for all renderers.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearSelectionOverrides(int rendererIndex)

Clears all track selection overrides for the specified renderer.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearVideoSizeConstraints()

Equivalent to setMaxVideoSize(Integer.MAX_VALUE, Integer.MAX_VALUE).

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder clearViewportSizeConstraints()

Equivalent to setViewportSize(Integer.MAX_VALUE, Integer.MAX_VALUE, true).

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowAudioMixedChannelCountAdaptiveness(
    boolean allowAudioMixedChannelCountAdaptiveness
)

Sets whether to allow adaptive audio selections containing mixed channel counts.

Adaptations between different channel counts may not be completely seamless.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowAudioMixedDecoderSupportAdaptiveness(
    boolean allowAudioMixedDecoderSupportAdaptiveness
)

Sets whether to allow adaptive audio selections with mixed levels of and .

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowAudioMixedMimeTypeAdaptiveness(
    boolean allowAudioMixedMimeTypeAdaptiveness
)

Sets whether to allow adaptive audio selections containing mixed MIME types.

Adaptations between different MIME types may not be completely seamless, in which case setAllowAudioNonSeamlessAdaptiveness also needs to be true for mixed MIME type selections to be made.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowAudioMixedSampleRateAdaptiveness(
    boolean allowAudioMixedSampleRateAdaptiveness
)

Sets whether to allow adaptive audio selections containing mixed sample rates.

Adaptations between different sample rates may not be completely seamless.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowMultipleAdaptiveSelections(
    boolean allowMultipleAdaptiveSelections
)

Sets whether multiple adaptive selections with more than one track are allowed.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowVideoMixedDecoderSupportAdaptiveness(
    boolean allowVideoMixedDecoderSupportAdaptiveness
)

Sets whether to allow adaptive video selections with mixed levels of and .

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowVideoMixedMimeTypeAdaptiveness(
    boolean allowVideoMixedMimeTypeAdaptiveness
)

Sets whether to allow adaptive video selections containing mixed MIME types.

Adaptations between different MIME types may not be completely seamless, in which case setAllowVideoNonSeamlessAdaptiveness also needs to be true for mixed MIME type selections to be made.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAllowVideoNonSeamlessAdaptiveness(
    boolean allowVideoNonSeamlessAdaptiveness
)

Sets whether to allow adaptive video selections where adaptation may not be completely seamless.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setAudioOffloadPreferences(
    TrackSelectionParameters.AudioOffloadPreferences audioOffloadPreferences
)

Sets the audio offload mode preferences. This includes whether to enable/disable offload as well as to set requirements like if the device must support gapless transitions or speed change during offload.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setExceedAudioConstraintsIfNecessary(
    boolean exceedAudioConstraintsIfNecessary
)

Sets whether to exceed the setMaxAudioChannelCount and setMaxAudioBitrate constraints when no selection can be made otherwise.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setExceedRendererCapabilitiesIfNecessary(
    boolean exceedRendererCapabilitiesIfNecessary
)

Sets whether to exceed renderer capabilities when no selection can be made otherwise.

This parameter applies when all of the tracks available for a renderer exceed the renderer's reported capabilities. If the parameter is true then the lowest quality track will still be selected. Playback may succeed if the renderer has under-reported its true capabilities. If false then no track will be selected.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setExceedVideoConstraintsIfNecessary(
    boolean exceedVideoConstraintsIfNecessary
)

Sets whether to exceed the setMaxVideoBitrate, setMaxVideoSize and setMaxVideoFrameRate constraints when no selection can be made otherwise.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setForceHighestSupportedBitrate(boolean forceHighestSupportedBitrate)

Sets whether to force selection of the highest bitrate audio and video tracks that comply with all other constraints.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setForceLowestBitrate(boolean forceLowestBitrate)

Sets whether to force selection of the single lowest bitrate audio and video tracks that comply with all other constraints.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setIgnoredTextSelectionFlags(
    @C.SelectionFlags int ignoredTextSelectionFlags
)

Sets a bitmask of selection flags that are ignored for text track selections.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMaxAudioBitrate(int maxAudioBitrate)

Sets the maximum allowed audio bitrate.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMaxAudioChannelCount(int maxAudioChannelCount)

Sets the maximum allowed audio channel count.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMaxVideoBitrate(int maxVideoBitrate)

Sets the maximum allowed video bitrate.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMaxVideoFrameRate(int maxVideoFrameRate)

Sets the maximum allowed video frame rate.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMaxVideoSize(int maxVideoWidth, int maxVideoHeight)

Sets the maximum allowed video width and height.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMaxVideoSizeSd()

Equivalent to setMaxVideoSize(1279, 719).

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMinVideoBitrate(int minVideoBitrate)

Sets the minimum allowed video bitrate.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMinVideoFrameRate(int minVideoFrameRate)

Sets the minimum allowed video frame rate.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setMinVideoSize(int minVideoWidth, int minVideoHeight)

Sets the minimum allowed video width and height.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setOverrideForType(TrackSelectionOverride override)

Sets an override, replacing all existing overrides with the same track type.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredAudioLanguage(@Nullable String preferredAudioLanguage)

Sets the preferred language for audio and forced text tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredAudioLanguages(String[] preferredAudioLanguages)

Sets the preferred languages for audio and forced text tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredAudioMimeType(@Nullable String mimeType)

Sets the preferred sample MIME type for audio tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredAudioMimeTypes(String[] mimeTypes)

Sets the preferred sample MIME types for audio tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredAudioRoleFlags(@C.RoleFlags int preferredAudioRoleFlags)

Sets the preferred C.RoleFlags for audio tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredTextLanguage(@Nullable String preferredTextLanguage)

Sets the preferred language for text tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredTextLanguageAndRoleFlagsToCaptioningManagerSettings(
    Context context
)

Sets the preferred language and role flags for text tracks based on the accessibility settings of CaptioningManager.

Does nothing when the CaptioningManager is disabled.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredTextLanguages(String[] preferredTextLanguages)

Sets the preferred languages for text tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredTextRoleFlags(@C.RoleFlags int preferredTextRoleFlags)

Sets the preferred C.RoleFlags for text tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredVideoMimeType(@Nullable String mimeType)

Sets the preferred sample MIME type for video tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredVideoMimeTypes(String[] mimeTypes)

Sets the preferred sample MIME types for video tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPreferredVideoRoleFlags(@C.RoleFlags int preferredVideoRoleFlags)

Sets the preferred C.RoleFlags for video tracks.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setPrioritizeImageOverVideoEnabled(
    boolean isPrioritizeImageOverVideoEnabled
)

Sets whether an image track would be selected over a video track if both are available.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setRendererDisabled(int rendererIndex, boolean disabled)

Sets whether the renderer at the specified index is disabled. Disabling a renderer prevents the selector from selecting any tracks for it.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setSelectUndeterminedTextLanguage(
    boolean selectUndeterminedTextLanguage
)

Sets whether a text track with undetermined language should be selected if no track with a preferred language is available, or if the preferred language is unset.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setSelectionOverride(
    int rendererIndex,
    TrackGroupArray groups,
    @Nullable DefaultTrackSelector.SelectionOverride override
)

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

When the TrackGroupArray mapped to the renderer 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 specified TrackGroupArray for the specified Renderer.

Passing a null override will cause the renderer to be disabled when the mapped to it matches the one provided. When the TrackGroupArray does not match a null override has no effect. Hence a null override differs from disabling the renderer using setRendererDisabled because the renderer is disabled conditionally on the TrackGroupArray mapped to it, where-as setRendererDisabled disables the renderer unconditionally.

To remove overrides use clearSelectionOverride, clearSelectionOverrides or clearSelectionOverrides.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setTrackTypeDisabled(@C.TrackType int trackType, boolean disabled)

Sets whether a track type is disabled. If disabled, no tracks of the specified type will be selected for playback.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setTunnelingEnabled(boolean tunnelingEnabled)

Sets whether to enable tunneling if possible. Tunneling will only be enabled if it's supported by the audio and video renderers for the selected tracks.

Tunneling is known to have many device specific issues and limitations. Manual testing is strongly recommended to check that the media plays correctly when this option is enabled. See:

• google/ExoPlayer#9661
• google/ExoPlayer#9133
• google/ExoPlayer#9317
• google/ExoPlayer#9502

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setViewportSize(
    int viewportWidth,
    int viewportHeight,
    boolean viewportOrientationMayChange
)

Sets the viewport size to constrain adaptive video selections so that only tracks suitable for the viewport are selected.

@CanIgnoreReturnValue
public DefaultTrackSelector.ParametersBuilder setViewportSizeToPhysicalDisplaySize(
    Context context,
    boolean viewportOrientationMayChange
)

Equivalent to calling setViewportSize with the viewport size obtained from getCurrentDisplayModeSize.

@CanIgnoreReturnValue
protected DefaultTrackSelector.ParametersBuilder set(TrackSelectionParameters parameters)

Overrides the value of the builder with the value of TrackSelectionParameters.