MetadataRetriever

Artifact: androidx.media3:media3-exoplayer

View Source

---

Kotlin |Java

@UnstableApi
public final class MetadataRetriever

---

Retrieves the static metadata of MediaItems.

Summary

Constants
static final int	DEFAULT_MAXIMUM_PARALLEL_RETRIEVALS = 5 The default number of maximum parallel retrievals.

Public methods
static ListenableFuture<TrackGroupArray>	retrieveMetadata(Context context, MediaItem mediaItem) Retrieves the TrackGroupArray corresponding to a MediaItem.
static ListenableFuture<TrackGroupArray>	retrieveMetadata(     MediaSource.Factory mediaSourceFactory,     MediaItem mediaItem ) Retrieves the TrackGroupArray corresponding to a MediaItem.
static void	setMaximumParallelRetrievals(int maximumParallelRetrievals) Sets the maximum number of metadata retrievals run in parallel.

Constants

DEFAULT_MAXIMUM_PARALLEL_RETRIEVALS

public static final int DEFAULT_MAXIMUM_PARALLEL_RETRIEVALS = 5

The default number of maximum parallel retrievals.

Public methods

retrieveMetadata

public static ListenableFuture<TrackGroupArray> retrieveMetadata(Context context, MediaItem mediaItem)

Retrieves the TrackGroupArray corresponding to a MediaItem.

This is equivalent to using retrieveMetadata with a DefaultMediaSourceFactory and a DefaultExtractorsFactory with FLAG_READ_MOTION_PHOTO_METADATA and FLAG_READ_SEF_DATA set.

Parameters
Context context	The Context.
MediaItem mediaItem	The MediaItem whose metadata should be retrieved.

Returns
ListenableFuture<TrackGroupArray>	A ListenableFuture of the result.

retrieveMetadata

public static ListenableFuture<TrackGroupArray> retrieveMetadata(
    MediaSource.Factory mediaSourceFactory,
    MediaItem mediaItem
)

Retrieves the TrackGroupArray corresponding to a MediaItem.

This method is thread-safe.

Parameters
MediaSource.Factory mediaSourceFactory	mediaSourceFactory The MediaSource.Factory to use to read the data.
MediaItem mediaItem	The MediaItem whose metadata should be retrieved.

Returns
ListenableFuture<TrackGroupArray>	A ListenableFuture of the result.

setMaximumParallelRetrievals

public static void setMaximumParallelRetrievals(int maximumParallelRetrievals)

Sets the maximum number of metadata retrievals run in parallel.

The default is DEFAULT_MAXIMUM_PARALLEL_RETRIEVALS.

Parameters
int maximumParallelRetrievals	The maximum number of parallel retrievals.