DefaultLoadControl

public static final int DEFAULT_AUDIO_BUFFER_SIZE = 13107200

A default size in bytes for an audio buffer.

public static final int DEFAULT_BACK_BUFFER_DURATION_MS = 0

The default back buffer duration in milliseconds.

public static final int DEFAULT_BUFFER_FOR_PLAYBACK_AFTER_REBUFFER_MS = 5000

The default duration of media that must be buffered for playback to resume after a rebuffer, in milliseconds. A rebuffer is defined to be caused by buffer depletion rather than a user action.

public static final int DEFAULT_BUFFER_FOR_PLAYBACK_MS = 2500

The default duration of media that must be buffered for playback to start or resume following a user action such as a seek, in milliseconds.

public static final int DEFAULT_CAMERA_MOTION_BUFFER_SIZE = 131072

A default size in bytes for a camera motion buffer.

public static final int DEFAULT_IMAGE_BUFFER_SIZE = 131072

A default size in bytes for an image buffer.

public static final int DEFAULT_MAX_BUFFER_MS = 50000

The default maximum duration of media that the player will attempt to buffer, in milliseconds.

public static final int DEFAULT_METADATA_BUFFER_SIZE = 131072

A default size in bytes for a metadata buffer.

public static final int DEFAULT_MIN_BUFFER_MS = 50000

The default minimum duration of media that the player will attempt to ensure is buffered at all times, in milliseconds.

public static final int DEFAULT_MIN_BUFFER_SIZE = 13107200

The buffer size in bytes that will be used as a minimum target buffer in all cases. This is also the default target buffer before tracks are selected.

public static final int DEFAULT_MUXED_BUFFER_SIZE = 144310272

A default size in bytes for a muxed buffer (e.g. containing video, audio and text).

public static final boolean DEFAULT_PRIORITIZE_TIME_OVER_SIZE_THRESHOLDS = false

The default prioritization of buffer time constraints over size constraints.

public static final boolean DEFAULT_RETAIN_BACK_BUFFER_FROM_KEYFRAME = false

The default for whether the back buffer is retained from the previous keyframe.

public static final int DEFAULT_TARGET_BUFFER_BYTES = -1

The default target buffer size in bytes. The value (LENGTH_UNSET) means that the load control will calculate the target buffer size based on the selected tracks.

public static final int DEFAULT_TEXT_BUFFER_SIZE = 131072

A default size in bytes for a text buffer.

public static final int DEFAULT_VIDEO_BUFFER_SIZE = 131072000

A default size in bytes for a video buffer.

public final long backBufferDurationUs

public DefaultLoadControl()

Constructs a new instance, using the DEFAULT_* constants defined in this class.

protected DefaultLoadControl(
    DefaultAllocator allocator,
    int minBufferMs,
    int maxBufferMs,
    int bufferForPlaybackMs,
    int bufferForPlaybackAfterRebufferMs,
    int targetBufferBytes,
    boolean prioritizeTimeOverSizeThresholds,
    int backBufferDurationMs,
    boolean retainBackBufferFromKeyframe
)

public Allocator getAllocator()

Returns the Allocator that should be used to obtain media buffer allocations.

public long getBackBufferDurationUs()

Returns the duration of media to retain in the buffer prior to the current playback position, for fast backward seeking.

Note: If retainBackBufferFromKeyframe is false then seeking in the back-buffer will only be fast if the back-buffer contains a keyframe prior to the seek position.

Note: Implementations should return a single value. Dynamic changes to the back-buffer are not currently supported.

public void onPrepared()

Called by the player when prepared with a new source.

public void onReleased()

Called by the player when released.

public void onStopped()

Called by the player when stopped.

public void onTracksSelected(
    Timeline timeline,
    MediaSource.MediaPeriodId mediaPeriodId,
    Renderer[] renderers,
    TrackGroupArray trackGroups,
    ExoTrackSelection[] trackSelections
)

Called by the player when a track selection occurs.

public boolean retainBackBufferFromKeyframe()

Returns whether media should be retained from the keyframe before the current playback position minus getBackBufferDurationUs, rather than any sample before or at that position.

Warning: Returning true will cause the back-buffer size to depend on the spacing of keyframes in the media being played. Returning true is not recommended unless you control the media and are comfortable with the back-buffer size exceeding getBackBufferDurationUs by as much as the maximum duration between adjacent keyframes in the media.

Note: Implementations should return a single value. Dynamic changes to the back-buffer are not currently supported.

public boolean shouldContinueLoading(
    long playbackPositionUs,
    long bufferedDurationUs,
    float playbackSpeed
)

Called by the player to determine whether it should continue to load the source. If this method returns true, the MediaPeriod identified in the most recent onTracksSelected call will continue being loaded.

public boolean shouldStartPlayback(
    Timeline timeline,
    MediaSource.MediaPeriodId mediaPeriodId,
    long bufferedDurationUs,
    float playbackSpeed,
    boolean rebuffering,
    long targetLiveOffsetUs
)

Called repeatedly by the player when it's loading the source, has yet to start playback, and has the minimum amount of data necessary for playback to be started. The value returned determines whether playback is actually started. The load control may opt to return false until some condition has been met (e.g. a certain amount of media is buffered).

protected int calculateTargetBufferBytes(
    Renderer[] renderers,
    ExoTrackSelection[] trackSelectionArray
)

Calculate target buffer size in bytes based on the selected tracks. The player will try not to exceed this target buffer. Only used when targetBufferBytes is LENGTH_UNSET.