EventLogger

Artifact: androidx.media3:media3-exoplayer

Kotlin |Java

public class EventLogger implements AnalyticsListener

Logs events from Player and other core components using Log.

Summary

Public constructors
`EventLogger()` Creates an instance.
`EventLogger(String tag)` Creates an instance.
`@UnstableApi EventLogger(@Nullable MappingTrackSelector trackSelector)` This method is deprecated. Use `EventLogger`
`@UnstableApi EventLogger(@Nullable MappingTrackSelector trackSelector, String tag)` This method is deprecated. Use `EventLogger`

Public methods
`void`	`@UnstableApi onAudioAttributesChanged( AnalyticsListener.EventTime eventTime, AudioAttributes audioAttributes )` Called when the audio attributes change.
`void`	`@UnstableApi onAudioDecoderInitialized( AnalyticsListener.EventTime eventTime, String decoderName, long initializedTimestampMs, long initializationDurationMs )` Called when an audio renderer creates a decoder.
`void`	`@UnstableApi onAudioDecoderReleased( AnalyticsListener.EventTime eventTime, String decoderName )` Called when an audio renderer releases a decoder.
`void`	`@UnstableApi onAudioDisabled( AnalyticsListener.EventTime eventTime, DecoderCounters decoderCounters )` Called when an audio renderer is disabled.
`void`	`@UnstableApi onAudioEnabled( AnalyticsListener.EventTime eventTime, DecoderCounters decoderCounters )` Called when an audio renderer is enabled.
`void`	`@UnstableApi onAudioInputFormatChanged( AnalyticsListener.EventTime eventTime, Format format, @Nullable DecoderReuseEvaluation decoderReuseEvaluation )` Called when the format of the media being consumed by an audio renderer changes.
`void`	`@UnstableApi onAudioSessionIdChanged( AnalyticsListener.EventTime eventTime, int audioSessionId )` Called when the audio session ID changes.
`void`	`@UnstableApi onAudioTrackInitialized( AnalyticsListener.EventTime eventTime, AudioSink.AudioTrackConfig audioTrackConfig )` Called when an `AudioTrack` has been initialized.
`void`	`@UnstableApi onAudioTrackReleased( AnalyticsListener.EventTime eventTime, AudioSink.AudioTrackConfig audioTrackConfig )` Called when an `AudioTrack` has been released.
`void`	`@UnstableApi onAudioUnderrun( AnalyticsListener.EventTime eventTime, int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs )` Called when an audio underrun occurs.
`void`	`@UnstableApi onDownstreamFormatChanged( AnalyticsListener.EventTime eventTime, MediaLoadData mediaLoadData )` Called when the downstream format sent to the renderers changed.
`void`	`@UnstableApi onDrmKeysLoaded(AnalyticsListener.EventTime eventTime)` Called each time drm keys are loaded.
`void`	`@UnstableApi onDrmKeysRemoved(AnalyticsListener.EventTime eventTime)` Called each time offline drm keys are removed.
`void`	`@UnstableApi onDrmKeysRestored(AnalyticsListener.EventTime eventTime)` Called each time offline drm keys are restored.
`void`	`@UnstableApi onDrmSessionAcquired( AnalyticsListener.EventTime eventTime, @DrmSession.State int state )` Called each time a drm session is acquired.
`void`	`@UnstableApi onDrmSessionManagerError( AnalyticsListener.EventTime eventTime, Exception error )` Called when a drm error occurs.
`void`	`@UnstableApi onDrmSessionReleased(AnalyticsListener.EventTime eventTime)` Called each time a drm session is released.
`void`	`@UnstableApi onDroppedVideoFrames( AnalyticsListener.EventTime eventTime, int droppedFrames, long elapsedMs )` Called after video frames have been dropped.
`void`	`@UnstableApi onIsLoadingChanged( AnalyticsListener.EventTime eventTime, boolean isLoading )` Called when the player starts or stops loading data from a source.
`void`	`@UnstableApi onIsPlayingChanged( AnalyticsListener.EventTime eventTime, boolean isPlaying )` Called when the player starts or stops playing.
`void`	`@UnstableApi onLoadError( AnalyticsListener.EventTime eventTime, LoadEventInfo loadEventInfo, MediaLoadData mediaLoadData, IOException error, boolean wasCanceled )` Called when a media source loading error occurred.
`void`	`@UnstableApi onMediaItemTransition( AnalyticsListener.EventTime eventTime, @Nullable MediaItem mediaItem, int reason )` Called when playback transitions to a different media item.
`void`	`@UnstableApi onMetadata(AnalyticsListener.EventTime eventTime, Metadata metadata)` Called when there is `Metadata` associated with the current playback time.
`void`	`@UnstableApi onPlayWhenReadyChanged( AnalyticsListener.EventTime eventTime, boolean playWhenReady, @Player.PlayWhenReadyChangeReason int reason )` Called when the value changed that indicates whether playback will proceed when ready.
`void`	`@UnstableApi onPlaybackParametersChanged( AnalyticsListener.EventTime eventTime, PlaybackParameters playbackParameters )` Called when the playback parameters changed.
`void`	`@UnstableApi onPlaybackStateChanged( AnalyticsListener.EventTime eventTime, @Player.State int state )` Called when the playback state changed.
`void`	`@UnstableApi onPlaybackSuppressionReasonChanged( AnalyticsListener.EventTime eventTime, @Player.PlaybackSuppressionReason int playbackSuppressionReason )` Called when playback suppression reason changed.
`void`	`@UnstableApi onPlayerError( AnalyticsListener.EventTime eventTime, PlaybackException error )` Called when a fatal player error occurred.
`void`	`@UnstableApi onPositionDiscontinuity( AnalyticsListener.EventTime eventTime, Player.PositionInfo oldPosition, Player.PositionInfo newPosition, @Player.DiscontinuityReason int reason )` Called when a position discontinuity occurred.
`void`	`@UnstableApi 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.
`void`	`@UnstableApi 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.
`void`	`@UnstableApi onRepeatModeChanged( AnalyticsListener.EventTime eventTime, @Player.RepeatMode int repeatMode )` Called when the repeat mode changed.
`void`	`@UnstableApi onShuffleModeChanged( AnalyticsListener.EventTime eventTime, boolean shuffleModeEnabled )` Called when the shuffle mode changed.
`void`	`@UnstableApi onSkipSilenceEnabledChanged( AnalyticsListener.EventTime eventTime, boolean skipSilenceEnabled )` Called when skipping silences is enabled or disabled in the audio stream.
`void`	`@UnstableApi onSurfaceSizeChanged( AnalyticsListener.EventTime eventTime, int width, int height )` Called when the output surface size changed.
`void`	`@UnstableApi onTimelineChanged( AnalyticsListener.EventTime eventTime, @Player.TimelineChangeReason int reason )` Called when the timeline changed.
`void`	`@UnstableApi onTracksChanged(AnalyticsListener.EventTime eventTime, Tracks tracks)` Called when the tracks change.
`void`	`@UnstableApi 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.
`void`	`@UnstableApi onVideoDecoderInitialized( AnalyticsListener.EventTime eventTime, String decoderName, long initializedTimestampMs, long initializationDurationMs )` Called when a video renderer creates a decoder.
`void`	`@UnstableApi onVideoDecoderReleased( AnalyticsListener.EventTime eventTime, String decoderName )` Called when a video renderer releases a decoder.
`void`	`@UnstableApi onVideoDisabled( AnalyticsListener.EventTime eventTime, DecoderCounters decoderCounters )` Called when a video renderer is disabled.
`void`	`@UnstableApi onVideoEnabled( AnalyticsListener.EventTime eventTime, DecoderCounters decoderCounters )` Called when a video renderer is enabled.
`void`	`@UnstableApi onVideoInputFormatChanged( AnalyticsListener.EventTime eventTime, Format format, @Nullable DecoderReuseEvaluation decoderReuseEvaluation )` Called when the format of the media being consumed by a video renderer changes.
`void`	`@UnstableApi 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.
`void`	`@UnstableApi onVolumeChanged(AnalyticsListener.EventTime eventTime, float volume)` Called when the volume changes.

Protected methods
`void`	`@UnstableApi logd(String msg)` Logs a debug message.
`void`	`@UnstableApi loge(String msg)` Logs an error message.

Inherited Constants

From androidx.media3.exoplayer.analytics.AnalyticsListener

`static final int`	`@UnstableApi EVENT_AUDIO_ATTRIBUTES_CHANGED = 20` Audio attributes changed.
`static final int`	`@UnstableApi EVENT_AUDIO_CODEC_ERROR = 1029` The audio codec encountered an error.
`static final int`	`@UnstableApi EVENT_AUDIO_DECODER_INITIALIZED = 1008` An audio renderer created a decoder.
`static final int`	`@UnstableApi EVENT_AUDIO_DECODER_RELEASED = 1012` An audio renderer released a decoder.
`static final int`	`@UnstableApi EVENT_AUDIO_DISABLED = 1013` An audio renderer was disabled.
`static final int`	`@UnstableApi EVENT_AUDIO_ENABLED = 1007` An audio renderer was enabled.
`static final int`	`@UnstableApi EVENT_AUDIO_INPUT_FORMAT_CHANGED = 1009` The format consumed by an audio renderer changed.
`static final int`	`@UnstableApi EVENT_AUDIO_POSITION_ADVANCING = 1010` The audio position has increased for the first time since the last pause or position reset.
`static final int`	`@UnstableApi EVENT_AUDIO_SESSION_ID = 21` An audio session id was set.
`static final int`	`@UnstableApi EVENT_AUDIO_SINK_ERROR = 1014` The audio sink encountered a non-fatal error.
`static final int`	`@UnstableApi EVENT_AUDIO_TRACK_INITIALIZED = 1031` An audio track has been initialized.
`static final int`	`@UnstableApi EVENT_AUDIO_TRACK_RELEASED = 1032` An audio track has been released.
`static final int`	`@UnstableApi EVENT_AUDIO_UNDERRUN = 1011` An audio underrun occurred.
`static final int`	`@UnstableApi EVENT_AVAILABLE_COMMANDS_CHANGED = 13` `getAvailableCommands` changed.
`static final int`	`@UnstableApi EVENT_BANDWIDTH_ESTIMATE = 1006` The bandwidth estimate has been updated.
`static final int`	`@UnstableApi EVENT_CUES = 27` `getCurrentCues` changed.
`static final int`	`@UnstableApi EVENT_DEVICE_INFO_CHANGED = 29` `getDeviceInfo` changed.
`static final int`	`@UnstableApi EVENT_DEVICE_VOLUME_CHANGED = 30` `getDeviceVolume` changed.
`static final int`	`@UnstableApi EVENT_DOWNSTREAM_FORMAT_CHANGED = 1004` The downstream format sent to renderers changed.
`static final int`	`@UnstableApi EVENT_DRM_KEYS_LOADED = 1023` DRM keys were loaded.
`static final int`	`@UnstableApi EVENT_DRM_KEYS_REMOVED = 1026` DRM keys were removed.
`static final int`	`@UnstableApi EVENT_DRM_KEYS_RESTORED = 1025` DRM keys were restored.
`static final int`	`@UnstableApi EVENT_DRM_SESSION_ACQUIRED = 1022` A DRM session has been acquired.
`static final int`	`@UnstableApi EVENT_DRM_SESSION_MANAGER_ERROR = 1024` A non-fatal DRM session manager error occurred.
`static final int`	`@UnstableApi EVENT_DRM_SESSION_RELEASED = 1027` A DRM session has been released.
`static final int`	`@UnstableApi EVENT_DROPPED_VIDEO_FRAMES = 1018` Video frames have been dropped.
`static final int`	`@UnstableApi EVENT_IS_LOADING_CHANGED = 3` `isLoading` ()} changed.
`static final int`	`@UnstableApi EVENT_IS_PLAYING_CHANGED = 7` `isPlaying` changed.
`static final int`	`@UnstableApi EVENT_LOAD_CANCELED = 1002` A source canceled loading data.
`static final int`	`@UnstableApi EVENT_LOAD_COMPLETED = 1001` A source started completed loading data.
`static final int`	`@UnstableApi EVENT_LOAD_ERROR = 1003` A source had a non-fatal error loading data.
`static final int`	`@UnstableApi EVENT_LOAD_STARTED = 1000` A source started loading data.
`static final int`	`@UnstableApi EVENT_MAX_SEEK_TO_PREVIOUS_POSITION_CHANGED = 18` `getMaxSeekToPreviousPosition` changed.
`static final int`	`@UnstableApi EVENT_MEDIA_ITEM_TRANSITION = 1` `getCurrentMediaItem` changed or the player started repeating the current item.
`static final int`	`@UnstableApi EVENT_MEDIA_METADATA_CHANGED = 14` `getMediaMetadata` changed.
`static final int`	`@UnstableApi EVENT_METADATA = 28` Metadata associated with the current playback time was reported.
`static final int`	`@UnstableApi EVENT_PLAYBACK_PARAMETERS_CHANGED = 12` `getPlaybackParameters` changed.
`static final int`	`@UnstableApi EVENT_PLAYBACK_STATE_CHANGED = 4` `getPlaybackState` changed.
`static final int`	`@UnstableApi EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED = 6` `getPlaybackSuppressionReason` changed.
`static final int`	`@UnstableApi EVENT_PLAYER_ERROR = 10` `getPlayerError` changed.
`static final int`	`@UnstableApi EVENT_PLAYER_RELEASED = 1028` The player was released.
`static final int`	`@UnstableApi EVENT_PLAYLIST_METADATA_CHANGED = 15` `getPlaylistMetadata` changed.
`static final int`	`@UnstableApi EVENT_PLAY_WHEN_READY_CHANGED = 5` `getPlayWhenReady` changed.
`static final int`	`@UnstableApi EVENT_POSITION_DISCONTINUITY = 11` A position discontinuity occurred.
`static final int`	`@UnstableApi 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.
`static final int`	`@UnstableApi EVENT_RENDERER_READY_CHANGED = 1033` A renderer changed its readiness for playback.
`static final int`	`@UnstableApi EVENT_REPEAT_MODE_CHANGED = 8` `getRepeatMode` changed.
`static final int`	`@UnstableApi EVENT_SEEK_BACK_INCREMENT_CHANGED = 16` `getSeekBackIncrement` changed.
`static final int`	`@UnstableApi EVENT_SEEK_FORWARD_INCREMENT_CHANGED = 17` `getSeekForwardIncrement` changed.
`static final int`	`@UnstableApi EVENT_SHUFFLE_MODE_ENABLED_CHANGED = 9` `getShuffleModeEnabled` changed.
`static final int`	`@UnstableApi EVENT_SKIP_SILENCE_ENABLED_CHANGED = 23` Skipping silences was enabled or disabled in the audio stream.
`static final int`	`@UnstableApi EVENT_SURFACE_SIZE_CHANGED = 24` The surface size changed.
`static final int`	`@UnstableApi EVENT_TIMELINE_CHANGED = 0` `getCurrentTimeline` changed.
`static final int`	`@UnstableApi EVENT_TRACKS_CHANGED = 2` `getCurrentTracks` changed.
`static final int`	`@UnstableApi EVENT_TRACK_SELECTION_PARAMETERS_CHANGED = 19` `getTrackSelectionParameters` changed.
`static final int`	`@UnstableApi EVENT_UPSTREAM_DISCARDED = 1005` Data was removed from the end of the media buffer.
`static final int`	`@UnstableApi EVENT_VIDEO_CODEC_ERROR = 1030` The video codec encountered an error.
`static final int`	`@UnstableApi EVENT_VIDEO_DECODER_INITIALIZED = 1016` A video renderer created a decoder.
`static final int`	`@UnstableApi EVENT_VIDEO_DECODER_RELEASED = 1019` A video renderer released a decoder.
`static final int`	`@UnstableApi EVENT_VIDEO_DISABLED = 1020` A video renderer was disabled.
`static final int`	`@UnstableApi EVENT_VIDEO_ENABLED = 1015` A video renderer was enabled.
`static final int`	`@UnstableApi EVENT_VIDEO_FRAME_PROCESSING_OFFSET = 1021` Video frame processing offset data has been reported.
`static final int`	`@UnstableApi EVENT_VIDEO_INPUT_FORMAT_CHANGED = 1017` The format consumed by a video renderer changed.
`static final int`	`@UnstableApi EVENT_VIDEO_SIZE_CHANGED = 25` The video size changed.
`static final int`	`@UnstableApi EVENT_VOLUME_CHANGED = 22` The volume changed.

Inherited methods

From androidx.media3.exoplayer.analytics.AnalyticsListener

`void`	`@UnstableApi onAudioCodecError( AnalyticsListener.EventTime eventTime, Exception audioCodecError )` Called when an audio decoder encounters an error.
`void`	`@UnstableApi onAudioDecoderInitialized( AnalyticsListener.EventTime eventTime, String decoderName, long initializationDurationMs )` This method is deprecated. Use `onAudioDecoderInitialized`.
`void`	`@UnstableApi onAudioPositionAdvancing( AnalyticsListener.EventTime eventTime, long playoutStartSystemTimeMs )` Called when the audio position has increased for the first time since the last pause or position reset.
`void`	`@UnstableApi onAudioSinkError( AnalyticsListener.EventTime eventTime, Exception audioSinkError )` Called when `AudioSink` has encountered an error.
`void`	`@UnstableApi onAvailableCommandsChanged( AnalyticsListener.EventTime eventTime, Player.Commands availableCommands )` Called when the player's available commands changed.
`void`	`@UnstableApi onBandwidthEstimate( AnalyticsListener.EventTime eventTime, int totalLoadTimeMs, long totalBytesLoaded, long bitrateEstimate )` Called when the bandwidth estimate for the current data source has been updated.
`void`	`@UnstableApi onCues(AnalyticsListener.EventTime eventTime, CueGroup cueGroup)` Called when there is a change in the `CueGroup`.
`void`	`@UnstableApi onCues(AnalyticsListener.EventTime eventTime, List<Cue> cues)` This method is deprecated. Use `onCues` instead.
`void`	`@UnstableApi onDeviceInfoChanged( AnalyticsListener.EventTime eventTime, DeviceInfo deviceInfo )` Called when the device information changes
`void`	`@UnstableApi onDeviceVolumeChanged( AnalyticsListener.EventTime eventTime, int volume, boolean muted )` Called when the device volume or mute state changes.
`void`	`@UnstableApi onDrmSessionAcquired(AnalyticsListener.EventTime eventTime)` This method is deprecated. Implement `onDrmSessionAcquired` instead.
`void`	`@UnstableApi onEvents(Player player, AnalyticsListener.Events events)` Called after one or more events occurred.
`void`	`@UnstableApi onLoadCanceled( AnalyticsListener.EventTime eventTime, LoadEventInfo loadEventInfo, MediaLoadData mediaLoadData )` Called when a media source canceled loading data.
`void`	`@UnstableApi onLoadCompleted( AnalyticsListener.EventTime eventTime, LoadEventInfo loadEventInfo, MediaLoadData mediaLoadData )` Called when a media source completed loading data.
`void`	`@UnstableApi onLoadStarted( AnalyticsListener.EventTime eventTime, LoadEventInfo loadEventInfo, MediaLoadData mediaLoadData )` Called when a media source started loading data.
`void`	`@UnstableApi onLoadingChanged( AnalyticsListener.EventTime eventTime, boolean isLoading )` This method is deprecated. Use `onIsLoadingChanged` instead.
`void`	`@UnstableApi onMaxSeekToPreviousPositionChanged( AnalyticsListener.EventTime eventTime, long maxSeekToPreviousPositionMs )` Called when the maximum position for which `seekToPrevious` seeks to the previous window changes.
`void`	`@UnstableApi onMediaMetadataChanged( AnalyticsListener.EventTime eventTime, MediaMetadata mediaMetadata )` Called when the combined `MediaMetadata` changes.
`void`	`@UnstableApi onPlayerErrorChanged( AnalyticsListener.EventTime eventTime, @Nullable PlaybackException error )` Called when the `PlaybackException` returned by `getPlayerError` changes.
`void`	`@UnstableApi onPlayerReleased(AnalyticsListener.EventTime eventTime)` Called when the `Player` is released.
`void`	`@UnstableApi onPlayerStateChanged( AnalyticsListener.EventTime eventTime, boolean playWhenReady, @Player.State int playbackState )` This method is deprecated. Use `onPlaybackStateChanged` and `onPlayWhenReadyChanged` instead.
`void`	`@UnstableApi onPlaylistMetadataChanged( AnalyticsListener.EventTime eventTime, MediaMetadata playlistMetadata )` Called when the playlist `MediaMetadata` changes.
`void`	`@UnstableApi onPositionDiscontinuity( AnalyticsListener.EventTime eventTime, @Player.DiscontinuityReason int reason )` This method is deprecated. Use `onPositionDiscontinuity` instead.
`void`	`@UnstableApi onSeekBackIncrementChanged( AnalyticsListener.EventTime eventTime, long seekBackIncrementMs )` Called when the seek back increment changed.
`void`	`@UnstableApi onSeekForwardIncrementChanged( AnalyticsListener.EventTime eventTime, long seekForwardIncrementMs )` Called when the seek forward increment changed.
`void`	`@UnstableApi onSeekStarted(AnalyticsListener.EventTime eventTime)` This method is deprecated. Use `onPositionDiscontinuity` instead, listening to changes with `DISCONTINUITY_REASON_SEEK`.
`void`	`@UnstableApi onTrackSelectionParametersChanged( AnalyticsListener.EventTime eventTime, TrackSelectionParameters trackSelectionParameters )` Called when track selection parameters change.
`void`	`@UnstableApi onVideoCodecError( AnalyticsListener.EventTime eventTime, Exception videoCodecError )` Called when a video decoder encounters an error.
`void`	`@UnstableApi onVideoDecoderInitialized( AnalyticsListener.EventTime eventTime, String decoderName, long initializationDurationMs )` This method is deprecated. Use `onVideoDecoderInitialized`.
`void`	`@UnstableApi 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.
`void`	`@UnstableApi onVideoSizeChanged( AnalyticsListener.EventTime eventTime, int width, int height, int unappliedRotationDegrees, float pixelWidthHeightRatio )` This method is deprecated. Implement `onVideoSizeChanged` instead.

Public constructors

EventLogger

public EventLogger()

Creates an instance.

EventLogger

public EventLogger(String tag)

Creates an instance.

Parameters
`String tag`	The tag used for logging.

EventLogger

@UnstableApi
public EventLogger(@Nullable MappingTrackSelector trackSelector)

Creates an instance.

Parameters
`@Nullable MappingTrackSelector trackSelector`	This parameter is ignored.

EventLogger

@UnstableApi
public EventLogger(@Nullable MappingTrackSelector trackSelector, String tag)

Creates an instance.

Parameters
`@Nullable MappingTrackSelector trackSelector`	This parameter is ignored.
`String tag`	The tag used for logging.

Public methods

onAudioAttributesChanged

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

Called when the audio attributes change.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`AudioAttributes audioAttributes`	The audio attributes.

onAudioDecoderInitialized

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

Called when an audio renderer creates a decoder.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`String decoderName`	The decoder that was created.
`long initializedTimestampMs`	`elapsedRealtime` when initialization finished.
`long initializationDurationMs`	The time taken to initialize the decoder in milliseconds.

onAudioDecoderReleased

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

Called when an audio renderer releases a decoder.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`String decoderName`	The decoder that was released.

onAudioDisabled

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

Called when an audio renderer is disabled.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`DecoderCounters decoderCounters`	`DecoderCounters` that were updated by the renderer.

onAudioEnabled

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

Called when an audio renderer is enabled.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`DecoderCounters decoderCounters`	`DecoderCounters` that will be updated by the renderer for as long as it remains enabled.

onAudioInputFormatChanged

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

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Format format`	The new format.
`@Nullable DecoderReuseEvaluation decoderReuseEvaluation`	The result of the evaluation to determine whether an existing decoder instance can be reused for the new format, or `null` if the renderer did not have a decoder.

onAudioSessionIdChanged

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

Called when the audio session ID changes.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`int audioSessionId`	The audio session ID.

onAudioTrackInitialized

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

Called when an AudioTrack has been initialized.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`AudioSink.AudioTrackConfig audioTrackConfig`	The `AudioSink.AudioTrackConfig` of the initialized .

onAudioTrackReleased

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

Called when an AudioTrack has been released.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`AudioSink.AudioTrackConfig audioTrackConfig`	The `AudioSink.AudioTrackConfig` of the released .

onAudioUnderrun

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

Called when an audio underrun occurs.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`int bufferSize`	The size of the audio output buffer, in bytes.
`long bufferSizeMs`	The size of the audio output buffer, in milliseconds, if it contains PCM encoded audio. `TIME_UNSET` if the output buffer contains non-PCM encoded audio.
`long elapsedSinceLastFeedMs`	The time since audio was last written to the output buffer.

onDownstreamFormatChanged

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

Called when the downstream format sent to the renderers changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`MediaLoadData mediaLoadData`	The `MediaLoadData` defining the newly selected media data.

onDrmKeysLoaded

@UnstableApi
public void onDrmKeysLoaded(AnalyticsListener.EventTime eventTime)

Called each time drm keys are loaded.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.

onDrmKeysRemoved

@UnstableApi
public void onDrmKeysRemoved(AnalyticsListener.EventTime eventTime)

Called each time offline drm keys are removed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.

onDrmKeysRestored

@UnstableApi
public void onDrmKeysRestored(AnalyticsListener.EventTime eventTime)

Called each time offline drm keys are restored.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.

onDrmSessionAcquired

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

Called each time a drm session is acquired.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`@DrmSession.State int state`	The `DrmSession.State` of the session when the acquisition completed.

onDrmSessionManagerError

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Exception error`	The error.

onDrmSessionReleased

@UnstableApi
public void onDrmSessionReleased(AnalyticsListener.EventTime eventTime)

Called each time a drm session is released.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.

onDroppedVideoFrames

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

Called after video frames have been dropped.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`int droppedFrames`	The number of dropped frames since the last call to this method.
`long 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.

onIsLoadingChanged

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

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`boolean isLoading`	Whether the player is loading.

onIsPlayingChanged

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

Called when the player starts or stops playing.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`boolean isPlaying`	Whether the player is playing.

onLoadError

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

Called when a media source loading error occurred.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`LoadEventInfo loadEventInfo`	The `LoadEventInfo` defining the load event.
`MediaLoadData mediaLoadData`	The `MediaLoadData` defining the data being loaded.
`IOException error`	The load error.
`boolean wasCanceled`	Whether the load was canceled as a result of the error.

onMediaItemTransition

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

Called when playback transitions to a different media item.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`@Nullable MediaItem mediaItem`	The media item.
`int reason`	The reason for the media item transition.

onMetadata

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

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Metadata metadata`	The metadata.

onPlayWhenReadyChanged

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

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`boolean playWhenReady`	Whether playback will proceed when ready.
`@Player.PlayWhenReadyChangeReason int reason`	The `reason` of the change.

onPlaybackParametersChanged

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

Called when the playback parameters changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`PlaybackParameters playbackParameters`	The new playback parameters.

onPlaybackStateChanged

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

Called when the playback state changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`@Player.State int state`	The new `playback state`.

onPlaybackSuppressionReasonChanged

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

Called when playback suppression reason changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`@Player.PlaybackSuppressionReason int playbackSuppressionReason`	The new `PlaybackSuppressionReason`.

onPlayerError

@UnstableApi
public 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 to this method in order to include more information about the error.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`PlaybackException error`	The error.

onPositionDiscontinuity

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

Called when a position discontinuity occurred.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Player.PositionInfo oldPosition`	The position before the discontinuity.
`Player.PositionInfo newPosition`	The position after the discontinuity.
`@Player.DiscontinuityReason int reason`	The reason for the position discontinuity.

onRenderedFirstFrame

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Object output`	The output to which a frame has been rendered. Normally a `Surface`, however may also be other output types (e.g., a `VideoDecoderOutputBufferRenderer`).
`long renderTimeMs`	`elapsedRealtime` when the first frame was rendered.

onRendererReadyChanged

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`int rendererIndex`	The index of the renderer in the instance.
`@C.TrackType int rendererTrackType`	The `C.TrackType` of the renderer.
`boolean isRendererReady`	Whether the renderer allows playback to be ready.

onRepeatModeChanged

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

Called when the repeat mode changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`@Player.RepeatMode int repeatMode`	The new repeat mode.

onShuffleModeChanged

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

Called when the shuffle mode changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`boolean shuffleModeEnabled`	Whether the shuffle mode is enabled.

onSkipSilenceEnabledChanged

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

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`boolean skipSilenceEnabled`	Whether skipping silences in the audio stream is enabled.

onSurfaceSizeChanged

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

Called when the output surface size changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`int width`	The surface width in pixels. May be `LENGTH_UNSET` if unknown, or 0 if the video is not rendered onto a surface.
`int height`	The surface height in pixels. May be `LENGTH_UNSET` if unknown, or 0 if the video is not rendered onto a surface.

onTimelineChanged

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

Called when the timeline changed.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`@Player.TimelineChangeReason int reason`	The reason for the timeline change.

onTracksChanged

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

Called when the tracks change.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Tracks tracks`	The tracks. Never null, but may be of length zero.

onUpstreamDiscarded

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`MediaLoadData mediaLoadData`	The `MediaLoadData` defining the media being discarded.

onVideoDecoderInitialized

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

Called when a video renderer creates a decoder.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`String decoderName`	The decoder that was created.
`long initializedTimestampMs`	`elapsedRealtime` when initialization finished.
`long initializationDurationMs`	The time taken to initialize the decoder in milliseconds.

onVideoDecoderReleased

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

Called when a video renderer releases a decoder.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`String decoderName`	The decoder that was released.

onVideoDisabled

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

Called when a video renderer is disabled.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`DecoderCounters decoderCounters`	`DecoderCounters` that were updated by the renderer.

onVideoEnabled

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

Called when a video renderer is enabled.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`DecoderCounters decoderCounters`	`DecoderCounters` that will be updated by the renderer for as long as it remains enabled.

onVideoInputFormatChanged

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

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`Format format`	The new format.
`@Nullable DecoderReuseEvaluation decoderReuseEvaluation`	The result of the evaluation to determine whether an existing decoder instance can be reused for the new format, or `null` if the renderer did not have a decoder.

onVideoSizeChanged

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

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`VideoSize videoSize`	The new size of the video.

onVolumeChanged

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

Called when the volume changes.

Parameters
`AnalyticsListener.EventTime eventTime`	The event time.
`float volume`	The new volume, with 0 being silence and 1 being unity gain.

Protected methods

logd

@UnstableApi
protected void logd(String msg)

Logs a debug message.

Parameters
`String msg`	The message to log.

loge

@UnstableApi
protected void loge(String msg)

Logs an error message.

Parameters
`String msg`	The message to log.