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
.
Kotlin
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() } }
Java
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 elementuMediaItem
drzewa treścionGetChildren()
w przypadku, gdy klient żąda elementów podrzędnychMediaItem
w drzewie treścionGetSearchResult()
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.