AnalyticsListener (ExoPlayer library)

All Known Implementing Classes:

DefaultAnalyticsListener, EventLogger
```
public interface AnalyticsListener
```
A listener for analytics events.
All events are recorded with an AnalyticsListener.EventTime specifying the elapsed real time and media time at the time of the event.
All methods have no-op default implementations to allow selective overrides.

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class AnalyticsListener.EventTime
Time information of an event.

Nested Classes
Modifier and Type	Interface and Description
`static class`	`AnalyticsListener.EventTime` Time information of an event.

Method Summary

All Methods Instance Methods Default Methods
Modifier and Type	Method and Description
`default void`	`onAudioAttributesChanged(AnalyticsListener.EventTime eventTime, AudioAttributes audioAttributes)` Called when the audio attributes change.
`default void`	`onAudioSessionId(AnalyticsListener.EventTime eventTime, int audioSessionId)` Called when the audio session id is set.
`default void`	`onAudioUnderrun(AnalyticsListener.EventTime eventTime, int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs)` Called when an audio underrun occurred.
`default void`	`onBandwidthEstimate(AnalyticsListener.EventTime eventTime, int totalLoadTimeMs, long totalBytesLoaded, long bitrateEstimate)` Called when the bandwidth estimate for the current data source has been updated.
`default void`	`onDecoderDisabled(AnalyticsListener.EventTime eventTime, int trackType, DecoderCounters decoderCounters)` Called when an audio or video decoder has been disabled.
`default void`	`onDecoderEnabled(AnalyticsListener.EventTime eventTime, int trackType, DecoderCounters decoderCounters)` Called when an audio or video decoder has been enabled.
`default void`	`onDecoderInitialized(AnalyticsListener.EventTime eventTime, int trackType, String decoderName, long initializationDurationMs)` Called when an audio or video decoder has been initialized.
`default void`	`onDecoderInputFormatChanged(AnalyticsListener.EventTime eventTime, int trackType, Format format)` Called when an audio or video decoder input format changed.
`default void`	`onDownstreamFormatChanged(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when the downstream format sent to the renderers changed.
`default void`	`onDrmKeysLoaded(AnalyticsListener.EventTime eventTime)` Called each time drm keys are loaded.
`default void`	`onDrmKeysRemoved(AnalyticsListener.EventTime eventTime)` Called each time offline drm keys are removed.
`default void`	`onDrmKeysRestored(AnalyticsListener.EventTime eventTime)` Called each time offline drm keys are restored.
`default void`	`onDrmSessionAcquired(AnalyticsListener.EventTime eventTime)` Called each time a drm session is acquired.
`default void`	`onDrmSessionManagerError(AnalyticsListener.EventTime eventTime, Exception error)` Called when a drm error occurs.
`default void`	`onDrmSessionReleased(AnalyticsListener.EventTime eventTime)` Called each time a drm session is released.
`default void`	`onDroppedVideoFrames(AnalyticsListener.EventTime eventTime, int droppedFrames, long elapsedMs)` Called after video frames have been dropped.
`default void`	`onLoadCanceled(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a media source canceled loading data.
`default void`	`onLoadCompleted(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a media source completed loading data.
`default void`	`onLoadError(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData, IOException error, boolean wasCanceled)` Called when a media source loading error occurred.
`default void`	`onLoadingChanged(AnalyticsListener.EventTime eventTime, boolean isLoading)` Called when the player starts or stops loading data from a source.
`default void`	`onLoadStarted(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a media source started loading data.
`default void`	`onMediaPeriodCreated(AnalyticsListener.EventTime eventTime)` Called when a media source created a media period.
`default void`	`onMediaPeriodReleased(AnalyticsListener.EventTime eventTime)` Called when a media source released a media period.
`default void`	`onMetadata(AnalyticsListener.EventTime eventTime, Metadata metadata)` Called when there is `Metadata` associated with the current playback time.
`default void`	`onPlaybackParametersChanged(AnalyticsListener.EventTime eventTime, PlaybackParameters playbackParameters)` Called when the playback parameters changed.
`default void`	`onPlayerError(AnalyticsListener.EventTime eventTime, ExoPlaybackException error)` Called when a fatal player error occurred.
`default void`	`onPlayerStateChanged(AnalyticsListener.EventTime eventTime, boolean playWhenReady, int playbackState)` Called when the player state changed.
`default void`	`onPositionDiscontinuity(AnalyticsListener.EventTime eventTime, int reason)` Called when a position discontinuity occurred.
`default void`	`onReadingStarted(AnalyticsListener.EventTime eventTime)` Called when the player started reading a media period.
`default void`	`onRenderedFirstFrame(AnalyticsListener.EventTime eventTime, Surface surface)` Called when a frame is rendered for the first time since setting the surface, and when a frame is rendered for the first time since the renderer was reset.
`default void`	`onRepeatModeChanged(AnalyticsListener.EventTime eventTime, int repeatMode)` Called when the repeat mode changed.
`default void`	`onSeekProcessed(AnalyticsListener.EventTime eventTime)` Called when a seek operation was processed.
`default void`	`onSeekStarted(AnalyticsListener.EventTime eventTime)` Called when a seek operation started.
`default void`	`onShuffleModeChanged(AnalyticsListener.EventTime eventTime, boolean shuffleModeEnabled)` Called when the shuffle mode changed.
`default void`	`onSurfaceSizeChanged(AnalyticsListener.EventTime eventTime, int width, int height)` Called when the output surface size changed.
`default void`	`onTimelineChanged(AnalyticsListener.EventTime eventTime, int reason)` Called when the timeline changed.
`default void`	`onTracksChanged(AnalyticsListener.EventTime eventTime, TrackGroupArray trackGroups, TrackSelectionArray trackSelections)` Called when the available or selected tracks for the renderers changed.
`default void`	`onUpstreamDiscarded(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.MediaLoadData 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.
`default void`	`onVideoSizeChanged(AnalyticsListener.EventTime eventTime, int width, int height, int unappliedRotationDegrees, float pixelWidthHeightRatio)` Called before a frame is rendered for the first time since setting the surface, and each time there's a change in the size or pixel aspect ratio of the video being rendered.
`default void`	`onVolumeChanged(AnalyticsListener.EventTime eventTime, float volume)` Called when the volume changes.

- Method Detail
  - onPlayerStateChanged
```
default void onPlayerStateChanged(AnalyticsListener.EventTime eventTime,
                                  boolean playWhenReady,
                                  int playbackState)
```
    Called when the player state changed.
    
    Parameters:
    
    eventTime - The event time.
    
    playWhenReady - Whether the playback will proceed when ready.
    
    playbackState - One of the Player.STATE constants.
  - onTimelineChanged
```
default void onTimelineChanged(AnalyticsListener.EventTime eventTime,
                               @Player.TimelineChangeReason
                               int reason)
```
    Called when the timeline changed.
    
    Parameters:
    
    eventTime - The event time.
    
    reason - The reason for the timeline change.
  - onPositionDiscontinuity
```
default void onPositionDiscontinuity(AnalyticsListener.EventTime eventTime,
                                     @Player.DiscontinuityReason
                                     int reason)
```
    Called when a position discontinuity occurred.
    
    Parameters:
    
    eventTime - The event time.
    
    reason - The reason for the position discontinuity.
  - onSeekStarted
```
default void onSeekStarted(AnalyticsListener.EventTime eventTime)
```
    Called when a seek operation started.
    
    Parameters:
    
    eventTime - The event time.
  - onSeekProcessed
```
default void onSeekProcessed(AnalyticsListener.EventTime eventTime)
```
    Called when a seek operation was processed.
    
    Parameters:
    
    eventTime - The event time.
  - onPlaybackParametersChanged
```
default void onPlaybackParametersChanged(AnalyticsListener.EventTime eventTime,
                                         PlaybackParameters playbackParameters)
```
    Called when the playback parameters changed.
    
    Parameters:
    
    eventTime - The event time.
    
    playbackParameters - The new playback parameters.
  - onRepeatModeChanged
```
default void onRepeatModeChanged(AnalyticsListener.EventTime eventTime,
                                 @Player.RepeatMode
                                 int repeatMode)
```
    Called when the repeat mode changed.
    
    Parameters:
    
    eventTime - The event time.
    
    repeatMode - The new repeat mode.
  - onShuffleModeChanged
```
default void onShuffleModeChanged(AnalyticsListener.EventTime eventTime,
                                  boolean shuffleModeEnabled)
```
    Called when the shuffle mode changed.
    
    Parameters:
    
    eventTime - The event time.
    
    shuffleModeEnabled - Whether the shuffle mode is enabled.
  - onLoadingChanged
```
default void onLoadingChanged(AnalyticsListener.EventTime eventTime,
                              boolean isLoading)
```
    Called when the player starts or stops loading data from a source.
    
    Parameters:
    
    eventTime - The event time.
    
    isLoading - Whether the player is loading.
  - onPlayerError
```
default void onPlayerError(AnalyticsListener.EventTime eventTime,
                           ExoPlaybackException error)
```
    Called when a fatal player error occurred.
    
    Parameters:
    
    eventTime - The event time.
    
    error - The error.
  - onTracksChanged
```
default void onTracksChanged(AnalyticsListener.EventTime eventTime,
                             TrackGroupArray trackGroups,
                             TrackSelectionArray trackSelections)
```
    Called when the available or selected tracks for the renderers changed.
    
    Parameters:
    
    eventTime - The event time.
    
    trackGroups - The available tracks. May be empty.
    
    trackSelections - The track selections for each renderer. May contain null elements.
  - onLoadStarted
```
default void onLoadStarted(AnalyticsListener.EventTime eventTime,
                           MediaSourceEventListener.LoadEventInfo loadEventInfo,
                           MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Called when a media source started loading data.
    
    Parameters:
    
    eventTime - The event time.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
  - onLoadCompleted
```
default void onLoadCompleted(AnalyticsListener.EventTime eventTime,
                             MediaSourceEventListener.LoadEventInfo loadEventInfo,
                             MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Called when a media source completed loading data.
    
    Parameters:
    
    eventTime - The event time.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
  - onLoadCanceled
```
default void onLoadCanceled(AnalyticsListener.EventTime eventTime,
                            MediaSourceEventListener.LoadEventInfo loadEventInfo,
                            MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Called when a media source canceled loading data.
    
    Parameters:
    
    eventTime - The event time.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
  - onLoadError
```
default void onLoadError(AnalyticsListener.EventTime eventTime,
                         MediaSourceEventListener.LoadEventInfo loadEventInfo,
                         MediaSourceEventListener.MediaLoadData mediaLoadData,
                         IOException error,
                         boolean wasCanceled)
```
    Called when a media source loading error occurred. These errors are just for informational purposes and the player may recover.
    
    Parameters:
    
    eventTime - The event time.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
    
    error - The load error.
    
    wasCanceled - Whether the load was canceled as a result of the error.
  - onDownstreamFormatChanged
```
default void onDownstreamFormatChanged(AnalyticsListener.EventTime eventTime,
                                       MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Called when the downstream format sent to the renderers changed.
    
    Parameters:
    
    eventTime - The event time.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the newly selected media data.
  - onUpstreamDiscarded
```
default void onUpstreamDiscarded(AnalyticsListener.EventTime eventTime,
                                 MediaSourceEventListener.MediaLoadData 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.
    
    Parameters:
    
    eventTime - The event time.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the media being discarded.
  - onMediaPeriodCreated
```
default void onMediaPeriodCreated(AnalyticsListener.EventTime eventTime)
```
    Called when a media source created a media period.
    
    Parameters:
    
    eventTime - The event time.
  - onMediaPeriodReleased
```
default void onMediaPeriodReleased(AnalyticsListener.EventTime eventTime)
```
    Called when a media source released a media period.
    
    Parameters:
    
    eventTime - The event time.
  - onReadingStarted
```
default void onReadingStarted(AnalyticsListener.EventTime eventTime)
```
    Called when the player started reading a media period.
    
    Parameters:
    
    eventTime - The event time.
  - onBandwidthEstimate
```
default void onBandwidthEstimate(AnalyticsListener.EventTime eventTime,
                                 int totalLoadTimeMs,
                                 long totalBytesLoaded,
                                 long bitrateEstimate)
```
    Called when the bandwidth estimate for the current data source has been updated.
    
    Parameters:
    
    eventTime - The event time.
    
    totalLoadTimeMs - The total time spend loading this update is based on, in milliseconds.
    
    totalBytesLoaded - The total bytes loaded this update is based on.
    
    bitrateEstimate - The bandwidth estimate, in bits per second.
  - onSurfaceSizeChanged
```
default void onSurfaceSizeChanged(AnalyticsListener.EventTime eventTime,
                                  int width,
                                  int height)
```
    Called when the output surface size changed.
    
    Parameters:
    
    eventTime - The event time.
    
    width - The surface width in pixels. May be C.LENGTH_UNSET if unknown, or 0 if the video is not rendered onto a surface.
    
    height - The surface height in pixels. May be C.LENGTH_UNSET if unknown, or 0 if the video is not rendered onto a surface.
  - onMetadata
```
default void onMetadata(AnalyticsListener.EventTime eventTime,
                        Metadata metadata)
```
    Called when there is Metadata associated with the current playback time.
    
    Parameters:
    
    eventTime - The event time.
    
    metadata - The metadata.
  - onDecoderEnabled
```
default void onDecoderEnabled(AnalyticsListener.EventTime eventTime,
                              int trackType,
                              DecoderCounters decoderCounters)
```
    Called when an audio or video decoder has been enabled.
    
    Parameters:
    
    eventTime - The event time.
    
    trackType - The track type of the enabled decoder. Either C.TRACK_TYPE_AUDIO or C.TRACK_TYPE_VIDEO.
    
    decoderCounters - The accumulated event counters associated with this decoder.
  - onDecoderInitialized
```
default void onDecoderInitialized(AnalyticsListener.EventTime eventTime,
                                  int trackType,
                                  String decoderName,
                                  long initializationDurationMs)
```
    Called when an audio or video decoder has been initialized.
    
    Parameters:
    
    eventTime - The event time.
    
    trackType - The track type of the initialized decoder. Either C.TRACK_TYPE_AUDIO or C.TRACK_TYPE_VIDEO.
    
    decoderName - The decoder that was created.
    
    initializationDurationMs - Time taken to initialize the decoder, in milliseconds.
  - onDecoderInputFormatChanged
```
default void onDecoderInputFormatChanged(AnalyticsListener.EventTime eventTime,
                                         int trackType,
                                         Format format)
```
    Called when an audio or video decoder input format changed.
    
    Parameters:
    
    eventTime - The event time.
    
    trackType - The track type of the decoder whose format changed. Either C.TRACK_TYPE_AUDIO or C.TRACK_TYPE_VIDEO.
    
    format - The new input format for the decoder.
  - onDecoderDisabled
```
default void onDecoderDisabled(AnalyticsListener.EventTime eventTime,
                               int trackType,
                               DecoderCounters decoderCounters)
```
    Called when an audio or video decoder has been disabled.
    
    Parameters:
    
    eventTime - The event time.
    
    trackType - The track type of the disabled decoder. Either C.TRACK_TYPE_AUDIO or C.TRACK_TYPE_VIDEO.
    
    decoderCounters - The accumulated event counters associated with this decoder.
  - onAudioSessionId
```
default void onAudioSessionId(AnalyticsListener.EventTime eventTime,
                              int audioSessionId)
```
    Called when the audio session id is set.
    
    Parameters:
    
    eventTime - The event time.
    
    audioSessionId - The audio session id.
  - onAudioAttributesChanged
```
default void onAudioAttributesChanged(AnalyticsListener.EventTime eventTime,
                                      AudioAttributes audioAttributes)
```
    Called when the audio attributes change.
    
    Parameters:
    
    eventTime - The event time.
    
    audioAttributes - The audio attributes.
  - onVolumeChanged
```
default void onVolumeChanged(AnalyticsListener.EventTime eventTime,
                             float volume)
```
    Called when the volume changes.
    
    Parameters:
    
    eventTime - The event time.
    
    volume - The new volume, with 0 being silence and 1 being unity gain.
  - onAudioUnderrun
```
default void onAudioUnderrun(AnalyticsListener.EventTime eventTime,
                             int bufferSize,
                             long bufferSizeMs,
                             long elapsedSinceLastFeedMs)
```
    Called when an audio underrun occurred.
    
    Parameters:
    
    eventTime - The event time.
    
    bufferSize - The size of the AudioSink's buffer, in bytes.
    
    bufferSizeMs - The size of the AudioSink's buffer, in milliseconds, if it is configured for PCM output. C.TIME_UNSET if it is configured for passthrough output, as the buffered media can have a variable bitrate so the duration may be unknown.
    
    elapsedSinceLastFeedMs - The time since the AudioSink was last fed data.
  - onDroppedVideoFrames
```
default void onDroppedVideoFrames(AnalyticsListener.EventTime eventTime,
                                  int droppedFrames,
                                  long elapsedMs)
```
    Called after video frames have been dropped.
    
    Parameters:
    
    eventTime - The event time.
    
    droppedFrames - The number of dropped frames since the last call to this method.
    
    elapsedMs - 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.
  - onVideoSizeChanged
```
default void onVideoSizeChanged(AnalyticsListener.EventTime eventTime,
                                int width,
                                int height,
                                int unappliedRotationDegrees,
                                float pixelWidthHeightRatio)
```
    Called before a frame is rendered for the first time since setting the surface, and each time there's a change in the size or pixel aspect ratio of the video being rendered.
    
    Parameters:
    
    eventTime - The event time.
    
    width - The width of the video.
    
    height - The height of the video.
    
    unappliedRotationDegrees - For videos that require a rotation, this is the clockwise rotation in degrees that the application should apply for the video for it to be rendered in the correct orientation. This value will always be zero on API levels 21 and above, since the renderer will apply all necessary rotations internally.
    
    pixelWidthHeightRatio - The width to height ratio of each pixel.
  - onRenderedFirstFrame
```
default void onRenderedFirstFrame(AnalyticsListener.EventTime eventTime,
                                  @Nullable
                                  Surface surface)
```
    Called when a frame is rendered for the first time since setting the surface, and when a frame is rendered for the first time since the renderer was reset.
    
    Parameters:
    
    eventTime - The event time.
    
    surface - The Surface to which a first frame has been rendered, or null if the renderer renders to something that isn't a Surface.
  - onDrmSessionAcquired
```
default void onDrmSessionAcquired(AnalyticsListener.EventTime eventTime)
```
    Called each time a drm session is acquired.
    
    Parameters:
    
    eventTime - The event time.
  - onDrmKeysLoaded
```
default void onDrmKeysLoaded(AnalyticsListener.EventTime eventTime)
```
    Called each time drm keys are loaded.
    
    Parameters:
    
    eventTime - The event time.
  - onDrmSessionManagerError
```
default void onDrmSessionManagerError(AnalyticsListener.EventTime eventTime,
                                      Exception error)
```
    Called when a drm error occurs. These errors are just for informational purposes and the player may recover.
    
    Parameters:
    
    eventTime - The event time.
    
    error - The error.
  - onDrmKeysRestored
```
default void onDrmKeysRestored(AnalyticsListener.EventTime eventTime)
```
    Called each time offline drm keys are restored.
    
    Parameters:
    
    eventTime - The event time.
  - onDrmKeysRemoved
```
default void onDrmKeysRemoved(AnalyticsListener.EventTime eventTime)
```
    Called each time offline drm keys are removed.
    
    Parameters:
    
    eventTime - The event time.
  - onDrmSessionReleased
```
default void onDrmSessionReleased(AnalyticsListener.EventTime eventTime)
```
    Called each time a drm session is released.
    
    Parameters:
    
    eventTime - The event time.

Interface AnalyticsListener

Nested Class Summary

Method Summary

Method Detail

onPlayerStateChanged

onTimelineChanged

onPositionDiscontinuity

onSeekStarted

onSeekProcessed

onPlaybackParametersChanged

onRepeatModeChanged

onShuffleModeChanged

onLoadingChanged

onPlayerError

onTracksChanged

onLoadStarted

onLoadCompleted

onLoadCanceled

onLoadError

onDownstreamFormatChanged

onUpstreamDiscarded

onMediaPeriodCreated

onMediaPeriodReleased

onReadingStarted

onBandwidthEstimate

onSurfaceSizeChanged

onMetadata

onDecoderEnabled

onDecoderInitialized

onDecoderInputFormatChanged

onDecoderDisabled

onAudioSessionId

onAudioAttributesChanged

onVolumeChanged

onAudioUnderrun

onDroppedVideoFrames

onVideoSizeChanged

onRenderedFirstFrame

onDrmSessionAcquired

onDrmKeysLoaded

onDrmSessionManagerError

onDrmKeysRestored

onDrmKeysRemoved

onDrmSessionReleased