AnalyticsCollector (library-core API)

java.lang.Object
- com.google.android.exoplayer2.analytics.AnalyticsCollector

All Implemented Interfaces:

AudioListener, AudioRendererEventListener, DefaultDrmSessionEventListener, MetadataOutput, Player.EventListener, MediaSourceEventListener, BandwidthMeter.EventListener, VideoListener, VideoRendererEventListener
```
public class AnalyticsCollector
extends java.lang.Object
implements Player.EventListener, MetadataOutput, AudioRendererEventListener, VideoRendererEventListener, MediaSourceEventListener, BandwidthMeter.EventListener, DefaultDrmSessionEventListener, VideoListener, AudioListener
```
Data collector which is able to forward analytics events to AnalyticsListeners by listening to all available ExoPlayer listeners.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class AnalyticsCollector.Factory
Factory for an analytics collector.
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.audio.AudioRendererEventListener
  AudioRendererEventListener.EventDispatcher
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.video.VideoRendererEventListener
  VideoRendererEventListener.EventDispatcher
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.source.MediaSourceEventListener
  MediaSourceEventListener.EventDispatcher, MediaSourceEventListener.LoadEventInfo, MediaSourceEventListener.MediaLoadData

Nested Classes
Modifier and Type	Class and Description
`static class`	`AnalyticsCollector.Factory` Factory for an analytics collector.

Constructor Summary

Constructors
Modifier Constructor and Description

protected AnalyticsCollector(Player player, Clock clock)
Creates an analytics collector for the specified player.

Constructors
Modifier	Constructor and Description
`protected`	`AnalyticsCollector(Player player, Clock clock)` Creates an analytics collector for the specified player.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addListener(AnalyticsListener listener)` Adds a listener for analytics events.
`protected AnalyticsListener.EventTime`	`generateEventTime(Timeline timeline, int windowIndex, MediaSource.MediaPeriodId mediaPeriodId)` Returns a new `AnalyticsListener.EventTime` for the specified timeline, window and media period id.
`protected java.util.Set<AnalyticsListener>`	`getListeners()` Returns read-only set of registered listeners.
`void`	`notifySeekStarted()` Notify analytics collector that a seek operation will start.
`void`	`onAudioAttributesChanged(AudioAttributes audioAttributes)` Called when the audio attributes change.
`void`	`onAudioDecoderInitialized(java.lang.String decoderName, long initializedTimestampMs, long initializationDurationMs)` Called when a decoder is created.
`void`	`onAudioDisabled(DecoderCounters counters)` Called when the renderer is disabled.
`void`	`onAudioEnabled(DecoderCounters counters)` Called when the renderer is enabled.
`void`	`onAudioInputFormatChanged(Format format)` Called when the format of the media being consumed by the renderer changes.
`void`	`onAudioSessionId(int audioSessionId)` Called when the audio session is set.
`void`	`onAudioSinkUnderrun(int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs)` Called when an `AudioSink` underrun occurs.
`void`	`onBandwidthSample(int elapsedMs, long bytes, long bitrate)` Called periodically to indicate that bytes have been transferred.
`void`	`onDownstreamFormatChanged(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a downstream format change occurs (i.e.
`void`	`onDrmKeysLoaded()` Called each time keys are loaded.
`void`	`onDrmKeysRemoved()` Called each time offline keys are removed.
`void`	`onDrmKeysRestored()` Called each time offline keys are restored.
`void`	`onDrmSessionAcquired()` Called each time a drm session is acquired.
`void`	`onDrmSessionManagerError(java.lang.Exception error)` Called when a drm error occurs.
`void`	`onDrmSessionReleased()` Called each time a drm session is released.
`void`	`onDroppedFrames(int count, long elapsedMs)` Called to report the number of frames dropped by the renderer.
`void`	`onLoadCanceled(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a load is canceled.
`void`	`onLoadCompleted(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a load ends.
`void`	`onLoadError(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData, java.io.IOException error, boolean wasCanceled)` Called when a load error occurs.
`void`	`onLoadingChanged(boolean isLoading)` Called when the player starts or stops loading the source.
`void`	`onLoadStarted(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData)` Called when a load begins.
`void`	`onMediaPeriodCreated(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId)` Called when a media period is created by the media source.
`void`	`onMediaPeriodReleased(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId)` Called when a media period is released by the media source.
`void`	`onMetadata(Metadata metadata)` Called when there is metadata associated with current playback time.
`void`	`onPlaybackParametersChanged(PlaybackParameters playbackParameters)` Called when the current playback parameters change.
`void`	`onPlayerError(ExoPlaybackException error)` Called when an error occurs.
`void`	`onPlayerStateChanged(boolean playWhenReady, int playbackState)` Called when the value returned from either `Player.getPlayWhenReady()` or `Player.getPlaybackState()` changes.
`void`	`onPositionDiscontinuity(int reason)` Called when a position discontinuity occurs without a change to the timeline.
`void`	`onReadingStarted(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId)` Called when a media period is first being read from.
`void`	`onRenderedFirstFrame()` 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 a video track was selected.
`void`	`onRenderedFirstFrame(android.view.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.
`void`	`onRepeatModeChanged(int repeatMode)` Called when the value of `Player.getRepeatMode()` changes.
`void`	`onSeekProcessed()` Called when all pending seek requests have been processed by the player.
`void`	`onShuffleModeEnabledChanged(boolean shuffleModeEnabled)` Called when the value of `Player.getShuffleModeEnabled()` changes.
`void`	`onSurfaceSizeChanged(int width, int height)` Called each time there's a change in the size of the surface onto which the video is being rendered.
`void`	`onTimelineChanged(Timeline timeline, java.lang.Object manifest, int reason)` Called when the timeline and/or manifest has been refreshed.
`void`	`onTracksChanged(TrackGroupArray trackGroups, TrackSelectionArray trackSelections)` Called when the available or selected tracks change.
`void`	`onUpstreamDiscarded(int windowIndex, MediaSource.MediaPeriodId mediaPeriodId, 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.
`void`	`onVideoDecoderInitialized(java.lang.String decoderName, long initializedTimestampMs, long initializationDurationMs)` Called when a decoder is created.
`void`	`onVideoDisabled(DecoderCounters counters)` Called when the renderer is disabled.
`void`	`onVideoEnabled(DecoderCounters counters)` Called when the renderer is enabled.
`void`	`onVideoInputFormatChanged(Format format)` Called when the format of the media being consumed by the renderer changes.
`void`	`onVideoSizeChanged(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, rotation or pixel aspect ratio of the video being rendered.
`void`	`onVolumeChanged(float audioVolume)` Called when the volume changes.
`void`	`removeListener(AnalyticsListener listener)` Removes a previously added analytics event listener.
`void`	`resetForNewMediaSource()` Resets the analytics collector for a new media source.
`void`	`setPlayer(Player player)` Sets the player for which data will be collected.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AnalyticsCollector
```
protected AnalyticsCollector(@Nullable
                             Player player,
                             Clock clock)
```
    Creates an analytics collector for the specified player.
    
    Parameters:
    
    player - The Player for which data will be collected. Can be null, if the player is set by calling setPlayer(Player) before using the analytics collector.
    
    clock - A Clock used to generate timestamps.
- Method Detail
  - addListener
```
public void addListener(AnalyticsListener listener)
```
    Adds a listener for analytics events.
    
    Parameters:
    
    listener - The listener to add.
  - removeListener
```
public void removeListener(AnalyticsListener listener)
```
    Removes a previously added analytics event listener.
    
    Parameters:
    
    listener - The listener to remove.
  - setPlayer
```
public void setPlayer(Player player)
```
    Sets the player for which data will be collected. Must only be called if no player has been set yet.
    
    Parameters:
    
    player - The Player for which data will be collected.
  - notifySeekStarted
```
public final void notifySeekStarted()
```
    Notify analytics collector that a seek operation will start. Should be called before the player adjusts its state and position to the seek.
  - resetForNewMediaSource
```
public final void resetForNewMediaSource()
```
    Resets the analytics collector for a new media source. Should be called before the player is prepared with a new media source.
  - onMetadata
```
public final void onMetadata(Metadata metadata)
```
    Description copied from interface: MetadataOutput
    
    Called when there is metadata associated with current playback time.
    
    Specified by:
    
    onMetadata in interface MetadataOutput
    
    Parameters:
    
    metadata - The metadata.
  - onAudioEnabled
```
public final void onAudioEnabled(DecoderCounters counters)
```
    Description copied from interface: AudioRendererEventListener
    
    Called when the renderer is enabled.
    
    Specified by:
    
    onAudioEnabled in interface AudioRendererEventListener
    
    Parameters:
    
    counters - DecoderCounters that will be updated by the renderer for as long as it remains enabled.
  - onAudioDecoderInitialized
```
public final void onAudioDecoderInitialized(java.lang.String decoderName,
                                            long initializedTimestampMs,
                                            long initializationDurationMs)
```
    Description copied from interface: AudioRendererEventListener
    
    Called when a decoder is created.
    
    Specified by:
    
    onAudioDecoderInitialized in interface AudioRendererEventListener
    
    Parameters:
    
    decoderName - The decoder that was created.
    
    initializedTimestampMs - SystemClock.elapsedRealtime() when initialization finished.
    
    initializationDurationMs - The time taken to initialize the decoder in milliseconds.
  - onAudioInputFormatChanged
```
public final void onAudioInputFormatChanged(Format format)
```
    Description copied from interface: AudioRendererEventListener
    
    Called when the format of the media being consumed by the renderer changes.
    
    Specified by:
    
    onAudioInputFormatChanged in interface AudioRendererEventListener
    
    Parameters:
    
    format - The new format.
  - onAudioSinkUnderrun
```
public final void onAudioSinkUnderrun(int bufferSize,
                                      long bufferSizeMs,
                                      long elapsedSinceLastFeedMs)
```
    Description copied from interface: AudioRendererEventListener
    
    Called when an AudioSink underrun occurs.
    
    Specified by:
    
    onAudioSinkUnderrun in interface AudioRendererEventListener
    
    Parameters:
    
    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.
  - onAudioDisabled
```
public final void onAudioDisabled(DecoderCounters counters)
```
    Description copied from interface: AudioRendererEventListener
    
    Called when the renderer is disabled.
    
    Specified by:
    
    onAudioDisabled in interface AudioRendererEventListener
    
    Parameters:
    
    counters - DecoderCounters that were updated by the renderer.
  - onAudioSessionId
```
public final void onAudioSessionId(int audioSessionId)
```
    Description copied from interface: AudioRendererEventListener
    
    Called when the audio session is set.
    
    Specified by:
    
    onAudioSessionId in interface AudioListener
    
    Specified by:
    
    onAudioSessionId in interface AudioRendererEventListener
    
    Parameters:
    
    audioSessionId - The audio session id.
  - onAudioAttributesChanged
```
public void onAudioAttributesChanged(AudioAttributes audioAttributes)
```
    Description copied from interface: AudioListener
    
    Called when the audio attributes change.
    
    Specified by:
    
    onAudioAttributesChanged in interface AudioListener
    
    Parameters:
    
    audioAttributes - The audio attributes.
  - onVolumeChanged
```
public void onVolumeChanged(float audioVolume)
```
    Description copied from interface: AudioListener
    
    Called when the volume changes.
    
    Specified by:
    
    onVolumeChanged in interface AudioListener
    
    Parameters:
    
    audioVolume - The new volume, with 0 being silence and 1 being unity gain.
  - onVideoEnabled
```
public final void onVideoEnabled(DecoderCounters counters)
```
    Description copied from interface: VideoRendererEventListener
    
    Called when the renderer is enabled.
    
    Specified by:
    
    onVideoEnabled in interface VideoRendererEventListener
    
    Parameters:
    
    counters - DecoderCounters that will be updated by the renderer for as long as it remains enabled.
  - onVideoDecoderInitialized
```
public final void onVideoDecoderInitialized(java.lang.String decoderName,
                                            long initializedTimestampMs,
                                            long initializationDurationMs)
```
    Description copied from interface: VideoRendererEventListener
    
    Called when a decoder is created.
    
    Specified by:
    
    onVideoDecoderInitialized in interface VideoRendererEventListener
    
    Parameters:
    
    decoderName - The decoder that was created.
    
    initializedTimestampMs - SystemClock.elapsedRealtime() when initialization finished.
    
    initializationDurationMs - The time taken to initialize the decoder in milliseconds.
  - onVideoInputFormatChanged
```
public final void onVideoInputFormatChanged(Format format)
```
    Description copied from interface: VideoRendererEventListener
    
    Called when the format of the media being consumed by the renderer changes.
    
    Specified by:
    
    onVideoInputFormatChanged in interface VideoRendererEventListener
    
    Parameters:
    
    format - The new format.
  - onDroppedFrames
```
public final void onDroppedFrames(int count,
                                  long elapsedMs)
```
    Description copied from interface: VideoRendererEventListener
    
    Called to report the number of frames dropped by the 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.
    
    Specified by:
    
    onDroppedFrames in interface VideoRendererEventListener
    
    Parameters:
    
    count - The number of dropped frames.
    
    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.
  - onVideoDisabled
```
public final void onVideoDisabled(DecoderCounters counters)
```
    Description copied from interface: VideoRendererEventListener
    
    Called when the renderer is disabled.
    
    Specified by:
    
    onVideoDisabled in interface VideoRendererEventListener
    
    Parameters:
    
    counters - DecoderCounters that were updated by the renderer.
  - onRenderedFirstFrame
```
public final void onRenderedFirstFrame(@Nullable
                                       android.view.Surface surface)
```
    Description copied from interface: VideoRendererEventListener
    
    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.
    
    Specified by:
    
    onRenderedFirstFrame in interface VideoRendererEventListener
    
    Parameters:
    
    surface - The Surface to which a first frame has been rendered, or null if the renderer renders to something that isn't a Surface.
  - onRenderedFirstFrame
```
public final void onRenderedFirstFrame()
```
    Description copied from interface: VideoListener
    
    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 a video track was selected.
    
    Specified by:
    
    onRenderedFirstFrame in interface VideoListener
  - onVideoSizeChanged
```
public final void onVideoSizeChanged(int width,
                                     int height,
                                     int unappliedRotationDegrees,
                                     float pixelWidthHeightRatio)
```
    Description copied from interface: VideoRendererEventListener
    
    Called before a frame is rendered for the first time since setting the surface, and each time there's a change in the size, rotation or pixel aspect ratio of the video being rendered.
    
    Specified by:
    
    onVideoSizeChanged in interface VideoListener
    
    Specified by:
    
    onVideoSizeChanged in interface VideoRendererEventListener
    
    Parameters:
    
    width - The video width in pixels.
    
    height - The video height in pixels.
    
    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. On earlier API levels this is not possible. Applications that use TextureView can apply the rotation by calling TextureView.setTransform(android.graphics.Matrix). Applications that do not expect to encounter rotated videos can safely ignore this parameter.
    
    pixelWidthHeightRatio - The width to height ratio of each pixel. For the normal case of square pixels this will be equal to 1.0. Different values are indicative of anamorphic content.
  - onSurfaceSizeChanged
```
public void onSurfaceSizeChanged(int width,
                                 int height)
```
    Description copied from interface: VideoListener
    
    Called each time there's a change in the size of the surface onto which the video is being rendered.
    
    Specified by:
    
    onSurfaceSizeChanged in interface VideoListener
    
    Parameters:
    
    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.
  - onMediaPeriodCreated
```
public final void onMediaPeriodCreated(int windowIndex,
                                       MediaSource.MediaPeriodId mediaPeriodId)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a media period is created by the media source.
    
    Specified by:
    
    onMediaPeriodCreated in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline this media period belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId of the created media period.
  - onMediaPeriodReleased
```
public final void onMediaPeriodReleased(int windowIndex,
                                        MediaSource.MediaPeriodId mediaPeriodId)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a media period is released by the media source.
    
    Specified by:
    
    onMediaPeriodReleased in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline this media period belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId of the released media period.
  - onLoadStarted
```
public final void onLoadStarted(int windowIndex,
                                @Nullable
                                MediaSource.MediaPeriodId mediaPeriodId,
                                MediaSourceEventListener.LoadEventInfo loadEventInfo,
                                MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a load begins.
    
    Specified by:
    
    onLoadStarted in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline of the media source this load belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId this load belongs to. Null if the load does not belong to a specific media period.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo corresponding to the event. The value of MediaSourceEventListener.LoadEventInfo.uri won't reflect potential redirection yet and MediaSourceEventListener.LoadEventInfo.responseHeaders will be empty.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
  - onLoadCompleted
```
public final void onLoadCompleted(int windowIndex,
                                  @Nullable
                                  MediaSource.MediaPeriodId mediaPeriodId,
                                  MediaSourceEventListener.LoadEventInfo loadEventInfo,
                                  MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a load ends.
    
    Specified by:
    
    onLoadCompleted in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline of the media source this load belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId this load belongs to. Null if the load does not belong to a specific media period.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo corresponding to the event. The values of MediaSourceEventListener.LoadEventInfo.elapsedRealtimeMs and MediaSourceEventListener.LoadEventInfo.bytesLoaded are relative to the corresponding #onLoadStarted(int, MediaPeriodId, LoadEventInfo, MediaLoadData) event.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
  - onLoadCanceled
```
public final void onLoadCanceled(int windowIndex,
                                 @Nullable
                                 MediaSource.MediaPeriodId mediaPeriodId,
                                 MediaSourceEventListener.LoadEventInfo loadEventInfo,
                                 MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a load is canceled.
    
    Specified by:
    
    onLoadCanceled in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline of the media source this load belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId this load belongs to. Null if the load does not belong to a specific media period.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo corresponding to the event. The values of MediaSourceEventListener.LoadEventInfo.elapsedRealtimeMs and MediaSourceEventListener.LoadEventInfo.bytesLoaded are relative to the corresponding #onLoadStarted(int, MediaPeriodId, LoadEventInfo, MediaLoadData) event.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.
  - onLoadError
```
public final void onLoadError(int windowIndex,
                              @Nullable
                              MediaSource.MediaPeriodId mediaPeriodId,
                              MediaSourceEventListener.LoadEventInfo loadEventInfo,
                              MediaSourceEventListener.MediaLoadData mediaLoadData,
                              java.io.IOException error,
                              boolean wasCanceled)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a load error occurs.
    The error may or may not have resulted in the load being canceled, as indicated by the wasCanceled parameter. If the load was canceled, MediaSourceEventListener.onLoadCanceled(int, com.google.android.exoplayer2.source.MediaSource.MediaPeriodId, com.google.android.exoplayer2.source.MediaSourceEventListener.LoadEventInfo, com.google.android.exoplayer2.source.MediaSourceEventListener.MediaLoadData) will not be called in addition to this method.
    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 and continue. Hence applications should not implement this method to display a user visible error or initiate an application level retry (Player.EventListener#onPlayerError 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.
    
    Specified by:
    
    onLoadError in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline of the media source this load belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId this load belongs to. Null if the load does not belong to a specific media period.
    
    loadEventInfo - The MediaSourceEventListener.LoadEventInfo corresponding to the event. The values of MediaSourceEventListener.LoadEventInfo.elapsedRealtimeMs and MediaSourceEventListener.LoadEventInfo.bytesLoaded are relative to the corresponding #onLoadStarted(int, MediaPeriodId, LoadEventInfo, MediaLoadData) 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.
  - onReadingStarted
```
public final void onReadingStarted(int windowIndex,
                                   MediaSource.MediaPeriodId mediaPeriodId)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a media period is first being read from.
    
    Specified by:
    
    onReadingStarted in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline this media period belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId of the media period being read from.
  - onUpstreamDiscarded
```
public final void onUpstreamDiscarded(int windowIndex,
                                      @Nullable
                                      MediaSource.MediaPeriodId mediaPeriodId,
                                      MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when data is removed from the back of a media buffer, typically so that it can be re-buffered in a different format.
    
    Specified by:
    
    onUpstreamDiscarded in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline of the media source this load belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId the media belongs to.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the media being discarded.
  - onDownstreamFormatChanged
```
public final void onDownstreamFormatChanged(int windowIndex,
                                            @Nullable
                                            MediaSource.MediaPeriodId mediaPeriodId,
                                            MediaSourceEventListener.MediaLoadData mediaLoadData)
```
    Description copied from interface: MediaSourceEventListener
    
    Called when a downstream format change occurs (i.e. when the format of the media being read from one or more SampleStreams provided by the source changes).
    
    Specified by:
    
    onDownstreamFormatChanged in interface MediaSourceEventListener
    
    Parameters:
    
    windowIndex - The window index in the timeline of the media source this load belongs to.
    
    mediaPeriodId - The MediaSource.MediaPeriodId the media belongs to.
    
    mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the newly selected downstream data.
  - onTimelineChanged
```
public final void onTimelineChanged(Timeline timeline,
                                    @Nullable
                                    java.lang.Object manifest,
                                    @Player.TimelineChangeReason
                                    int reason)
```
    Description copied from interface: Player.EventListener
    
    Called when the timeline and/or manifest has been refreshed.
    Note that if the timeline has changed then a position discontinuity may also have occurred. For example, the current period index may have changed as a result of periods being added or removed from the timeline. This will not be reported via a separate call to Player.EventListener.onPositionDiscontinuity(int).
    
    Specified by:
    
    onTimelineChanged in interface Player.EventListener
    
    Parameters:
    
    timeline - The latest timeline. Never null, but may be empty.
    
    manifest - The latest manifest. May be null.
    
    reason - The Player.TimelineChangeReason responsible for this timeline change.
  - onTracksChanged
```
public final void onTracksChanged(TrackGroupArray trackGroups,
                                  TrackSelectionArray trackSelections)
```
    Description copied from interface: Player.EventListener
    
    Called when the available or selected tracks change.
    
    Specified by:
    
    onTracksChanged in interface Player.EventListener
    
    Parameters:
    
    trackGroups - The available tracks. Never null, but may be of length zero.
    
    trackSelections - The track selections for each renderer. Never null and always of length Player.getRendererCount(), but may contain null elements.
  - onLoadingChanged
```
public final void onLoadingChanged(boolean isLoading)
```
    Description copied from interface: Player.EventListener
    
    Called when the player starts or stops loading the source.
    
    Specified by:
    
    onLoadingChanged in interface Player.EventListener
    
    Parameters:
    
    isLoading - Whether the source is currently being loaded.
  - onPlayerStateChanged
```
public final void onPlayerStateChanged(boolean playWhenReady,
                                       int playbackState)
```
    Description copied from interface: Player.EventListener
    
    Called when the value returned from either Player.getPlayWhenReady() or Player.getPlaybackState() changes.
    
    Specified by:
    
    onPlayerStateChanged in interface Player.EventListener
    
    Parameters:
    
    playWhenReady - Whether playback will proceed when ready.
    
    playbackState - One of the STATE constants.
  - onRepeatModeChanged
```
public final void onRepeatModeChanged(@Player.RepeatMode
                                      int repeatMode)
```
    Description copied from interface: Player.EventListener
    
    Called when the value of Player.getRepeatMode() changes.
    
    Specified by:
    
    onRepeatModeChanged in interface Player.EventListener
    
    Parameters:
    
    repeatMode - The Player.RepeatMode used for playback.
  - onShuffleModeEnabledChanged
```
public final void onShuffleModeEnabledChanged(boolean shuffleModeEnabled)
```
    Description copied from interface: Player.EventListener
    
    Called when the value of Player.getShuffleModeEnabled() changes.
    
    Specified by:
    
    onShuffleModeEnabledChanged in interface Player.EventListener
    
    Parameters:
    
    shuffleModeEnabled - Whether shuffling of windows is enabled.
  - onPlayerError
```
public final void onPlayerError(ExoPlaybackException error)
```
    Description copied from interface: Player.EventListener
    
    Called when an error occurs. The playback state will transition to Player.STATE_IDLE immediately after this method is called. The player instance can still be used, and Player.release() must still be called on the player should it no longer be required.
    
    Specified by:
    
    onPlayerError in interface Player.EventListener
    
    Parameters:
    
    error - The error.
  - onPositionDiscontinuity
```
public final void onPositionDiscontinuity(@Player.DiscontinuityReason
                                          int reason)
```
    Description copied from interface: Player.EventListener
    
    Called when a position discontinuity occurs without a change to the timeline. A position discontinuity occurs when the current window or period index changes (as a result of playback transitioning from one period in the timeline to the next), or when the playback position jumps within the period currently being played (as a result of a seek being performed, or when the source introduces a discontinuity internally).
    When a position discontinuity occurs as a result of a change to the timeline this method is not called. Player.EventListener.onTimelineChanged(Timeline, Object, int) is called in this case.
    
    Specified by:
    
    onPositionDiscontinuity in interface Player.EventListener
    
    Parameters:
    
    reason - The Player.DiscontinuityReason responsible for the discontinuity.
  - onPlaybackParametersChanged
```
public final void onPlaybackParametersChanged(PlaybackParameters playbackParameters)
```
    Description copied from interface: Player.EventListener
    
    Called when the current playback parameters change. The playback parameters may change due to a call to Player.setPlaybackParameters(PlaybackParameters), or the player itself may change them (for example, if audio playback switches to passthrough mode, where speed adjustment is no longer possible).
    
    Specified by:
    
    onPlaybackParametersChanged in interface Player.EventListener
    
    Parameters:
    
    playbackParameters - The playback parameters.
  - onSeekProcessed
```
public final void onSeekProcessed()
```
    Description copied from interface: Player.EventListener
    
    Called when all pending seek requests have been processed by the player. This is guaranteed to happen after any necessary changes to the player state were reported to Player.EventListener.onPlayerStateChanged(boolean, int).
    
    Specified by:
    
    onSeekProcessed in interface Player.EventListener
  - onBandwidthSample
```
public final void onBandwidthSample(int elapsedMs,
                                    long bytes,
                                    long bitrate)
```
    Description copied from interface: BandwidthMeter.EventListener
    
    Called periodically to indicate that bytes have been transferred.
    Note: The estimated bitrate is typically derived from more information than just bytes and elapsedMs.
    
    Specified by:
    
    onBandwidthSample in interface BandwidthMeter.EventListener
    
    Parameters:
    
    elapsedMs - The time taken to transfer the bytes, in milliseconds.
    
    bytes - The number of bytes transferred.
    
    bitrate - The estimated bitrate in bits/sec.
  - onDrmSessionAcquired
```
public final void onDrmSessionAcquired()
```
    Description copied from interface: DefaultDrmSessionEventListener
    
    Called each time a drm session is acquired.
    
    Specified by:
    
    onDrmSessionAcquired in interface DefaultDrmSessionEventListener
  - onDrmKeysLoaded
```
public final void onDrmKeysLoaded()
```
    Description copied from interface: DefaultDrmSessionEventListener
    
    Called each time keys are loaded.
    
    Specified by:
    
    onDrmKeysLoaded in interface DefaultDrmSessionEventListener
  - onDrmSessionManagerError
```
public final void onDrmSessionManagerError(java.lang.Exception error)
```
    Description copied from interface: DefaultDrmSessionEventListener
    
    Called when a drm error occurs.
    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 and continue. Hence applications should not implement this method to display a user visible error or initiate an application level retry (Player.EventListener#onPlayerError 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.
    
    Specified by:
    
    onDrmSessionManagerError in interface DefaultDrmSessionEventListener
    
    Parameters:
    
    error - The corresponding exception.
  - onDrmKeysRestored
```
public final void onDrmKeysRestored()
```
    Description copied from interface: DefaultDrmSessionEventListener
    
    Called each time offline keys are restored.
    
    Specified by:
    
    onDrmKeysRestored in interface DefaultDrmSessionEventListener
  - onDrmKeysRemoved
```
public final void onDrmKeysRemoved()
```
    Description copied from interface: DefaultDrmSessionEventListener
    
    Called each time offline keys are removed.
    
    Specified by:
    
    onDrmKeysRemoved in interface DefaultDrmSessionEventListener
  - onDrmSessionReleased
```
public final void onDrmSessionReleased()
```
    Description copied from interface: DefaultDrmSessionEventListener
    
    Called each time a drm session is released.
    
    Specified by:
    
    onDrmSessionReleased in interface DefaultDrmSessionEventListener
  - getListeners
```
protected java.util.Set<AnalyticsListener> getListeners()
```
    Returns read-only set of registered listeners.
  - generateEventTime
```
@RequiresNonNull(value="player")
protected AnalyticsListener.EventTime generateEventTime(Timeline timeline,
                                                                                         int windowIndex,
                                                                                         @Nullable
                                                                                         MediaSource.MediaPeriodId mediaPeriodId)
```
    Returns a new AnalyticsListener.EventTime for the specified timeline, window and media period id.

Class AnalyticsCollector

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.audio.AudioRendererEventListener

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.video.VideoRendererEventListener

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.source.MediaSourceEventListener

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AnalyticsCollector

Method Detail

addListener

removeListener

setPlayer

notifySeekStarted

resetForNewMediaSource

onMetadata

onAudioEnabled

onAudioDecoderInitialized

onAudioInputFormatChanged

onAudioSinkUnderrun

onAudioDisabled

onAudioSessionId

onAudioAttributesChanged

onVolumeChanged

onVideoEnabled

onVideoDecoderInitialized

onVideoInputFormatChanged

onDroppedFrames

onVideoDisabled

onRenderedFirstFrame

onRenderedFirstFrame

onVideoSizeChanged

onSurfaceSizeChanged

onMediaPeriodCreated

onMediaPeriodReleased

onLoadStarted

onLoadCompleted

onLoadCanceled

onLoadError

onReadingStarted

onUpstreamDiscarded

onDownstreamFormatChanged

onTimelineChanged

onTracksChanged

onLoadingChanged

onPlayerStateChanged

onRepeatModeChanged

onShuffleModeEnabledChanged

onPlayerError

onPositionDiscontinuity

onPlaybackParametersChanged

onSeekProcessed

onBandwidthSample

onDrmSessionAcquired

onDrmKeysLoaded

onDrmSessionManagerError

onDrmKeysRestored

onDrmKeysRemoved

onDrmSessionReleased

getListeners

generateEventTime