Wyświetlanie treści przy użyciu usługi MediaLibraryService

Aplikacje do multimediów często zawierają kolekcje elementów multimedialnych uporządkowane według hierarchii. Na przykład utwory z albumu lub odcinki programów telewizyjnych na playliście. Ta hierarchia elementów multimedialnych jest nazywana biblioteką multimediów.

MediaLibraryService udostępnia standardowy interfejs API służący do wyświetlania biblioteki multimediów i uzyskiwania do niej dostępu. Jest to przydatne na przykład wtedy, gdy dodajesz do aplikacji do multimediów obsługę Androida Auto, który zapewnia własny, bezpieczny dla sterownika interfejs biblioteki multimediów.

Utwórz MediaLibraryService

Implementacja MediaLibraryService jest podobna do implementacji MediaSessionService, z tą różnicą, że w metodzie onGetSession() należy zwrócić MediaLibrarySession zamiast MediaSession.

class PlaybackService : MediaLibraryService() {
  var mediaLibrarySession: MediaLibrarySession? = null
  var callback: MediaLibrarySession.Callback = object : MediaLibrarySession.Callback {...}

  // If desired, validate the controller before returning the media library session
  override fun onGetSession(controllerInfo: MediaSession.ControllerInfo): MediaLibrarySession? =
    mediaLibrarySession

  // Create your player and media library session in the onCreate lifecycle event
  override fun onCreate() {
    super.onCreate()
    val player = ExoPlayer.Builder(this).build()
    mediaLibrarySession = MediaLibrarySession.Builder(this, player, callback).build()
  }

  // Remember to release the player and media library session in onDestroy
  override fun onDestroy() {
    mediaLibrarySession?.run { 
      player.release()
      release()
      mediaLibrarySession = null
    }
    super.onDestroy()
  }
}

class PlaybackService extends MediaLibraryService {
  MediaLibrarySession mediaLibrarySession = null;
  MediaLibrarySession.Callback callback = new MediaLibrarySession.Callback() {...};

  @Override
  public MediaLibrarySession onGetSession(MediaSession.ControllerInfo controllerInfo) {
    // If desired, validate the controller before returning the media library session
    return mediaLibrarySession;
  }

  // Create your player and media library session in the onCreate lifecycle event
  @Override
  public void onCreate() {
    super.onCreate();
    ExoPlayer player = new ExoPlayer.Builder(this).build();
    mediaLibrarySession = new MediaLibrarySession.Builder(this, player, callback).build();
  }

  // Remember to release the player and media library session in onDestroy
  @Override
  public void onDestroy() {
    if (mediaLibrarySession != null) {
      mediaLibrarySession.getPlayer().release();
      mediaLibrarySession.release();
      mediaLibrarySession = null;
    }
    super.onDestroy();
  }
}

Pamiętaj, aby w pliku manifestu zadeklarować Service i wymagane uprawnienia:

<service
    android:name=".PlaybackService"
    android:foregroundServiceType="mediaPlayback"
    android:exported="true">
    <intent-filter>
        <action android:name="androidx.media3.session.MediaSessionService"/>
    </intent-filter>
</service>

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- For targetSdk 34+ -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

Użyj formy płatności MediaLibrarySession

Interfejs API MediaLibraryService wymaga, aby biblioteka multimediów była uporządkowana w formacie drzewa, z jednym węzłem głównym i węzłami podrzędnymi, które można odtwarzać lub przeglądać.

MediaLibrarySession rozszerza interfejs API MediaSession o interfejsy API przeglądania treści. W porównaniu z wywołaniem zwrotnym MediaSession wywołanie zwrotne MediaLibrarySession dodaje metody takie jak:

• onGetLibraryRoot() w przypadku, gdy klient żąda głównego elementu MediaItem drzewa treści
• onGetChildren() w przypadku, gdy klient żąda elementów podrzędnych MediaItem w drzewie treści
• onGetSearchResult() w przypadku, gdy klient zażąda wyników wyszukiwania z drzewa treści dla danego zapytania

Odpowiednie metody wywołania zwrotnego obejmują obiekt LibraryParams z dodatkowymi sygnałami dotyczącymi typu drzewa treści, którym interesuje się aplikacja kliencka.