loliball/media3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix the release notes for 1.4.0 stable release

Browse Source 
#cherrypick

PiperOrigin-RevId: 655558346
This commit is contained in:
tianyifeng 2024-07-24 07:28:50 -07:00 committed by Copybara-Service
parent da4c962e09
commit d70ff7e4d2
1 changed files with 30 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
RELEASENOTES.md
View File

@ -109,14 +109,14 @@ This release includes the following changes since the
[1.3.1 release](#131-2024-04-11): [1.3.1 release](#131-2024-04-11):
* Common Library: * Common Library:
* Forward presumed no-op seek calls to the protected `BasePlayer.seekTo` * Forward presumed no-op seek calls to the protected `BasePlayer.seekTo()`
and `SimpleBasePlayer.handleSeek` methods instead of ignoring them. If and `SimpleBasePlayer.handleSeek()` methods instead of ignoring them. If
you are implementing these methods in a custom player, you may need to you are implementing these methods in a custom player, you may need to
handle these additional calls with `mediaItemIndex == C.INDEX_UNSET`. handle these additional calls with `mediaItemIndex == C.INDEX_UNSET`.
* Remove compile dependency on enhanced Java 8 desugaring * Remove compile dependency on enhanced Java 8 desugaring
([#1312](https://github.com/androidx/media/issues/1312)). ([#1312](https://github.com/androidx/media/issues/1312)).
* Ensure the duration passed to `MediaItem.Builder.setImageDurationMs` is * Ensure the duration passed to `MediaItem.Builder.setImageDurationMs()`
ignored for a non-image `MediaItem` (as documented). is ignored for a non-image `MediaItem` (as documented).
* Add `Format.customData` to store app-provided custom information about * Add `Format.customData` to store app-provided custom information about
`Format` instances. `Format` instances.
* ExoPlayer: * ExoPlayer:
@ -134,16 +134,16 @@ This release includes the following changes since the
check if the buffer time is at least check if the buffer time is at least
`BaseRenderer.getLastResetPositionUs()` to decide whether a sample `BaseRenderer.getLastResetPositionUs()` to decide whether a sample
should be shown. Custom `SimpleDecoder` implementations can check should be shown. Custom `SimpleDecoder` implementations can check
`isAtLeastOutputStartTimeUs` if needed or mark other buffers with `isAtLeastOutputStartTimeUs()` if needed or mark other buffers with
`DecoderOutputBuffer.shouldBeSkipped` to skip them. `DecoderOutputBuffer.shouldBeSkipped` to skip them.
* Allow a null value to be returned by * Allow a null value to be returned by
`TargetPreloadStatusControl.getTargetPreloadStatus(T)` to indicate not `TargetPreloadStatusControl.getTargetPreloadStatus(T)` to indicate not
to preload a `MediaSource` with the given `rankingData`. to preload a `MediaSource` with the given `rankingData`.
* Add `remove(MediaSource)` to `BasePreloadManager`. * Add `remove(MediaSource)` to `BasePreloadManager`.
* Add `reset` to `BasePreloadManager` to release all the holding sources * Add `reset()` to `BasePreloadManager` to release all the holding sources
while keep the preload manager instance. while keep the preload manager instance.
* Add `ExoPlayer.setPriority` (and `Builder.setPriority`) to define the * Add `ExoPlayer.setPriority()` (and `Builder.setPriority()`) to define
priority value used in `PriorityTaskManager` and for MediaCodec the priority value used in `PriorityTaskManager` and for MediaCodec
importance from API 35. importance from API 35.
* Fix issue with updating the last rebuffer time which resulted in * Fix issue with updating the last rebuffer time which resulted in
incorrect `bs` (buffer starvation) key in CMCD incorrect `bs` (buffer starvation) key in CMCD
@ -166,31 +166,32 @@ This release includes the following changes since the
* Fix bug where playback moved to `STATE_ENDED` when re-preparing a * Fix bug where playback moved to `STATE_ENDED` when re-preparing a
multi-period DASH live stream after the original period was already multi-period DASH live stream after the original period was already
removed from the manifest. removed from the manifest.
* Rename `onTimelineRefreshed` to `onSourcePrepared` and `onPrepared` to * Rename `onTimelineRefreshed()` to `onSourcePrepared()` and
`onTracksSelected` in `PreloadMediaSource.PreloadControl`. Also rename `onPrepared()` to `onTracksSelected()` in
the IntDefs in `DefaultPreloadManager.Stage` accordingly. `PreloadMediaSource.PreloadControl`. Also rename the IntDefs in
`DefaultPreloadManager.Stage` accordingly.
* Add experimental support for dynamic scheduling to better align work * Add experimental support for dynamic scheduling to better align work
with CPU wake-cycles and delay waking up to when renderers can progress. with CPU wake-cycles and delay waking up to when renderers can progress.
You can enable this using `experimentalSetDynamicSchedulingEnabled` when You can enable this using `experimentalSetDynamicSchedulingEnabled()`
setting up your ExoPlayer instance. when setting up your ExoPlayer instance.
* Add `Renderer.getDurationToProgressMs`. A `Renderer` can implement this * Add `Renderer.getDurationToProgressUs()`. A `Renderer` can implement
method to return to ExoPlayer the duration that playback must advance this method to return to ExoPlayer the duration that playback must
for the renderer to progress. If `ExoPlayer` is set with advance for the renderer to progress. If `ExoPlayer` is set with
`experimentalSetDynamicSchedulingEnabled` then `ExoPlayer` will call `experimentalSetDynamicSchedulingEnabled()` then `ExoPlayer` will call
this method when calculating the time to schedule its work task. this method when calculating the time to schedule its work task.
* Add `MediaCodecAdapter#OnBufferAvailableListener` to alert when input * Add `MediaCodecAdapter#OnBufferAvailableListener` to alert when input
and output buffers are available for use by `MediaCodecRenderer`. and output buffers are available for use by `MediaCodecRenderer`.
`MediaCodecRenderer` will signal `ExoPlayer` when receiving these `MediaCodecRenderer` will signal `ExoPlayer` when receiving these
callbacks and if `ExoPlayer` is set with callbacks and if `ExoPlayer` is set with
`experimentalSetDynamicSchedulingEnabled`, then `ExoPlayer` will `experimentalSetDynamicSchedulingEnabled()`, then `ExoPlayer` will
schedule its work loop as renderers can make progress. schedule its work loop as renderers can make progress.
* Use data class for `LoadControl` methods instead of individual * Use data class for `LoadControl` methods instead of individual
parameters. parameters.
* Add `ExoPlayer.isReleased()` to check whether `Exoplayer.release()` has * Add `ExoPlayer.isReleased()` to check whether `Exoplayer.release()` has
been called. been called.
* Add `ExoPlayer.Builder.setMaxSeekToPreviousPositionMs` to configure the * Add `ExoPlayer.Builder.setMaxSeekToPreviousPositionMs()` to configure
maximum position for which `seekToPrevious()` seeks to the previous item the maximum position for which `seekToPrevious()` seeks to the previous
([#1425](https://github.com/androidx/media/issues/1425)). item ([#1425](https://github.com/androidx/media/issues/1425)).
* Fix some audio focus inconsistencies, e.g. not reporting full or * Fix some audio focus inconsistencies, e.g. not reporting full or
transient focus loss while the player is paused transient focus loss while the player is paused
([#1436](https://github.com/androidx/media/issues/1436)). ([#1436](https://github.com/androidx/media/issues/1436)).
@ -257,7 +258,7 @@ This release includes the following changes since the
different audio formats (for example stereo to mono) can cause the different audio formats (for example stereo to mono) can cause the
processor to throw an exception processor to throw an exception
([#1352](https://github.com/androidx/media/issues/1352)). ([#1352](https://github.com/androidx/media/issues/1352)).
* Implement `MediaCodecAudioRenderer.getDurationToProgressUs` so that * Implement `MediaCodecAudioRenderer.getDurationToProgressUs()` so that
ExoPlayer will dynamically schedule its main work loop to when the ExoPlayer will dynamically schedule its main work loop to when the
MediaCodecAudioRenderer can make progress. MediaCodecAudioRenderer can make progress.
* Video: * Video:
@ -315,7 +316,7 @@ This release includes the following changes since the
* Add support for non-square DASH thumbnail grids * Add support for non-square DASH thumbnail grids
([#1300](https://github.com/androidx/media/pull/1300)). ([#1300](https://github.com/androidx/media/pull/1300)).
* Add support for AVIF for API 34+. * Add support for AVIF for API 34+.
* Allow `null` as parameter for `ExoPlayer.setImageOutput` to clear a * Allow `null` as parameter for `ExoPlayer.setImageOutput()` to clear a
previously set `ImageOutput`. previously set `ImageOutput`.
* DataSource: * DataSource:
* Implement support for `android.resource://package/id` raw resource URIs * Implement support for `android.resource://package/id` raw resource URIs
@ -358,7 +359,7 @@ This release includes the following changes since the
* Remove unused `OverlaySettings.useHdr` since dynamic range of overlay * Remove unused `OverlaySettings.useHdr` since dynamic range of overlay
and frame must match. and frame must match.
* Add HDR support for `TextOverlay`. Luminance of the text overlay can be * Add HDR support for `TextOverlay`. Luminance of the text overlay can be
adjusted with `OverlaySettings.setHdrLuminanceMultiplier`. adjusted with `OverlaySettings.Builder.setHdrLuminanceMultiplier()`.
* IMA extension: * IMA extension:
* Promote API that is required for apps to play * Promote API that is required for apps to play
[DAI ad streams](https://developers.google.com/ad-manager/dynamic-ad-insertion/full-service) [DAI ad streams](https://developers.google.com/ad-manager/dynamic-ad-insertion/full-service)
@ -366,7 +367,7 @@ This release includes the following changes since the
* Add `replaceAdTagParameters(Map <String, String>)` to * Add `replaceAdTagParameters(Map <String, String>)` to
`ImaServerSideAdInsertionMediaSource.AdLoader` that allows replacing ad `ImaServerSideAdInsertionMediaSource.AdLoader` that allows replacing ad
tag parameters at runtime. tag parameters at runtime.
* Fix bug where `VideoAdPlayer.VideoAdPlayerCallback.onError` was not * Fix bug where `VideoAdPlayer.VideoAdPlayerCallback.onError()` was not
called when a player error happened during ad playback called when a player error happened during ad playback
([#1334](https://github.com/androidx/media/issues/1334)). ([#1334](https://github.com/androidx/media/issues/1334)).
* Bump IMA SDK version to 3.33.0 to fix a `NullPointerException` when * Bump IMA SDK version to 3.33.0 to fix a `NullPointerException` when
@ -382,7 +383,7 @@ This release includes the following changes since the
the service needs to be stopped in `onTaskRemoved()` the service needs to be stopped in `onTaskRemoved()`
([#1219](https://github.com/androidx/media/issues/1219)). ([#1219](https://github.com/androidx/media/issues/1219)).
* Add `MediaSessionService.pauseAllPlayersAndStopSelf()` that conveniently * Add `MediaSessionService.pauseAllPlayersAndStopSelf()` that conveniently
allows to pause playback of all sessions and call `stopSelf` to allows to pause playback of all sessions and call `stopSelf()` to
terminate the lifecycle of the `MediaSessionService`. terminate the lifecycle of the `MediaSessionService`.
* Override `MediaSessionService.onTaskRemoved(Intent)` to provide a safe * Override `MediaSessionService.onTaskRemoved(Intent)` to provide a safe
default implementation that keeps the service running in the foreground default implementation that keeps the service running in the foreground
@ -399,7 +400,7 @@ This release includes the following changes since the
is used to update the `PlaybackState` of the platform session to an is used to update the `PlaybackState` of the platform session to an
error state with the given error information error state with the given error information
([#543](https://github.com/androidx/media/issues/543)). ([#543](https://github.com/androidx/media/issues/543)).
* Add `MediaSession.Callback.onPlayerInteractionFinished` to inform * Add `MediaSession.Callback.onPlayerInteractionFinished()` to inform
sessions when a series of player interactions from a specific controller sessions when a series of player interactions from a specific controller
finished. finished.
* Add `SessionError` and use it in `SessionResult` and `LibraryResult` * Add `SessionError` and use it in `SessionResult` and `LibraryResult`
@ -474,9 +475,9 @@ This release includes the following changes since the
([#1255](https://github.com/androidx/media/pull/1255)). ([#1255](https://github.com/androidx/media/pull/1255)).
* Test Utilities: * Test Utilities:
* Implement `onInit()` and `onRelease()` in `FakeRenderer`. * Implement `onInit()` and `onRelease()` in `FakeRenderer`.
* Change `TestPlayerRunHelper.runUntil/playUntil` methods to fail on * Change `TestPlayerRunHelper.runUntil()/playUntil()` methods to fail on
nonfatal errors (e.g. those reported to nonfatal errors (e.g. those reported to
`AnalyticsListener.onVideoCodecError`). Use the new `AnalyticsListener.onVideoCodecError()`). Use the new
`TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX()` `TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX()`
method chain to disable this behavior. method chain to disable this behavior.
* Demo app: * Demo app: