com.google.android.exoplayer2.util

Class EventLogger

java.lang.Object

com.google.android.exoplayer2.util.EventLogger

All Implemented Interfaces:

AnalyticsListener

public class EventLogger
extends java.lang.Object
implements AnalyticsListener

Logs events from Player and other core components using Log.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.analytics.AnalyticsListener

AnalyticsListener.EventTime

Constructor Summary

Constructors

Constructor and Description
EventLogger(MappingTrackSelector trackSelector) Creates event logger.
EventLogger(MappingTrackSelector trackSelector, java.lang.String tag) Creates event logger.

Method Summary

Modifier and Type	Method and Description
protected void	logd(java.lang.String msg) Logs a debug message.
protected void	loge(java.lang.String msg, java.lang.Throwable tr) Logs an error message and exception.
void	onAudioSessionId(AnalyticsListener.EventTime eventTime, int audioSessionId) Called when the audio session id is set.
void	onAudioUnderrun(AnalyticsListener.EventTime eventTime, int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs) Called when an audio underrun occurred.
void	onBandwidthEstimate(AnalyticsListener.EventTime eventTime, int totalLoadTimeMs, long totalBytesLoaded, long bitrateEstimate) Called when the bandwidth estimate for the current data source has been updated.
void	onDecoderDisabled(AnalyticsListener.EventTime eventTime, int trackType, DecoderCounters counters) Called when an audio or video decoder has been disabled.
void	onDecoderEnabled(AnalyticsListener.EventTime eventTime, int trackType, DecoderCounters counters) Called when an audio or video decoder has been enabled.
void	onDecoderInitialized(AnalyticsListener.EventTime eventTime, int trackType, java.lang.String decoderName, long initializationDurationMs) Called when an audio or video decoder has been initialized.
void	onDecoderInputFormatChanged(AnalyticsListener.EventTime eventTime, int trackType, Format format) Called when an audio or video decoder input format changed.
void	onDownstreamFormatChanged(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.MediaLoadData mediaLoadData) Called when the downstream format sent to the renderers changed.
void	onDrmKeysLoaded(AnalyticsListener.EventTime eventTime) Called each time drm keys are loaded.
void	onDrmKeysRemoved(AnalyticsListener.EventTime eventTime) Called each time offline drm keys are removed.
void	onDrmKeysRestored(AnalyticsListener.EventTime eventTime) Called each time offline drm keys are restored.
void	onDrmSessionAcquired(AnalyticsListener.EventTime eventTime) Called each time a drm session is acquired.
void	onDrmSessionManagerError(AnalyticsListener.EventTime eventTime, java.lang.Exception e) Called when a drm error occurs.
void	onDrmSessionReleased(AnalyticsListener.EventTime eventTime) Called each time a drm session is released.
void	onDroppedVideoFrames(AnalyticsListener.EventTime eventTime, int count, long elapsedMs) Called after video frames have been dropped.
void	onLoadCanceled(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData) Called when a media source canceled loading data.
void	onLoadCompleted(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData) Called when a media source completed loading data.
void	onLoadError(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData, java.io.IOException error, boolean wasCanceled) Called when a media source loading error occurred.
void	onLoadingChanged(AnalyticsListener.EventTime eventTime, boolean isLoading) Called when the player starts or stops loading data from a source.
void	onLoadStarted(AnalyticsListener.EventTime eventTime, MediaSourceEventListener.LoadEventInfo loadEventInfo, MediaSourceEventListener.MediaLoadData mediaLoadData) Called when a media source started loading data.
void	onMediaPeriodCreated(AnalyticsListener.EventTime eventTime) Called when a media source created a media period.
void	onMediaPeriodReleased(AnalyticsListener.EventTime eventTime) Called when a media source released a media period.
void	onMetadata(AnalyticsListener.EventTime eventTime, Metadata metadata) Called when there is Metadata associated with the current playback time.
void	onPlaybackParametersChanged(AnalyticsListener.EventTime eventTime, PlaybackParameters playbackParameters) Called when the playback parameters changed.
void	onPlayerError(AnalyticsListener.EventTime eventTime, ExoPlaybackException e) Called when a fatal player error occurred.
void	onPlayerStateChanged(AnalyticsListener.EventTime eventTime, boolean playWhenReady, int state) Called when the player state changed.
void	onPositionDiscontinuity(AnalyticsListener.EventTime eventTime, int reason) Called when a position discontinuity occurred.
void	onReadingStarted(AnalyticsListener.EventTime eventTime) Called when the player started reading a media period.
void	onRenderedFirstFrame(AnalyticsListener.EventTime eventTime, 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(AnalyticsListener.EventTime eventTime, int repeatMode) Called when the repeat mode changed.
void	onSeekProcessed(AnalyticsListener.EventTime eventTime) Called when a seek operation was processed.
void	onSeekStarted(AnalyticsListener.EventTime eventTime) Called when a seek operation started.
void	onShuffleModeChanged(AnalyticsListener.EventTime eventTime, boolean shuffleModeEnabled) Called when the shuffle mode changed.
void	onSurfaceSizeChanged(AnalyticsListener.EventTime eventTime, int width, int height) Called when the output surface size changed.
void	onTimelineChanged(AnalyticsListener.EventTime eventTime, int reason) Called when the timeline changed.
void	onTracksChanged(AnalyticsListener.EventTime eventTime, TrackGroupArray ignored, TrackSelectionArray trackSelections) Called when the available or selected tracks for the renderers changed.
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.
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.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.android.exoplayer2.analytics.AnalyticsListener

onAudioAttributesChanged, onVolumeChanged

Constructor Detail

EventLogger

public EventLogger(@Nullable
                   MappingTrackSelector trackSelector)

Creates event logger.

Parameters:

trackSelector - The mapping track selector used by the player. May be null if detailed logging of track mapping is not required.

EventLogger

public EventLogger(@Nullable
                   MappingTrackSelector trackSelector,
                   java.lang.String tag)

Creates event logger.

Parameters:

trackSelector - The mapping track selector used by the player. May be null if detailed logging of track mapping is not required.

tag - The tag used for logging.

Method Detail

onLoadingChanged

public void onLoadingChanged(AnalyticsListener.EventTime eventTime,
                             boolean isLoading)

Description copied from interface: AnalyticsListener

Called when the player starts or stops loading data from a source.

Specified by:

onLoadingChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

isLoading - Whether the player is loading.

onPlayerStateChanged

public void onPlayerStateChanged(AnalyticsListener.EventTime eventTime,
                                 boolean playWhenReady,
                                 int state)

Description copied from interface: AnalyticsListener

Called when the player state changed.

Specified by:

onPlayerStateChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

playWhenReady - Whether the playback will proceed when ready.

state - One of the Player.STATE constants.

onRepeatModeChanged

public void onRepeatModeChanged(AnalyticsListener.EventTime eventTime,
                                @Player.RepeatMode
                                int repeatMode)

Description copied from interface: AnalyticsListener

Called when the repeat mode changed.

Specified by:

onRepeatModeChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

repeatMode - The new repeat mode.

onShuffleModeChanged

public void onShuffleModeChanged(AnalyticsListener.EventTime eventTime,
                                 boolean shuffleModeEnabled)

Description copied from interface: AnalyticsListener

Called when the shuffle mode changed.

Specified by:

onShuffleModeChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

shuffleModeEnabled - Whether the shuffle mode is enabled.

onPositionDiscontinuity

public void onPositionDiscontinuity(AnalyticsListener.EventTime eventTime,
                                    @Player.DiscontinuityReason
                                    int reason)

Description copied from interface: AnalyticsListener

Called when a position discontinuity occurred.

Specified by:

onPositionDiscontinuity in interface AnalyticsListener

Parameters:

eventTime - The event time.

reason - The reason for the position discontinuity.

onSeekStarted

public void onSeekStarted(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called when a seek operation started.

Specified by:

onSeekStarted in interface AnalyticsListener

Parameters:

eventTime - The event time.

onPlaybackParametersChanged

public void onPlaybackParametersChanged(AnalyticsListener.EventTime eventTime,
                                        PlaybackParameters playbackParameters)

Description copied from interface: AnalyticsListener

Called when the playback parameters changed.

Specified by:

onPlaybackParametersChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

playbackParameters - The new playback parameters.

onTimelineChanged

public void onTimelineChanged(AnalyticsListener.EventTime eventTime,
                              @Player.TimelineChangeReason
                              int reason)

Description copied from interface: AnalyticsListener

Called when the timeline changed.

Specified by:

onTimelineChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

reason - The reason for the timeline change.

onPlayerError

public void onPlayerError(AnalyticsListener.EventTime eventTime,
                          ExoPlaybackException e)

Description copied from interface: AnalyticsListener

Called when a fatal player error occurred.

Specified by:

onPlayerError in interface AnalyticsListener

Parameters:

eventTime - The event time.

e - The error.

onTracksChanged

public void onTracksChanged(AnalyticsListener.EventTime eventTime,
                            TrackGroupArray ignored,
                            TrackSelectionArray trackSelections)

Description copied from interface: AnalyticsListener

Called when the available or selected tracks for the renderers changed.

Specified by:

onTracksChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

ignored - The available tracks. May be empty.

trackSelections - The track selections for each renderer. May contain null elements.

onSeekProcessed

public void onSeekProcessed(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called when a seek operation was processed.

Specified by:

onSeekProcessed in interface AnalyticsListener

Parameters:

eventTime - The event time.

onMetadata

public void onMetadata(AnalyticsListener.EventTime eventTime,
                       Metadata metadata)

Description copied from interface: AnalyticsListener

Called when there is Metadata associated with the current playback time.

Specified by:

onMetadata in interface AnalyticsListener

Parameters:

eventTime - The event time.

metadata - The metadata.

onDecoderEnabled

public void onDecoderEnabled(AnalyticsListener.EventTime eventTime,
                             int trackType,
                             DecoderCounters counters)

Description copied from interface: AnalyticsListener

Called when an audio or video decoder has been enabled.

Specified by:

onDecoderEnabled in interface AnalyticsListener

Parameters:

eventTime - The event time.

trackType - The track type of the enabled decoder. Either C.TRACK_TYPE_AUDIO or C.TRACK_TYPE_VIDEO.

counters - The accumulated event counters associated with this decoder.

onAudioSessionId

public void onAudioSessionId(AnalyticsListener.EventTime eventTime,
                             int audioSessionId)

Description copied from interface: AnalyticsListener

Called when the audio session id is set.

Specified by:

onAudioSessionId in interface AnalyticsListener

Parameters:

eventTime - The event time.

audioSessionId - The audio session id.

onDecoderInitialized

public void onDecoderInitialized(AnalyticsListener.EventTime eventTime,
                                 int trackType,
                                 java.lang.String decoderName,
                                 long initializationDurationMs)

Description copied from interface: AnalyticsListener

Called when an audio or video decoder has been initialized.

Specified by:

onDecoderInitialized in interface AnalyticsListener

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

public void onDecoderInputFormatChanged(AnalyticsListener.EventTime eventTime,
                                        int trackType,
                                        Format format)

Description copied from interface: AnalyticsListener

Called when an audio or video decoder input format changed.

Specified by:

onDecoderInputFormatChanged in interface AnalyticsListener

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

public void onDecoderDisabled(AnalyticsListener.EventTime eventTime,
                              int trackType,
                              DecoderCounters counters)

Description copied from interface: AnalyticsListener

Called when an audio or video decoder has been disabled.

Specified by:

onDecoderDisabled in interface AnalyticsListener

Parameters:

eventTime - The event time.

trackType - The track type of the disabled decoder. Either C.TRACK_TYPE_AUDIO or C.TRACK_TYPE_VIDEO.

counters - The accumulated event counters associated with this decoder.

onAudioUnderrun

public void onAudioUnderrun(AnalyticsListener.EventTime eventTime,
                            int bufferSize,
                            long bufferSizeMs,
                            long elapsedSinceLastFeedMs)

Description copied from interface: AnalyticsListener

Called when an audio underrun occurred.

Specified by:

onAudioUnderrun in interface AnalyticsListener

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

public void onDroppedVideoFrames(AnalyticsListener.EventTime eventTime,
                                 int count,
                                 long elapsedMs)

Description copied from interface: AnalyticsListener

Called after video frames have been dropped.

Specified by:

onDroppedVideoFrames in interface AnalyticsListener

Parameters:

eventTime - The event time.

count - 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

public void onVideoSizeChanged(AnalyticsListener.EventTime eventTime,
                               int width,
                               int height,
                               int unappliedRotationDegrees,
                               float pixelWidthHeightRatio)

Description copied from interface: AnalyticsListener

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.

Specified by:

onVideoSizeChanged in interface AnalyticsListener

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

public void onRenderedFirstFrame(AnalyticsListener.EventTime eventTime,
                                 @Nullable
                                 android.view.Surface surface)

Description copied from interface: AnalyticsListener

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 AnalyticsListener

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.

onMediaPeriodCreated

public void onMediaPeriodCreated(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called when a media source created a media period.

Specified by:

onMediaPeriodCreated in interface AnalyticsListener

Parameters:

eventTime - The event time.

onMediaPeriodReleased

public void onMediaPeriodReleased(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called when a media source released a media period.

Specified by:

onMediaPeriodReleased in interface AnalyticsListener

Parameters:

eventTime - The event time.

onLoadStarted

public void onLoadStarted(AnalyticsListener.EventTime eventTime,
                          MediaSourceEventListener.LoadEventInfo loadEventInfo,
                          MediaSourceEventListener.MediaLoadData mediaLoadData)

Description copied from interface: AnalyticsListener

Called when a media source started loading data.

Specified by:

onLoadStarted in interface AnalyticsListener

Parameters:

eventTime - The event time.

loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.

mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.

onLoadError

public void onLoadError(AnalyticsListener.EventTime eventTime,
                        MediaSourceEventListener.LoadEventInfo loadEventInfo,
                        MediaSourceEventListener.MediaLoadData mediaLoadData,
                        java.io.IOException error,
                        boolean wasCanceled)

Description copied from interface: AnalyticsListener

Called when a media source loading error occurred. These errors are just for informational purposes and the player may recover.

Specified by:

onLoadError in interface AnalyticsListener

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.

onLoadCanceled

public void onLoadCanceled(AnalyticsListener.EventTime eventTime,
                           MediaSourceEventListener.LoadEventInfo loadEventInfo,
                           MediaSourceEventListener.MediaLoadData mediaLoadData)

Description copied from interface: AnalyticsListener

Called when a media source canceled loading data.

Specified by:

onLoadCanceled in interface AnalyticsListener

Parameters:

eventTime - The event time.

loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.

mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.

onLoadCompleted

public void onLoadCompleted(AnalyticsListener.EventTime eventTime,
                            MediaSourceEventListener.LoadEventInfo loadEventInfo,
                            MediaSourceEventListener.MediaLoadData mediaLoadData)

Description copied from interface: AnalyticsListener

Called when a media source completed loading data.

Specified by:

onLoadCompleted in interface AnalyticsListener

Parameters:

eventTime - The event time.

loadEventInfo - The MediaSourceEventListener.LoadEventInfo defining the load event.

mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the data being loaded.

onReadingStarted

public void onReadingStarted(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called when the player started reading a media period.

Specified by:

onReadingStarted in interface AnalyticsListener

Parameters:

eventTime - The event time.

onBandwidthEstimate

public void onBandwidthEstimate(AnalyticsListener.EventTime eventTime,
                                int totalLoadTimeMs,
                                long totalBytesLoaded,
                                long bitrateEstimate)

Description copied from interface: AnalyticsListener

Called when the bandwidth estimate for the current data source has been updated.

Specified by:

onBandwidthEstimate in interface AnalyticsListener

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

public void onSurfaceSizeChanged(AnalyticsListener.EventTime eventTime,
                                 int width,
                                 int height)

Description copied from interface: AnalyticsListener

Called when the output surface size changed.

Specified by:

onSurfaceSizeChanged in interface AnalyticsListener

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.

onUpstreamDiscarded

public void onUpstreamDiscarded(AnalyticsListener.EventTime eventTime,
                                MediaSourceEventListener.MediaLoadData mediaLoadData)

Description copied from interface: AnalyticsListener

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 AnalyticsListener

Parameters:

eventTime - The event time.

mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the media being discarded.

onDownstreamFormatChanged

public void onDownstreamFormatChanged(AnalyticsListener.EventTime eventTime,
                                      MediaSourceEventListener.MediaLoadData mediaLoadData)

Description copied from interface: AnalyticsListener

Called when the downstream format sent to the renderers changed.

Specified by:

onDownstreamFormatChanged in interface AnalyticsListener

Parameters:

eventTime - The event time.

mediaLoadData - The MediaSourceEventListener.MediaLoadData defining the newly selected media data.

onDrmSessionAcquired

public void onDrmSessionAcquired(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called each time a drm session is acquired.

Specified by:

onDrmSessionAcquired in interface AnalyticsListener

Parameters:

eventTime - The event time.

onDrmSessionManagerError

public void onDrmSessionManagerError(AnalyticsListener.EventTime eventTime,
                                     java.lang.Exception e)

Description copied from interface: AnalyticsListener

Called when a drm error occurs. These errors are just for informational purposes and the player may recover.

Specified by:

onDrmSessionManagerError in interface AnalyticsListener

Parameters:

eventTime - The event time.

e - The error.

onDrmKeysRestored

public void onDrmKeysRestored(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called each time offline drm keys are restored.

Specified by:

onDrmKeysRestored in interface AnalyticsListener

Parameters:

eventTime - The event time.

onDrmKeysRemoved

public void onDrmKeysRemoved(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called each time offline drm keys are removed.

Specified by:

onDrmKeysRemoved in interface AnalyticsListener

Parameters:

eventTime - The event time.

onDrmKeysLoaded

public void onDrmKeysLoaded(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called each time drm keys are loaded.

Specified by:

onDrmKeysLoaded in interface AnalyticsListener

Parameters:

eventTime - The event time.

onDrmSessionReleased

public void onDrmSessionReleased(AnalyticsListener.EventTime eventTime)

Description copied from interface: AnalyticsListener

Called each time a drm session is released.

Specified by:

onDrmSessionReleased in interface AnalyticsListener

Parameters:

eventTime - The event time.

logd

protected void logd(java.lang.String msg)

Logs a debug message.

Parameters:

msg - The message to log.

loge

protected void loge(java.lang.String msg,
                    @Nullable
                    java.lang.Throwable tr)

Logs an error message and exception.

Parameters:

msg - The message to log.

tr - The exception to log.