Durante a reprodução
Os metadados da mídia podem ser recuperados durante a reprodução de várias maneiras. O
mais simples é detectar o evento
Player.Listener#onMediaMetadataChanged
. Isso fornecerá um objeto
MediaMetadata
para uso, que tem campos como title
e
albumArtist
. Como alternativa, chamar Player#getMediaMetadata
retorna o mesmo
objeto.
Kotlin
override fun onMediaMetadataChanged(mediaMetadata: MediaMetadata) { mediaMetadata.title?.let(::handleTitle) }
Java
@Override public void onMediaMetadataChanged(MediaMetadata mediaMetadata) { if (mediaMetadata.title != null) { handleTitle(mediaMetadata.title); } }
Se o app precisar acessar objetos Metadata.Entry
específicos, ele
precisará detectar Player.Listener#onMetadata
(para metadados dinâmicos enviados
durante a reprodução). Como alternativa, se houver necessidade de analisar metadados estáticos,
ele pode ser acessado por meio do TrackSelections#getFormat
.
Player#getMediaMetadata
é preenchido a partir dessas duas origens.
Sem reprodução
Caso a reprodução não seja necessária, é mais eficiente usar a
MetadataRetriever
para extrair os metadados, porque isso evita a necessidade
de criar e preparar um player.
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);
Fotos com movimento
Também é possível extrair metadados de fotos com movimento, incluindo os deslocamentos e os comprimentos das partes de imagem e vídeo do arquivo. Os seguintes formatos de contêiner de fotos com movimento têm suporte:
- Fotos com movimento JPEG gravadas por alguns apps de câmera Android. A parte de vídeo
desses arquivos pode ser reproduzida pelo ExoPlayer. Os metadados associados também são expostos
pelo player e podem ser recuperados usando
MetadataRetriever
. - Fotos com movimento HEIC gravadas por alguns apps de câmera Android. A parte de vídeo
desses arquivos não pode ser reproduzida pelo ExoPlayer, mas os metadados
associados podem ser recuperados usando
MetadataRetriever
.
Para fotos com movimento, a TrackGroupArray
recebida com MetadataRetriever
contém um TrackGroup
com uma única Format
envolvendo uma
entrada de metadados 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); } } }