Podczas odtwarzania
Metadane multimediów można pobierać podczas odtwarzania na wiele sposobów. Najprostszym sposobem jest nasłuchiwanie zdarzenia Player.Listener#onMediaMetadataChanged
. Spowoduje to udostępnienie obiektu MediaMetadata
z polami takimi jak title
i albumArtist
. Alternatywnie wywołanie Player#getMediaMetadata
zwraca ten sam obiekt.
Kotlin
override fun onMediaMetadataChanged(mediaMetadata: MediaMetadata) { mediaMetadata.title?.let(::handleTitle) }
Java
@Override public void onMediaMetadataChanged(MediaMetadata mediaMetadata) { if (mediaMetadata.title != null) { handleTitle(mediaMetadata.title); } }
Jeśli aplikacja wymaga dostępu do określonych obiektów Metadata.Entry
, powinna nasłuchiwać Player.Listener#onMetadata
(aby dostarczać dynamiczne metadane podczas odtwarzania). Jeśli chcesz spojrzeć na statyczne metadane, możesz je też otworzyć przez TrackSelections#getFormat
.
Źródło Player#getMediaMetadata
jest wypełniane z obu tych źródeł.
Bez odtwarzania
Jeśli odtwarzanie nie jest potrzebne, lepiej użyć tagu MetadataRetriever
do wyodrębnienia metadanych, ponieważ pozwoli to uniknąć konieczności tworzenia i przygotowywania odtwarzacza.
Kotlin
val trackGroupsFuture = MetadataRetriever.retrieveMetadata(context, mediaItem) Futures.addCallback( trackGroupsFuture, object : FutureCallback<TrackGroupArray?> { override fun onSuccess(trackGroups: TrackGroupArray?) { if (trackGroups != null) handleMetadata(trackGroups) } override fun onFailure(t: Throwable) { handleFailure(t) } }, executor )
Java
ListenableFuture<TrackGroupArray> trackGroupsFuture = MetadataRetriever.retrieveMetadata(context, mediaItem); Futures.addCallback( trackGroupsFuture, new FutureCallback<TrackGroupArray>() { @Override public void onSuccess(TrackGroupArray trackGroups) { handleMetadata(trackGroups); } @Override public void onFailure(Throwable t) { handleFailure(t); } }, executor);
Zdjęcia ruchome
Możliwe jest też wyodrębnianie metadanych zdjęcia ruchomego, zawierających na przykład przesunięcie i długość obrazu oraz filmu. Obsługiwane są te formaty:
- Zdjęcia ruchome JPEG nagrane przez aplikacje aparatu Google Pixel i Samsung. ExoPlayer odtwarza ten format, więc powiązane metadane można pobrać za pomocą odtwarzacza lub funkcji
MetadataRetriever
. - Zdjęcia ruchome HEIC nagrane przez aplikacje aparatu Google Pixel i Samsung. ExoPlayer obecnie nie odtwarza tego formatu, dlatego powiązane z nim metadane należy pobierać za pomocą
MetadataRetriever
.
W przypadku zdjęć ruchomych parametr TrackGroupArray
uzyskany za pomocą MetadataRetriever
zawiera element TrackGroup
z pojedynczym elementem Format
zawierającym wpis metadanych MotionPhotoMetadata
.
Kotlin
0.until(trackGroups.length) .asSequence() .mapNotNull { trackGroups[it].getFormat(0).metadata } .filter { metadata -> metadata.length() == 1 } .map { metadata -> metadata[0] } .filterIsInstance<MotionPhotoMetadata>() .forEach(::handleMotionPhotoMetadata)
Java
for (int i = 0; i < trackGroups.length; i++) { TrackGroup trackGroup = trackGroups.get(i); Metadata metadata = trackGroup.getFormat(0).metadata; if (metadata != null && metadata.length() == 1) { Metadata.Entry metadataEntry = metadata.get(0); if (metadataEntry instanceof MotionPhotoMetadata) { MotionPhotoMetadata motionPhotoMetadata = (MotionPhotoMetadata) metadataEntry; handleMotionPhotoMetadata(motionPhotoMetadata); } } }