Recupero dei metadati

Durante la riproduzione

Durante la riproduzione è possibile recuperare i metadati dei contenuti multimediali in diversi modi. La più semplice è ascoltare Player.Listener#onMediaMetadataChanged evento; questo fornirà un MediaMetadata da utilizzare, dotato di campi come title e albumArtist, In alternativa, la chiamata di Player#getMediaMetadata restituisce lo stesso .

override fun onMediaMetadataChanged(mediaMetadata: MediaMetadata) {
  mediaMetadata.title?.let(::handleTitle)
}

@Override
public void onMediaMetadataChanged(MediaMetadata mediaMetadata) {
  if (mediaMetadata.title != null) {
    handleTitle(mediaMetadata.title);
  }
}

Se la tua app richiede l'accesso a oggetti Metadata.Entry specifici, deve ascoltare Player.Listener#onMetadata (per i metadati dinamici pubblicati durante la riproduzione). In alternativa, se è necessario esaminare metadati statici, è possibile accedervi tramite TrackSelections#getFormat. Player#getMediaMetadata viene compilato da entrambe le origini.

Senza riproduzione

Se la riproduzione non è necessaria, è più efficiente utilizzare lo MetadataRetriever per estrarre i metadati perché evita di doverli per la creazione e la preparazione di un player.

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
)

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);

Foto in movimento

È anche possibile estrarre i metadati delle foto in movimento, tra cui gli offset e delle parti immagine e video del file.

Per le foto in movimento, il valore di TrackGroupArray ottenuto con MetadataRetriever contiene un elemento TrackGroup con un singolo Format che include un Voce dei metadati MotionPhotoMetadata.

0.until(trackGroups.length)
  .asSequence()
  .mapNotNull { trackGroups[it].getFormat(0).metadata }
  .filter { metadata -> metadata.length() == 1 }
  .map { metadata -> metadata[0] }
  .filterIsInstance<MotionPhotoMetadata>()
  .forEach(::handleMotionPhotoMetadata)

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);
    }
  }
}