SDK / exoplayer

With this change we will now support loading bitmaps from all the formats documented [here](https://developer.android.com/guide/topics/media/media-formats#image-formats) except for gifs (because they are animated). Java doc is added to express this.

PiperOrigin-RevId: 535610152
(cherry picked from commit 7740ccc9382c55e246f5b7e5ea4e120d99b662bc)

PiperOrigin-RevId: 535554628
(cherry picked from commit 8ba6b12ebc28a5fefe5f0b1d9a565794ebaf9ea6)

*** Original commit ***

ExoPlayer: Add setVideoFrameProcessorFactory().

This allows apps to use a custom VideoFrameProcessor implementation for video
playback. This may be useful, for example, when outputting to a texture.
***

PiperOrigin-RevId: 536391597
(cherry picked from commit dbbb0919075a9c95f45d51307b434eda4c4744bd)

#minor-release

PiperOrigin-RevId: 535268825
(cherry picked from commit e7d1c57e80b7416a8093c098ccc9b927d361fe16)

PiperOrigin-RevId: 535255453
(cherry picked from commit 6a9167097e78341b3bd3ad8309ee79ae35ecfd13)

PiperOrigin-RevId: 535233266
(cherry picked from commit 02698a8a4c169546c17c20c8336a05470b957da7)

PiperOrigin-RevId: 535183521
(cherry picked from commit c9ca510a8382abc601faa3d91e95fde845ea952a)

This change moves the default logic into the actual Player
implementations, but does not introduce any behavior changes compared
to addMediaItems+removeMediaItems except to make the updates "atomic"
in ExoPlayerImpl, SimpleBasePlayer and MediaController. It also
provides backwards compatbility for cases where Players don't support
the operation.

Issue: google/ExoPlayer#8046

#minor-release

PiperOrigin-RevId: 534945089
(cherry picked from commit 6309b11792b05306d004747af35d67f32a352782)

PiperOrigin-RevId: 534927167
(cherry picked from commit d8e30c351e9e790730942c8d336b1e4689f571c2)

Issue: google/ExoPlayer#11160

#minor-release

PiperOrigin-RevId: 534896789
(cherry picked from commit b72ef3e9b7ce14eaf98de5b2cc32be6d25a61ed8)

Also, document that texture output disables manual frame release.

In the past, texture output would lead to surface output methods throwing. Now,
they're simply no-ops instead.

PiperOrigin-RevId: 534894168
(cherry picked from commit 21ee2e2243c2d0f2875ae7506e90217fe6044bc7)

PiperOrigin-RevId: 534869452
(cherry picked from commit a785d7d01643cc6c07a741a33e588c8c43feb31c)

When the video renderer is disabled, the video size is set to 0/0
and sent to listeners. The `PlayerView` potentially still has the last frame
displayed when the player is stopped or an error occurs. This may have the
effect that the frame is displayed distorted.

Not changing the aspect ratio when the video size arrives when the player is IDLE
avoids the problem. In the case when playback starts again and the renderes is
enabled, another video size is sent to the listener.

#minor-release

PiperOrigin-RevId: 534860889
(cherry picked from commit 3e3aaf8816aa4a425343ac4aaf2299cd6e9f8085)

Fix `@param`s and clarify wording.

PiperOrigin-RevId: 534857204
(cherry picked from commit 07e6708e92afbc213718a05a3549542c60558b99)

PiperOrigin-RevId: 534848363
(cherry picked from commit e8a934992ccd5f44db169d5b230eea8350524576)

This helps to highlight that the replaced range doesn't need to have
the same size as before.

#minor-release

PiperOrigin-RevId: 534834917
(cherry picked from commit 19ded9c7912c0ed85a791d352fecdb0d1030bde3)

PiperOrigin-RevId: 534814892
(cherry picked from commit cf4be52f5976a852ce89e9a16472ee8aa71f42c0)

PiperOrigin-RevId: 534801202
(cherry picked from commit be6f5e437828ba92d1046c375a977c3a1d58a3ad)

This change removes it from `Player.Listener` and `AnalyticsListener`,
use `onPositionDiscontinuity` with `DISCONTINUITY_REASON_SEEK` instead.

#minor-release

PiperOrigin-RevId: 534757426
(cherry picked from commit 624ab259f06673940849e71bc335cfa17bcab887)

Tentative/experimental value to reduce codec timeouts. We will reconsider using a larger limit after seeing whether this really does reduce error rate.

PiperOrigin-RevId: 534491615
(cherry picked from commit 8d7848a5bd72298c8a521414a95763982a74f032)

- Number of frames from SurfaceTexture that is sent downstream
- Times ExtTexMgr signaled end of current input stream

PiperOrigin-RevId: 534487842
(cherry picked from commit d21bf0ee89c40bd0d94107b9d1e74874438aa869)

Mp4Muxer already supports writing Mp4LocationData so added that
as supported Metadata entry.
Support for more Metadata entries will be added in upcoming CLs.

PiperOrigin-RevId: 534473866
(cherry picked from commit 24753dab7c46079181f9d466801b0cc809ceb326)

I moved this assignment in https://github.com/google/ExoPlayer/commit/326f53a61c4e58a9123561e0f0c838c40929852f
in order to provide a single source-of-truth for `publish.gradle`,
but as pointed out in Issue: androidx/media#416 this breaks apps that are depending
on our project locally using the instructions we publish. Instead we can
remove the `rootProject.name` check from `publish.gradle`, and check an
explicit boolean value instead to indicate if the root project is 'ours'
(with this boolean only set from `settings.gradle`, so it doesn't get
picked up by apps depending on us locally).

#minor-release

PiperOrigin-RevId: 534459085
(cherry picked from commit 3ca3e11de1ab7c8a1fde0f9dd92dd9724fedcc56)

And fix violation of this in AdsMediaSource.

#minor-release

PiperOrigin-RevId: 534441648
(cherry picked from commit 23b53fc7942131823c62af3570cfebb28614521b)

Use the audio or video specific variants instead.

#minor-release

PiperOrigin-RevId: 534436644
(cherry picked from commit 868e44290e7701c55352368a72a63aa0647fc483)

Use the non-deprecated constructor instead.

#minor-release

PiperOrigin-RevId: 534426655
(cherry picked from commit 523ec804d2fc50111eaad7b73510c21cd5f68896)

#minor-release

PiperOrigin-RevId: 534412494
(cherry picked from commit 6dcd6276ae4129361d48af032a4fe62fd499ccc5)

PiperOrigin-RevId: 534390168
(cherry picked from commit 3ac41de751e27e28bc383cc2aa0667d9332322b3)

Use the constructor that takes an `Executor` instead.

#minor-release

PiperOrigin-RevId: 534370613
(cherry picked from commit b56fddfa01b85eb7370308057c0c69eb0c779f1c)

Use `build()` instead.

#minor-release

PiperOrigin-RevId: 534348979
(cherry picked from commit b71487ebb468b511b1d6880d4f5d26c0f0777fcd)

Use `setWakeMode(int)` instead.

#minor-release

PiperOrigin-RevId: 534344010
(cherry picked from commit 90303e40ed86364d3128e5f9fec306a6f3bb5906)

This change deprecates `PlayerView.setUseArtwork(boolean)` and
introduces `setArtworkDisplayMode(mode)` and
`artworkDisplayMode="off|fit|fill"` instead.

- off: no artwork is displayed (like deprecated useArtwork=false)
- fit: letterbox like media (like deprecated useArtwork=true)
- fill: scales the artwork to fill the entire width/weight of the player view

#minor-release

PiperOrigin-RevId: 534167226
(cherry picked from commit 7f3f2fe0758e083cc5baf8781b1f1be20d32f052)

Fix a bug when seeking in an opus container. The calculations inside
DefaultOggSeeker may overflow a long primitive.

Issue: androidx/media#391

#minor-release

PiperOrigin-RevId: 534128513
(cherry picked from commit 5535cd18ec50862425adadd231778752bfe12ba1)

Earlier metadata was written multiple times as it came.
With new changes, all the distinct metadata entries will
get collected and will be written at once in the end.

PiperOrigin-RevId: 534088401
(cherry picked from commit f88fde8b88c2422f096425b6568ee7ac8ebb2ade)

This allows us to disallow access after release.

PiperOrigin-RevId: 534046475
(cherry picked from commit d357cd616c47cce0a5cdd066b25e307488d25534)

This allows apps to use a custom VideoFrameProcessor implementation for video
playback. This may be useful, for example, when outputting to a texture.

PiperOrigin-RevId: 534044831
(cherry picked from commit 703923d196934fdcc019ffd610b6f778f8fa043d)

The methods in ExoPlayerImpl and MediaControllerImplBase that determine
the new PlayerInfo/PlaybackInfo currently have a hard-to-reason-about
setup where the method generating the new info accesses other methods
that rely on the existing class field instead of working with the
passed in PlayerInfo/PlaybackInfo. This prevents reuse of the util
methods (e.g. for replaceMediaItems) because they access potentially
stale state.

This change untangles these methods a bit by making the util methods
either static or at least ensure that they don't rely on existing
class fields of PlayerInfo/PlaybackInfo. Overall, the change is a
complete no-op.

#minor-release

PiperOrigin-RevId: 534036633
(cherry picked from commit f898a7f17376d50c4de6cd8f67fe047410581527)

The main interface documentation hasn't been updated substantially
since 2017 and is missing notes for many of its current features and
requirements.

Also change the recommendation for implementors from BasePlayer to
SimpleBasePlayer to ensure new classes are more likely to cover all
of the interface requirements.

#minor-release

PiperOrigin-RevId: 534027117
(cherry picked from commit d75e24a713dd8648ff775c6d29be6db30a7d31d9)

This field is always accessed with the mutex held.

PiperOrigin-RevId: 534027096
(cherry picked from commit ea42465fef89a667655c4d2603e7b48b54157d92)