Overview
A builder for DefaultTrackSelector.Parameters. See the DefaultTrackSelector.Parameters documentation for explanations of
the parameters that can be configured using this builder.
Summary
| Methods |
|---|
| public DefaultTrackSelector.Parameters | build()
Builds a DefaultTrackSelector.Parameters instance with the selected values. |
| public final DefaultTrackSelector.ParametersBuilder | clearSelectionOverride(int rendererIndex, TrackGroupArray groups)
Clears a track selection override for the specified renderer and TrackGroupArray. |
| public final DefaultTrackSelector.ParametersBuilder | clearSelectionOverrides()
Clears all track selection overrides for all renderers. |
| public final DefaultTrackSelector.ParametersBuilder | clearSelectionOverrides(int rendererIndex)
Clears all track selection overrides for the specified renderer. |
| public TrackSelectionParameters.Builder | clearVideoSizeConstraints()
Equivalent to setMaxVideoSize(Integer.MAX_VALUE, Integer.MAX_VALUE). |
| public TrackSelectionParameters.Builder | clearViewportSizeConstraints()
Equivalent to setViewportSize(Integer.MAX_VALUE, Integer.MAX_VALUE,
true). |
| protected TrackSelectionParameters.Builder | set(TrackSelectionParameters parameters)
Overrides the value of the builder with the value of TrackSelectionParameters. |
| public DefaultTrackSelector.ParametersBuilder | setAllowAudioMixedChannelCountAdaptiveness(boolean allowAudioMixedChannelCountAdaptiveness)
Sets whether to allow adaptive audio selections containing mixed channel counts. |
| public DefaultTrackSelector.ParametersBuilder | setAllowAudioMixedDecoderSupportAdaptiveness(boolean allowAudioMixedDecoderSupportAdaptiveness)
Sets whether to allow adaptive audio selections with mixed levels of and . |
| public DefaultTrackSelector.ParametersBuilder | setAllowAudioMixedMimeTypeAdaptiveness(boolean allowAudioMixedMimeTypeAdaptiveness)
Sets whether to allow adaptive audio selections containing mixed MIME types. |
| public DefaultTrackSelector.ParametersBuilder | setAllowAudioMixedSampleRateAdaptiveness(boolean allowAudioMixedSampleRateAdaptiveness)
Sets whether to allow adaptive audio selections containing mixed sample rates. |
| public DefaultTrackSelector.ParametersBuilder | setAllowMultipleAdaptiveSelections(boolean allowMultipleAdaptiveSelections)
Sets whether multiple adaptive selections with more than one track are allowed. |
| public DefaultTrackSelector.ParametersBuilder | setAllowVideoMixedDecoderSupportAdaptiveness(boolean allowVideoMixedDecoderSupportAdaptiveness)
Sets whether to allow adaptive video selections with mixed levels of and . |
| public DefaultTrackSelector.ParametersBuilder | setAllowVideoMixedMimeTypeAdaptiveness(boolean allowVideoMixedMimeTypeAdaptiveness)
Sets whether to allow adaptive video selections containing mixed MIME types. |
| public DefaultTrackSelector.ParametersBuilder | setAllowVideoNonSeamlessAdaptiveness(boolean allowVideoNonSeamlessAdaptiveness)
Sets whether to allow adaptive video selections where adaptation may not be completely
seamless. |
| public DefaultTrackSelector.ParametersBuilder | setDisabledTextTrackSelectionFlags(int disabledTextTrackSelectionFlags)
Sets a bitmask of selection flags that are disabled for text track selections. |
| public TrackSelectionParameters.Builder | setDisabledTrackTypes(java.util.Set<java.lang.Integer> disabledTrackTypes)
Sets the disabled track types, preventing all tracks of those types from being selected for
playback. |
| public DefaultTrackSelector.ParametersBuilder | setExceedAudioConstraintsIfNecessary(boolean exceedAudioConstraintsIfNecessary)
Sets whether to exceed the DefaultTrackSelector.ParametersBuilder.setMaxAudioChannelCount(int) and DefaultTrackSelector.ParametersBuilder.setMaxAudioBitrate(int) constraints when no selection can be made otherwise. |
| public DefaultTrackSelector.ParametersBuilder | setExceedRendererCapabilitiesIfNecessary(boolean exceedRendererCapabilitiesIfNecessary)
Sets whether to exceed renderer capabilities when no selection can be made otherwise. |
| public DefaultTrackSelector.ParametersBuilder | setExceedVideoConstraintsIfNecessary(boolean exceedVideoConstraintsIfNecessary)
Sets whether to exceed the DefaultTrackSelector.ParametersBuilder.setMaxVideoBitrate(int), DefaultTrackSelector.ParametersBuilder.setMaxVideoSize(int, int)
and DefaultTrackSelector.ParametersBuilder.setMaxVideoFrameRate(int) constraints when no selection can be made otherwise. |
| public TrackSelectionParameters.Builder | setForceHighestSupportedBitrate(boolean forceHighestSupportedBitrate)
Sets whether to force selection of the highest bitrate audio and video tracks that comply
with all other constraints. |
| public TrackSelectionParameters.Builder | setForceLowestBitrate(boolean forceLowestBitrate)
Sets whether to force selection of the single lowest bitrate audio and video tracks that
comply with all other constraints. |
| public TrackSelectionParameters.Builder | setMaxAudioBitrate(int maxAudioBitrate)
Sets the maximum allowed audio bitrate. |
| public TrackSelectionParameters.Builder | setMaxAudioChannelCount(int maxAudioChannelCount)
Sets the maximum allowed audio channel count. |
| public TrackSelectionParameters.Builder | setMaxVideoBitrate(int maxVideoBitrate)
Sets the maximum allowed video bitrate. |
| public TrackSelectionParameters.Builder | setMaxVideoFrameRate(int maxVideoFrameRate)
Sets the maximum allowed video frame rate. |
| public TrackSelectionParameters.Builder | setMaxVideoSize(int maxVideoWidth, int maxVideoHeight)
Sets the maximum allowed video width and height. |
| public TrackSelectionParameters.Builder | setMaxVideoSizeSd()
Equivalent to setMaxVideoSize(1279, 719). |
| public TrackSelectionParameters.Builder | setMinVideoBitrate(int minVideoBitrate)
Sets the minimum allowed video bitrate. |
| public TrackSelectionParameters.Builder | setMinVideoFrameRate(int minVideoFrameRate)
Sets the minimum allowed video frame rate. |
| public TrackSelectionParameters.Builder | setMinVideoSize(int minVideoWidth, int minVideoHeight)
Sets the minimum allowed video width and height. |
| public TrackSelectionParameters.Builder | setPreferredAudioLanguage(java.lang.String preferredAudioLanguage)
Sets the preferred language for audio and forced text tracks. |
| public TrackSelectionParameters.Builder | setPreferredAudioLanguages(java.lang.String preferredAudioLanguages[])
Sets the preferred languages for audio and forced text tracks. |
| public TrackSelectionParameters.Builder | setPreferredAudioMimeType(java.lang.String mimeType)
Sets the preferred sample MIME type for audio tracks. |
| public TrackSelectionParameters.Builder | setPreferredAudioMimeTypes(java.lang.String mimeTypes[])
Sets the preferred sample MIME types for audio tracks. |
| public TrackSelectionParameters.Builder | setPreferredAudioRoleFlags(int preferredAudioRoleFlags)
Sets the preferred C.RoleFlags for audio tracks. |
| public TrackSelectionParameters.Builder | setPreferredTextLanguage(java.lang.String preferredTextLanguage)
Sets the preferred language for text tracks. |
| public TrackSelectionParameters.Builder | setPreferredTextLanguageAndRoleFlagsToCaptioningManagerSettings(Context context)
Sets the preferred language and role flags for text tracks based on the accessibility
settings of CaptioningManager. |
| public TrackSelectionParameters.Builder | setPreferredTextLanguages(java.lang.String preferredTextLanguages[])
Sets the preferred languages for text tracks. |
| public TrackSelectionParameters.Builder | setPreferredTextRoleFlags(int preferredTextRoleFlags)
Sets the preferred C.RoleFlags for text tracks. |
| public TrackSelectionParameters.Builder | setPreferredVideoMimeType(java.lang.String mimeType)
Sets the preferred sample MIME type for video tracks. |
| public TrackSelectionParameters.Builder | setPreferredVideoMimeTypes(java.lang.String mimeTypes[])
Sets the preferred sample MIME types for video tracks. |
| public TrackSelectionParameters.Builder | setPreferredVideoRoleFlags(int preferredVideoRoleFlags)
Sets the preferred C.RoleFlags for video tracks. |
| public final DefaultTrackSelector.ParametersBuilder | setRendererDisabled(int rendererIndex, boolean disabled)
Sets whether the renderer at the specified index is disabled. |
| public final DefaultTrackSelector.ParametersBuilder | setSelectionOverride(int rendererIndex, TrackGroupArray groups, DefaultTrackSelector.SelectionOverride override)
Overrides the track selection for the renderer at the specified index. |
| public TrackSelectionParameters.Builder | 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. |
| public TrackSelectionParameters.Builder | setTrackSelectionOverrides(TrackSelectionOverrides trackSelectionOverrides)
Sets the selection overrides. |
| public DefaultTrackSelector.ParametersBuilder | setTunnelingEnabled(boolean tunnelingEnabled)
Sets whether to enable tunneling if possible. |
| public TrackSelectionParameters.Builder | 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. |
| public TrackSelectionParameters.Builder | setViewportSizeToPhysicalDisplaySize(Context context, boolean viewportOrientationMayChange)
Equivalent to calling TrackSelectionParameters.Builder.setViewportSize(int, int, boolean) with the viewport size
obtained from Util.getCurrentDisplayModeSize(Context). |
| from java.lang.Object | clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructors
public
ParametersBuilder()
Deprecated: constraints will not be set using this constructor. Use DefaultTrackSelector.ParametersBuilder instead.
public
ParametersBuilder(Context context)
Creates a builder with default initial values.
Parameters:
context: Any context.
Methods
Overrides the value of the builder with the value of TrackSelectionParameters.
Equivalent to setMaxVideoSize(1279, 719).
Returns:
This builder.
Equivalent to setMaxVideoSize(Integer.MAX_VALUE, Integer.MAX_VALUE).
Returns:
This builder.
Sets the maximum allowed video width and height.
Parameters:
maxVideoWidth: Maximum allowed video width in pixels.
maxVideoHeight: Maximum allowed video height in pixels.
Returns:
This builder.
Sets the maximum allowed video frame rate.
Parameters:
maxVideoFrameRate: Maximum allowed video frame rate in hertz.
Returns:
This builder.
Sets the maximum allowed video bitrate.
Parameters:
maxVideoBitrate: Maximum allowed video bitrate in bits per second.
Returns:
This builder.
Sets the minimum allowed video width and height.
Parameters:
minVideoWidth: Minimum allowed video width in pixels.
minVideoHeight: Minimum allowed video height in pixels.
Returns:
This builder.
Sets the minimum allowed video frame rate.
Parameters:
minVideoFrameRate: Minimum allowed video frame rate in hertz.
Returns:
This builder.
Sets the minimum allowed video bitrate.
Parameters:
minVideoBitrate: Minimum allowed video bitrate in bits per second.
Returns:
This builder.
Sets whether to exceed the DefaultTrackSelector.ParametersBuilder.setMaxVideoBitrate(int), DefaultTrackSelector.ParametersBuilder.setMaxVideoSize(int, int)
and DefaultTrackSelector.ParametersBuilder.setMaxVideoFrameRate(int) constraints when no selection can be made otherwise.
Parameters:
exceedVideoConstraintsIfNecessary: Whether to exceed video constraints when no
selection can be made otherwise.
Returns:
This builder.
Sets whether to allow adaptive video selections containing mixed MIME types.
Adaptations between different MIME types may not be completely seamless, in which case
DefaultTrackSelector.ParametersBuilder.setAllowVideoNonSeamlessAdaptiveness(boolean) also needs to be true for
mixed MIME type selections to be made.
Parameters:
allowVideoMixedMimeTypeAdaptiveness: Whether to allow adaptive video selections
containing mixed MIME types.
Returns:
This builder.
Sets whether to allow adaptive video selections where adaptation may not be completely
seamless.
Parameters:
allowVideoNonSeamlessAdaptiveness: Whether to allow adaptive video selections where
adaptation may not be completely seamless.
Returns:
This builder.
Sets whether to allow adaptive video selections with mixed levels of and .
Parameters:
allowVideoMixedDecoderSupportAdaptiveness: Whether to allow adaptive video selections
with mixed levels of decoder and hardware acceleration support.
Returns:
This builder.
Equivalent to calling TrackSelectionParameters.Builder.setViewportSize(int, int, boolean) with the viewport size
obtained from Util.getCurrentDisplayModeSize(Context).
Parameters:
context: Any context.
viewportOrientationMayChange: Whether the viewport orientation may change during
playback.
Returns:
This builder.
Equivalent to setViewportSize(Integer.MAX_VALUE, Integer.MAX_VALUE,
true).
Returns:
This builder.
Sets the viewport size to constrain adaptive video selections so that only tracks suitable
for the viewport are selected.
Parameters:
viewportWidth: Viewport width in pixels.
viewportHeight: Viewport height in pixels.
viewportOrientationMayChange: Whether the viewport orientation may change during
playback.
Returns:
This builder.
Sets the preferred sample MIME type for video tracks.
Parameters:
mimeType: The preferred MIME type for video tracks, or null to clear a
previously set preference.
Returns:
This builder.
Sets the preferred sample MIME types for video tracks.
Parameters:
mimeTypes: The preferred MIME types for video tracks in order of preference, or an
empty list for no preference.
Returns:
This builder.
Sets the preferred C.RoleFlags for video tracks.
Parameters:
preferredVideoRoleFlags: Preferred video role flags.
Returns:
This builder.
Sets the preferred language for audio and forced text tracks.
Parameters:
preferredAudioLanguage: Preferred audio language as an IETF BCP 47 conformant tag, or
null to select the default track, or the first track if there's no default.
Returns:
This builder.
Sets the preferred languages for audio and forced text tracks.
Parameters:
preferredAudioLanguages: Preferred audio languages as IETF BCP 47 conformant tags in
order of preference, or an empty array to select the default track, or the first track if
there's no default.
Returns:
This builder.
Sets the preferred C.RoleFlags for audio tracks.
Parameters:
preferredAudioRoleFlags: Preferred audio role flags.
Returns:
This builder.
Sets the maximum allowed audio channel count.
Parameters:
maxAudioChannelCount: Maximum allowed audio channel count.
Returns:
This builder.
Sets the maximum allowed audio bitrate.
Parameters:
maxAudioBitrate: Maximum allowed audio bitrate in bits per second.
Returns:
This builder.
Sets whether to exceed the DefaultTrackSelector.ParametersBuilder.setMaxAudioChannelCount(int) and DefaultTrackSelector.ParametersBuilder.setMaxAudioBitrate(int) constraints when no selection can be made otherwise.
Parameters:
exceedAudioConstraintsIfNecessary: Whether to exceed audio constraints when no
selection can be made otherwise.
Returns:
This builder.
Sets whether to allow adaptive audio selections containing mixed MIME types.
Adaptations between different MIME types may not be completely seamless.
Parameters:
allowAudioMixedMimeTypeAdaptiveness: Whether to allow adaptive audio selections
containing mixed MIME types.
Returns:
This builder.
Sets whether to allow adaptive audio selections containing mixed sample rates.
Adaptations between different sample rates may not be completely seamless.
Parameters:
allowAudioMixedSampleRateAdaptiveness: Whether to allow adaptive audio selections
containing mixed sample rates.
Returns:
This builder.
Sets whether to allow adaptive audio selections containing mixed channel counts.
Adaptations between different channel counts may not be completely seamless.
Parameters:
allowAudioMixedChannelCountAdaptiveness: Whether to allow adaptive audio selections
containing mixed channel counts.
Returns:
This builder.
Sets whether to allow adaptive audio selections with mixed levels of and .
Parameters:
allowAudioMixedDecoderSupportAdaptiveness: Whether to allow adaptive audio selections
with mixed levels of decoder and hardware acceleration support.
Returns:
This builder.
Sets the preferred sample MIME type for audio tracks.
Parameters:
mimeType: The preferred MIME type for audio tracks, or null to clear a
previously set preference.
Returns:
This builder.
Sets the preferred sample MIME types for audio tracks.
Parameters:
mimeTypes: The preferred MIME types for audio tracks in order of preference, or an
empty list for no preference.
Returns:
This builder.
Sets the preferred language and role flags for text tracks based on the accessibility
settings of CaptioningManager.
Does nothing for API levels < 19 or when the CaptioningManager is disabled.
Parameters:
context: A .
Returns:
This builder.
Sets the preferred language for text tracks.
Parameters:
preferredTextLanguage: Preferred text language as an IETF BCP 47 conformant tag, or
null to select the default track if there is one, or no track otherwise.
Returns:
This builder.
Sets the preferred languages for text tracks.
Parameters:
preferredTextLanguages: Preferred text languages as IETF BCP 47 conformant tags in
order of preference, or an empty array to select the default track if there is one, or no
track otherwise.
Returns:
This builder.
Sets the preferred C.RoleFlags for text tracks.
Parameters:
preferredTextRoleFlags: Preferred text role flags.
Returns:
This builder.
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.
Parameters:
selectUndeterminedTextLanguage: Whether a text track with undetermined language should
be selected if no preferred language track is available.
Returns:
This builder.
Sets a bitmask of selection flags that are disabled for text track selections.
Parameters:
disabledTextTrackSelectionFlags: A bitmask of that are
disabled for text track selections.
Returns:
This builder.
Sets whether to force selection of the single lowest bitrate audio and video tracks that
comply with all other constraints.
Parameters:
forceLowestBitrate: Whether to force selection of the single lowest bitrate audio and
video tracks.
Returns:
This builder.
Sets whether to force selection of the highest bitrate audio and video tracks that comply
with all other constraints.
Parameters:
forceHighestSupportedBitrate: Whether to force selection of the highest bitrate audio
and video tracks.
Returns:
This builder.
Sets the selection overrides.
Parameters:
trackSelectionOverrides: The track selection overrides.
Returns:
This builder.
Sets the disabled track types, preventing all tracks of those types from being selected for
playback.
Parameters:
disabledTrackTypes: The track types to disable.
Returns:
This builder.
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.
Parameters:
exceedRendererCapabilitiesIfNecessary: Whether to exceed renderer capabilities when no
selection can be made otherwise.
Returns:
This builder.
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 recomended to check that the media plays correctly when this option is enabled. See
[#9661](https://github.com/google/ExoPlayer/issues/9661),
[#9133](https://github.com/google/ExoPlayer/issues/9133),
[#9317](https://github.com/google/ExoPlayer/issues/9317),
[#9502](https://github.com/google/ExoPlayer/issues/9502).
Parameters:
tunnelingEnabled: Whether to enable tunneling if possible.
Returns:
This builder.
Sets whether multiple adaptive selections with more than one track are allowed.
Parameters:
allowMultipleAdaptiveSelections: Whether multiple adaptive selections are allowed.
Returns:
This builder.
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.
Returns:
This builder.
Deprecated: Use .
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 DefaultTrackSelector.ParametersBuilder.setRendererDisabled(int, boolean) because the renderer
is disabled conditionally on the TrackGroupArray mapped to it, where-as DefaultTrackSelector.ParametersBuilder.setRendererDisabled(int, boolean) disables the renderer unconditionally.
To remove overrides use DefaultTrackSelector.ParametersBuilder.clearSelectionOverride(int, TrackGroupArray), DefaultTrackSelector.ParametersBuilder.clearSelectionOverrides(int) or DefaultTrackSelector.ParametersBuilder.clearSelectionOverrides().
Parameters:
rendererIndex: The renderer index.
groups: The TrackGroupArray for which the override should be applied.
override: The override.
Returns:
This builder.
Deprecated: Use .
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.
Returns:
This builder.
Deprecated: Use .
Clears all track selection overrides for the specified renderer.
Parameters:
rendererIndex: The renderer index.
Returns:
This builder.
Deprecated: Use .
Clears all track selection overrides for all renderers.
Returns:
This builder.
Builds a DefaultTrackSelector.Parameters instance with the selected values.