AnalyticsListener

@UnstableApi
default static final int EVENT_AUDIO_ATTRIBUTES_CHANGED = 20

Audio attributes changed.

@UnstableApi
default static final int EVENT_AUDIO_CODEC_ERROR = 1029

The audio codec encountered an error.

@UnstableApi
default static final int EVENT_AUDIO_DECODER_INITIALIZED = 1008

An audio renderer created a decoder.

@UnstableApi
default static final int EVENT_AUDIO_DECODER_RELEASED = 1012

An audio renderer released a decoder.

@UnstableApi
default static final int EVENT_AUDIO_DISABLED = 1013

An audio renderer was disabled.

@UnstableApi
default static final int EVENT_AUDIO_ENABLED = 1007

An audio renderer was enabled.

@UnstableApi
default static final int EVENT_AUDIO_INPUT_FORMAT_CHANGED = 1009

The format consumed by an audio renderer changed.

@UnstableApi
default static final int EVENT_AUDIO_POSITION_ADVANCING = 1010

The audio position has increased for the first time since the last pause or position reset.

@UnstableApi
default static final int EVENT_AUDIO_SESSION_ID = 21

An audio session id was set.

@UnstableApi
default static final int EVENT_AUDIO_SINK_ERROR = 1014

The audio sink encountered a non-fatal error.

@UnstableApi
default static final int EVENT_AUDIO_TRACK_INITIALIZED = 1031

An audio track has been initialized.

@UnstableApi
default static final int EVENT_AUDIO_TRACK_RELEASED = 1032

An audio track has been released.

@UnstableApi
default static final int EVENT_AUDIO_UNDERRUN = 1011

An audio underrun occurred.

@UnstableApi
default static final int EVENT_AVAILABLE_COMMANDS_CHANGED = 13

getAvailableCommands changed.

@UnstableApi
default static final int EVENT_BANDWIDTH_ESTIMATE = 1006

The bandwidth estimate has been updated.

@UnstableApi
default static final int EVENT_CUES = 27

getCurrentCues changed.

@UnstableApi
default static final int EVENT_DEVICE_INFO_CHANGED = 29

getDeviceInfo changed.

@UnstableApi
default static final int EVENT_DEVICE_VOLUME_CHANGED = 30

getDeviceVolume changed.

@UnstableApi
default static final int EVENT_DOWNSTREAM_FORMAT_CHANGED = 1004

The downstream format sent to renderers changed.

@UnstableApi
default static final int EVENT_DRM_KEYS_LOADED = 1023

DRM keys were loaded.

@UnstableApi
default static final int EVENT_DRM_KEYS_REMOVED = 1026

DRM keys were removed.

@UnstableApi
default static final int EVENT_DRM_KEYS_RESTORED = 1025

DRM keys were restored.

@UnstableApi
default static final int EVENT_DRM_SESSION_ACQUIRED = 1022

A DRM session has been acquired.

@UnstableApi
default static final int EVENT_DRM_SESSION_MANAGER_ERROR = 1024

A non-fatal DRM session manager error occurred.

@UnstableApi
default static final int EVENT_DRM_SESSION_RELEASED = 1027

A DRM session has been released.

@UnstableApi
default static final int EVENT_DROPPED_SEEKS_WHILE_SCRUBBING = 1034

Seeks have been dropped when scrubbing.

@UnstableApi
default static final int EVENT_DROPPED_VIDEO_FRAMES = 1018

Video frames have been dropped.

@UnstableApi
default static final int EVENT_IS_LOADING_CHANGED = 3

isLoading ()} changed.

@UnstableApi
default static final int EVENT_IS_PLAYING_CHANGED = 7

isPlaying changed.

@UnstableApi
default static final int EVENT_LOAD_CANCELED = 1002

A source canceled loading data.

@UnstableApi
default static final int EVENT_LOAD_COMPLETED = 1001

A source started completed loading data.

@UnstableApi
default static final int EVENT_LOAD_ERROR = 1003

A source had a non-fatal error loading data.

@UnstableApi
default static final int EVENT_LOAD_STARTED = 1000

A source started loading data.

@UnstableApi
default static final int EVENT_MAX_SEEK_TO_PREVIOUS_POSITION_CHANGED = 18

getMaxSeekToPreviousPosition changed.

@UnstableApi
default static final int EVENT_MEDIA_ITEM_TRANSITION = 1

getCurrentMediaItem changed or the player started repeating the current item.

@UnstableApi
default static final int EVENT_MEDIA_METADATA_CHANGED = 14

getMediaMetadata changed.

@UnstableApi
default static final int EVENT_METADATA = 28

Metadata associated with the current playback time was reported.

@UnstableApi
default static final int EVENT_PLAYBACK_PARAMETERS_CHANGED = 12

getPlaybackParameters changed.

@UnstableApi
default static final int EVENT_PLAYBACK_STATE_CHANGED = 4

getPlaybackState changed.

@UnstableApi
default static final int EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED = 6

getPlaybackSuppressionReason changed.

@UnstableApi
default static final int EVENT_PLAYER_ERROR = 10

getPlayerError changed.

@UnstableApi
default static final int EVENT_PLAYER_RELEASED = 1028

The player was released.

@UnstableApi
default static final int EVENT_PLAYLIST_METADATA_CHANGED = 15

getPlaylistMetadata changed.

@UnstableApi
default static final int EVENT_PLAY_WHEN_READY_CHANGED = 5

getPlayWhenReady changed.

@UnstableApi
default static final int EVENT_POSITION_DISCONTINUITY = 11

A position discontinuity occurred. See onPositionDiscontinuity.

@UnstableApi
default static final int EVENT_RENDERED_FIRST_FRAME = 26

The first frame has been rendered since setting the surface, since the renderer was reset or since the stream changed.

@UnstableApi
default static final int EVENT_RENDERER_READY_CHANGED = 1033

A renderer changed its readiness for playback.

@UnstableApi
default static final int EVENT_REPEAT_MODE_CHANGED = 8

getRepeatMode changed.

@UnstableApi
default static final int EVENT_SEEK_BACK_INCREMENT_CHANGED = 16

getSeekBackIncrement changed.

@UnstableApi
default static final int EVENT_SEEK_FORWARD_INCREMENT_CHANGED = 17

getSeekForwardIncrement changed.

@UnstableApi
default static final int EVENT_SHUFFLE_MODE_ENABLED_CHANGED = 9

getShuffleModeEnabled changed.

@UnstableApi
default static final int EVENT_SKIP_SILENCE_ENABLED_CHANGED = 23

Skipping silences was enabled or disabled in the audio stream.

@UnstableApi
default static final int EVENT_SURFACE_SIZE_CHANGED = 24

The surface size changed.

@UnstableApi
default static final int EVENT_TIMELINE_CHANGED = 0

getCurrentTimeline changed.

@UnstableApi
default static final int EVENT_TRACKS_CHANGED = 2

getCurrentTracks changed.

@UnstableApi
default static final int EVENT_TRACK_SELECTION_PARAMETERS_CHANGED = 19

getTrackSelectionParameters changed.

@UnstableApi
default static final int EVENT_UPSTREAM_DISCARDED = 1005

Data was removed from the end of the media buffer.

@UnstableApi
default static final int EVENT_VIDEO_CODEC_ERROR = 1030

The video codec encountered an error.

@UnstableApi
default static final int EVENT_VIDEO_DECODER_INITIALIZED = 1016

A video renderer created a decoder.

@UnstableApi
default static final int EVENT_VIDEO_DECODER_RELEASED = 1019

A video renderer released a decoder.

@UnstableApi
default static final int EVENT_VIDEO_DISABLED = 1020

A video renderer was disabled.

@UnstableApi
default static final int EVENT_VIDEO_ENABLED = 1015

A video renderer was enabled.

@UnstableApi
default static final int EVENT_VIDEO_FRAME_PROCESSING_OFFSET = 1021

Video frame processing offset data has been reported.

@UnstableApi
default static final int EVENT_VIDEO_INPUT_FORMAT_CHANGED = 1017

The format consumed by a video renderer changed.

@UnstableApi
default static final int EVENT_VIDEO_SIZE_CHANGED = 25

The video size changed.

@UnstableApi
default static final int EVENT_VOLUME_CHANGED = 22

The volume changed.

@UnstableApi
default void onAudioAttributesChanged(
    AnalyticsListener.EventTime eventTime,
    AudioAttributes audioAttributes
)

Called when the audio attributes change.

@UnstableApi
default void onAudioCodecError(
    AnalyticsListener.EventTime eventTime,
    Exception audioCodecError
)

Called when an audio decoder encounters an error.

This method being called does not indicate that playback has failed, or that it will fail. The player may be able to recover from the error. Hence applications should not implement this method to display a user visible error or initiate an application level retry. onPlayerError 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.

@UnstableApi
default void onAudioDecoderInitialized(
    AnalyticsListener.EventTime eventTime,
    String decoderName,
    long initializedTimestampMs,
    long initializationDurationMs
)

Called when an audio renderer creates a decoder.

@UnstableApi
default void onAudioDecoderReleased(
    AnalyticsListener.EventTime eventTime,
    String decoderName
)

Called when an audio renderer releases a decoder.

@UnstableApi
default void onAudioDisabled(
    AnalyticsListener.EventTime eventTime,
    DecoderCounters decoderCounters
)

Called when an audio renderer is disabled.

@UnstableApi
default void onAudioEnabled(
    AnalyticsListener.EventTime eventTime,
    DecoderCounters decoderCounters
)

Called when an audio renderer is enabled.

@UnstableApi
default void onAudioInputFormatChanged(
    AnalyticsListener.EventTime eventTime,
    Format format,
    @Nullable DecoderReuseEvaluation decoderReuseEvaluation
)

Called when the format of the media being consumed by an audio renderer changes.

@UnstableApi
default void onAudioPositionAdvancing(
    AnalyticsListener.EventTime eventTime,
    long playoutStartSystemTimeMs
)

Called when the audio position has increased for the first time since the last pause or position reset.

@UnstableApi
default void onAudioSessionIdChanged(
    AnalyticsListener.EventTime eventTime,
    int audioSessionId
)

Called when the audio session ID changes.

@UnstableApi
default void onAudioSinkError(
    AnalyticsListener.EventTime eventTime,
    Exception audioSinkError
)

Called when AudioSink has encountered an error.

This method being called does not indicate that playback has failed, or that it will fail. The player may be able to recover from the error. Hence applications should not implement this method to display a user visible error or initiate an application level retry. onPlayerError 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.

@UnstableApi
default void onAudioTrackInitialized(
    AnalyticsListener.EventTime eventTime,
    AudioSink.AudioTrackConfig audioTrackConfig
)

Called when an AudioTrack has been initialized.

@UnstableApi
default void onAudioTrackReleased(
    AnalyticsListener.EventTime eventTime,
    AudioSink.AudioTrackConfig audioTrackConfig
)

Called when an AudioTrack has been released.

@UnstableApi
default void onAudioUnderrun(
    AnalyticsListener.EventTime eventTime,
    int bufferSize,
    long bufferSizeMs,
    long elapsedSinceLastFeedMs
)

Called when an audio underrun occurs.

@UnstableApi
default void onAvailableCommandsChanged(
    AnalyticsListener.EventTime eventTime,
    Player.Commands availableCommands
)

Called when the player's available commands changed.

@UnstableApi
default void onBandwidthEstimate(
    AnalyticsListener.EventTime eventTime,
    int totalLoadTimeMs,
    long totalBytesLoaded,
    long bitrateEstimate
)

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

@UnstableApi
default void onCues(AnalyticsListener.EventTime eventTime, CueGroup cueGroup)

Called when there is a change in the CueGroup.

Both onCues and onCues are called when there is a change in the cues. You should only implement one or the other.

@UnstableApi
default void onCues(AnalyticsListener.EventTime eventTime, List<Cue> cues)

Called when there is a change in the Cues.

Both onCues and onCues are called when there is a change in the cues. You should only implement one or the other.

@UnstableApi
default void onDeviceInfoChanged(
    AnalyticsListener.EventTime eventTime,
    DeviceInfo deviceInfo
)

Called when the device information changes

@UnstableApi
default void onDeviceVolumeChanged(
    AnalyticsListener.EventTime eventTime,
    int volume,
    boolean muted
)

Called when the device volume or mute state changes.

@UnstableApi
default void onDownstreamFormatChanged(
    AnalyticsListener.EventTime eventTime,
    MediaLoadData mediaLoadData
)

Called when the downstream format sent to the renderers changed.

@UnstableApi
default void onDrmKeysLoaded(
    AnalyticsListener.EventTime eventTime,
    KeyRequestInfo keyRequestInfo
)

Called each time drm keys are loaded.

@UnstableApi
default void onDrmKeysRemoved(AnalyticsListener.EventTime eventTime)

Called each time offline drm keys are removed.

@UnstableApi
default void onDrmKeysRestored(AnalyticsListener.EventTime eventTime)

Called each time offline drm keys are restored.

@UnstableApi
default void onDrmSessionAcquired(
    AnalyticsListener.EventTime eventTime,
    @DrmSession.State int state
)

Called each time a drm session is acquired.

@UnstableApi
default void onDrmSessionManagerError(
    AnalyticsListener.EventTime eventTime,
    Exception error
)

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. Hence applications should not implement this method to display a user visible error or initiate an application level retry. 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.

@UnstableApi
default void onDrmSessionReleased(AnalyticsListener.EventTime eventTime)

Called each time a drm session is released.

@UnstableApi
default void onDroppedSeeksWhileScrubbing(
    AnalyticsListener.EventTime eventTime,
    int droppedSeeks
)

Called when seeks have been dropped while in scrubbing mode.

Seeks are dropped in scrubbing mode when at least two calls are made to seekTo while an earlier call to seekTo is still being processed (i.e. the resulting frame hasn't been rendered/released yet). The most recent seek is queued to process later and any intermediate seeks are dropped.

@UnstableApi
default void onDroppedVideoFrames(
    AnalyticsListener.EventTime eventTime,
    int droppedFrames,
    long elapsedMs
)

Called after video frames have been dropped.

@UnstableApi
default void onEvents(Player player, AnalyticsListener.Events events)

Called after one or more events occurred.

State changes and events that happen within one Looper message queue iteration are reported together and only after all individual callbacks were triggered.

Listeners should prefer this method over individual callbacks in the following cases:

• They intend to trigger the same logic for multiple events (e.g. when updating a UI for both onPlaybackStateChanged and onPlayWhenReadyChanged).
• They need access to the Player object to trigger further events (e.g. to call seekTo after a onMediaItemTransition).
• They intend to use multiple state values together or in combination with Player getter methods. For example using getCurrentMediaItemIndex with the timeline provided in onTimelineChanged is only safe from within this method.
• They are interested in events that logically happened together (e.g onPlaybackStateChanged to STATE_BUFFERING because of onMediaItemTransition).

@UnstableApi
default void onIsLoadingChanged(
    AnalyticsListener.EventTime eventTime,
    boolean isLoading
)

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

@UnstableApi
default void onIsPlayingChanged(
    AnalyticsListener.EventTime eventTime,
    boolean isPlaying
)

Called when the player starts or stops playing.

@UnstableApi
default void onLoadCanceled(
    AnalyticsListener.EventTime eventTime,
    LoadEventInfo loadEventInfo,
    MediaLoadData mediaLoadData
)

Called when a media source canceled loading data.

@UnstableApi
default void onLoadCompleted(
    AnalyticsListener.EventTime eventTime,
    LoadEventInfo loadEventInfo,
    MediaLoadData mediaLoadData
)

Called when a media source completed loading data.

@UnstableApi
default void onLoadError(
    AnalyticsListener.EventTime eventTime,
    LoadEventInfo loadEventInfo,
    MediaLoadData mediaLoadData,
    IOException error,
    boolean wasCanceled
)

Called when a media source loading error occurred.

This method being called does not indicate that playback has failed, or that it will fail. The player may be able to recover from the error. Hence applications should not implement this method to display a user visible error or initiate an application level retry. onPlayerError 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.

@UnstableApi
default void onLoadStarted(
    AnalyticsListener.EventTime eventTime,
    LoadEventInfo loadEventInfo,
    MediaLoadData mediaLoadData,
    int retryCount
)

Called when a media source started loading data.

@UnstableApi
default void onMaxSeekToPreviousPositionChanged(
    AnalyticsListener.EventTime eventTime,
    long maxSeekToPreviousPositionMs
)

Called when the maximum position for which seekToPrevious seeks to the previous window changes.

@UnstableApi
default void onMediaItemTransition(
    AnalyticsListener.EventTime eventTime,
    @Nullable MediaItem mediaItem,
    @Player.MediaItemTransitionReason int reason
)

Called when playback transitions to a different media item.

@UnstableApi
default void onMediaMetadataChanged(
    AnalyticsListener.EventTime eventTime,
    MediaMetadata mediaMetadata
)

Called when the combined MediaMetadata changes.

The provided MediaMetadata is a combination of the mediaMetadata and the static and dynamic metadata from the track selections' formats and onMetadata.

@UnstableApi
default void onMetadata(AnalyticsListener.EventTime eventTime, Metadata metadata)

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

@UnstableApi
default void onPlayWhenReadyChanged(
    AnalyticsListener.EventTime eventTime,
    boolean playWhenReady,
    @Player.PlayWhenReadyChangeReason int reason
)

Called when the value changed that indicates whether playback will proceed when ready.

@UnstableApi
default void onPlaybackParametersChanged(
    AnalyticsListener.EventTime eventTime,
    PlaybackParameters playbackParameters
)

Called when the playback parameters changed.

@UnstableApi
default void onPlaybackStateChanged(
    AnalyticsListener.EventTime eventTime,
    @Player.State int state
)

Called when the playback state changed.

@UnstableApi
default void onPlaybackSuppressionReasonChanged(
    AnalyticsListener.EventTime eventTime,
    @Player.PlaybackSuppressionReason int playbackSuppressionReason
)

Called when playback suppression reason changed.

@UnstableApi
default void onPlayerError(
    AnalyticsListener.EventTime eventTime,
    PlaybackException error
)

Called when a fatal player error occurred.

Implementations of Player may pass an instance of a subclass of PlaybackException to this method in order to include more information about the error.

@UnstableApi
default void onPlayerErrorChanged(
    AnalyticsListener.EventTime eventTime,
    @Nullable PlaybackException error
)

Called when the PlaybackException returned by getPlayerError changes.

Implementations of Player may pass an instance of a subclass of PlaybackException to this method in order to include more information about the error.

@UnstableApi
default void onPlayerReleased(AnalyticsListener.EventTime eventTime)

Called when the Player is released.

@UnstableApi
default void onPlaylistMetadataChanged(
    AnalyticsListener.EventTime eventTime,
    MediaMetadata playlistMetadata
)

Called when the playlist MediaMetadata changes.

@UnstableApi
default void onPositionDiscontinuity(
    AnalyticsListener.EventTime eventTime,
    Player.PositionInfo oldPosition,
    Player.PositionInfo newPosition,
    @Player.DiscontinuityReason int reason
)

Called when a position discontinuity occurred.

@UnstableApi
default void onRenderedFirstFrame(
    AnalyticsListener.EventTime eventTime,
    Object output,
    long renderTimeMs
)

Called when a frame is rendered for the first time since setting the surface, or since the renderer was reset, or since the stream being rendered was changed.

@UnstableApi
default void onRendererReadyChanged(
    AnalyticsListener.EventTime eventTime,
    int rendererIndex,
    @C.TrackType int rendererTrackType,
    boolean isRendererReady
)

Called each time a renderer starts or stops allowing playback to be ready.

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

Called when the repeat mode changed.

@UnstableApi
default void onSeekBackIncrementChanged(
    AnalyticsListener.EventTime eventTime,
    long seekBackIncrementMs
)

Called when the seek back increment changed.

@UnstableApi
default void onSeekForwardIncrementChanged(
    AnalyticsListener.EventTime eventTime,
    long seekForwardIncrementMs
)

Called when the seek forward increment changed.

@UnstableApi
default void onShuffleModeChanged(
    AnalyticsListener.EventTime eventTime,
    boolean shuffleModeEnabled
)

Called when the shuffle mode changed.

@UnstableApi
default void onSkipSilenceEnabledChanged(
    AnalyticsListener.EventTime eventTime,
    boolean skipSilenceEnabled
)

Called when skipping silences is enabled or disabled in the audio stream.

@UnstableApi
default void onSurfaceSizeChanged(
    AnalyticsListener.EventTime eventTime,
    int width,
    int height
)

Called when the output surface size changed.

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

Called when the timeline changed.

@UnstableApi
default void onTrackSelectionParametersChanged(
    AnalyticsListener.EventTime eventTime,
    TrackSelectionParameters trackSelectionParameters
)

Called when track selection parameters change.

@UnstableApi
default void onTracksChanged(AnalyticsListener.EventTime eventTime, Tracks tracks)

Called when the tracks change.

@UnstableApi
default void onUpstreamDiscarded(
    AnalyticsListener.EventTime eventTime,
    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.

@UnstableApi
default void onVideoCodecError(
    AnalyticsListener.EventTime eventTime,
    Exception videoCodecError
)

Called when a video decoder encounters an error.

This method being called does not indicate that playback has failed, or that it will fail. The player may be able to recover from the error. Hence applications should not implement this method to display a user visible error or initiate an application level retry. onPlayerError 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.

@UnstableApi
default void onVideoDecoderInitialized(
    AnalyticsListener.EventTime eventTime,
    String decoderName,
    long initializedTimestampMs,
    long initializationDurationMs
)

Called when a video renderer creates a decoder.

@UnstableApi
default void onVideoDecoderReleased(
    AnalyticsListener.EventTime eventTime,
    String decoderName
)

Called when a video renderer releases a decoder.

@UnstableApi
default void onVideoDisabled(
    AnalyticsListener.EventTime eventTime,
    DecoderCounters decoderCounters
)

Called when a video renderer is disabled.

@UnstableApi
default void onVideoEnabled(
    AnalyticsListener.EventTime eventTime,
    DecoderCounters decoderCounters
)

Called when a video renderer is enabled.

@UnstableApi
default void onVideoFrameProcessingOffset(
    AnalyticsListener.EventTime eventTime,
    long totalProcessingOffsetUs,
    int frameCount
)

Called when there is an update to the video frame processing offset reported by a video renderer.

The processing offset for a video frame is the difference between the time at which the frame became available to render, and the time at which it was scheduled to be rendered. A positive value indicates the frame became available early enough, whereas a negative value indicates that the frame wasn't available until after the time at which it should have been rendered.

@UnstableApi
default void onVideoInputFormatChanged(
    AnalyticsListener.EventTime eventTime,
    Format format,
    @Nullable DecoderReuseEvaluation decoderReuseEvaluation
)

Called when the format of the media being consumed by a video renderer changes.

@UnstableApi
default void onVideoSizeChanged(
    AnalyticsListener.EventTime eventTime,
    VideoSize videoSize
)

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.

@UnstableApi
default void onVolumeChanged(AnalyticsListener.EventTime eventTime, float volume)

Called when the volume changes.