com.google.android.exoplayer2.util

Class EventLogger

java.lang.Object

com.google.android.exoplayer2.util.EventLogger

All Implemented Interfaces:

AudioRendererEventListener, DefaultDrmSessionManager.EventListener, MetadataOutput, Player.EventListener, AdsMediaSource.EventListener, MediaSourceEventListener, VideoRendererEventListener

public class EventLogger
extends java.lang.Object
implements Player.EventListener, MetadataOutput, AudioRendererEventListener, VideoRendererEventListener, MediaSourceEventListener, AdsMediaSource.EventListener, DefaultDrmSessionManager.EventListener

Logs events from Player and other core components using Log.

Nested Class Summary

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

Constructor Summary

Constructors

Constructor and Description
EventLogger(MappingTrackSelector trackSelector)

Method Summary

Modifier and Type	Method and Description
void	onAdClicked() Called when the user clicks through an ad (for example, following a 'learn more' link).
void	onAdLoadError(java.io.IOException error) Called if there was an error loading one or more ads.
void	onAdTapped() Called when the user taps a non-clickthrough part of an ad.
void	onAudioDecoderInitialized(java.lang.String decoderName, long elapsedRealtimeMs, 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	onDownstreamFormatChanged(int trackType, Format trackFormat, int trackSelectionReason, java.lang.Object trackSelectionData, long mediaTimeMs) 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	onDrmSessionManagerError(java.lang.Exception e) Called when a drm error occurs.
void	onDroppedFrames(int count, long elapsed) Called to report the number of frames dropped by the renderer.
void	onInternalAdLoadError(java.lang.RuntimeException error) Called when an unexpected internal error is encountered while loading ads.
void	onLoadCanceled(DataSpec dataSpec, int dataType, int trackType, Format trackFormat, int trackSelectionReason, java.lang.Object trackSelectionData, long mediaStartTimeMs, long mediaEndTimeMs, long elapsedRealtimeMs, long loadDurationMs, long bytesLoaded) Called when a load is canceled.
void	onLoadCompleted(DataSpec dataSpec, int dataType, int trackType, Format trackFormat, int trackSelectionReason, java.lang.Object trackSelectionData, long mediaStartTimeMs, long mediaEndTimeMs, long elapsedRealtimeMs, long loadDurationMs, long bytesLoaded) Called when a load ends.
void	onLoadError(DataSpec dataSpec, int dataType, int trackType, Format trackFormat, int trackSelectionReason, java.lang.Object trackSelectionData, long mediaStartTimeMs, long mediaEndTimeMs, long elapsedRealtimeMs, long loadDurationMs, long bytesLoaded, 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(DataSpec dataSpec, int dataType, int trackType, Format trackFormat, int trackSelectionReason, java.lang.Object trackSelectionData, long mediaStartTimeMs, long mediaEndTimeMs, long elapsedRealtimeMs) Called when a load begins.
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 e) Called when an error occurs.
void	onPlayerStateChanged(boolean playWhenReady, int state) 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	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	onTimelineChanged(Timeline timeline, java.lang.Object manifest, int reason) Called when the timeline and/or manifest has been refreshed.
void	onTracksChanged(TrackGroupArray ignored, TrackSelectionArray trackSelections) Called when the available or selected tracks change.
void	onUpstreamDiscarded(int trackType, long mediaStartTimeMs, long mediaEndTimeMs) 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 elapsedRealtimeMs, 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.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventLogger

public EventLogger(MappingTrackSelector trackSelector)

Method Detail

onLoadingChanged

public 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 void onPlayerStateChanged(boolean playWhenReady,
                                 int state)

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.

state - One of the STATE constants.

onRepeatModeChanged

public void onRepeatModeChanged(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 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.

onPositionDiscontinuity

public void onPositionDiscontinuity(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 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.

onTimelineChanged

public void onTimelineChanged(Timeline timeline,
                              java.lang.Object manifest,
                              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.

onPlayerError

public void onPlayerError(ExoPlaybackException e)

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:

e - The error.

onTracksChanged

public void onTracksChanged(TrackGroupArray ignored,
                            TrackSelectionArray trackSelections)

Description copied from interface: Player.EventListener

Called when the available or selected tracks change.

Specified by:

onTracksChanged in interface Player.EventListener

Parameters:

ignored - 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.

onSeekProcessed

public 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

onMetadata

public 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 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.

onAudioSessionId

public void onAudioSessionId(int audioSessionId)

Description copied from interface: AudioRendererEventListener

Called when the audio session is set.

Specified by:

onAudioSessionId in interface AudioRendererEventListener

Parameters:

audioSessionId - The audio session id.

onAudioDecoderInitialized

public void onAudioDecoderInitialized(java.lang.String decoderName,
                                      long elapsedRealtimeMs,
                                      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.

elapsedRealtimeMs - SystemClock.elapsedRealtime() when initialization finished.

initializationDurationMs - The time taken to initialize the decoder in milliseconds.

onAudioInputFormatChanged

public 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.

onAudioDisabled

public 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.

onAudioSinkUnderrun

public 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.

onVideoEnabled

public 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 void onVideoDecoderInitialized(java.lang.String decoderName,
                                      long elapsedRealtimeMs,
                                      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.

elapsedRealtimeMs - SystemClock.elapsedRealtime() when initialization finished.

initializationDurationMs - The time taken to initialize the decoder in milliseconds.

onVideoInputFormatChanged

public 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.

onVideoDisabled

public 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.

onDroppedFrames

public void onDroppedFrames(int count,
                            long elapsed)

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.

elapsed - 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(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 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.

onRenderedFirstFrame

public void onRenderedFirstFrame(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.

onDrmSessionManagerError

public void onDrmSessionManagerError(java.lang.Exception e)

Description copied from interface: DefaultDrmSessionManager.EventListener

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 DefaultDrmSessionManager.EventListener

Parameters:

e - The corresponding exception.

onDrmKeysRestored

public void onDrmKeysRestored()

Description copied from interface: DefaultDrmSessionManager.EventListener

Called each time offline keys are restored.

Specified by:

onDrmKeysRestored in interface DefaultDrmSessionManager.EventListener

onDrmKeysRemoved

public void onDrmKeysRemoved()

Description copied from interface: DefaultDrmSessionManager.EventListener

Called each time offline keys are removed.

Specified by:

onDrmKeysRemoved in interface DefaultDrmSessionManager.EventListener

onDrmKeysLoaded

public void onDrmKeysLoaded()

Description copied from interface: DefaultDrmSessionManager.EventListener

Called each time keys are loaded.

Specified by:

onDrmKeysLoaded in interface DefaultDrmSessionManager.EventListener

onLoadStarted

public void onLoadStarted(DataSpec dataSpec,
                          int dataType,
                          int trackType,
                          Format trackFormat,
                          int trackSelectionReason,
                          java.lang.Object trackSelectionData,
                          long mediaStartTimeMs,
                          long mediaEndTimeMs,
                          long elapsedRealtimeMs)

Description copied from interface: MediaSourceEventListener

Called when a load begins.

Specified by:

onLoadStarted in interface MediaSourceEventListener

Parameters:

dataSpec - Defines the data being loaded.

dataType - One of the C DATA_TYPE_* constants defining the type of data being loaded.

trackType - One of the C TRACK_TYPE_* constants if the data corresponds to media of a specific type. C.TRACK_TYPE_UNKNOWN otherwise.

trackFormat - The format of the track to which the data belongs. Null if the data does not belong to a track.

trackSelectionReason - One of the C SELECTION_REASON_* constants if the data belongs to a track. C.SELECTION_REASON_UNKNOWN otherwise.

trackSelectionData - Optional data associated with the selection of the track to which the data belongs. Null if the data does not belong to a track.

mediaStartTimeMs - The start time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

mediaEndTimeMs - The end time of the media being loaded, or C.TIME_UNSET if the load is not for media data or the end time is unknown.

elapsedRealtimeMs - The value of SystemClock.elapsedRealtime() when the load began.

onLoadError

public void onLoadError(DataSpec dataSpec,
                        int dataType,
                        int trackType,
                        Format trackFormat,
                        int trackSelectionReason,
                        java.lang.Object trackSelectionData,
                        long mediaStartTimeMs,
                        long mediaEndTimeMs,
                        long elapsedRealtimeMs,
                        long loadDurationMs,
                        long bytesLoaded,
                        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(com.google.android.exoplayer2.upstream.DataSpec, int, int, com.google.android.exoplayer2.Format, int, java.lang.Object, long, long, long, long, long) 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:

dataSpec - Defines the data being loaded.

dataType - One of the C DATA_TYPE_* constants defining the type of data being loaded.

trackType - One of the C TRACK_TYPE_* constants if the data corresponds to media of a specific type. C.TRACK_TYPE_UNKNOWN otherwise.

trackFormat - The format of the track to which the data belongs. Null if the data does not belong to a track.

trackSelectionReason - One of the C SELECTION_REASON_* constants if the data belongs to a track. C.SELECTION_REASON_UNKNOWN otherwise.

trackSelectionData - Optional data associated with the selection of the track to which the data belongs. Null if the data does not belong to a track.

mediaStartTimeMs - The start time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

mediaEndTimeMs - The end time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

elapsedRealtimeMs - The value of SystemClock.elapsedRealtime() when the error occurred.

loadDurationMs - The duration of the load up to the point at which the error occurred.

bytesLoaded - The number of bytes that were loaded prior to the error.

error - The load error.

wasCanceled - Whether the load was canceled as a result of the error.

onLoadCanceled

public void onLoadCanceled(DataSpec dataSpec,
                           int dataType,
                           int trackType,
                           Format trackFormat,
                           int trackSelectionReason,
                           java.lang.Object trackSelectionData,
                           long mediaStartTimeMs,
                           long mediaEndTimeMs,
                           long elapsedRealtimeMs,
                           long loadDurationMs,
                           long bytesLoaded)

Description copied from interface: MediaSourceEventListener

Called when a load is canceled.

Specified by:

onLoadCanceled in interface MediaSourceEventListener

Parameters:

dataSpec - Defines the data being loaded.

dataType - One of the C DATA_TYPE_* constants defining the type of data being loaded.

trackType - One of the C TRACK_TYPE_* constants if the data corresponds to media of a specific type. C.TRACK_TYPE_UNKNOWN otherwise.

trackFormat - The format of the track to which the data belongs. Null if the data does not belong to a track.

trackSelectionReason - One of the C SELECTION_REASON_* constants if the data belongs to a track. C.SELECTION_REASON_UNKNOWN otherwise.

trackSelectionData - Optional data associated with the selection of the track to which the data belongs. Null if the data does not belong to a track.

mediaStartTimeMs - The start time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

mediaEndTimeMs - The end time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

elapsedRealtimeMs - The value of SystemClock.elapsedRealtime() when the load was canceled.

loadDurationMs - The duration of the load up to the point at which it was canceled.

bytesLoaded - The number of bytes that were loaded prior to cancelation.

onLoadCompleted

public void onLoadCompleted(DataSpec dataSpec,
                            int dataType,
                            int trackType,
                            Format trackFormat,
                            int trackSelectionReason,
                            java.lang.Object trackSelectionData,
                            long mediaStartTimeMs,
                            long mediaEndTimeMs,
                            long elapsedRealtimeMs,
                            long loadDurationMs,
                            long bytesLoaded)

Description copied from interface: MediaSourceEventListener

Called when a load ends.

Specified by:

onLoadCompleted in interface MediaSourceEventListener

Parameters:

dataSpec - Defines the data being loaded.

dataType - One of the C DATA_TYPE_* constants defining the type of data being loaded.

trackType - One of the C TRACK_TYPE_* constants if the data corresponds to media of a specific type. C.TRACK_TYPE_UNKNOWN otherwise.

trackFormat - The format of the track to which the data belongs. Null if the data does not belong to a track.

trackSelectionReason - One of the C SELECTION_REASON_* constants if the data belongs to a track. C.SELECTION_REASON_UNKNOWN otherwise.

trackSelectionData - Optional data associated with the selection of the track to which the data belongs. Null if the data does not belong to a track.

mediaStartTimeMs - The start time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

mediaEndTimeMs - The end time of the media being loaded, or C.TIME_UNSET if the load is not for media data.

elapsedRealtimeMs - The value of SystemClock.elapsedRealtime() when the load ended.

loadDurationMs - The duration of the load.

bytesLoaded - The number of bytes that were loaded.

onUpstreamDiscarded

public void onUpstreamDiscarded(int trackType,
                                long mediaStartTimeMs,
                                long mediaEndTimeMs)

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:

trackType - The type of the media. One of the C TRACK_TYPE_* constants.

mediaStartTimeMs - The start time of the media being discarded.

mediaEndTimeMs - The end time of the media being discarded.

onDownstreamFormatChanged

public void onDownstreamFormatChanged(int trackType,
                                      Format trackFormat,
                                      int trackSelectionReason,
                                      java.lang.Object trackSelectionData,
                                      long mediaTimeMs)

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:

trackType - The type of the media. One of the C TRACK_TYPE_* constants.

trackFormat - The format of the track to which the data belongs. Null if the data does not belong to a track.

trackSelectionReason - One of the C SELECTION_REASON_* constants if the data belongs to a track. C.SELECTION_REASON_UNKNOWN otherwise.

trackSelectionData - Optional data associated with the selection of the track to which the data belongs. Null if the data does not belong to a track.

mediaTimeMs - The media time at which the change occurred.

onAdLoadError

public void onAdLoadError(java.io.IOException error)

Description copied from interface: AdsMediaSource.EventListener

Called if there was an error loading one or more ads. The loader will skip the problematic ad(s).

Specified by:

onAdLoadError in interface AdsMediaSource.EventListener

Parameters:

error - The error.

onInternalAdLoadError

public void onInternalAdLoadError(java.lang.RuntimeException error)

Description copied from interface: AdsMediaSource.EventListener

Called when an unexpected internal error is encountered while loading ads. The loader will skip all remaining ads, as the error is not recoverable.

Specified by:

onInternalAdLoadError in interface AdsMediaSource.EventListener

Parameters:

error - The error.

onAdClicked

public void onAdClicked()

Description copied from interface: AdsMediaSource.EventListener

Called when the user clicks through an ad (for example, following a 'learn more' link).

Specified by:

onAdClicked in interface AdsMediaSource.EventListener

onAdTapped

public void onAdTapped()

Description copied from interface: AdsMediaSource.EventListener

Called when the user taps a non-clickthrough part of an ad.

Specified by:

onAdTapped in interface AdsMediaSource.EventListener