Media3 Migration

[ashiagr]

Tasks/ Checklist

• [x] Migrate Standalone ExoPlayer libs to Media3 ExoPlayer (PR#886)

• [x] Migrate MediaBrowserService to MediaLibraryService (PR#886)

  • [x] Register both (MediaBrowserService, MediaLibraryService) service interfaces for backward compatibility
  • [x] Add media3-session dependency
  • [x] Change service to inherit from a MediaLibraryService instead of MediaBrowserService
  • [x] Implement the service life-cycle methods
  • [x] Implement MediaLibraryService.MediaLibrarySessionCallback
  • [x] Use androidx.media3.common.MediaItem instead of MediaBrowserCompat.MediaItem
  • [x] Use Futures in contrast to the detachable Result approach of the MediaBrowserServiceCompat
  • [x] Implement MediaSession.Callback.onAddMediaItems()
  • [x] Migrate AutoPlaybackService

• [ ] Update player for media3

  • [x] Migrate local player instantiation to PlaybackService (PR#894)
  • [ ] Migrate switching to cast player
    • [x] Set wrapper player class on the media3 session that switches between the local and cast player (PR#899)
    • [x] Testing (PR#899)
      • [x] Starting playback on a chromecast from a paused/not-playing state works
      • [x] Transferring playback from the phone to the chromecast (and vice-versa) while playback is in progress, and playback continues
      • [ ] Cleanup

• [ ] Control playback in the media session

  • [ ] Handle UI commands
  • [ ] Migrate audio effects
    • Globally selected audio effects are used when appropriate
    • Podcast-specific audio effects are used when appropriate
    • Changes to audio effects during playback take immediate effect
  • [ ] Audio focus
    • Starts/stops playing appropriately when focus changes. Should check both transient focus changes and non-transient focus changes
    • Ducking still works the same as it did before
  • [ ] UI commands from Auto, Automotive, Google Maps driving mode should work as before
  • [ ] HLS support - DefaultMediaSourceFactory automatically supports HLS, progressive and few other media sources.

• [ ] Up Next Queue

  • If the user taps an item in the queue, it starts playing as before
  • Transitioning to the next item in the queue occurs as before when an episode finishes

• [ ] Notification MediaSessionService automatically creates a MediaNotification that should work in most cases.

  • [ ] Remove PlayerNotificationManager
  • [ ] Migrate custom actions in notifications
    • Setting for hiding custom actions should work
    • Setting for reordering custom actions should work
    • Notification channel should work as expected (disabling/enabling notifications from the channel)
    • Button states should update depending on state (star/unstarred, skip forward/backward amount)

• [ ] Support lower API devices

  • Test on lower API devices. Sounds like the relevant buckets for purposes of the media notifications are 21 - 28, 29 - 30, and 31 - 32 (link).

• [ ] Test for foreground service exception - comment

[PaulWoitaschek]

Hey there, fellow OSS developers.

Just a heads up; while debugging this issue: https://github.com/PaulWoitaschek/Voice/issues/1765 I found that Nederadio as well as Pocket Casts suffer from the same bug: in Android Auto if the App is not running, it will not show the previously playing book.

You can find a reproducer here: https://github.com/NielsMasdorp/Nederadio-Android/issues/42#issuecomment-1564578319

This does work with the current implementation on the main branch.