# AnalyticsCollector
# AnalyticsCollector
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/analytics/AnalyticsCollector.java+class:androidx.media3.exoplayer.analytics.AnalyticsCollector)
*** ** * ** ***
Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/exoplayer/analytics/AnalyticsCollector "View this page in Java")
```
@UnstableApi
interface AnalyticsCollector : Player.Listener, MediaSourceEventListener, BandwidthMeter.EventListener, DrmSessionEventListener
```
Known direct subclasses
[DefaultAnalyticsCollector](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/DefaultAnalyticsCollector)
|-------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [DefaultAnalyticsCollector](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/DefaultAnalyticsCollector) | Data collector that forwards analytics events to[AnalyticsListeners](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsListener). |
*** ** * ** ***
Interface for data collectors that forward analytics events to[AnalyticsListeners](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsListener).
## Summary
| ### Public functions |
|-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [addListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#addListener(androidx.media3.exoplayer.analytics.AnalyticsListener))`(listener: `[AnalyticsListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsListener)`!)` Adds a listener for analytics events. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [notifySeekStarted](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#notifySeekStarted())`()` Notifies the analytics collector that a seek operation will start. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioCodecError](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioCodecError(java.lang.Exception))`(audioCodecError: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!)` Called when an audio decoder encounters an error. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioDecoderInitialized](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioDecoderInitialized(java.lang.String,long,long))`(` ` decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!,` ` initializedTimestampMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`,` ` initializationDurationMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) `)` Called when a audio decoder is created. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioDecoderReleased](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioDecoderReleased(java.lang.String))`(decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Called when a audio decoder is released. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioDisabled](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioDisabled(androidx.media3.exoplayer.DecoderCounters))`(counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!)` Called when the audio renderer is disabled. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioEnabled](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioEnabled(androidx.media3.exoplayer.DecoderCounters))`(counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!)` Called when the audio renderer is enabled. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioInputFormatChanged](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioInputFormatChanged(androidx.media3.common.Format,androidx.media3.exoplayer.DecoderReuseEvaluation))`(` ` format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!,` ` decoderReuseEvaluation: `[DecoderReuseEvaluation](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderReuseEvaluation)`?` `)` Called when the format of the media being consumed by the audio renderer changes. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioPositionAdvancing](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioPositionAdvancing(long))`(playoutStartSystemTimeMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Called when the audio position has increased for the first time since the last pause or position reset. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioSinkError](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioSinkError(java.lang.Exception))`(audioSinkError: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!)` Called when[AudioSink](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink)has encountered an error. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioTrackInitialized](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioTrackInitialized(androidx.media3.exoplayer.audio.AudioSink.AudioTrackConfig))`(audioTrackConfig: `[AudioSink.AudioTrackConfig](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.AudioTrackConfig)`!)` Called when an[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html)has been initialized. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioTrackReleased](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioTrackReleased(androidx.media3.exoplayer.audio.AudioSink.AudioTrackConfig))`(audioTrackConfig: `[AudioSink.AudioTrackConfig](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.AudioTrackConfig)`!)` Called when an[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html)has been released. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioUnderrun](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onAudioUnderrun(int,long,long))`(` ` bufferSize: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` bufferSizeMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`,` ` elapsedSinceLastFeedMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) `)` Called when an audio underrun occurs. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDroppedFrames](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onDroppedFrames(int,long))`(count: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`, elapsedMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Called to report the number of frames dropped by the video renderer. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDroppedSeeksWhileScrubbing](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onDroppedSeeksWhileScrubbing(int))`(droppedSeekCount: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Called when seeks are dropped when scrubbing. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onRenderedFirstFrame](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onRenderedFirstFrame(java.lang.Object,long))`(output: `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`!, renderTimeMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Called when a frame is rendered for the first time since setting the output, or since the renderer was reset, or since the stream being rendered was changed. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onRendererReadyChanged](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onRendererReadyChanged(int,int,boolean))`(` ` rendererIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` @`[C.TrackType](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType)` rendererTrackType: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` isRendererReady: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html) `)` Called each time a renderer starts or stops allowing playback to be ready. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoCodecError](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoCodecError(java.lang.Exception))`(videoCodecError: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!)` Called when a video decoder encounters an error. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoDecoderInitialized](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoDecoderInitialized(java.lang.String,long,long))`(` ` decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!,` ` initializedTimestampMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`,` ` initializationDurationMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) `)` Called when a video decoder is created. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoDecoderReleased](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoDecoderReleased(java.lang.String))`(decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Called when a video decoder is released. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoDisabled](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoDisabled(androidx.media3.exoplayer.DecoderCounters))`(counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!)` Called when the video renderer is disabled. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoEnabled](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoEnabled(androidx.media3.exoplayer.DecoderCounters))`(counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!)` Called when the video renderer is enabled. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoFrameProcessingOffset](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoFrameProcessingOffset(long,int))`(` ` totalProcessingOffsetUs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`,` ` frameCount: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called to report the video processing offset of video frames processed by the video renderer. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoInputFormatChanged](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#onVideoInputFormatChanged(androidx.media3.common.Format,androidx.media3.exoplayer.DecoderReuseEvaluation))`(` ` format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!,` ` decoderReuseEvaluation: `[DecoderReuseEvaluation](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderReuseEvaluation)`?` `)` Called when the format of the media being consumed by the video renderer changes. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [release](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#release())`()` Releases the collector. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [removeListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#removeListener(androidx.media3.exoplayer.analytics.AnalyticsListener))`(listener: `[AnalyticsListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsListener)`!)` Removes a previously added analytics event listener. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [setPlayer](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#setPlayer(androidx.media3.common.Player,android.os.Looper))`(player: `[Player](https://developer.android.com/reference/kotlin/androidx/media3/common/Player)`!, looper: `[Looper](https://developer.android.com/reference/android/os/Looper.html)`!)` Sets the player for which data will be collected. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [updateMediaPeriodQueueInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsCollector#updateMediaPeriodQueueInfo(java.util.List,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId))`(` ` queue: (`[Mutable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)`)`[List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)`<`[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`!>!,` ` readingPeriod: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?` `)` Updates the playback queue information used for event association. |
| ### Inherited functions |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From[androidx.media3.exoplayer.upstream.BandwidthMeter.EventListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/BandwidthMeter.EventListener) |-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onBandwidthSample](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/BandwidthMeter.EventListener#onBandwidthSample(int,long,long))`(` ` elapsedMs: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` bytesTransferred: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`,` ` bitrateEstimate: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) `)` Called periodically to indicate that bytes have been transferred or the estimated bitrate has changed. | |
| From[androidx.media3.exoplayer.drm.DrmSessionEventListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener) |-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | ~~[onDrmKeysLoaded](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmKeysLoaded(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId))~~`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?` `)` **This function is deprecated.** Implement[onDrmKeysLoaded](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmKeysLoaded(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.drm.KeyRequestInfo))instead
| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDrmKeysLoaded](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmKeysLoaded(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.drm.KeyRequestInfo))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` keyRequestInfo: `[KeyRequestInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/KeyRequestInfo)`!` `)` Called each time keys are loaded. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDrmKeysRemoved](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmKeysRemoved(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?` `)` Called each time offline keys are removed. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDrmKeysRestored](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmKeysRestored(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?` `)` Called each time offline keys are restored. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDrmSessionAcquired](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmSessionAcquired(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,int))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` @`[DrmSession.State](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSession.State)` state: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called each time a drm session is acquired. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDrmSessionManagerError](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmSessionManagerError(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,java.lang.Exception))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` error: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!` `)` Called when a drm error occurs. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDrmSessionReleased](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/drm/DrmSessionEventListener#onDrmSessionReleased(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?` `)` Called each time a drm session is released. | |
| From[androidx.media3.exoplayer.source.MediaSourceEventListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener) |-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDownstreamFormatChanged](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener#onDownstreamFormatChanged(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.source.MediaLoadData))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` mediaLoadData: `[MediaLoadData](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaLoadData)`!` `)` Called when a downstream format change occurs (i.e. when the format of the media being read from one or more[SampleStream](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream)s provided by the source changes). | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onLoadCanceled](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener#onLoadCanceled(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.source.LoadEventInfo,androidx.media3.exoplayer.source.MediaLoadData))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` loadEventInfo: `[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)`!,` ` mediaLoadData: `[MediaLoadData](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaLoadData)`!` `)` Called when a load is canceled. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onLoadCompleted](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener#onLoadCompleted(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.source.LoadEventInfo,androidx.media3.exoplayer.source.MediaLoadData))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` loadEventInfo: `[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)`!,` ` mediaLoadData: `[MediaLoadData](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaLoadData)`!` `)` Called when a load ends. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onLoadError](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener#onLoadError(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.source.LoadEventInfo,androidx.media3.exoplayer.source.MediaLoadData,java.io.IOException,boolean))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` loadEventInfo: `[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)`!,` ` mediaLoadData: `[MediaLoadData](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaLoadData)`!,` ` error: `[IOException](https://developer.android.com/reference/java/io/IOException.html)`!,` ` wasCanceled: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html) `)` Called when a load error occurs. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onLoadStarted](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener#onLoadStarted(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.source.LoadEventInfo,androidx.media3.exoplayer.source.MediaLoadData,int))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?,` ` loadEventInfo: `[LoadEventInfo](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/LoadEventInfo)`!,` ` mediaLoadData: `[MediaLoadData](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaLoadData)`!,` ` retryCount: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called when a load begins. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onUpstreamDiscarded](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSourceEventListener#onUpstreamDiscarded(int,androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.source.MediaLoadData))`(` ` windowIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` mediaPeriodId: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`!,` ` mediaLoadData: `[MediaLoadData](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaLoadData)`!` `)` Called when data is removed from the back of a media buffer, typically so that it can be re-buffered in a different format. | |
| From[androidx.media3.common.Player.Listener](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener) |-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAudioAttributesChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onAudioAttributesChanged(androidx.media3.common.AudioAttributes))`(audioAttributes: `[AudioAttributes](https://developer.android.com/reference/kotlin/androidx/media3/common/AudioAttributes)`!)` Called when the value of[getAudioAttributes](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getAudioAttributes())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) [onAudioSessionIdChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onAudioSessionIdChanged(int))`(audioSessionId: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Called when the audio session ID changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onAvailableCommandsChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onAvailableCommandsChanged(androidx.media3.common.Player.Commands))`(availableCommands: `[Player.Commands](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Commands)`!)` Called when the value returned from[isCommandAvailable](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#isCommandAvailable(int))changes for at least one[Command](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Command). | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onCues](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onCues(androidx.media3.common.text.CueGroup))`(cueGroup: `[CueGroup](https://developer.android.com/reference/kotlin/androidx/media3/common/text/CueGroup)`!)` Called when the value of[getCurrentCues](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getCurrentCues())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) ~~[onCues](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onCues(java.util.List))~~`(cues: (`[Mutable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)`)`[List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)`<`[Cue](https://developer.android.com/reference/kotlin/androidx/media3/common/text/Cue)`!>!)` **This function is deprecated.** Use[onCues](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onCues(androidx.media3.common.text.CueGroup))instead.
| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDeviceInfoChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onDeviceInfoChanged(androidx.media3.common.DeviceInfo))`(deviceInfo: `[DeviceInfo](https://developer.android.com/reference/kotlin/androidx/media3/common/DeviceInfo)`!)` Called when the device information changes | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onDeviceVolumeChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onDeviceVolumeChanged(int,boolean))`(volume: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`, muted: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Called when the value of[getDeviceVolume](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getDeviceVolume())or[isDeviceMuted](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#isDeviceMuted())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onEvents](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onEvents(androidx.media3.common.Player,androidx.media3.common.Player.Events))`(player: `[Player](https://developer.android.com/reference/kotlin/androidx/media3/common/Player)`!, events: `[Player.Events](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Events)`!)` Called when one or more player states changed. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onIsLoadingChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onIsLoadingChanged(boolean))`(isLoading: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Called when the player starts or stops loading the source. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onIsPlayingChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onIsPlayingChanged(boolean))`(isPlaying: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Called when the value of[isPlaying](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#isPlaying())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) ~~[onLoadingChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onLoadingChanged(boolean))~~`(isLoading: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` **This function is deprecated.** Use[onIsLoadingChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onIsLoadingChanged(boolean))instead.
| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onMaxSeekToPreviousPositionChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onMaxSeekToPreviousPositionChanged(long))`(maxSeekToPreviousPositionMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Called when the value of[getMaxSeekToPreviousPosition](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getMaxSeekToPreviousPosition())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onMediaItemTransition](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onMediaItemTransition(androidx.media3.common.MediaItem,int))`(` ` mediaItem: `[MediaItem](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem)`?,` ` @`[Player.MediaItemTransitionReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.MediaItemTransitionReason)` reason: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called when playback transitions to a media item or starts repeating a media item according to the current[repeat mode](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getRepeatMode()). | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onMediaMetadataChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onMediaMetadataChanged(androidx.media3.common.MediaMetadata))`(mediaMetadata: `[MediaMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaMetadata)`!)` Called when the value of[getMediaMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getMediaMetadata())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) [onMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onMetadata(androidx.media3.common.Metadata))`(metadata: `[Metadata](https://developer.android.com/reference/kotlin/androidx/media3/common/Metadata)`!)` Called when there is metadata associated with the current playback time. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlayWhenReadyChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlayWhenReadyChanged(boolean,int))`(` ` playWhenReady: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`,` ` @`[Player.PlayWhenReadyChangeReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.PlayWhenReadyChangeReason)` reason: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called when the value returned from[getPlayWhenReady](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getPlayWhenReady())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlaybackParametersChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlaybackParametersChanged(androidx.media3.common.PlaybackParameters))`(playbackParameters: `[PlaybackParameters](https://developer.android.com/reference/kotlin/androidx/media3/common/PlaybackParameters)`!)` Called when the value of[getPlaybackParameters](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getPlaybackParameters())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlaybackStateChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlaybackStateChanged(int))`(@`[Player.State](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.State)` playbackState: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Called when the value returned from[getPlaybackState](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getPlaybackState())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlaybackSuppressionReasonChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlaybackSuppressionReasonChanged(int))`(` ` @`[Player.PlaybackSuppressionReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.PlaybackSuppressionReason)` playbackSuppressionReason: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called when the value returned from[getPlaybackSuppressionReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getPlaybackSuppressionReason())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlayerError](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlayerError(androidx.media3.common.PlaybackException))`(error: `[PlaybackException](https://developer.android.com/reference/kotlin/androidx/media3/common/PlaybackException)`!)` Called when an error occurs. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlayerErrorChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlayerErrorChanged(androidx.media3.common.PlaybackException))`(error: `[PlaybackException](https://developer.android.com/reference/kotlin/androidx/media3/common/PlaybackException)`?)` Called when the[PlaybackException](https://developer.android.com/reference/kotlin/androidx/media3/common/PlaybackException)returned by[getPlayerError](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getPlayerError())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) ~~[onPlayerStateChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlayerStateChanged(boolean,int))~~`(` ` playWhenReady: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`,` ` @`[Player.State](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.State)` playbackState: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` **This function is deprecated.** Use[onPlaybackStateChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlaybackStateChanged(int))and[onPlayWhenReadyChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlayWhenReadyChanged(boolean,int))instead.
| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPlaylistMetadataChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlaylistMetadataChanged(androidx.media3.common.MediaMetadata))`(mediaMetadata: `[MediaMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaMetadata)`!)` Called when the value of[getPlaylistMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getPlaylistMetadata())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) ~~[onPositionDiscontinuity](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPositionDiscontinuity(int))~~`(@`[Player.DiscontinuityReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.DiscontinuityReason)` reason: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` **This function is deprecated.** Use[onPositionDiscontinuity](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPositionDiscontinuity(androidx.media3.common.Player.PositionInfo,androidx.media3.common.Player.PositionInfo,int))instead.
| | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onPositionDiscontinuity](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPositionDiscontinuity(androidx.media3.common.Player.PositionInfo,androidx.media3.common.Player.PositionInfo,int))`(` ` oldPosition: `[Player.PositionInfo](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.PositionInfo)`!,` ` newPosition: `[Player.PositionInfo](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.PositionInfo)`!,` ` @`[Player.DiscontinuityReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.DiscontinuityReason)` reason: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called when a position discontinuity occurs. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onRenderedFirstFrame](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onRenderedFirstFrame())`()` Called when a frame is rendered for the first time since setting the surface, or since the renderer was reset, or since the stream being rendered was changed. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onRepeatModeChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onRepeatModeChanged(int))`(@`[Player.RepeatMode](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.RepeatMode)` repeatMode: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Called when the value of[getRepeatMode](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getRepeatMode())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onSeekBackIncrementChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onSeekBackIncrementChanged(long))`(seekBackIncrementMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Called when the value of[getSeekBackIncrement](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getSeekBackIncrement())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onSeekForwardIncrementChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onSeekForwardIncrementChanged(long))`(seekForwardIncrementMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)`)` Called when the value of[getSeekForwardIncrement](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getSeekForwardIncrement())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onShuffleModeEnabledChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onShuffleModeEnabledChanged(boolean))`(shuffleModeEnabled: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Called when the value of[getShuffleModeEnabled](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getShuffleModeEnabled())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onSkipSilenceEnabledChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onSkipSilenceEnabledChanged(boolean))`(skipSilenceEnabled: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`)` Called when skipping silences is enabled or disabled in the audio stream. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onSurfaceSizeChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onSurfaceSizeChanged(int,int))`(width: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`, height: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Called each time there's a change in the size of the surface onto which the video is being rendered. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onTimelineChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onTimelineChanged(androidx.media3.common.Timeline,int))`(` ` timeline: `[Timeline](https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline)`!,` ` @`[Player.TimelineChangeReason](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.TimelineChangeReason)` reason: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Called when the value of[getCurrentTimeline](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getCurrentTimeline())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onTrackSelectionParametersChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onTrackSelectionParametersChanged(androidx.media3.common.TrackSelectionParameters))`(parameters: `[TrackSelectionParameters](https://developer.android.com/reference/kotlin/androidx/media3/common/TrackSelectionParameters)`!)` Called when the value returned from[getTrackSelectionParameters](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getTrackSelectionParameters())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onTracksChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onTracksChanged(androidx.media3.common.Tracks))`(tracks: `[Tracks](https://developer.android.com/reference/kotlin/androidx/media3/common/Tracks)`!)` Called when the value of[getCurrentTracks](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getCurrentTracks())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVideoSizeChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onVideoSizeChanged(androidx.media3.common.VideoSize))`(videoSize: `[VideoSize](https://developer.android.com/reference/kotlin/androidx/media3/common/VideoSize)`!)` Called each time when[getVideoSize](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getVideoSize())changes. | | [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [onVolumeChanged](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onVolumeChanged(float))`(volume: `[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`)` Called when the value of[getVolume](https://developer.android.com/reference/kotlin/androidx/media3/common/Player#getVolume())changes. | |
## Public functions
### addListener
```
fun addListener(listener: AnalyticsListener!): Unit
```
Adds a listener for analytics events.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------|----------------------|
| `listener: `[AnalyticsListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsListener)`!` | The listener to add. |
### notifySeekStarted
```
fun notifySeekStarted(): Unit
```
Notifies the analytics collector that a seek operation will start. Should be called before the player adjusts its state and position to the seek.
### onAudioCodecError
```
fun onAudioCodecError(audioCodecError: Exception!): Unit
```
Called when an audio decoder encounters an error.
| Parameters |
|-----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `audioCodecError: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!` | The error. Typically a[CodecException](https://developer.android.com/reference/android/media/MediaCodec.CodecException.html)if the renderer uses[MediaCodec](https://developer.android.com/reference/android/media/MediaCodec.html), or a[DecoderException](https://developer.android.com/reference/kotlin/androidx/media3/decoder/DecoderException)if the renderer uses a software decoder. |
### onAudioDecoderInitialized
```
fun onAudioDecoderInitialized(
decoderName: String!,
initializedTimestampMs: Long,
initializationDurationMs: Long
): Unit
```
Called when a audio decoder is created.
| Parameters |
|-----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|
| `decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The audio decoder that was created. |
| `initializedTimestampMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | [elapsedRealtime](https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime())when initialization finished. |
| `initializationDurationMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The time taken to initialize the decoder in milliseconds. |
### onAudioDecoderReleased
```
fun onAudioDecoderReleased(decoderName: String!): Unit
```
Called when a audio decoder is released.
| Parameters |
|-----------------------------------------------------------------------------------------------------|--------------------------------------|
| `decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The audio decoder that was released. |
### onAudioDisabled
```
fun onAudioDisabled(counters: DecoderCounters!): Unit
```
Called when the audio renderer is disabled.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| `counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!` | [DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)that were updated by the audio renderer. |
### onAudioEnabled
```
fun onAudioEnabled(counters: DecoderCounters!): Unit
```
Called when the audio renderer is enabled.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!` | [DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)that will be updated by the audio renderer for as long as it remains enabled. |
### onAudioInputFormatChanged
```
fun onAudioInputFormatChanged(
format: Format!,
decoderReuseEvaluation: DecoderReuseEvaluation?
): Unit
```
Called when the format of the media being consumed by the audio renderer changes.
| Parameters |
|--------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!` | The new format. |
| `decoderReuseEvaluation: `[DecoderReuseEvaluation](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderReuseEvaluation)`?` | The result of the evaluation to determine whether an existing decoder instance can be reused for the new format, or`null`if the renderer did not have a decoder. |
### onAudioPositionAdvancing
```
fun onAudioPositionAdvancing(playoutStartSystemTimeMs: Long): Unit
```
Called when the audio position has increased for the first time since the last pause or position reset.
| Parameters |
|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
| `playoutStartSystemTimeMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The approximate derived[currentTimeMillis](https://developer.android.com/reference/java/lang/System.html#currentTimeMillis())at which playout started. |
### onAudioSinkError
```
fun onAudioSinkError(audioSinkError: Exception!): Unit
```
Called when[AudioSink](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink)has encountered an error.
If the sink writes to a platform[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html), this will be called for all[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html)errors.
| Parameters |
|----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `audioSinkError: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!` | The error that occurred. Typically an[AudioSink.InitializationException](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.InitializationException), a[AudioSink.WriteException](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.WriteException), or an[AudioSink.UnexpectedDiscontinuityException](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.UnexpectedDiscontinuityException). |
### onAudioTrackInitialized
```
fun onAudioTrackInitialized(audioTrackConfig: AudioSink.AudioTrackConfig!): Unit
```
Called when an[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html)has been initialized.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `audioTrackConfig: `[AudioSink.AudioTrackConfig](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.AudioTrackConfig)`!` | The[AudioSink.AudioTrackConfig](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.AudioTrackConfig)of the initialized[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html). |
### onAudioTrackReleased
```
fun onAudioTrackReleased(audioTrackConfig: AudioSink.AudioTrackConfig!): Unit
```
Called when an[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html)has been released.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `audioTrackConfig: `[AudioSink.AudioTrackConfig](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.AudioTrackConfig)`!` | The[AudioSink.AudioTrackConfig](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/audio/AudioSink.AudioTrackConfig)of the released[AudioTrack](https://developer.android.com/reference/android/media/AudioTrack.html). |
### onAudioUnderrun
```
fun onAudioUnderrun(
bufferSize: Int,
bufferSizeMs: Long,
elapsedSinceLastFeedMs: Long
): Unit
```
Called when an audio underrun occurs.
| Parameters |
|---------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `bufferSize: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The size of the audio output buffer, in bytes. |
| `bufferSizeMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The size of the audio output buffer, in milliseconds, if it contains PCM encoded audio.[TIME_UNSET](https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_UNSET())if the output buffer contains non-PCM encoded audio. |
| `elapsedSinceLastFeedMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The time since audio was last written to the output buffer. |
### onDroppedFrames
```
fun onDroppedFrames(count: Int, elapsedMs: Long): Unit
```
Called to report the number of frames dropped by the video renderer. Dropped frames are reported whenever the renderer is stopped having dropped frames, and optionally, whenever the count reaches a specified threshold whilst the renderer is started.
| Parameters |
|--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `count: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The number of dropped frames. |
| `elapsedMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The duration in milliseconds over which the frames were dropped. This duration is timed from when the renderer was started or from when dropped frames were last reported (whichever was more recent), and not from when the first of the reported drops occurred. |
### onDroppedSeeksWhileScrubbing
```
fun onDroppedSeeksWhileScrubbing(droppedSeekCount: Int): Unit
```
Called when seeks are dropped when scrubbing.
| Parameters |
|-------------------------------------------------------------------------------------------------|------------------------------|
| `droppedSeekCount: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The number of dropped seeks. |
### onRenderedFirstFrame
```
fun onRenderedFirstFrame(output: Any!, renderTimeMs: Long): Unit
```
Called when a frame is rendered for the first time since setting the output, or since the renderer was reset, or since the stream being rendered was changed.
| Parameters |
|-----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `output: `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`!` | The output of the video renderer. Normally a[Surface](https://developer.android.com/reference/android/view/Surface.html), however some video renderers may have other output types (e.g., a[VideoDecoderOutputBufferRenderer](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/video/VideoDecoderOutputBufferRenderer)). |
| `renderTimeMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The[elapsedRealtime](https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime())when the frame was rendered. |
### onRendererReadyChanged
```
fun onRendererReadyChanged(
rendererIndex: Int,
@C.TrackType rendererTrackType: Int,
isRendererReady: Boolean
): Unit
```
Called each time a renderer starts or stops allowing playback to be ready.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `rendererIndex: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The index of the renderer in the[androidx.media3.exoplayer.ExoPlayer](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/ExoPlayer)instance. |
| `@`[C.TrackType](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType)` rendererTrackType: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The[C.TrackType](https://developer.android.com/reference/kotlin/androidx/media3/common/C.TrackType)of the renderer. |
| `isRendererReady: `[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html) | Whether the renderer allows playback to be ready. |
### onVideoCodecError
```
fun onVideoCodecError(videoCodecError: Exception!): Unit
```
Called when a video decoder encounters an error.
This method being called does not indicate that playback has failed, or that it will fail. The player may be able to recover from the error. Hence applications should*not* implement this method to display a user visible error or initiate an application level retry.[onPlayerError](https://developer.android.com/reference/kotlin/androidx/media3/common/Player.Listener#onPlayerError(androidx.media3.common.PlaybackException))is the appropriate place to implement such behavior. This method is called to provide the application with an opportunity to log the error if it wishes to do so.
| Parameters |
|-----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `videoCodecError: `[Exception](https://developer.android.com/reference/java/lang/Exception.html)`!` | The error. Typically a[CodecException](https://developer.android.com/reference/android/media/MediaCodec.CodecException.html)if the renderer uses[MediaCodec](https://developer.android.com/reference/android/media/MediaCodec.html), or a[DecoderException](https://developer.android.com/reference/kotlin/androidx/media3/decoder/DecoderException)if the renderer uses a software decoder. |
### onVideoDecoderInitialized
```
fun onVideoDecoderInitialized(
decoderName: String!,
initializedTimestampMs: Long,
initializationDurationMs: Long
): Unit
```
Called when a video decoder is created.
| Parameters |
|-----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|
| `decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The decoder that was created. |
| `initializedTimestampMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | [elapsedRealtime](https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime())when initialization finished. |
| `initializationDurationMs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The time taken to initialize the decoder in milliseconds. |
### onVideoDecoderReleased
```
fun onVideoDecoderReleased(decoderName: String!): Unit
```
Called when a video decoder is released.
| Parameters |
|-----------------------------------------------------------------------------------------------------|--------------------------------------|
| `decoderName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | The video decoder that was released. |
### onVideoDisabled
```
fun onVideoDisabled(counters: DecoderCounters!): Unit
```
Called when the video renderer is disabled.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| `counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!` | [DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)that were updated by the video renderer. |
### onVideoEnabled
```
fun onVideoEnabled(counters: DecoderCounters!): Unit
```
Called when the video renderer is enabled.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `counters: `[DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)`!` | [DecoderCounters](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderCounters)that will be updated by the video renderer for as long as it remains enabled. |
### onVideoFrameProcessingOffset
```
fun onVideoFrameProcessingOffset(
totalProcessingOffsetUs: Long,
frameCount: Int
): Unit
```
Called to report the video processing offset of video frames processed by the video renderer.
Video processing offset represents how early a video frame is processed compared to the player's current position. For each video frame, the offset is calculated as*Pvf - Ppl* where*Pvf* is the presentation timestamp of the video frame and*Ppl*is the current position of the player. Positive values indicate the frame was processed early enough whereas negative values indicate that the player's position had progressed beyond the frame's timestamp when the frame was processed (and the frame was probably dropped).
The renderer reports the sum of video processing offset samples (one sample per processed video frame: dropped, skipped or rendered) and the total number of samples.
| Parameters |
|----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
| `totalProcessingOffsetUs: `[Long](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html) | The sum of all video frame processing offset samples for the video frames processed by the renderer in microseconds. |
| `frameCount: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The number of samples included in the`totalProcessingOffsetUs`. |
### onVideoInputFormatChanged
```
fun onVideoInputFormatChanged(
format: Format!,
decoderReuseEvaluation: DecoderReuseEvaluation?
): Unit
```
Called when the format of the media being consumed by the video renderer changes.
| Parameters |
|--------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `format: `[Format](https://developer.android.com/reference/kotlin/androidx/media3/common/Format)`!` | The new format. |
| `decoderReuseEvaluation: `[DecoderReuseEvaluation](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/DecoderReuseEvaluation)`?` | The result of the evaluation to determine whether an existing decoder instance can be reused for the new format, or`null`if the renderer did not have a decoder. |
### release
```
fun release(): Unit
```
Releases the collector. Must be called after the player for which data is collected has been released.
### removeListener
```
fun removeListener(listener: AnalyticsListener!): Unit
```
Removes a previously added analytics event listener.
| Parameters |
|------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
| `listener: `[AnalyticsListener](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/analytics/AnalyticsListener)`!` | The listener to remove. |
### setPlayer
```
fun setPlayer(player: Player!, looper: Looper!): Unit
```
Sets the player for which data will be collected. Must only be called if no player has been set yet or the current player is idle.
| Parameters |
|-----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
| `player: `[Player](https://developer.android.com/reference/kotlin/androidx/media3/common/Player)`!` | The[Player](https://developer.android.com/reference/kotlin/androidx/media3/common/Player)for which data will be collected. |
| `looper: `[Looper](https://developer.android.com/reference/android/os/Looper.html)`!` | The[Looper](https://developer.android.com/reference/android/os/Looper.html)used for listener callbacks. |
### updateMediaPeriodQueueInfo
```
fun updateMediaPeriodQueueInfo(
queue: (Mutable)List!,
readingPeriod: MediaSource.MediaPeriodId?
): Unit
```
Updates the playback queue information used for event association.
Should only be called by the player controlling the queue and not from app code.
| Parameters |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `queue: (`[Mutable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)`)`[List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)`<`[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`!>!` | The playback queue of media periods identified by their[MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId). |
| `readingPeriod: `[MediaSource.MediaPeriodId](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId)`?` | The media period in the queue that is currently being read by renderers, or null if the queue is empty. |