MetadataRetriever

Kotlin |Java

@UnstableApi
public final class MetadataRetriever implements AutoCloseable

Summary

Nested types
`public final class MetadataRetriever.Builder` Builder for `MetadataRetriever` instances.

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

Public methods
`void`	`close()`
`ListenableFuture<Long>`	`retrieveDurationUs()` Asynchronously retrieves the duration for the `MediaItem`.
`static ListenableFuture<TrackGroupArray>`	`retrieveMetadata(Context context, MediaItem mediaItem)` This method is deprecated. Use `Builder` to create an instance and call `retrieveTrackGroups` instead.
`static ListenableFuture<TrackGroupArray>`	`retrieveMetadata( MediaSource.Factory mediaSourceFactory, MediaItem mediaItem )` This method is deprecated. Use `Builder` to create an instance and call `retrieveTrackGroups` instead.
`ListenableFuture<Timeline>`	`retrieveTimeline()` Asynchronously retrieves the `Timeline` for the `MediaItem`.
`ListenableFuture<TrackGroupArray>`	`retrieveTrackGroups()` Asynchronously retrieves the `TrackGroupArray` for the `MediaItem`.
`static void`	`setMaximumParallelRetrievals(int maximumParallelRetrievals)` Sets the maximum number of metadata retrievals run in parallel.

public static final int DEFAULT_MAXIMUM_PARALLEL_RETRIEVALS = 5

The default number of maximum parallel retrievals.

public void close()

public ListenableFuture<Long> retrieveDurationUs()

Asynchronously retrieves the duration for the MediaItem.

Returns
`ListenableFuture<Long>`	A `ListenableFuture` that will be populated with the duration in microseconds, or `TIME_UNSET` if unknown.

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

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

public ListenableFuture<Timeline> retrieveTimeline()

Asynchronously retrieves the Timeline for the MediaItem.

Returns
`ListenableFuture<Timeline>`	A `ListenableFuture` that will be populated with the `Timeline`.

public ListenableFuture<TrackGroupArray> retrieveTrackGroups()

Asynchronously retrieves the TrackGroupArray for the MediaItem.

Returns
`ListenableFuture<TrackGroupArray>`	A `ListenableFuture` that will be populated with the `TrackGroupArray`.

public static void setMaximumParallelRetrievals(int maximumParallelRetrievals)

Sets the maximum number of metadata retrievals run in parallel.

Parameters
`int maximumParallelRetrievals`	The maximum number of parallel retrievals.