Receives broadcast events indicating changes to the device's audio capabilities, notifying a
AudioCapabilitiesReceiver.Listener when audio capability changes occur.
Provides a default MediaMetadataCompat with properties and extras taken from the MediaDescriptionCompat of the MediaSessionCompat.QueueItem of the active queue item.
A media player interface defining traditional high-level functionality, such as the ability to
play, pause, seek and query properties of the currently playing media.
Controls how a frame is presented with options to set the output resolution, crop the input, and
+ choose how to map the input pixels onto the output frame geometry (for example, by stretching the
+ input frame to match the specified output frame, or fitting the input frame using letterboxing).
Interface for time bar views that can display a playback position, buffered position, duration
and ad markers, and that have a listener for scrubbing (seeking) events.
Adapter to get MediaDescriptionCompat of items in the queue and to notify the
application about changes in the queue to sync the data structure backing the MediaSessionConnector.
Information about a single group of tracks, including the underlying TrackGroup, the
+ level to which each track is supported by the player, and whether any of the tracks are
+ selected.
Information about a single group of tracks, including the underlying TrackGroup, the
- type of tracks it contains, and the level to which each track is supported
- by the player.
public DefaultRenderersFactory experimentalSetImmediateCodecStartAfterFlushEnabled(boolean enabled)
-
Enable calling MediaCodec.start() immediately after MediaCodec.flush() on the
- playback thread, when operating the codec in asynchronous mode. If disabled, MediaCodec.start() will be called by the callback thread after pending callbacks are handled.
-
-
By default, this feature is disabled.
-
-
This method is experimental, and will be renamed or removed in a future release.
public ExoPlayer.Builder setUsePlatformDiagnostics(boolean usePlatformDiagnostics)
+
Sets whether the player reports diagnostics data to the Android platform.
+
+
If enabled, the player will use the MediaMetricsManager to
+ create a PlaybackSession and forward playback events and
+ performance data to this session. This helps to provide system performance and debugging
+ information for media playback on the device. This data may also be collected by Google if sharing usage and diagnostics
+ data is enabled by the user of the device.
+
+
Parameters:
+
usePlatformDiagnostics - Whether the player reports diagnostics data to the Android
+ platform.
public static final class MediaItem.RequestMetadata
extends Object
-implements Bundleable
-
Forces the selection of the specified tracks in TrackGroups.
-
-
Each override only affects the selection of tracks of that
- type. For example overriding the selection of an audioTrackGroup will not affect the selection of video or
- text tracks.
+implements Bundleable
+
Metadata that helps the player to understand a playback request represented by a MediaItem.
-
If multiple TrackGroups of the same C.TrackType are overridden,
- which tracks will be selected depend on the player capabilities. For example, by default
- ExoPlayer doesn't support selecting more than one TrackGroup per C.TrackType.
-
-
Overrides of TrackGroup that are not currently available are ignored. For example,
- when the player transitions to the next MediaItem in a playlist, any overrides of the
- previous MediaItem are ignored.
This metadata is most useful for cases where playback requests are forwarded to other player
+ instances (e.g. from a MediaController) and the player creating
+ the request doesn't know the required MediaItem.LocalConfiguration for playback.
Returns the encoding and channel config to use when configuring an AudioTrack in
+ passthrough mode for the specified Format. Returns null if passthrough of the
+ format is unsupported.
Called when the renderer's stream has changed. This occurs when the renderer is enabled after
+ BaseRenderer.onEnabled(boolean, boolean) has been called, and also when the stream has been
+ replaced whilst the renderer is enabled or started.
+
+
Receives broadcast events indicating changes to the device's audio capabilities, notifying a
AudioCapabilitiesReceiver.Listener when audio capability changes occur.
defaultLicenseUrl - The default license URL. Used for key requests that do not specify
their own license URL. May be null if it's known that all key requests will specify
their own URLs.
-
dataSourceFactory - A factory from which to obtain HttpDataSource instances.
+
dataSourceFactory - A factory from which to obtain DataSource instances. This will
+ usually be an HTTP-based DataSource.
A concrete implementation may include null elements if it has a fixed number of renderer
- components, wishes to report a TrackSelection for each of them, and has one or more renderer
- components that is not assigned any selected tracks.
public void experimentalSetDiscardPaddingEnabled(boolean enabled)
+
Sets whether discard padding is enabled. When enabled, discard padding samples (provided as
+ supplemental data on the input buffer) will be removed from the end of the decoder output.
+
+
This method is experimental, and will be renamed or removed in a future release.
timestamp - The timestamp associated with the first received RTP packet. This number has
+ no unit, the duration conveyed by it depends on the frequency of the media that the RTP
+ packet is carrying.
+
sequenceNumber - The sequence associated with the first received RTP packet.
timestamp - The timestamp of the RTP packet that transmitted the data. This number has no
+ unit, the duration conveyed by it depends on the frequency of the media that the RTP packet
+ is carrying.
+
sequenceNumber - The sequence number of the RTP packet.
+
rtpMarker - The marker bit of the RTP packet. The interpretation of this bit is specific
+ to each payload format.
+ loads data from multiple streams (video, audio etc.).
Parameters:
compositeSequenceableLoaderFactory - A factory to create composite SequenceableLoaders for when this media source loads data from multiple streams (video,
@@ -425,13 +438,10 @@
Most implementations should pass all these tests. If necessary, subclasses can disable tests
by overriding the @Test method with a no-op implementation. It's recommended (but
- not required) to also annotate this @Ignore so that JUnit correclty reports the
+ not required) to also annotate this @Ignore so that JUnit correctly reports the
test as skipped/ignored instead of passing.
A concrete implementation may include null elements if it has a fixed number of renderer
- components, wishes to report a TrackSelection for each of them, and has one or more renderer
- components that is not assigned any selected tracks.
This list is in ascending order of priority. If any of the cue boxes overlap when displayed,
+ the Cue nearer the end of the list should be shown on top.
+
+
This list may be empty if the group represents a state with no cues.
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.
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(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.
allowVideoMixedDecoderSupportAdaptiveness - Whether to allow adaptive video selections
+ with mixed levels of decoder and hardware acceleration support.
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.
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.
allowAudioMixedDecoderSupportAdaptiveness - Whether to allow adaptive audio selections
+ with mixed levels of decoder and hardware acceleration support.
Whether to only select audio tracks with channel counts that don't exceed the device's
+ output capabilities. The default value is true.
+
+
When enabled, the track selector will prefer stereo/mono audio tracks over multichannel
+ if the audio cannot be spatialized or the device is outputting stereo audio. For example,
+ on a mobile device that outputs non-spatialized audio to its speakers. Dolby surround sound
+ formats are excluded from these constraints because some Dolby decoders are known to
+ spatialize multichannel audio on Android OS versions that don't support the Spatializer API.
+
+
For devices with Android 12L+ that support audio
+ spatialization, when this is enabled the track selector will trigger a new track selection
+ everytime a change in spatialization properties is detected.
+
+
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.
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.
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.
Sets the disabled track types, preventing all tracks of those types from being selected for
+ playback. Any previously disabled track types are cleared.
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.
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 [#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.
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.
+
+
public final boolean constrainAudioChannelCountToDeviceCapabilities
+
Whether to constrain audio track selection so that the selected track's channel count does
+ not exceed the device's output capabilities. The default value is true.
+
+
@@ -632,7 +649,7 @@
getDefaults
getRendererDisabled
-
public final boolean getRendererDisabled(int rendererIndex)
+
public boolean getRendererDisabled(int rendererIndex)
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.
Sets whether a text track with undetermined language should be selected if no track with
a preferred language is available, or if the
@@ -1344,16 +1502,12 @@
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
+ strongly recommended 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),
@@ -1490,6 +1736,7 @@
diff --git a/docs/doc/reference/com/google/android/exoplayer2/trackselection/DefaultTrackSelector.html b/docs/doc/reference/com/google/android/exoplayer2/trackselection/DefaultTrackSelector.html
index c0de0d7dec4..1a9b563400a 100644
--- a/docs/doc/reference/com/google/android/exoplayer2/trackselection/DefaultTrackSelector.html
+++ b/docs/doc/reference/com/google/android/exoplayer2/trackselection/DefaultTrackSelector.html
@@ -25,8 +25,8 @@
catch(err) {
}
//-->
-var data = {"i0":10,"i1":9,"i2":10,"i3":10,"i4":9,"i5":9,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10};
-var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
+var data = {"i0":10,"i1":9,"i2":10,"i3":10,"i4":9,"i5":9,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":42,"i16":10};
+var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
@@ -159,11 +159,10 @@
Modifying parameters
.setMaxVideoSizeSd()
.setPreferredAudioLanguage("de")
.build());
-
Some specialized parameters are only available in the extended DefaultTrackSelector.Parameters class, which
- can be retrieved and modified in a similar way in this track selector:
+ can be retrieved and modified in a similar way by calling methods directly on this class:
Returns the maximum number of frames that may be pending in the output Codec at a time,
+ or Codec.UNLIMITED_PENDING_FRAME_COUNT if it's not necessary to enforce a limit.
Returns the maximum number of frames that may be pending in the output Codec at a time,
+ or Codec.UNLIMITED_PENDING_FRAME_COUNT if it's not necessary to enforce a limit.
Signals end-of-stream on input to a video encoder.
+
+
This method must only be called on video encoders because they must use a Surface as
+ input. For audio/video decoders or audio encoders, the C.BUFFER_FLAG_END_OF_STREAM flag
+ should be set on the last input buffer queued.
Only set render to true when the Codec is a video decoder. Setting
+ render to true will first render the buffer to the output surface. In this
+ case, the surface will release the buffer back to the Codec once it is no longer
+ used/displayed.
+
+
This should be called after the buffer has been processed. The next output buffer will not
+ be available until the current output buffer has been released.
public DefaultEncoderFactory(EncoderSelector videoEncoderSelector,
+ VideoEncoderSettings requestedVideoEncoderSettings,
+ boolean enableFallback)
+
Creates a new instance.
+
+
With format fallback enabled, when the requested Format is not supported,
+ DefaultEncoderFactory finds a format that is supported by the device and configures the Codec with it. The fallback process may change the requested MIME
+ type, resolution, bitrate, profile/level etc.
+
+
This method must validate that the Codec is configured to produce one of the
+ allowedMimeTypes. The sample MIME type given in
+ format is not necessarily allowed.
This method must validate that the Codec is configured to produce one of the
+ allowedMimeTypes. The sample MIME type given in
+ format is not necessarily allowed.
@Nullable
-public static Pair<Integer,Integer> getClosestSupportedResolution(MediaCodecInfo encoderInfo,
- String mimeType,
- int width,
- int height)
-
Finds the encoder's closest supported resolution from the given
- resolution.
+public static Size getSupportedResolution(MediaCodecInfo encoderInfo,
+ String mimeType,
+ int width,
+ int height)
+
Finds an encoder's supported resolution from a given resolution.
-
The input resolution is returned, if it is supported by the encoder.
+
The input resolution is returned, if it (after aligning to the encoder's requirement) is
+ supported by the encoder.
-
The resolution will be clamped to the encoder's range of supported
- resolutions, and adjusted to the encoder's size alignment. The
- adjustment process takes into account the original aspect ratio. But the fixed resolution may
- not preserve the original aspect ratio, depending on the encoder's required size alignment.
+
The resolution will be adjusted to be within the encoder's range
+ of supported resolutions, and will be aligned to the encoder's
+ alignment requirement. The adjustment process takes into account the original aspect ratio. But
+ the fixed resolution may not preserve the original aspect ratio, depending on the encoder's
+ required size alignment.
public interface GlMatrixTransformation
+extends GlEffect
+
Specifies a 4x4 transformation Matrix to apply in the vertex shader for each frame.
+
+
The matrix is applied to points given in normalized device coordinates (-1 to 1 on x, y, and z
+ axes). Transformed pixels that are moved outside of the normal device coordinate range are
+ clipped.
+
+
Output frame pixels outside of the transformed input frame will be black.
Specifies a 3x3 transformation Matrix to apply in the vertex shader for each frame.
+
+
The matrix is applied to points given in normalized device coordinates (-1 to 1 on x and y
+ axes). Transformed pixels that are moved outside of the normal device coordinate range are
+ clipped.
+
+
Output frame pixels outside of the transformed input frame will be black.
Crops a smaller (or larger frame), per normalized device coordinates (NDC), where the input
+ frame corresponds to the square ranging from -1 to 1 on the x and y axes.
Sets the output resolution using the output height.
+
+
The default value, C.LENGTH_UNSET, corresponds to using the same height as the
+ input. Output width of the displayed frame will scale to preserve the frame's aspect ratio
+ after other transformations.
+
+
For example, a 1920x1440 frame can be scaled to 640x480 by calling
+ setResolution(480).
+
+
Parameters:
+
height - The output height of the displayed frame, in pixels.
Crops a smaller (or larger frame), per normalized device coordinates (NDC), where the input
+ frame corresponds to the square ranging from -1 to 1 on the x and y axes.
+
+
left and bottom default to -1, and right and top default
+ to 1, which corresponds to not applying any crop. To crop to a smaller subset of the input
+ frame, use values between -1 and 1. To crop to a larger frame, use values below -1 and above
+ 1.
+
+
Width and height values set may be rescaled by setResolution(int), which is
+ applied after cropping changes.
+
+
Strategies controlling the layout of input pixels in the output frame.
-
Note: Changes to the Bundleable implementation must be backwards compatible, so as to avoid
- breaking communication across different Bundleable implementation versions.
May scale either width or height, leaving the other output dimension equal to its input,
+ unless Presentation.Builder.setResolution(int) rescales width and height.
Controls how a frame is presented with options to set the output resolution, crop the input, and
+ choose how to map the input pixels onto the output frame geometry (for example, by stretching the
+ input frame to match the specified output frame, or fitting the input frame using letterboxing).
+
+
Cropping or aspect ratio is applied before setting resolution.
+
+
The background color of the output frame will be black.
Empty pixels added above and below the input frame (for letterboxing), or to the left and right
+ of the input frame (for pillarboxing), until the desired aspect ratio is achieved.
Empty pixels added above and below the input frame (for letterboxing), or to the left and right
+ of the input frame (for pillarboxing), until the desired aspect ratio is achieved. All input
+ frame pixels will be within the output frame.
+
+
When applying:
+
+
+
letterboxing, the output width will default to the input width, and the output height
+ will be scaled appropriately.
+
pillarboxing, the output height will default to the input height, and the output width
+ will be scaled appropriately.
+
public static final int LAYOUT_SCALE_TO_FIT_WITH_CROP
+
Pixels cropped from the input frame, until the desired aspect ratio is achieved. Pixels may be
+ cropped either from the bottom and top, or from the left and right sides, of the input frame.
+
+
When cropping from the:
+
+
+
bottom and top, the output width will default to the input width, and the output height
+ will be scaled appropriately.
+
left and right, the output height will default to the input height, and the output width
+ will be scaled appropriately.
+
Specifies a simple rotation and/or scale to apply in the vertex shader.
+
+
All input frames' pixels will be preserved and copied into an output frame, potentially
+ changing the width and height of the frame by scaling dimensions to fit.
+
+
The background color of the output frame will be black.
Manages a GLSL shader program for processing a frame. Implementations generally copy input pixels
+ into an output frame, with changes to pixels specific to the implementation.
+
+
Methods must be called in the following order:
+
+
+
The constructor, for implementation-specific arguments.
+
This method may only be called after the texture processor has been initialized. The caller is responsible for focussing the
+ correct render target before calling this method.
+
+
A minimal implementation should tell OpenGL to use its shader program, bind the shader
+ program's vertex attributes and uniforms, and issue a drawing command.
+
+
Parameters:
+
presentationTimeUs - The presentation timestamp of the current frame, in microseconds.
Sets whether the input should be flattened for media containing slow motion markers. The
- transformed output is obtained by removing the slow motion metadata and by actually slowing
- down the parts of the video and audio streams defined in this metadata. The default value for
- flattenForSlowMotion is false.
+
Sets whether the input should be flattened for media containing slow motion markers.
+
+
The transformed output is obtained by removing the slow motion metadata and by actually
+ slowing down the parts of the video and audio streams defined in this metadata. The default
+ value for flattenForSlowMotion is false.
Only Samsung Extension Format (SEF) slow motion metadata type is supported. The
transformation has no effect if the input does not contain this metadata type.
@@ -324,7 +317,9 @@
Sets the rotation, in degrees, counterclockwise, to apply to each frame.
+
+
The output frame's width and height are automatically adjusted to preserve all input
+ pixels. The rotated input frame is fitted inside an enclosing black rectangle if its edges
+ aren't parallel to the x and y axes.
+
+
The default value, 0, corresponds to not applying any rotation.
+
+
Parameters:
+
rotationDegrees - The counterclockwise rotation, in degrees.
Sets the output resolution using the output height. The default value C.LENGTH_UNSET
- corresponds to using the same height as the input. Output width will scale to preserve the
- input video's aspect ratio.
+
Sets the output resolution using the output height.
+
+
Output width of the displayed video will scale to preserve the video's aspect ratio after
+ other transformations.
-
For now, only "popular" heights like 144, 240, 360, 480, 720, 1080, 1440, or 2160 are
- supported, to ensure compatibility on different devices.
+
For example, a 1920x1440 video can be scaled to 640x480 by calling setResolution(480).
-
For example, a 1920x1440 video can be scaled to 640x480 by calling setResolution(480).
+
The default value, C.LENGTH_UNSET, leaves the width and height unchanged unless
+ scaling or @linkplain #setRotationDegrees(float)
+ rotation} are requested.
Parameters:
-
outputHeight - The output height in pixels.
+
outputHeight - The output height of the displayed video, in pixels.
Sets the video MIME type of the output. The default value is null which corresponds
- to using the same MIME type as the input. Supported MIME types are:
+
Sets the video MIME type of the output.
+
+
The default value is null which corresponds to using the same MIME type as the
+ input. Supported MIME types are:
Sets the audio MIME type of the output. The default value is null which corresponds
- to using the same MIME type as the input. Supported MIME types are:
+
Sets the audio MIME type of the output.
+
+
The default value is null which corresponds to using the same MIME type as the
+ input. Supported MIME types are:
Sets whether to request tone-mapping to standard dynamic range (SDR). If enabled and
+ supported, high dynamic range (HDR) input will be tone-mapped into an SDR opto-electrical
+ transfer function before processing.
+
+
The setting has no effect if the input is already in SDR, or if tone-mapping is not
+ supported. Currently tone-mapping is only guaranteed to be supported from Android T onwards.
+
+
Parameters:
+
enableRequestSdrToneMapping - Whether to request tone-mapping down to SDR.
+
Returns:
+
This builder.
@@ -425,7 +489,7 @@
experimental_setEnableHdrEditing
This method is experimental, and will be renamed or removed in a future release. The HDR
editing feature is under development and is intended for developing/testing HDR processing
- and encoding support.
+ and encoding support. HDR editing can't be enabled at the same time as SDR tone-mapping.
Parameters:
enableHdrEditing - Whether to attempt to process any input video stream as a high
diff --git a/docs/doc/reference/com/google/android/exoplayer2/transformer/TransformationRequest.html b/docs/doc/reference/com/google/android/exoplayer2/transformer/TransformationRequest.html
index 6ffff3fd868..e7f341bc6ac 100644
--- a/docs/doc/reference/com/google/android/exoplayer2/transformer/TransformationRequest.html
+++ b/docs/doc/reference/com/google/android/exoplayer2/transformer/TransformationRequest.html
@@ -181,8 +181,8 @@
Sets the Looper that must be used for all calls to the transformer and that is used
- to call listeners on. The default value is the Looper of the thread that this builder was
- created on, or if that thread does not have a Looper, the Looper of the application's main
- thread.
+ to call listeners on.
+
+
The default value is the Looper of the thread that this builder was created on, or if that
+ thread does not have a Looper, the Looper of the application's main thread.
Sets a provider for views to show diagnostic information (if available) during
- transformation. This is intended for debugging. The default value is Transformer.DebugViewProvider.NONE, which doesn't show any debug info.
+ transformation.
+
+
Starts an asynchronous operation to transform the given MediaItem.
-
The transformation state is notified through the listener.
+
The transformation state is notified through the listener.
Concurrent transformations on the same Transformer object are not allowed.
The output is an MP4 file. It can contain at most one video track and one audio track. Other
- track types are ignored. For adaptive bitrate media sources, the highest
- bitrate video and audio streams are selected.
+ track types are ignored. For adaptive bitrate media sources, the
+ highest bitrate video and audio streams are selected.
Starts an asynchronous operation to transform the given MediaItem.
-
The transformation state is notified through the listener.
+
The transformation state is notified through the listener.
Concurrent transformations on the same Transformer object are not allowed.
The output is an MP4 file. It can contain at most one video track and one audio track. Other
- track types are ignored. For adaptive bitrate media sources, the highest
- bitrate video and audio streams are selected.
+ track types are ignored. For adaptive bitrate media sources, the
+ highest bitrate video and audio streams are selected.
Controls how a frame is presented with options to set the output resolution, crop the input, and
+ choose how to map the input pixels onto the output frame geometry (for example, by stretching the
+ input frame to match the specified output frame, or fitting the input frame using letterboxing).
Sets a listener to be called when the fullscreen mode should be changed. A non-null listener
- needs to be set in order to display the fullscreen button.
-
-
Parameters:
-
listener - The listener to be called. A value of null removes any existing
- listener and hides the fullscreen button.
cues is in ascending order of priority. If any of the cue boxes overlap when
- displayed, the Cue nearer the end of the list should be shown on top.
-
-
Creates a builder for a track selection dialog which automatically updates a DefaultTrackSelector.
+ Player player,
+ @com.google.android.exoplayer2.C.TrackType int trackType)
+
Creates a builder for a track selection dialog.
Parameters:
context - The context of the dialog.
title - The title of the dialog.
-
trackSelector - A DefaultTrackSelector whose current selection is used to set up
- the dialog and which is updated when new tracks are selected in the dialog.
-
rendererIndex - The renderer index in the trackSelector for which the track
- selection is shown.
+
player - The Player whose tracks should be selected.
+
trackType - The type of tracks to show for selection.
Sets the initial track overrides. Any overrides that do not correspond to track groups that
+ were passed to the constructor will be ignored. If setAllowMultipleOverrides(boolean)
+ hasn't been set to true then all but one override will be ignored. The retained
+ override will be the one whose track group was first in the list of track groups passed to the
+ constructor.
Parameters:
-
overrides - The list of initial overrides to show. There must be at most one override for
- each track group.
+
overrides - The initially selected track overrides.
Returns the subset of overrides that apply to the specified trackGroups. If
+ allowMultipleOverrides is then at most one override is retained, which will be
+ the one whose track group is first in trackGroups.
+
+
Parameters:
+
overrides - The overrides to filter.
+
trackGroups - The track groups whose overrides should be retained.
+
allowMultipleOverrides - Whether more than one override can be retained.
+
Returns:
+
The filtered overrides.
+
+
+
@@ -466,10 +495,10 @@
setAllowAdaptiveSelections
setAllowMultipleOverrides
public void setAllowMultipleOverrides(boolean allowMultipleOverrides)
-
Sets whether tracks from multiple track groups can be selected. This results in multiple SelectionOverrides to be returned by getOverrides().
isDisabled - Whether the renderer should be initially shown as disabled.
-
overrides - List of initial overrides to be shown for this renderer. There must be at most
- one override for each track group. If setAllowMultipleOverrides(boolean) hasn't
- been set to true, only the first override is used.
isDisabled - Whether the disabled option should be initially selected.
+
overrides - The initially selected track overrides. Any overrides that do not correspond
+ to track groups in trackGroups will be ignored. If setAllowMultipleOverrides(boolean) hasn't been set to true then all but one
+ override will be ignored. The retained override will be the one whose track group is first
+ in trackGroups.
trackFormatComparator - An optional comparator used to determine the display order of the
tracks within each track group.
-
listener - An optional listener for track selection updates.
+
listener - An optional listener to receive selection updates.