# BandwidthStatistic

# BandwidthStatistic

Artifact:[androidx.media3:media3-exoplayer](https://developer.android.com/jetpack/androidx/releases/media3)  
[View Source](https://cs.android.com/search?q=file:androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic.java+class:androidx.media3.exoplayer.upstream.experimental.BandwidthStatistic)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic "View this page in Java")

<br />

```
@UnstableApi
interface BandwidthStatistic
```

<br />

Known direct subclasses  
[ExponentialWeightedAverageStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/ExponentialWeightedAverageStatistic),[SlidingPercentileBandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/SlidingPercentileBandwidthStatistic),[SlidingWeightedAverageBandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/SlidingWeightedAverageBandwidthStatistic)  

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ExponentialWeightedAverageStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/ExponentialWeightedAverageStatistic)           | A[BandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic)that calculates estimates using an exponential weighted average.         |
| [SlidingPercentileBandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/SlidingPercentileBandwidthStatistic)           | A[BandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic)that calculates estimates based on a sliding window weighted percentile. |
| [SlidingWeightedAverageBandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/SlidingWeightedAverageBandwidthStatistic) | A[BandwidthStatistic](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic)that calculates estimates based on a sliding window weighted average.    |

*** ** * ** ***

The interface for different bandwidth estimation statistics.

## Summary

|                             ### Public functions                              |
|-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [addSample](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic#addSample(long,long))`(bytes: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`, durationUs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Adds a transfer sample to the statistic.                                                  |
| [Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | [getBandwidthEstimate](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic#getBandwidthEstimate())`()` Returns the bandwidth estimate in bits per second, or[ESTIMATE_NOT_AVAILABLE](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthEstimator#ESTIMATE_NOT_AVAILABLE())if there is no estimate available yet. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [reset](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthStatistic#reset())`()` Resets the statistic.                                                                                                                                                                                                                                                                         |

## Public functions

### addSample

```
fun addSample(bytes: Long, durationUs: Long): Unit
```

Adds a transfer sample to the statistic.  

|                                         Parameters                                          |
|---------------------------------------------------------------------------------------------|------------------------------------------------|
| `bytes: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)      | The number of bytes transferred.               |
| `durationUs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The duration of the transfer, in microseconds. |

### getBandwidthEstimate

```
fun getBandwidthEstimate(): Long
```

Returns the bandwidth estimate in bits per second, or[ESTIMATE_NOT_AVAILABLE](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/experimental/BandwidthEstimator#ESTIMATE_NOT_AVAILABLE())if there is no estimate available yet.  

### reset

```
fun reset(): Unit
```

Resets the statistic. The statistic should drop all samples and reset to its initial state, similar to right after construction.