com.google.android.exoplayer2.trackselection

Class AdaptiveTrackSelection.Factory

java.lang.Object

com.google.android.exoplayer2.trackselection.AdaptiveTrackSelection.Factory

All Implemented Interfaces:

TrackSelection.Factory

Enclosing class:

AdaptiveTrackSelection

public static final class AdaptiveTrackSelection.Factory
extends java.lang.Object
implements TrackSelection.Factory

Factory for AdaptiveTrackSelection instances.

Constructor Summary

Constructors

Constructor and Description
Factory(BandwidthMeter bandwidthMeter)
Factory(BandwidthMeter bandwidthMeter, int maxInitialBitrate, int minDurationForQualityIncreaseMs, int maxDurationForQualityDecreaseMs, int minDurationToRetainAfterDiscardMs, float bandwidthFraction)
Factory(BandwidthMeter bandwidthMeter, int maxInitialBitrate, int minDurationForQualityIncreaseMs, int maxDurationForQualityDecreaseMs, int minDurationToRetainAfterDiscardMs, float bandwidthFraction, float bufferedFractionToLiveEdgeForQualityIncrease, long minTimeBetweenBufferReevaluationMs, Clock clock)

Method Summary

Modifier and Type	Method and Description
AdaptiveTrackSelection	createTrackSelection(TrackGroup group, int... tracks) Creates a new selection.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Factory

public Factory(BandwidthMeter bandwidthMeter)

Parameters:

bandwidthMeter - Provides an estimate of the currently available bandwidth.

Factory

public Factory(BandwidthMeter bandwidthMeter,
               int maxInitialBitrate,
               int minDurationForQualityIncreaseMs,
               int maxDurationForQualityDecreaseMs,
               int minDurationToRetainAfterDiscardMs,
               float bandwidthFraction)

Parameters:

bandwidthMeter - Provides an estimate of the currently available bandwidth.

maxInitialBitrate - The maximum bitrate in bits per second that should be assumed when a bandwidth estimate is unavailable.

minDurationForQualityIncreaseMs - The minimum duration of buffered data required for the selected track to switch to one of higher quality.

maxDurationForQualityDecreaseMs - The maximum duration of buffered data required for the selected track to switch to one of lower quality.

minDurationToRetainAfterDiscardMs - When switching to a track of significantly higher quality, the selection may indicate that media already buffered at the lower quality can be discarded to speed up the switch. This is the minimum duration of media that must be retained at the lower quality.

bandwidthFraction - The fraction of the available bandwidth that the selection should consider available for use. Setting to a value less than 1 is recommended to account for inaccuracies in the bandwidth estimator.

Factory

public Factory(BandwidthMeter bandwidthMeter,
               int maxInitialBitrate,
               int minDurationForQualityIncreaseMs,
               int maxDurationForQualityDecreaseMs,
               int minDurationToRetainAfterDiscardMs,
               float bandwidthFraction,
               float bufferedFractionToLiveEdgeForQualityIncrease,
               long minTimeBetweenBufferReevaluationMs,
               Clock clock)

Parameters:

bandwidthMeter - Provides an estimate of the currently available bandwidth.

maxInitialBitrate - The maximum bitrate in bits per second that should be assumed when a bandwidth estimate is unavailable.

minDurationForQualityIncreaseMs - The minimum duration of buffered data required for the selected track to switch to one of higher quality.

maxDurationForQualityDecreaseMs - The maximum duration of buffered data required for the selected track to switch to one of lower quality.

minDurationToRetainAfterDiscardMs - When switching to a track of significantly higher quality, the selection may indicate that media already buffered at the lower quality can be discarded to speed up the switch. This is the minimum duration of media that must be retained at the lower quality.

bandwidthFraction - The fraction of the available bandwidth that the selection should consider available for use. Setting to a value less than 1 is recommended to account for inaccuracies in the bandwidth estimator.

bufferedFractionToLiveEdgeForQualityIncrease - For live streaming, the fraction of the duration from current playback position to the live edge that has to be buffered before the selected track can be switched to one of higher quality. This parameter is only applied when the playback position is closer to the live edge than minDurationForQualityIncreaseMs, which would otherwise prevent switching to a higher quality from happening.

minTimeBetweenBufferReevaluationMs - The track selection may periodically reevaluate its buffer and discard some chunks of lower quality to improve the playback quality if network conditions have changed. This is the minimum duration between 2 consecutive buffer reevaluation calls.

clock - A Clock.

Method Detail

createTrackSelection

public AdaptiveTrackSelection createTrackSelection(TrackGroup group,
                                                   int... tracks)

Description copied from interface: TrackSelection.Factory

Creates a new selection.

Specified by:

createTrackSelection in interface TrackSelection.Factory

Parameters:

group - The TrackGroup. Must not be null.

tracks - The indices of the selected tracks within the TrackGroup. Must not be null or empty. May be in any order.

Returns:

The created selection.