com.google.android.exoplayer2.trackselection

Class DefaultTrackSelector.Parameters

java.lang.Object

com.google.android.exoplayer2.trackselection.DefaultTrackSelector.Parameters

Enclosing class:

DefaultTrackSelector

public static final class DefaultTrackSelector.Parameters
extends Object

Constraint parameters for DefaultTrackSelector.

Field Summary

Fields

Modifier and Type	Field and Description
boolean	allowMixedMimeAdaptiveness Whether to allow adaptive selections containing mixed mime types.
boolean	allowNonSeamlessAdaptiveness Whether to allow adaptive selections where adaptation may not be completely seamless.
boolean	exceedRendererCapabilitiesIfNecessary Whether to exceed renderer capabilities when no selection can be made otherwise.
boolean	exceedVideoConstraintsIfNecessary Whether to exceed video constraints when no selection can be made otherwise.
int	maxVideoBitrate Maximum video bitrate.
int	maxVideoHeight Maximum allowed video height.
int	maxVideoWidth Maximum allowed video width.
String	preferredAudioLanguage The preferred language for audio, as well as for forced text tracks as defined by RFC 5646.
String	preferredTextLanguage The preferred language for text tracks as defined by RFC 5646.
int	viewportHeight Viewport height in pixels.
boolean	viewportOrientationMayChange Whether the viewport orientation may change during playback.
int	viewportWidth Viewport width in pixels.

Constructor Summary

Constructors

Constructor and Description
Parameters() Default parameters.
Parameters(String preferredAudioLanguage, String preferredTextLanguage, boolean allowMixedMimeAdaptiveness, boolean allowNonSeamlessAdaptiveness, int maxVideoWidth, int maxVideoHeight, int maxVideoBitrate, boolean exceedVideoConstraintsIfNecessary, boolean exceedRendererCapabilitiesIfNecessary, int viewportWidth, int viewportHeight, boolean viewportOrientationMayChange)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
int	hashCode()
DefaultTrackSelector.Parameters	withAllowMixedMimeAdaptiveness(boolean allowMixedMimeAdaptiveness) Returns an instance with the provided mixed mime adaptiveness allowance.
DefaultTrackSelector.Parameters	withAllowNonSeamlessAdaptiveness(boolean allowNonSeamlessAdaptiveness) Returns an instance with the provided seamless adaptiveness allowance.
DefaultTrackSelector.Parameters	withExceedRendererCapabilitiesIfNecessary(boolean exceedRendererCapabilitiesIfNecessary) Returns an instance with the provided exceedRendererCapabilitiesIfNecessary value.
DefaultTrackSelector.Parameters	withExceedVideoConstraintsIfNecessary(boolean exceedVideoConstraintsIfNecessary) Returns an instance with the provided exceedVideoConstraintsIfNecessary value.
DefaultTrackSelector.Parameters	withMaxVideoBitrate(int maxVideoBitrate) Returns an instance with the provided max video bitrate.
DefaultTrackSelector.Parameters	withMaxVideoSize(int maxVideoWidth, int maxVideoHeight) Returns an instance with the provided max video size.
DefaultTrackSelector.Parameters	withMaxVideoSizeSd() Equivalent to withMaxVideoSize(1279, 719).
DefaultTrackSelector.Parameters	withoutVideoSizeConstraints() Equivalent to withMaxVideoSize(Integer.MAX_VALUE, Integer.MAX_VALUE).
DefaultTrackSelector.Parameters	withoutViewportSizeConstraints() Equivalent to withViewportSize(Integer.MAX_VALUE, Integer.MAX_VALUE, true).
DefaultTrackSelector.Parameters	withPreferredAudioLanguage(String preferredAudioLanguage) Returns an instance with the provided preferred language for audio and forced text tracks.
DefaultTrackSelector.Parameters	withPreferredTextLanguage(String preferredTextLanguage) Returns an instance with the provided preferred language for text tracks.
DefaultTrackSelector.Parameters	withViewportSize(int viewportWidth, int viewportHeight, boolean viewportOrientationMayChange) Returns an instance with the provided viewport size.
DefaultTrackSelector.Parameters	withViewportSizeFromContext(Context context, boolean viewportOrientationMayChange) Returns an instance where the viewport size is obtained from the provided Context.

Methods inherited from class java.lang.Object

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

Field Detail

preferredAudioLanguage

public final String preferredAudioLanguage

The preferred language for audio, as well as for forced text tracks as defined by RFC 5646. null selects the default track, or the first track if there's no default.

preferredTextLanguage

public final String preferredTextLanguage

The preferred language for text tracks as defined by RFC 5646. null selects the default track if there is one, or no track otherwise.

maxVideoWidth

public final int maxVideoWidth

Maximum allowed video width.

maxVideoHeight

public final int maxVideoHeight

Maximum allowed video height.

maxVideoBitrate

public final int maxVideoBitrate

Maximum video bitrate.

exceedVideoConstraintsIfNecessary

public final boolean exceedVideoConstraintsIfNecessary

Whether to exceed video constraints when no selection can be made otherwise.

viewportWidth

public final int viewportWidth

Viewport width in pixels. Constrains video tracks selections for adaptive playbacks so that only tracks suitable for the viewport are selected.

viewportHeight

public final int viewportHeight

Viewport height in pixels. Constrains video tracks selections for adaptive playbacks so that only tracks suitable for the viewport are selected.

viewportOrientationMayChange

public final boolean viewportOrientationMayChange

Whether the viewport orientation may change during playback. Constrains video tracks selections for adaptive playbacks so that only tracks suitable for the viewport are selected.

allowMixedMimeAdaptiveness

public final boolean allowMixedMimeAdaptiveness

Whether to allow adaptive selections containing mixed mime types.

allowNonSeamlessAdaptiveness

public final boolean allowNonSeamlessAdaptiveness

Whether to allow adaptive selections where adaptation may not be completely seamless.

exceedRendererCapabilitiesIfNecessary

public final boolean exceedRendererCapabilitiesIfNecessary

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

Constructor Detail

Parameters

public Parameters()

Default parameters. The default values are:

• No preferred audio language is set.
• No preferred text language is set.
• Adaptation between different mime types is not allowed.
• Non seamless adaptation is allowed.
• No max limit for video width/height.
• No max video bitrate.
• Video constraints are exceeded if no supported selection can be made otherwise.
• Renderer capabilities are exceeded if no supported selection can be made.
• No viewport constraints are set.

Parameters

public Parameters(String preferredAudioLanguage,
                  String preferredTextLanguage,
                  boolean allowMixedMimeAdaptiveness,
                  boolean allowNonSeamlessAdaptiveness,
                  int maxVideoWidth,
                  int maxVideoHeight,
                  int maxVideoBitrate,
                  boolean exceedVideoConstraintsIfNecessary,
                  boolean exceedRendererCapabilitiesIfNecessary,
                  int viewportWidth,
                  int viewportHeight,
                  boolean viewportOrientationMayChange)

Parameters:

preferredAudioLanguage - See preferredAudioLanguage

preferredTextLanguage - See preferredTextLanguage

allowMixedMimeAdaptiveness - See allowMixedMimeAdaptiveness

allowNonSeamlessAdaptiveness - See allowNonSeamlessAdaptiveness

maxVideoWidth - See maxVideoWidth

maxVideoHeight - See maxVideoHeight

maxVideoBitrate - See maxVideoBitrate

exceedVideoConstraintsIfNecessary - See exceedVideoConstraintsIfNecessary

exceedRendererCapabilitiesIfNecessary - See preferredTextLanguage

viewportWidth - See viewportWidth

viewportHeight - See viewportHeight

viewportOrientationMayChange - See viewportOrientationMayChange

Method Detail

withPreferredAudioLanguage

public DefaultTrackSelector.Parameters withPreferredAudioLanguage(String preferredAudioLanguage)

Returns an instance with the provided preferred language for audio and forced text tracks.

Parameters:

preferredAudioLanguage - The preferred language as defined by RFC 5646. null to select the default track, or first track if there's no default.

Returns:

An instance with the provided preferred language for audio and forced text tracks.

withPreferredTextLanguage

public DefaultTrackSelector.Parameters withPreferredTextLanguage(String preferredTextLanguage)

Returns an instance with the provided preferred language for text tracks.

Parameters:

preferredTextLanguage - The preferred language as defined by RFC 5646. null to select the default track, or no track if there's no default.

Returns:

An instance with the provided preferred language for text tracks.

withAllowMixedMimeAdaptiveness

public DefaultTrackSelector.Parameters withAllowMixedMimeAdaptiveness(boolean allowMixedMimeAdaptiveness)

Returns an instance with the provided mixed mime adaptiveness allowance.

Parameters:

allowMixedMimeAdaptiveness - Whether to allow selections to contain mixed mime types.

Returns:

An instance with the provided mixed mime adaptiveness allowance.

withAllowNonSeamlessAdaptiveness

public DefaultTrackSelector.Parameters withAllowNonSeamlessAdaptiveness(boolean allowNonSeamlessAdaptiveness)

Returns an instance with the provided seamless adaptiveness allowance.

Parameters:

allowNonSeamlessAdaptiveness - Whether non-seamless adaptation is allowed.

Returns:

An instance with the provided seamless adaptiveness allowance.

withMaxVideoSize

public DefaultTrackSelector.Parameters withMaxVideoSize(int maxVideoWidth,
                                                        int maxVideoHeight)

Returns an instance with the provided max video size.

Parameters:

maxVideoWidth - The max video width.

maxVideoHeight - The max video width.

Returns:

An instance with the provided max video size.

withMaxVideoBitrate

public DefaultTrackSelector.Parameters withMaxVideoBitrate(int maxVideoBitrate)

Returns an instance with the provided max video bitrate.

Parameters:

maxVideoBitrate - The max video bitrate.

Returns:

An instance with the provided max video bitrate.

withMaxVideoSizeSd

public DefaultTrackSelector.Parameters withMaxVideoSizeSd()

Equivalent to withMaxVideoSize(1279, 719).

Returns:

An instance with maximum standard definition as maximum video size.

withoutVideoSizeConstraints

public DefaultTrackSelector.Parameters withoutVideoSizeConstraints()

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

Returns:

An instance without video size constraints.

withExceedVideoConstraintsIfNecessary

public DefaultTrackSelector.Parameters withExceedVideoConstraintsIfNecessary(boolean exceedVideoConstraintsIfNecessary)

Returns an instance with the provided exceedVideoConstraintsIfNecessary value.

Parameters:

exceedVideoConstraintsIfNecessary - Whether to exceed video constraints when no selection can be made otherwise.

Returns:

An instance with the provided exceedVideoConstraintsIfNecessary value.

withExceedRendererCapabilitiesIfNecessary

public DefaultTrackSelector.Parameters withExceedRendererCapabilitiesIfNecessary(boolean exceedRendererCapabilitiesIfNecessary)

Returns an instance with the provided exceedRendererCapabilitiesIfNecessary value.

Parameters:

exceedRendererCapabilitiesIfNecessary - Whether to exceed renderer capabilities when no selection can be made otherwise.

Returns:

An instance with the provided exceedRendererCapabilitiesIfNecessary value.

withViewportSize

public DefaultTrackSelector.Parameters withViewportSize(int viewportWidth,
                                                        int viewportHeight,
                                                        boolean viewportOrientationMayChange)

Returns an instance with the provided viewport size.

Parameters:

viewportWidth - Viewport width in pixels.

viewportHeight - Viewport height in pixels.

viewportOrientationMayChange - Whether orientation may change during playback.

Returns:

An instance with the provided viewport size.

withViewportSizeFromContext

public DefaultTrackSelector.Parameters withViewportSizeFromContext(Context context,
                                                                   boolean viewportOrientationMayChange)

Returns an instance where the viewport size is obtained from the provided Context.

Parameters:

context - The context to obtain the viewport size from.

viewportOrientationMayChange - Whether orientation may change during playback.

Returns:

An instance where the viewport size is obtained from the provided Context.

withoutViewportSizeConstraints

public DefaultTrackSelector.Parameters withoutViewportSizeConstraints()

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

Returns:

An instance without viewport size constraints.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object