com.google.android.exoplayer2.trackselection

Class DefaultTrackSelector.ParametersBuilder

java.lang.Object

com.google.android.exoplayer2.trackselection.DefaultTrackSelector.ParametersBuilder

Enclosing class:

DefaultTrackSelector

public static final class DefaultTrackSelector.ParametersBuilder
extends java.lang.Object

A builder for DefaultTrackSelector.Parameters. See the DefaultTrackSelector.Parameters documentation for explanations of the parameters that can be configured using this builder.

Constructor Summary

Constructors

Constructor and Description
ParametersBuilder() Creates a builder with default initial values.

Method Summary

Modifier and Type	Method and Description
DefaultTrackSelector.Parameters	build() Builds a DefaultTrackSelector.Parameters instance with the selected values.
DefaultTrackSelector.ParametersBuilder	clearSelectionOverride(int rendererIndex, TrackGroupArray groups) Clears a track selection override for the specified renderer and TrackGroupArray.
DefaultTrackSelector.ParametersBuilder	clearSelectionOverrides() Clears all track selection overrides for all renderers.
DefaultTrackSelector.ParametersBuilder	clearSelectionOverrides(int rendererIndex) Clears all track selection overrides for the specified renderer.
DefaultTrackSelector.ParametersBuilder	clearVideoSizeConstraints() Equivalent to setMaxVideoSize(Integer.MAX_VALUE, Integer.MAX_VALUE).
DefaultTrackSelector.ParametersBuilder	clearViewportSizeConstraints() Equivalent to setViewportSize(Integer.MAX_VALUE, Integer.MAX_VALUE, true).
DefaultTrackSelector.ParametersBuilder	setAllowMixedMimeAdaptiveness(boolean allowMixedMimeAdaptiveness) See DefaultTrackSelector.Parameters.allowMixedMimeAdaptiveness.
DefaultTrackSelector.ParametersBuilder	setAllowNonSeamlessAdaptiveness(boolean allowNonSeamlessAdaptiveness) See DefaultTrackSelector.Parameters.allowNonSeamlessAdaptiveness.
DefaultTrackSelector.ParametersBuilder	setDisabledTextTrackSelectionFlags(int disabledTextTrackSelectionFlags) See DefaultTrackSelector.Parameters.disabledTextTrackSelectionFlags.
DefaultTrackSelector.ParametersBuilder	setExceedRendererCapabilitiesIfNecessary(boolean exceedRendererCapabilitiesIfNecessary) See DefaultTrackSelector.Parameters.exceedRendererCapabilitiesIfNecessary.
DefaultTrackSelector.ParametersBuilder	setExceedVideoConstraintsIfNecessary(boolean exceedVideoConstraintsIfNecessary) See DefaultTrackSelector.Parameters.exceedVideoConstraintsIfNecessary.
DefaultTrackSelector.ParametersBuilder	setForceHighestSupportedBitrate(boolean forceHighestSupportedBitrate) See DefaultTrackSelector.Parameters.forceHighestSupportedBitrate.
DefaultTrackSelector.ParametersBuilder	setForceLowestBitrate(boolean forceLowestBitrate) See DefaultTrackSelector.Parameters.forceLowestBitrate.
DefaultTrackSelector.ParametersBuilder	setMaxVideoBitrate(int maxVideoBitrate) See DefaultTrackSelector.Parameters.maxVideoBitrate.
DefaultTrackSelector.ParametersBuilder	setMaxVideoFrameRate(int maxVideoFrameRate) See DefaultTrackSelector.Parameters.maxVideoFrameRate.
DefaultTrackSelector.ParametersBuilder	setMaxVideoSize(int maxVideoWidth, int maxVideoHeight) See DefaultTrackSelector.Parameters.maxVideoWidth and DefaultTrackSelector.Parameters.maxVideoHeight.
DefaultTrackSelector.ParametersBuilder	setMaxVideoSizeSd() Equivalent to setMaxVideoSize(1279, 719).
DefaultTrackSelector.ParametersBuilder	setPreferredAudioLanguage(java.lang.String preferredAudioLanguage) See DefaultTrackSelector.Parameters.preferredAudioLanguage.
DefaultTrackSelector.ParametersBuilder	setPreferredTextLanguage(java.lang.String preferredTextLanguage) See DefaultTrackSelector.Parameters.preferredTextLanguage.
DefaultTrackSelector.ParametersBuilder	setRendererDisabled(int rendererIndex, boolean disabled) Sets whether the renderer at the specified index is disabled.
DefaultTrackSelector.ParametersBuilder	setSelectionOverride(int rendererIndex, TrackGroupArray groups, DefaultTrackSelector.SelectionOverride override) Overrides the track selection for the renderer at the specified index.
DefaultTrackSelector.ParametersBuilder	setSelectUndeterminedTextLanguage(boolean selectUndeterminedTextLanguage) See DefaultTrackSelector.Parameters.selectUndeterminedTextLanguage.
DefaultTrackSelector.ParametersBuilder	setTunnelingAudioSessionId(int tunnelingAudioSessionId) See DefaultTrackSelector.Parameters.tunnelingAudioSessionId.
DefaultTrackSelector.ParametersBuilder	setViewportSize(int viewportWidth, int viewportHeight, boolean viewportOrientationMayChange) See DefaultTrackSelector.Parameters.viewportWidth, DefaultTrackSelector.Parameters.maxVideoHeight and DefaultTrackSelector.Parameters.viewportOrientationMayChange.
DefaultTrackSelector.ParametersBuilder	setViewportSizeToPhysicalDisplaySize(android.content.Context context, boolean viewportOrientationMayChange) Equivalent to calling setViewportSize(int, int, boolean) with the viewport size obtained from Util.getPhysicalDisplaySize(Context).

Methods inherited from class java.lang.Object

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

Constructor Detail

ParametersBuilder

public ParametersBuilder()

Creates a builder with default initial values.

Method Detail

setPreferredAudioLanguage

public DefaultTrackSelector.ParametersBuilder setPreferredAudioLanguage(java.lang.String preferredAudioLanguage)

See DefaultTrackSelector.Parameters.preferredAudioLanguage.

Returns:

This builder.

setPreferredTextLanguage

public DefaultTrackSelector.ParametersBuilder setPreferredTextLanguage(java.lang.String preferredTextLanguage)

See DefaultTrackSelector.Parameters.preferredTextLanguage.

Returns:

This builder.

setSelectUndeterminedTextLanguage

public DefaultTrackSelector.ParametersBuilder setSelectUndeterminedTextLanguage(boolean selectUndeterminedTextLanguage)

See DefaultTrackSelector.Parameters.selectUndeterminedTextLanguage.

Returns:

This builder.

setDisabledTextTrackSelectionFlags

public DefaultTrackSelector.ParametersBuilder setDisabledTextTrackSelectionFlags(int disabledTextTrackSelectionFlags)

See DefaultTrackSelector.Parameters.disabledTextTrackSelectionFlags.

Returns:

This builder.

setForceLowestBitrate

public DefaultTrackSelector.ParametersBuilder setForceLowestBitrate(boolean forceLowestBitrate)

See DefaultTrackSelector.Parameters.forceLowestBitrate.

Returns:

This builder.

setForceHighestSupportedBitrate

public DefaultTrackSelector.ParametersBuilder setForceHighestSupportedBitrate(boolean forceHighestSupportedBitrate)

See DefaultTrackSelector.Parameters.forceHighestSupportedBitrate.

Returns:

This builder.

setAllowMixedMimeAdaptiveness

public DefaultTrackSelector.ParametersBuilder setAllowMixedMimeAdaptiveness(boolean allowMixedMimeAdaptiveness)

See DefaultTrackSelector.Parameters.allowMixedMimeAdaptiveness.

Returns:

This builder.

setAllowNonSeamlessAdaptiveness

public DefaultTrackSelector.ParametersBuilder setAllowNonSeamlessAdaptiveness(boolean allowNonSeamlessAdaptiveness)

See DefaultTrackSelector.Parameters.allowNonSeamlessAdaptiveness.

Returns:

This builder.

setMaxVideoSizeSd

public DefaultTrackSelector.ParametersBuilder setMaxVideoSizeSd()

Equivalent to setMaxVideoSize(1279, 719).

Returns:

This builder.

clearVideoSizeConstraints

public DefaultTrackSelector.ParametersBuilder clearVideoSizeConstraints()

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

Returns:

This builder.

setMaxVideoSize

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

See DefaultTrackSelector.Parameters.maxVideoWidth and DefaultTrackSelector.Parameters.maxVideoHeight.

Returns:

This builder.

setMaxVideoFrameRate

public DefaultTrackSelector.ParametersBuilder setMaxVideoFrameRate(int maxVideoFrameRate)

See DefaultTrackSelector.Parameters.maxVideoFrameRate.

Returns:

This builder.

setMaxVideoBitrate

public DefaultTrackSelector.ParametersBuilder setMaxVideoBitrate(int maxVideoBitrate)

See DefaultTrackSelector.Parameters.maxVideoBitrate.

Returns:

This builder.

setExceedVideoConstraintsIfNecessary

public DefaultTrackSelector.ParametersBuilder setExceedVideoConstraintsIfNecessary(boolean exceedVideoConstraintsIfNecessary)

See DefaultTrackSelector.Parameters.exceedVideoConstraintsIfNecessary.

Returns:

This builder.

setExceedRendererCapabilitiesIfNecessary

public DefaultTrackSelector.ParametersBuilder setExceedRendererCapabilitiesIfNecessary(boolean exceedRendererCapabilitiesIfNecessary)

See DefaultTrackSelector.Parameters.exceedRendererCapabilitiesIfNecessary.

Returns:

This builder.

setViewportSizeToPhysicalDisplaySize

public DefaultTrackSelector.ParametersBuilder setViewportSizeToPhysicalDisplaySize(android.content.Context context,
                                                                                   boolean viewportOrientationMayChange)

Equivalent to calling setViewportSize(int, int, boolean) with the viewport size obtained from Util.getPhysicalDisplaySize(Context).

Parameters:

context - Any context.

viewportOrientationMayChange - See DefaultTrackSelector.Parameters.viewportOrientationMayChange.

Returns:

This builder.

clearViewportSizeConstraints

public DefaultTrackSelector.ParametersBuilder clearViewportSizeConstraints()

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

Returns:

This builder.

setViewportSize

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

See DefaultTrackSelector.Parameters.viewportWidth, DefaultTrackSelector.Parameters.maxVideoHeight and DefaultTrackSelector.Parameters.viewportOrientationMayChange.

Parameters:

viewportWidth - See DefaultTrackSelector.Parameters.viewportWidth.

viewportHeight - See DefaultTrackSelector.Parameters.viewportHeight.

viewportOrientationMayChange - See DefaultTrackSelector.Parameters.viewportOrientationMayChange.

Returns:

This builder.

setRendererDisabled

public final 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.

Parameters:

rendererIndex - The renderer index.

disabled - Whether the renderer is disabled.

setSelectionOverride

public final DefaultTrackSelector.ParametersBuilder setSelectionOverride(int rendererIndex,
                                                                         TrackGroupArray groups,
                                                                         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 TrackGroupArray 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(int, boolean) because the renderer is disabled conditionally on the TrackGroupArray mapped to it, where-as setRendererDisabled(int, boolean) disables the renderer unconditionally.

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.

clearSelectionOverride

public final DefaultTrackSelector.ParametersBuilder 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 DefaultTrackSelector.ParametersBuilder clearSelectionOverrides(int rendererIndex)

Clears all track selection overrides for the specified renderer.

Parameters:

rendererIndex - The renderer index.

clearSelectionOverrides

public final DefaultTrackSelector.ParametersBuilder clearSelectionOverrides()

Clears all track selection overrides for all renderers.

setTunnelingAudioSessionId

public DefaultTrackSelector.ParametersBuilder setTunnelingAudioSessionId(int tunnelingAudioSessionId)

See DefaultTrackSelector.Parameters.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.

build

public DefaultTrackSelector.Parameters build()

Builds a DefaultTrackSelector.Parameters instance with the selected values.