tv.danmaku.ijk.media.exo

Class DefaultBandwidthMeter

java.lang.Object

tv.danmaku.ijk.media.exo.DefaultBandwidthMeter

public class DefaultBandwidthMeter
extends java.lang.Object

Estimates bandwidth by listening to data transfers.

The bandwidth estimate is calculated using a SlidingPercentile and is updated each time a transfer ends. The initial estimate is based on the current operator's network country code or the locale of the user, as well as the network connection type. This can be configured in the DefaultBandwidthMeter.Builder.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultBandwidthMeter.Builder Builder for a bandwidth meter.

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_INITIAL_BITRATE_ESTIMATE Default initial bitrate estimate used when the device is offline or the network type cannot be determined, in bits per second.
static <any>	DEFAULT_INITIAL_BITRATE_ESTIMATES_2G Default initial 2G bitrate estimates in bits per second.
static <any>	DEFAULT_INITIAL_BITRATE_ESTIMATES_3G Default initial 3G bitrate estimates in bits per second.
static <any>	DEFAULT_INITIAL_BITRATE_ESTIMATES_4G Default initial 4G bitrate estimates in bits per second.
static <any>	DEFAULT_INITIAL_BITRATE_ESTIMATES_5G_NSA Default initial 5G-NSA bitrate estimates in bits per second.
static <any>	DEFAULT_INITIAL_BITRATE_ESTIMATES_5G_SA Default initial 5G-SA bitrate estimates in bits per second.
static <any>	DEFAULT_INITIAL_BITRATE_ESTIMATES_WIFI Default initial Wifi bitrate estimate in bits per second.
static int	DEFAULT_SLIDING_WINDOW_MAX_WEIGHT Default maximum weight for the sliding window.
static float	DEFAULT_SLIDING_WINDOW_PERCENTILE Default percentile for the sliding window.

Constructor Summary

Constructors

Constructor and Description
DefaultBandwidthMeter() Deprecated. Use DefaultBandwidthMeter.Builder instead.

Method Summary

Modifier and Type	Method and Description
void	addEventListener(android.os.Handler eventHandler, EventListener eventListener)
void	addSample(int dataSize, int sampleElapsedTimeMs)
long	getBitrateEstimate()
static DefaultBandwidthMeter	getSingletonInstance(android.content.Context context) Returns a singleton instance of a DefaultBandwidthMeter with default configuration.
TransferListener	getTransferListener()
void	onBytesTransferred(DataSource source, DataSpec dataSpec, boolean isNetwork, int bytesTransferred)
void	onTransferEnd(DataSource source, DataSpec dataSpec, boolean isNetwork)
void	onTransferInitializing(DataSource source, DataSpec dataSpec, boolean isNetwork)
void	onTransferStart(DataSource source, DataSpec dataSpec, boolean isNetwork)
void	removeEventListener(EventListener eventListener)
void	setNetworkTypeOverride(int networkType) Overrides the network type.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_INITIAL_BITRATE_ESTIMATES_WIFI

public static final <any> DEFAULT_INITIAL_BITRATE_ESTIMATES_WIFI

Default initial Wifi bitrate estimate in bits per second.

DEFAULT_INITIAL_BITRATE_ESTIMATES_2G

public static final <any> DEFAULT_INITIAL_BITRATE_ESTIMATES_2G

Default initial 2G bitrate estimates in bits per second.

DEFAULT_INITIAL_BITRATE_ESTIMATES_3G

public static final <any> DEFAULT_INITIAL_BITRATE_ESTIMATES_3G

Default initial 3G bitrate estimates in bits per second.

DEFAULT_INITIAL_BITRATE_ESTIMATES_4G

public static final <any> DEFAULT_INITIAL_BITRATE_ESTIMATES_4G

Default initial 4G bitrate estimates in bits per second.

DEFAULT_INITIAL_BITRATE_ESTIMATES_5G_NSA

public static final <any> DEFAULT_INITIAL_BITRATE_ESTIMATES_5G_NSA

Default initial 5G-NSA bitrate estimates in bits per second.

DEFAULT_INITIAL_BITRATE_ESTIMATES_5G_SA

public static final <any> DEFAULT_INITIAL_BITRATE_ESTIMATES_5G_SA

Default initial 5G-SA bitrate estimates in bits per second.

DEFAULT_INITIAL_BITRATE_ESTIMATE

public static final long DEFAULT_INITIAL_BITRATE_ESTIMATE

Default initial bitrate estimate used when the device is offline or the network type cannot be determined, in bits per second.

See Also:

Constant Field Values

DEFAULT_SLIDING_WINDOW_MAX_WEIGHT

public static final int DEFAULT_SLIDING_WINDOW_MAX_WEIGHT

Default maximum weight for the sliding window.

See Also:

Constant Field Values

DEFAULT_SLIDING_WINDOW_PERCENTILE

public static final float DEFAULT_SLIDING_WINDOW_PERCENTILE

Default percentile for the sliding window.

See Also:

Constant Field Values

Constructor Detail

DefaultBandwidthMeter

@Deprecated
public DefaultBandwidthMeter()

Deprecated. Use DefaultBandwidthMeter.Builder instead.

Method Detail

getSingletonInstance

public static DefaultBandwidthMeter getSingletonInstance(android.content.Context context)

Returns a singleton instance of a DefaultBandwidthMeter with default configuration.

Parameters:

context - A Context.

Returns:

The singleton instance.

setNetworkTypeOverride

public void setNetworkTypeOverride(int networkType)

Overrides the network type. Handled in the same way as if the meter had detected a change from the current network type to the specified network type internally.

Applications should not normally call this method. It is intended for testing purposes.

Parameters:

networkType - The overriding network type.

getBitrateEstimate

public long getBitrateEstimate()

getTransferListener

public TransferListener getTransferListener()

addEventListener

public void addEventListener(android.os.Handler eventHandler,
                             EventListener eventListener)

removeEventListener

public void removeEventListener(EventListener eventListener)

onTransferInitializing

public void onTransferInitializing(DataSource source,
                                   DataSpec dataSpec,
                                   boolean isNetwork)

onTransferStart

public void onTransferStart(DataSource source,
                            DataSpec dataSpec,
                            boolean isNetwork)

onBytesTransferred

public void onBytesTransferred(DataSource source,
                               DataSpec dataSpec,
                               boolean isNetwork,
                               int bytesTransferred)

onTransferEnd

public void onTransferEnd(DataSource source,
                          DataSpec dataSpec,
                          boolean isNetwork)

addSample

public void addSample(int dataSize,
                      int sampleElapsedTimeMs)