Add AC-4 Level-4 ISO base media file format support

.github/ISSUE_TEMPLATE/bug.yml

@@ -5,27 +5,34 @@ body:
   - type: markdown
     attributes:
       value: |
-        We can only process bug reports that are actionable. Unclear bug reports or reports with insufficient information may not get attention.
+        We can only process bug reports that are actionable. Unclear bug reports or reports with
+        insufficient information may not get attention.
 
         Before filing a bug:
         -------------------------
 
-        - Search existing issues, including issues that are closed: https://github.com/androidx/media/issues?q=is%3Aissue
-        - For ExoPlayer-related bugs, please also check for existing issues on the ExoPlayer tracker: https://github.com/google/ExoPlayer/issues?q=is%3Aissue
+        - Search existing issues, including issues that are closed:
+          https://github.com/androidx/media/issues?q=is%3Aissue
+        - For ExoPlayer-related bugs, please also check for existing issues on the ExoPlayer
+          tracker: https://github.com/google/ExoPlayer/issues?q=is%3Aissue
   - type: dropdown
     attributes:
       label: Version
       description: What version of Media3 (or ExoPlayer) are you using?
       options:
-        - Media3 main branch
-        - Media3 pre-release (alpha, beta or RC not in this list)
-        - Media3 1.2.1
         - Media3 1.2.0
-        - Media3 1.1.1 / ExoPlayer 2.19.1
-        - Media3 1.1.0 / ExoPlayer 2.19.0
-        - Media3 1.0.2 / ExoPlayer 2.18.7
-        - Media3 1.0.1 / ExoPlayer 2.18.6
-        - Media3 1.0.0 / ExoPlayer 2.18.5
+        - Media3 1.1.1
+        - Media3 1.1.0
+        - Media3 1.0.2
+        - Media3 1.0.1
+        - Media3 1.0.0
+        - Media3 `main` branch
+        - Media3 pre-release (alpha, beta or RC not in this list)
+        - ExoPlayer 2.19.1
+        - ExoPlayer 2.19.0
+        - ExoPlayer 2.18.7
+        - ExoPlayer 2.18.6
+        - ExoPlayer 2.18.5
         - ExoPlayer 2.18.4
         - ExoPlayer 2.18.3
         - ExoPlayer 2.18.2
@@ -40,14 +47,14 @@ body:
         - ExoPlayer 2.14.2
         - ExoPlayer 2.14.1
         - ExoPlayer 2.14.0
-        - ExoPlayer dev-v2 branch
+        - ExoPlayer `dev-v2` branch
         - Older (unsupported)
     validations:
       required: true
   - type: textarea
     attributes:
       label: More version details
-      description: >
+      description: |
         Required if you selected `main` or `dev-v2` (please provide an exact commit SHA),
         or 'pre-release' or 'older' (please provide the version).
   - type: textarea

RELEASENOTES.md

@@ -2,64 +2,6 @@
 
 ### Unreleased changes
 
-*   Common Library:
-*   ExoPlayer:
-    *   Prevent subclassing `CompositeSequenceableLoader`. This component was
-        [previously made extensible](https://github.com/androidx/media/commit/0de57cbfae7165dd3bb829e323d089cd312b4b1b)
-        but was never subclassed within the library. Customizations can be done
-        by wrapping an instance using the
-        [decorator pattern](https://en.wikipedia.org/wiki/Decorator_pattern) and
-        implementing a custom `CompositeSequenceableLoaderFactory`.
-*   Transformer:
-*   Track Selection:
-*   Extractors:
-    *   MP3: Use constant bitrate (CBR) seeking for files with an `Info` header
-        (the CBR equivalent of the `Xing` header). Previously we used the seek
-        table from the `Info` header, but this results in less precise seeking
-        than if we ignore it and assume the file is CBR.
-    *   MPEG2-TS: Add DTS, DTS-LBR and DTS:X Profile2 support
-        ([#275](https://github.com/androidx/media/pull/275)).
-    *   Extract audio types from TS descriptors and map them to role flags,
-        allowing users to make better-informed audio track selections
-        ([#973](https://github.com/androidx/media/pull/973)).
-*   Audio:
-*   Video:
-*   Text:
-*   Metadata:
-*   Image:
-    *   Add support for DASH thumbnails. Grid images are cropped and individual
-        thumbnails are provided to `ImageOutput` close to their presentation
-        times.
-*   DRM:
-*   Effect:
-*   Muxers:
-*   IMA extension:
-*   Session:
-    *   Disable double-click detection for TV apps
-        ([#962](https://github.com/androidx/media/issues/962)).
-*   UI:
-*   Downloads:
-*   OkHttp Extension:
-*   Cronet Extension:
-*   RTMP Extension:
-*   HLS Extension:
-*   DASH Extension:
-*   Smooth Streaming Extension:
-*   RTSP Extension:
-*   Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
-*   Leanback extension:
-*   Cast Extension:
-*   Test Utilities:
-*   Remove deprecated symbols:
-*   Demo app:
-
-## 1.3
-
-### 1.3.0-alpha01 (2024-01-15)
-
-This release includes the following changes since the
-[1.2.1 release](#121-2024-01-09):
-
 *   Common Library:
     *   Implement support for `android.resource://package/[type/]name` raw
         resource URIs where `package` is different to the package of the current
@@ -69,40 +11,22 @@ This release includes the following changes since the
         lower-case.
     *   Define ads with a full `MediaItem` instead of a single `Uri` in
         `AdPlaybackState`.
-    *   Increase `minSdk` to 19 (Android KitKat). This is
-        [aligned with all other AndroidX libraries](https://android-developers.googleblog.com/2023/10/androidx-minsdkversion-19.html),
-        and is required for us to upgrade to the latest versions of our AndroidX
-        dependencies.
 *   ExoPlayer:
     *   Add `PreloadMediaSource` and `PreloadMediaPeriod` that allows apps to
-        preload a content media source at a specific start position before
-        playback. `PreloadMediaSource` takes care of preparing the content media
-        source to receive the `Timeline`, preparing and caching the period at
-        the given start position, selecting tracks and loading media data for
-        the period. Apps control the preload progress by implementing
-        `PreloadMediaSource.PreloadControl` and set the preloaded source to the
-        player for playback.
+        preload the media source at a specific start position before playback,
+        where the efforts include preparing the source for a `Timeline`,
+        preparing and caching the period, selecting tracks and loading the data
+        on the period. Apps are able to control the preload progress by
+        implementing `PreloadMediaSource.PreloadControl`.
     *   Add `ExoPlayer.setImageOutput` that allows apps to set
         `ImageRenderer.ImageOutput`.
     *   `DefaultRenderersFactory` now provides an `ImageRenderer` to the player
         by default with null `ImageOutput` and `ImageDecoder.Factory.DEFAULT`.
     *   Emit `Player.Listener.onPositionDiscontinuity` event when silence is
         skipped ([#765](https://github.com/androidx/media/issues/765)).
-    *   Add experimental support for parsing subtitles during extraction. You
-        can enable this using
-        `MediaSource.Factory.experimentalParseSubtitlesDuringExtraction()`.
-    *   Support adaptive media sources with `PreloadMediaSource`.
-    *   Implement `HttpEngineDataSource`, an `HttpDataSource` using the
-        [HttpEngine](https://developer.android.com/reference/android/net/http/HttpEngine)
-        API.
 *   Transformer:
     *   Add support for flattening H.265/HEVC SEF slow motion videos.
     *   Increase transmuxing speed, especially for 'remove video' edits.
-    *   Add API to ensure that the output file starts on a video frame. This can
-        make the output of trimming operations more compatible with player
-        implementations that don't show the first video frame until its
-        presentation timestamp
-        ([#829](https://github.com/androidx/media/issues/829)).
 *   Track Selection:
     *   Add `DefaultTrackSelector.selectImageTrack` to enable image track
         selection.
@@ -115,138 +39,67 @@ This release includes the following changes since the
         `ColorInfo.colorSpace`, `ColorInfo.colorTransfer`, and
         `ColorInfo.colorRange` values
         ([#692](https://github.com/androidx/media/pull/692)).
-*   Video:
-    *   Change the `MediaCodecVideoRenderer` constructor that takes a
-        `VideoFrameProcessor.Factory` argument and replace it with a constructor
-        that takes a `VideoSinkProvider` argument. Apps that want to inject a
-        custom `VideoFrameProcessor.Factory` can instantiate a
-        `CompositingVideoSinkProvider` that uses the custom
-        `VideoFrameProcessor.Factory` and pass the video sink provider to
-        `MediaCodecVideoRenderer`.
-*   Text:
-    *   Fix serialization of bitmap cues to resolve `Tried to marshall a Parcel
-        that contained Binder objects` error when using
-        `DefaultExtractorsFactory.setTextTrackTranscodingEnabled`
-        ([#836](https://github.com/androidx/media/issues/836)).
-    *   CEA-708: Ignore `rowLock` value. The CEA-708-E S-2023 spec states that
-        `rowLock` and `columnLock` should both be assumed to be true, regardless
-        of the values present in the stream (`columnLock` support is not
-        implemented, so it's effectively assumed to always be false).
-*   DRM:
-    *   Play 'clear lead' unencrypted samples in DRM content immediately by
-        default, even if the keys for the later encrypted samples aren't ready
-        yet. This may lead to mid-playback stalls if the keys still aren't ready
-        when the playback position reaches the encrypted samples (but previously
-        playback wouldn't have started at all by this point). This behavior can
-        be disabled with
-        [`MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey`](https://developer.android.com/reference/androidx/media3/common/MediaItem.DrmConfiguration.Builder#setPlayClearContentWithoutKey\(boolean\))
-        or
-        [`DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys`](https://developer.android.com/reference/androidx/media3/exoplayer/drm/DefaultDrmSessionManager.Builder#setPlayClearSamplesWithoutKeys\(boolean\)).
-*   IMA extension:
-    *   Fix issue where DASH and HLS ads without the appropriate file extension
-        can't be played.
-*   HLS Extension:
-    *   Reduce `HlsMediaPeriod` to package-private visibility. This type
-        shouldn't be directly depended on from outside the HLS package.
-*   Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
-    *   MIDI decoder: Ignore SysEx event messages
-        ([#710](https://github.com/androidx/media/pull/710)).
-*   Test Utilities:
-    *   Don't pause playback in `TestPlayerRunHelper.playUntilPosition`. The
-        test keeps the playback in a playing state, but suspends progress until
-        the test is able to add assertions and further actions.
-*   Demo app:
-    *   Add a shortform demo module to demo the usage of `PreloadMediaSource`
-        with the short-form content use case.
-
-## 1.2
-
-### 1.2.1 (2024-01-09)
-
-This release includes the following changes since the
-[1.2.0 release](#120-2023-11-15):
-
-*   ExoPlayer:
-    *   Fix issue where manual seeks outside of the
-        `LiveConfiguration.min/maxOffset` range keep adjusting the offset back
-        to `min/maxOffset`.
-    *   Fix issue that OPUS and VORBIS channel layouts are wrong for 3, 5, 6, 7
-        and 8 channels
-        ([#8396](https://github.com/google/ExoPlayer/issues/8396)).
-    *   Fix issue where track selections after seek to zero in a live stream
-        incorrectly let the stream start at its default position
-        ([#9347](https://github.com/google/ExoPlayer/issues/9347)).
-    *   Fix the issue where new instances of `CmcdData.Factory` were receiving
-        negative values for `bufferedDurationUs` from chunk sources, resulting
-        in an `IllegalArgumentException`
-        ([#888](https://github.com/androidx/media/issues/888)).
-*   Transformer:
-    *   Work around an issue where the encoder would throw at configuration time
-        due to setting a high operating rate.
-*   Extractors:
-    *   Mark secondary (unplayable) HEVC tracks in JPEG motion photos as
-        `ROLE_FLAG_ALTERNATE` to prevent them being automatically selected for
-        playback because of their higher resolution.
-    *   Fix wrong keyframe detection for TS H264 streams
-        ([#864](https://github.com/androidx/media/pull/864)).
-    *   Fix duration estimation of TS streams that are longer than 47721 seconds
-        ([#855](https://github.com/androidx/media/issues/855)).
 *   Audio:
-    *   Fix handling of EOS for `SilenceSkippingAudioProcessor` when called
-        multiple times ([#712](https://github.com/androidx/media/issues/712)).
 *   Video:
     *   Add workaround for a device issue on Galaxy Tab S7 FE, Chromecast with
         Google TV, and Lenovo M10 FHD Plus that causes 60fps AVC streams to be
         marked as unsupported
         ([#693](https://github.com/androidx/media/issues/693)).
+*   Text:
 *   Metadata:
-    *   Fix bug where `MediaMetadata` was only populated from Vorbis comments
-        with upper-case keys
-        ([#876](https://github.com/androidx/media/issues/876)).
-    *   Catch `OutOfMemoryError` when parsing very large ID3 frames, meaning
-        playback can continue without the tag info instead of playback failing
-        completely.
 *   DRM:
-    *   Extend workaround for spurious ClearKey `https://default.url` license
-        URL to API 33+ (previously the workaround only applied on API 33
-        exactly) ([#837](https://github.com/androidx/media/pull/837)).
-    *   Fix `ERROR_DRM_SESSION_NOT_OPENED` when switching from encrypted to
-        clear content without a surface attached to the player. The error was
-        due to incorrectly using a secure decoder to play the clear content.
+*   Effect:
+*   Muxers:
+*   IMA extension:
+    *   Fix issue where DASH and HLS ads without the appropriate file extension
+        can't be played.
 *   Session:
     *   Put the custom keys and values in `MediaMetadataCompat` to
         `MediaMetadata.extras` and `MediaMetadata.extras` to
         `MediaMetadataCompat`
         ([#756](https://github.com/androidx/media/issues/756),
         [#802](https://github.com/androidx/media/issues/802)).
-    *   Fix broadcasting `notifyChildrenChanged` for legacy controllers
-        ([#644](https://github.com/androidx/media/issues/644)).
-    *   Fix a bug where setting a negative time for a disabled `setWhen` timer
-        of the notification caused a crash on some devices
-        ([#903](https://github.com/androidx/media/issues/903)).
-    *   Fix `IllegalStateException` when the media notification controller
-        hasn't completed connecting when the first notification update is
-        requested ([#917](https://github.com/androidx/media/issues/917)).
 *   UI:
     *   Fix issue where forward and rewind buttons are not visible when used
         with Material Design in a BottomSheetDialogFragment
         ([#511](https://github.com/androidx/media/issues/511)).
-    *   Fix issue where the numbers in the fast forward button of the
-        `PlayerControlView` were misaligned
-        ([#547](https://github.com/androidx/media/issues/547)).
+*   Downloads:
+*   OkHttp Extension:
+*   Cronet Extension:
+*   HttpEngine Extension:
+    *   Implement `HttpEngineDataSource`, an `HttpDataSource` using the
+        [HttpEngine](https://developer.android.com/reference/android/net/http/HttpEngine)
+        API.
+*   RTMP Extension:
+*   HLS Extension:
+    *   Reduce `HlsMediaPeriod` to package-private visibility. This type
+        shouldn't be directly depended on from outside the HLS package.
+    *   Add experimental support for parsing subtitles during extraction. You
+        can enable this using
+        `HlsMediaSource.Factory.experimentalParseSubtitlesDuringExtraction()`.
 *   DASH Extension:
+    *   Extend experimental support for parsing subtitles during extraction to
+        work with standalone text files (previously it only worked with
+        subtitles muxed into MP4 segments).
     *   Parse "f800" as channel count of 5 for Dolby in DASH manifest
         ([#688](https://github.com/androidx/media/issues/688)).
+*   Smooth Streaming Extension:
+*   RTSP Extension:
 *   Decoder Extensions (FFmpeg, VP9, AV1, MIDI, etc.):
-    *   MIDI: Fix issue where seeking forward skips the Program Change events
-        ([#704](https://github.com/androidx/media/issues/704)).
-    *   Migrate to FFmpeg 6.0 and update supported NDK to `r26b`
-        ([#707](https://github.com/androidx/media/pull/707),
-        [#867](https://github.com/androidx/media/pull/867)).
+    *   MIDI decoder: Ignore SysEx event messages
+        ([#710](https://github.com/androidx/media/pull/710)).
+*   Leanback extension:
 *   Cast Extension:
     *   Sanitize creation of a `Timeline` to not crash the app when loading
         media fails on the cast device
         ([#708](https://github.com/androidx/media/issues/708)).
+*   Test Utilities:
+*   Remove deprecated symbols:
+*   Demo app:
+    *   Add a shortform demo module to demo the usage of `PreloadMediaSource`
+        with the short-form content use case.
+
+## 1.2
 
 ### 1.2.0 (2023-11-15)
 

api.txt

@@ -763,7 +763,7 @@ package androidx.media3.common {
     method @Deprecated public void setDeviceMuted(boolean);
     method public void setDeviceMuted(boolean, @androidx.media3.common.C.VolumeFlags int);
     method @Deprecated public void setDeviceVolume(@IntRange(from=0) int);
-    method public void setDeviceVolume(@IntRange(from=0) int, @androidx.media3.common.C.VolumeFlags int);
+    method public void setDeviceVolume(@IntRange(from=0) int, int);
     method public void setMediaItem(androidx.media3.common.MediaItem);
     method public void setMediaItem(androidx.media3.common.MediaItem, boolean);
     method public void setMediaItem(androidx.media3.common.MediaItem, long);

constants.gradle

@@ -12,9 +12,9 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 project.ext {
-    releaseVersion = '1.3.0-alpha01'
-    releaseVersionCode = 1_003_000_0_01
-    minSdkVersion = 19
+    releaseVersion = '1.2.0'
+    releaseVersionCode = 1_002_000_3_00
+    minSdkVersion = 16
     // See https://developer.android.com/training/cars/media/automotive-os#automotive-module
     automotiveMinSdkVersion = 28
     appTargetSdkVersion = 34
@@ -28,7 +28,7 @@ project.ext {
     // https://cs.android.com/android/platform/superproject/main/+/main:external/guava/METADATA
     guavaVersion = '32.1.3-android'
     mockitoVersion = '3.12.4'
-    robolectricVersion = '4.11'
+    robolectricVersion = '4.10.3'
     // Keep this in sync with Google's internal Checker Framework version.
     checkerframeworkVersion = '3.13.0'
     errorProneVersion = '2.18.0'
@@ -44,7 +44,7 @@ project.ext {
     androidxCoreVersion = '1.8.0'
     androidxExifInterfaceVersion = '1.3.6'
     androidxFuturesVersion = '1.1.0'
-    androidxMediaVersion = '1.7.0'
+    androidxMediaVersion = '1.6.0'
     androidxMedia2Version = '1.2.1'
     androidxMultidexVersion = '2.0.1'
     androidxRecyclerViewVersion = '1.3.0'

demos/gl/src/main/java/androidx/media3/demo/gl/BitmapOverlayVideoProcessor.java

@@ -63,7 +63,7 @@ public BitmapOverlayVideoProcessor(Context context) {
     paint = new Paint();
     paint.setTextSize(64);
     paint.setAntiAlias(true);
-    paint.setColor(Color.WHITE);
+    paint.setARGB(0xFF, 0xFF, 0xFF, 0xFF);
     textures = new int[1];
     overlayBitmap = Bitmap.createBitmap(OVERLAY_WIDTH, OVERLAY_HEIGHT, Bitmap.Config.ARGB_8888);
     overlayCanvas = new Canvas(overlayBitmap);