Subclasses:

DefaultHlsPlaylistTracker, SsMediaSource, ChunkSampleStream<T>

Overview

A callback to be notified of Loader events.

Summary

Methods

Called when a load has started for the first time or through a retry.

Parameters:

loadable: The loadable whose load has completed.
elapsedRealtimeMs: when the load attempts to start.
loadDurationMs: The duration in milliseconds of the load since Loader.startLoading(T, Loader.Callback, int) was called.
retryCount: The number of failed attempts since Loader.startLoading(T, Loader.Callback, int) was called (this is zero for the first load attempt).

Called when a load has completed.

Note: There is guaranteed to be a memory barrier between Loader.Loadable.load() exiting and this callback being called.

Parameters:

loadable: The loadable whose load has completed.
elapsedRealtimeMs: when the load ended.
loadDurationMs: The duration in milliseconds of the load since Loader.startLoading(T, Loader.Callback, int) was called.

Called when a load has been canceled.

Note: If the Loader has not been released then there is guaranteed to be a memory barrier between Loader.Loadable.load() exiting and this callback being called. If the Loader has been released then this callback may be called before Loader.Loadable.load() exits.

Parameters:

loadable: The loadable whose load has been canceled.
elapsedRealtimeMs: when the load was canceled.
loadDurationMs: The duration in milliseconds of the load since Loader.startLoading(T, Loader.Callback, int) was called up to the point at which it was canceled.
released: True if the load was canceled because the Loader was released. False otherwise.

Called when a load encounters an error.

Note: There is guaranteed to be a memory barrier between Loader.Loadable.load() exiting and this callback being called.

Parameters:

loadable: The loadable whose load has encountered an error.
elapsedRealtimeMs: when the error occurred.
loadDurationMs: The duration in milliseconds of the load since Loader.startLoading(T, Loader.Callback, int) was called up to the point at which the error occurred.
error: The load error.
errorCount: The number of errors this load has encountered, including this one.

Returns:

The desired error handling action. One of Loader.RETRY, Loader.RETRY_RESET_ERROR_COUNT, Loader.DONT_RETRY, Loader.DONT_RETRY_FATAL or a retry action created by Loader.createRetryAction(boolean, long).