androidx/media 1.8.0-alpha01

on GitHub

This release includes the following changes since 1.6.1:

• ExoPlayer:
  • Add ExoPlayer.setScrubbingModeEnabled(boolean) method. This optimizes the player for many frequent seeks (for example, from a user dragging a scrubber bar around). The behavior of scrubbing mode can be customized with setScrubbingModeParameters(..) on ExoPlayer and ExoPlayer.Builder.
  • Allow customizing fractional seek tolerance in scrubbing mode.
  • Increase codec operating rate in scrubbing mode.
  • Fix bug where prepare errors in the content of AdsMediaSource may be never reported (#2337).
  • Fix memory leak in MergingMediaSource, for example used when sideloading subtitles (#2338).
  • Allow CmcdConfiguration.Factory to return null to disable CMCD logging for specific media items (#2386).
  • Increase default image buffer size from 128kB (copy-paste mistake from text tracks) to 26MB, which is large enough for 50MP Ultra HDR images (#2417).
  • Add PreCacheHelper that allows apps to pre-cache a single media with specified start position and duration.
• Transformer:
  • Filling an initial gap (added via addGap()) with silent audio now requires explicitly setting experimentalSetForceAudioTrack(true) in EditedMediaItemSequence.Builder. If the gap is in the middle of the sequence, then this flag is not required.
  • Move Muxer interface from media3-transformer to media3-muxer.
  • Make setting MediaItem.Builder().setImageDuration(long) mandatory to import a media item as an image.
  • Add Transformer.Builder().experimentalSetMp4EditListTrimEnabled(boolean) which includes an MP4 edit list when trimming to instruct players to ignore samples between the key frame before the trim start point, and the trim start point.
  • Update Composition Demo app to use Kotlin and Jetpack Compose, and add a custom VideoCompositorSettings to arrange sequences into a 2x2 or PiP layout.
• Extractors:
  • MP3: Use duration and data size from unseekable Xing, VBRI and similar variable bitrate metadata when falling back to constant bitrate seeking due to FLAG_ENABLE_CONSTANT_BITRATE_SEEKING(_ALWAYS) (#2194).
• Audio:
  • Allow constant power upmixing/downmixing in DefaultAudioMixer.
  • Make ChannelMappingAudioProcessor, TrimmingAudioProcessor and ToFloatPcmAudioProcessor public (#2339).
  • Use AudioTrack#getUnderrunCount() in AudioTrackPositionTracker to detect underruns in DefaultAudioSink instead of best-effort estimation.
  • Improve audio timestamp smoothing for unexpected position drift from the audio output device.
  • Fix bug where A/V sync is broken for the first 10 seconds after resuming from pause when connected to Bluetooth devices.
  • Fix bug that AnalyticsListener.onAudioPositionAdvancing was not reporting the time when the audio started advancing but the time of the first measurement.
• Video:
  • Add experimental ExoPlayer API to include the MediaCodec.BUFFER_FLAG_DECODE_ONLY flag when queuing decode-only input buffers. This flag will signal the decoder to skip the decode-only buffers thereby resulting in faster seeking. Enable it with DefaultRenderersFactory.experimentalSetEnableMediaCodecBufferDecodeOnlyFlag.
  • Improve codec performance checks for software video codecs. This may lead to some additional tracks being marked as EXCEEDS_CAPABILITIES.
  • Fix VP9 Widevine playback errors on some devices (#2408).
• Text:
  • Fix SSA and SubRip to display an in-progress cue when enabling subtitles (#2309).
  • Fix playback getting stuck when switching from a stream with a subtitle error to a live stream with an empty subtitle track (#2328).
  • Fix garbled CEA-608 subtitles when playing H.262 streams containing B-frames (#2372).
  • Add support for SSA subtitles with CodecId = S_TEXT/SSA in Matroska files. Previously MatroskaExtractor only supported CodecId = S_TEXT/ASS which is meant to represent the 'advanced' (v4+) variant of SubStation Alpha subtitles (but ExoPlayer's parsing logic is the same for both variants) (#2384).
  • Add support for the layer property in SubStation Alpha (SSA) subtitle files which is used to define the z-order of cues when more than one is shown on screen at the same time (#2124).
• Effect:
  • Add Presentation.createForShortSide(int) that creates a Presentation that ensures the shortest side always matches the given value, regardless of input orientation.
• Muxers:
  • writeSampleData() API now uses muxer specific BufferInfo class instead of MediaCodec.BufferInfo.
  • Add Muxer.Factory#supportsWritingNegativeTimestampsInEditList which defaults to false.
• IMA extension:
  • Fix a bug where a load error in one ad may accidentally invalidate another ad group.
  • Fix bug where ad groups after the end of a VOD window stalled playback. Ads groups with a start time after the window are not enqueued into the MediaPeriodQueue anymore (#2215).
• Session:
  • Fix a bug where passing null into getLibraryRoot of a MediaBrowser connected to a legacy MediaBrowserServiceCompat produced a NullPointerException.
  • Fix a bug where where sending custom actions, a search result or a getItem request crashed the legacy session app with a ClassNotFoundException.
  • Fix a bug where MediaItem.LocalConfiguration.uri was shared to the platform sessions's MediaMetadata. To intentionally share a URI to allow controllers to re-request the media, set MediaItem.RequestMetadata.mediaUri instead.
• UI:
  • Fix a Compose bug which resulted in a gap between setting the initial button states and observing the change in state (e.g. icon shapes or being enabled). Any changes made to the Player outside of the observation period are now picked up (#2313).
  • Add state holders and composables to the media3-ui-compose module for SeekBackButtonState and SeekForwardButtonState.
  • Make PlayerSurface accept a nullable Player argument.
  • Add support for ExoPlayer's scrubbing mode to PlayerControlView. When enabled, this puts the player into scrubbing mode when the user starts dragging the scrubber bar, issues a player.seekTo call for every movement, and then exits scrubbing mode when the touch is lifted from the screen. This integration can be enabled with either time_bar_scrubbing_enabled = true in XML or the setTimeBarScrubbingEnabled(boolean) method from Java/Kotlin.
• Downloads:
  • Add partial download support for progressive streams. Apps can prepare a progressive stream with DownloadHelper, and request a DownloadRequest from the helper with specifying the time-based media start and end positions that the download should cover. The returned DownloadRequest carries the resolved byte range, with which a ProgressiveDownloader can be created and download the content correspondingly.
  • Add DownloadHelper.Factory with which the static DownloadHelper.forMediaItem() methods are replaced.
  • Add Factory for SegmentDownloader implementations.
  • Add partial download support for adaptive streams. Apps can prepare an adaptive stream with DownloadHelper, and request a DownloadRequest from the helper with specifying the time-based media start and end positions that the download should cover. The returned DownloadRequest carries the resolved time range, with which a concrete SegmentDownloader can be created and download the content correspondingly.
• HLS extension:
  • Support X-ASSET-LIST and live streams with HlsInterstitialsAdsLoader.
• RTSP extension:
  • Add parsing support for SessionDescriptions containing lines with trailing whitespace characters (#2357).
• Cast extension:
  • Add support for getDeviceVolume(), setDeviceVolume(), getDeviceMuted(), and setDeviceMuted() (#2089).
• Test Utilities:
  • Removed transformer.TestUtil.addAudioDecoders(String...), transformer.TestUtil.addAudioEncoders(String...), and transformer.TestUtil.addAudioEncoders(ShadowMediaCodec.CodecConfig, String...). Use ShadowMediaCodecConfig to configure shadow encoders and decoders instead.
  • Replaced the "exotest" prefix with "media3" in codec names reported by ShadowMediaCodecConfig.
• Remove deprecated symbols:
  • Removed deprecated SegmentDownloader constructor SegmentDownloader(MediaItem, Parser<M>, CacheDataSource.Factory, Executor) and the corresponding constructors in its subclasses DashDownloader, HlsDownloader and SsDownloader.
  • Removed deprecated Player.hasNext(), Player.hasNextWindow(). Use Player.hasNextMediaItem() instead.
  • Removed deprecated Player.next(). Use Player.seekToNextMediaItem() instead.
  • Removed deprecated Player.seekToPreviousWindow(). Use Player.seekToPreviousMediaItem() instead.
  • Removed deprecated Player.seekToNextWindow(). Use Player.seekToNextMediaItem() instead.
  • Removed deprecated BaseAudioProcessor in exoplayer module. Use BaseAudioProcessor under common module.
  • Remove deprecated MediaCodecVideoRenderer constructor MediaCodecVideoRenderer(Context, MediaCodecAdapter.Factor, MediaCodecSelector, long, boolean, @Nullable Handler, @Nullable VideoRendererEventListener, int, float, @Nullable VideoSinkProvider).