Field Detail

• EVENT_TIMELINE_CHANGED

  static final int EVENT_TIMELINE_CHANGED

  Player.getCurrentTimeline() changed.

  See Also:

  Constant Field Values

• EVENT_MEDIA_ITEM_TRANSITION

  static final int EVENT_MEDIA_ITEM_TRANSITION

  Player.getCurrentMediaItem() changed or the player started repeating the current item.

  See Also:

  Constant Field Values

• EVENT_TRACKS_CHANGED

  static final int EVENT_TRACKS_CHANGED

  Player.getCurrentTrackGroups() or Player.getCurrentTrackSelections() changed.

  See Also:

  Constant Field Values

• EVENT_STATIC_METADATA_CHANGED

  static final int EVENT_STATIC_METADATA_CHANGED

  Player.getCurrentStaticMetadata() changed.

  See Also:

  Constant Field Values

• EVENT_IS_LOADING_CHANGED

  static final int EVENT_IS_LOADING_CHANGED

  Player.isLoading() ()} changed.

  See Also:

  Constant Field Values

• EVENT_PLAYBACK_STATE_CHANGED

  static final int EVENT_PLAYBACK_STATE_CHANGED

  Player.getPlaybackState() changed.

  See Also:

  Constant Field Values

• EVENT_PLAY_WHEN_READY_CHANGED

  static final int EVENT_PLAY_WHEN_READY_CHANGED

  Player.getPlayWhenReady() changed.

  See Also:

  Constant Field Values

• EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED

  static final int EVENT_PLAYBACK_SUPPRESSION_REASON_CHANGED

  Player.getPlaybackSuppressionReason() changed.

  See Also:

  Constant Field Values

• EVENT_IS_PLAYING_CHANGED

  static final int EVENT_IS_PLAYING_CHANGED

  Player.isPlaying() changed.

  See Also:

  Constant Field Values

• EVENT_REPEAT_MODE_CHANGED

  static final int EVENT_REPEAT_MODE_CHANGED

  Player.getRepeatMode() changed.

  See Also:

  Constant Field Values

• EVENT_SHUFFLE_MODE_ENABLED_CHANGED

  static final int EVENT_SHUFFLE_MODE_ENABLED_CHANGED

  Player.getShuffleModeEnabled() changed.

  See Also:

  Constant Field Values

• EVENT_PLAYER_ERROR

  static final int EVENT_PLAYER_ERROR

  Player.getPlayerError() changed.

  See Also:

  Constant Field Values

• EVENT_POSITION_DISCONTINUITY

  static final int EVENT_POSITION_DISCONTINUITY

  A position discontinuity occurred. See Player.Listener.onPositionDiscontinuity(Player.PositionInfo, Player.PositionInfo, int).

  See Also:

  Constant Field Values

• EVENT_PLAYBACK_PARAMETERS_CHANGED

  static final int EVENT_PLAYBACK_PARAMETERS_CHANGED

  Player.getPlaybackParameters() changed.

  See Also:

  Constant Field Values

• EVENT_MEDIA_METADATA_CHANGED

  static final int EVENT_MEDIA_METADATA_CHANGED

  Player.getMediaMetadata() changed.

  See Also:

  Constant Field Values

• EVENT_LOAD_STARTED

  static final int EVENT_LOAD_STARTED

  A source started loading data.

  See Also:

  Constant Field Values

• EVENT_LOAD_COMPLETED

  static final int EVENT_LOAD_COMPLETED

  A source started completed loading data.

  See Also:

  Constant Field Values

• EVENT_LOAD_CANCELED

  static final int EVENT_LOAD_CANCELED

  A source canceled loading data.

  See Also:

  Constant Field Values

• EVENT_LOAD_ERROR

  static final int EVENT_LOAD_ERROR

  A source had a non-fatal error loading data.

  See Also:

  Constant Field Values

• EVENT_DOWNSTREAM_FORMAT_CHANGED

  static final int EVENT_DOWNSTREAM_FORMAT_CHANGED

  The downstream format sent to renderers changed.

  See Also:

  Constant Field Values

• EVENT_UPSTREAM_DISCARDED

  static final int EVENT_UPSTREAM_DISCARDED

  Data was removed from the end of the media buffer.

  See Also:

  Constant Field Values

• EVENT_BANDWIDTH_ESTIMATE

  static final int EVENT_BANDWIDTH_ESTIMATE

  The bandwidth estimate has been updated.

  See Also:

  Constant Field Values

• EVENT_METADATA

  static final int EVENT_METADATA

  Metadata associated with the current playback time was reported.

  See Also:

  Constant Field Values

• EVENT_AUDIO_ENABLED

  static final int EVENT_AUDIO_ENABLED

  An audio renderer was enabled.

  See Also:

  Constant Field Values

• EVENT_AUDIO_DECODER_INITIALIZED

  static final int EVENT_AUDIO_DECODER_INITIALIZED

  An audio renderer created a decoder.

  See Also:

  Constant Field Values

• EVENT_AUDIO_INPUT_FORMAT_CHANGED

  static final int EVENT_AUDIO_INPUT_FORMAT_CHANGED

  The format consumed by an audio renderer changed.

  See Also:

  Constant Field Values

• EVENT_AUDIO_POSITION_ADVANCING

  static final int EVENT_AUDIO_POSITION_ADVANCING

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

  See Also:

  Constant Field Values

• EVENT_AUDIO_UNDERRUN

  static final int EVENT_AUDIO_UNDERRUN

  An audio underrun occurred.

  See Also:

  Constant Field Values

• EVENT_AUDIO_DECODER_RELEASED

  static final int EVENT_AUDIO_DECODER_RELEASED

  An audio renderer released a decoder.

  See Also:

  Constant Field Values

• EVENT_AUDIO_DISABLED

  static final int EVENT_AUDIO_DISABLED

  An audio renderer was disabled.

  See Also:

  Constant Field Values

• EVENT_AUDIO_SESSION_ID

  static final int EVENT_AUDIO_SESSION_ID

  An audio session id was set.

  See Also:

  Constant Field Values

• EVENT_AUDIO_ATTRIBUTES_CHANGED

  static final int EVENT_AUDIO_ATTRIBUTES_CHANGED

  Audio attributes changed.

  See Also:

  Constant Field Values

• EVENT_SKIP_SILENCE_ENABLED_CHANGED

  static final int EVENT_SKIP_SILENCE_ENABLED_CHANGED

  Skipping silences was enabled or disabled in the audio stream.

  See Also:

  Constant Field Values

• EVENT_AUDIO_SINK_ERROR

  static final int EVENT_AUDIO_SINK_ERROR

  The audio sink encountered a non-fatal error.

  See Also:

  Constant Field Values

• EVENT_VOLUME_CHANGED

  static final int EVENT_VOLUME_CHANGED

  The volume changed.

  See Also:

  Constant Field Values

• EVENT_VIDEO_ENABLED

  static final int EVENT_VIDEO_ENABLED

  A video renderer was enabled.

  See Also:

  Constant Field Values

• EVENT_VIDEO_DECODER_INITIALIZED

  static final int EVENT_VIDEO_DECODER_INITIALIZED

  A video renderer created a decoder.

  See Also:

  Constant Field Values

• EVENT_VIDEO_INPUT_FORMAT_CHANGED

  static final int EVENT_VIDEO_INPUT_FORMAT_CHANGED

  The format consumed by a video renderer changed.

  See Also:

  Constant Field Values

• EVENT_DROPPED_VIDEO_FRAMES

  static final int EVENT_DROPPED_VIDEO_FRAMES

  Video frames have been dropped.

  See Also:

  Constant Field Values

• EVENT_VIDEO_DECODER_RELEASED

  static final int EVENT_VIDEO_DECODER_RELEASED

  A video renderer released a decoder.

  See Also:

  Constant Field Values

• EVENT_VIDEO_DISABLED

  static final int EVENT_VIDEO_DISABLED

  A video renderer was disabled.

  See Also:

  Constant Field Values

• EVENT_VIDEO_FRAME_PROCESSING_OFFSET

  static final int EVENT_VIDEO_FRAME_PROCESSING_OFFSET

  Video frame processing offset data has been reported.

  See Also:

  Constant Field Values

• EVENT_RENDERED_FIRST_FRAME

  static final int EVENT_RENDERED_FIRST_FRAME

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

  See Also:

  Constant Field Values

• EVENT_VIDEO_SIZE_CHANGED

  static final int EVENT_VIDEO_SIZE_CHANGED

  The video size changed.

  See Also:

  Constant Field Values

• EVENT_SURFACE_SIZE_CHANGED

  static final int EVENT_SURFACE_SIZE_CHANGED

  The surface size changed.

  See Also:

  Constant Field Values

• EVENT_DRM_SESSION_ACQUIRED

  static final int EVENT_DRM_SESSION_ACQUIRED

  A DRM session has been acquired.

  See Also:

  Constant Field Values

• EVENT_DRM_KEYS_LOADED

  static final int EVENT_DRM_KEYS_LOADED

  DRM keys were loaded.

  See Also:

  Constant Field Values

• EVENT_DRM_SESSION_MANAGER_ERROR

  static final int EVENT_DRM_SESSION_MANAGER_ERROR

  A non-fatal DRM session manager error occurred.

  See Also:

  Constant Field Values

• EVENT_DRM_KEYS_RESTORED

  static final int EVENT_DRM_KEYS_RESTORED

  DRM keys were restored.

  See Also:

  Constant Field Values

• EVENT_DRM_KEYS_REMOVED

  static final int EVENT_DRM_KEYS_REMOVED

  DRM keys were removed.

  See Also:

  Constant Field Values

• EVENT_DRM_SESSION_RELEASED

  static final int EVENT_DRM_SESSION_RELEASED

  A DRM session has been released.

  See Also:

  Constant Field Values

• EVENT_PLAYER_RELEASED

  static final int EVENT_PLAYER_RELEASED

  The player was released.

  See Also:

  Constant Field Values

• EVENT_AUDIO_CODEC_ERROR

  static final int EVENT_AUDIO_CODEC_ERROR

  The audio codec encountered an error.

  See Also:

  Constant Field Values

• EVENT_VIDEO_CODEC_ERROR

  static final int EVENT_VIDEO_CODEC_ERROR

  The video codec encountered an error.

  See Also:

  Constant Field Values

Method Detail

• onPlayerStateChanged

  @Deprecated
  default void onPlayerStateChanged​(AnalyticsListener.EventTime eventTime,
                                    boolean playWhenReady,
                                    @State
                                    int playbackState)

  Deprecated.

  Use onPlaybackStateChanged(EventTime, int) and onPlayWhenReadyChanged(EventTime, boolean, int) instead.

• onPlaybackStateChanged

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

  Called when the playback state changed.

  Parameters:

  eventTime - The event time.

  state - The new playback state.

• onPlayWhenReadyChanged

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

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

  Parameters:

  eventTime - The event time.

  playWhenReady - Whether playback will proceed when ready.

  reason - The reason of the change.

• onPlaybackSuppressionReasonChanged

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

  Called when playback suppression reason changed.

  Parameters:

  eventTime - The event time.

  playbackSuppressionReason - The new Player.PlaybackSuppressionReason.

• onIsPlayingChanged

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

  Called when the player starts or stops playing.

  Parameters:

  eventTime - The event time.

  isPlaying - Whether the player is playing.

• onTimelineChanged

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

  Called when the timeline changed.

  Parameters:

  eventTime - The event time.

  reason - The reason for the timeline change.

• onMediaItemTransition

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

  Called when playback transitions to a different media item.

  Parameters:

  eventTime - The event time.

  mediaItem - The media item.

  reason - The reason for the media item transition.

• onPositionDiscontinuity

  @Deprecated
  default void onPositionDiscontinuity​(AnalyticsListener.EventTime eventTime,
                                       @DiscontinuityReason
                                       int reason)

  Deprecated.

  Use onPositionDiscontinuity(EventTime, Player.PositionInfo, Player.PositionInfo, int) instead.

• onPositionDiscontinuity

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

  Called when a position discontinuity occurred.

  Parameters:

  eventTime - The event time.

  oldPosition - The position before the discontinuity.

  newPosition - The position after the discontinuity.

  reason - The reason for the position discontinuity.

• onSeekStarted

  @Deprecated
  default void onSeekStarted​(AnalyticsListener.EventTime eventTime)

  Deprecated.

  Use onPositionDiscontinuity(EventTime, Player.PositionInfo, Player.PositionInfo, int) instead, listening to changes with Player.DISCONTINUITY_REASON_SEEK.

• onSeekProcessed

  @Deprecated
  default void onSeekProcessed​(AnalyticsListener.EventTime eventTime)

  Deprecated.

  Seeks are processed without delay. Use onPositionDiscontinuity(EventTime, int) with reason Player.DISCONTINUITY_REASON_SEEK instead.

• onPlaybackParametersChanged

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

  Called when the playback parameters changed.

  Parameters:

  eventTime - The event time.

  playbackParameters - The new playback parameters.

• onRepeatModeChanged

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

  Called when the repeat mode changed.

  Parameters:

  eventTime - The event time.

  repeatMode - The new repeat mode.

• onShuffleModeChanged

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

  Called when the shuffle mode changed.

  Parameters:

  eventTime - The event time.

  shuffleModeEnabled - Whether the shuffle mode is enabled.

• onIsLoadingChanged

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

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

  Parameters:

  eventTime - The event time.

  isLoading - Whether the player is loading.

• onLoadingChanged

  @Deprecated
  default void onLoadingChanged​(AnalyticsListener.EventTime eventTime,
                                boolean isLoading)

  Deprecated.

  Use onIsLoadingChanged(EventTime, boolean) instead.

• onPlayerError

  default void onPlayerError​(AnalyticsListener.EventTime eventTime,
                             ExoPlaybackException error)

  Called when a fatal player error occurred.

  Parameters:

  eventTime - The event time.

  error - The error.

• onTracksChanged

  default void onTracksChanged​(AnalyticsListener.EventTime eventTime,
                               TrackGroupArray trackGroups,
                               TrackSelectionArray trackSelections)

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

  Parameters:

  eventTime - The event time.

  trackGroups - The available tracks. May be empty.

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

• onStaticMetadataChanged

  default void onStaticMetadataChanged​(AnalyticsListener.EventTime eventTime,
                                       List<Metadata> metadataList)

  Called when the static metadata changes.

  The provided metadataList is an immutable list of Metadata instances, where the elements correspond to the current track selections (as returned by onTracksChanged(EventTime, TrackGroupArray, TrackSelectionArray), or an empty list if there are no track selections or the selected tracks contain no static metadata.

  The metadata is considered static in the sense that it comes from the tracks' declared Formats, rather than being timed (or dynamic) metadata, which is represented within a metadata track.

  Parameters:

  eventTime - The event time.

  metadataList - The static metadata.

• onMediaMetadataChanged

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

  Called when the combined MediaMetadata changes.

  The provided MediaMetadata is a combination of the MediaItem.mediaMetadata and the static and dynamic metadata sourced from Player.Listener.onStaticMetadataChanged(List) and MetadataOutput.onMetadata(Metadata).

  Parameters:

  eventTime - The event time.

  mediaMetadata - The combined MediaMetadata.

• onLoadStarted

  default void onLoadStarted​(AnalyticsListener.EventTime eventTime,
                             LoadEventInfo loadEventInfo,
                             MediaLoadData mediaLoadData)

  Called when a media source started loading data.

  Parameters:

  eventTime - The event time.

  loadEventInfo - The LoadEventInfo defining the load event.

  mediaLoadData - The MediaLoadData defining the data being loaded.

• onLoadCompleted

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

  Called when a media source completed loading data.

  Parameters:

  eventTime - The event time.

  loadEventInfo - The LoadEventInfo defining the load event.

  mediaLoadData - The MediaLoadData defining the data being loaded.

• onLoadCanceled

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

  Called when a media source canceled loading data.

  Parameters:

  eventTime - The event time.

  loadEventInfo - The LoadEventInfo defining the load event.

  mediaLoadData - The MediaLoadData defining the data being loaded.

• onLoadError

  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. Player.Listener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException) 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:

  eventTime - The event time.

  loadEventInfo - The LoadEventInfo defining the load event.

  mediaLoadData - The MediaLoadData defining the data being loaded.

  error - The load error.

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

• onDownstreamFormatChanged

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

  Called when the downstream format sent to the renderers changed.

  Parameters:

  eventTime - The event time.

  mediaLoadData - The MediaLoadData defining the newly selected media data.

• onUpstreamDiscarded

  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.

  Parameters:

  eventTime - The event time.

  mediaLoadData - The MediaLoadData defining the media being discarded.

• onBandwidthEstimate

  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.

  Parameters:

  eventTime - The event time.

  totalLoadTimeMs - The total time spend loading this update is based on, in milliseconds.

  totalBytesLoaded - The total bytes loaded this update is based on.

  bitrateEstimate - The bandwidth estimate, in bits per second.

• onMetadata

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

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

  Parameters:

  eventTime - The event time.

  metadata - The metadata.

• onDecoderEnabled

  @Deprecated
  default void onDecoderEnabled​(AnalyticsListener.EventTime eventTime,
                                int trackType,
                                DecoderCounters decoderCounters)

  Deprecated.

  Use onAudioEnabled(com.google.android.exoplayer2.analytics.AnalyticsListener.EventTime, com.google.android.exoplayer2.decoder.DecoderCounters) and onVideoEnabled(com.google.android.exoplayer2.analytics.AnalyticsListener.EventTime, com.google.android.exoplayer2.decoder.DecoderCounters) instead.

• onDecoderInitialized

  @Deprecated
  default void onDecoderInitialized​(AnalyticsListener.EventTime eventTime,
                                    int trackType,
                                    String decoderName,
                                    long initializationDurationMs)

  Deprecated.

  Use onAudioDecoderInitialized(com.google.android.exoplayer2.analytics.AnalyticsListener.EventTime, java.lang.String, long, long) and onVideoDecoderInitialized(com.google.android.exoplayer2.analytics.AnalyticsListener.EventTime, java.lang.String, long, long) instead.

• onDecoderInputFormatChanged

  @Deprecated
  default void onDecoderInputFormatChanged​(AnalyticsListener.EventTime eventTime,
                                           int trackType,
                                           Format format)

  Deprecated.

  Use onAudioInputFormatChanged(EventTime, Format, DecoderReuseEvaluation) and onVideoInputFormatChanged(EventTime, Format, DecoderReuseEvaluation). instead.

• onDecoderDisabled

  @Deprecated
  default void onDecoderDisabled​(AnalyticsListener.EventTime eventTime,
                                 int trackType,
                                 DecoderCounters decoderCounters)

  Deprecated.

  Use onAudioDisabled(com.google.android.exoplayer2.analytics.AnalyticsListener.EventTime, com.google.android.exoplayer2.decoder.DecoderCounters) and onVideoDisabled(com.google.android.exoplayer2.analytics.AnalyticsListener.EventTime, com.google.android.exoplayer2.decoder.DecoderCounters) instead.

• onAudioEnabled

  default void onAudioEnabled​(AnalyticsListener.EventTime eventTime,
                              DecoderCounters counters)

  Called when an audio renderer is enabled.

  Parameters:

  eventTime - The event time.

  counters - DecoderCounters that will be updated by the renderer for as long as it remains enabled.

• onAudioDecoderInitialized

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

  Called when an audio renderer creates a decoder.

  Parameters:

  eventTime - The event time.

  decoderName - The decoder that was created.

  initializedTimestampMs - SystemClock.elapsedRealtime() when initialization finished.

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

• onAudioDecoderInitialized

  @Deprecated
  default void onAudioDecoderInitialized​(AnalyticsListener.EventTime eventTime,
                                         String decoderName,
                                         long initializationDurationMs)

  Deprecated.

  Use onAudioDecoderInitialized(EventTime, String, long, long).

• onAudioInputFormatChanged

  @Deprecated
  default void onAudioInputFormatChanged​(AnalyticsListener.EventTime eventTime,
                                         Format format)

  Deprecated.

  Use onAudioInputFormatChanged(EventTime, Format, DecoderReuseEvaluation).

• onAudioInputFormatChanged

  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.

  Parameters:

  eventTime - The event time.

  format - The new format.

  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.

• onAudioPositionAdvancing

  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.

  Parameters:

  eventTime - The event time.

  playoutStartSystemTimeMs - The approximate derived System.currentTimeMillis() at which playout started.

• onAudioUnderrun

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

  Called when an audio underrun occurs.

  Parameters:

  eventTime - The event time.

  bufferSize - The size of the audio output buffer, in bytes.

  bufferSizeMs - The size of the audio output buffer, in milliseconds, if it contains PCM encoded audio. C.TIME_UNSET if the output buffer contains non-PCM encoded audio.

  elapsedSinceLastFeedMs - The time since audio was last written to the output buffer.

• onAudioDecoderReleased

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

  Called when an audio renderer releases a decoder.

  Parameters:

  eventTime - The event time.

  decoderName - The decoder that was released.

• onAudioDisabled

  default void onAudioDisabled​(AnalyticsListener.EventTime eventTime,
                               DecoderCounters counters)

  Called when an audio renderer is disabled.

  Parameters:

  eventTime - The event time.

  counters - DecoderCounters that were updated by the renderer.

• onAudioSessionIdChanged

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

  Called when the audio session ID changes.

  Parameters:

  eventTime - The event time.

  audioSessionId - The audio session ID.

• onAudioAttributesChanged

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

  Called when the audio attributes change.

  Parameters:

  eventTime - The event time.

  audioAttributes - The audio attributes.

• onSkipSilenceEnabledChanged

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

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

  Parameters:

  eventTime - The event time.

  skipSilenceEnabled - Whether skipping silences in the audio stream is enabled.

• onAudioSinkError

  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. Player.Listener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException) 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:

  eventTime - The event time.

  audioSinkError - The error that occurred. Typically an AudioSink.InitializationException, a AudioSink.WriteException, or an AudioSink.UnexpectedDiscontinuityException.

• onAudioCodecError

  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. Player.Listener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException) 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:

  eventTime - The event time.

  audioCodecError - The error. Typically a MediaCodec.CodecException if the renderer uses MediaCodec, or a DecoderException if the renderer uses a software decoder.

• onVolumeChanged

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

  Called when the volume changes.

  Parameters:

  eventTime - The event time.

  volume - The new volume, with 0 being silence and 1 being unity gain.

• onVideoEnabled

  default void onVideoEnabled​(AnalyticsListener.EventTime eventTime,
                              DecoderCounters counters)

  Called when a video renderer is enabled.

  Parameters:

  eventTime - The event time.

  counters - DecoderCounters that will be updated by the renderer for as long as it remains enabled.

• onVideoDecoderInitialized

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

  Called when a video renderer creates a decoder.

  Parameters:

  eventTime - The event time.

  decoderName - The decoder that was created.

  initializedTimestampMs - SystemClock.elapsedRealtime() when initialization finished.

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

• onVideoDecoderInitialized

  @Deprecated
  default void onVideoDecoderInitialized​(AnalyticsListener.EventTime eventTime,
                                         String decoderName,
                                         long initializationDurationMs)

  Deprecated.

  Use onVideoDecoderInitialized(EventTime, String, long, long).

• onVideoInputFormatChanged

  @Deprecated
  default void onVideoInputFormatChanged​(AnalyticsListener.EventTime eventTime,
                                         Format format)

  Deprecated.

  Use onVideoInputFormatChanged(EventTime, Format, DecoderReuseEvaluation).

• onVideoInputFormatChanged

  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.

  Parameters:

  eventTime - The event time.

  format - The new format.

  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.

• onDroppedVideoFrames

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

  Called after video frames have been dropped.

  Parameters:

  eventTime - The event time.

  droppedFrames - The number of dropped frames since the last call to this method.

  elapsedMs - The duration in milliseconds over which the frames were dropped. This duration is timed from when the renderer was started or from when dropped frames were last reported (whichever was more recent), and not from when the first of the reported drops occurred.

• onVideoDecoderReleased

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

  Called when a video renderer releases a decoder.

  Parameters:

  eventTime - The event time.

  decoderName - The decoder that was released.

• onVideoDisabled

  default void onVideoDisabled​(AnalyticsListener.EventTime eventTime,
                               DecoderCounters counters)

  Called when a video renderer is disabled.

  Parameters:

  eventTime - The event time.

  counters - DecoderCounters that were updated by the renderer.

• onVideoFrameProcessingOffset

  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.

  Parameters:

  eventTime - The event time.

  totalProcessingOffsetUs - The sum of the video frame processing offsets for frames rendered since the last call to this method.

  frameCount - The number to samples included in totalProcessingOffsetUs.

• onVideoCodecError

  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. Player.Listener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException) 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:

  eventTime - The event time.

  videoCodecError - The error. Typically a MediaCodec.CodecException if the renderer uses MediaCodec, or a DecoderException if the renderer uses a software decoder.

• onRenderedFirstFrame

  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.

  Parameters:

  eventTime - The event time.

  output - The output to which a frame has been rendered. Normally a Surface, however may also be other output types (e.g., a VideoDecoderOutputBufferRenderer).

  renderTimeMs - SystemClock.elapsedRealtime() when the first frame was rendered.

• onVideoSizeChanged

  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.

  Parameters:

  eventTime - The event time.

  videoSize - The new size of the video.

• onVideoSizeChanged

  @Deprecated
  default void onVideoSizeChanged​(AnalyticsListener.EventTime eventTime,
                                  int width,
                                  int height,
                                  int unappliedRotationDegrees,
                                  float pixelWidthHeightRatio)

  Deprecated.

  Implement onVideoSizeChanged(EventTime eventTime, VideoSize) instead.

• onSurfaceSizeChanged

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

  Called when the output surface size changed.

  Parameters:

  eventTime - The event time.

  width - The surface width in pixels. May be C.LENGTH_UNSET if unknown, or 0 if the video is not rendered onto a surface.

  height - The surface height in pixels. May be C.LENGTH_UNSET if unknown, or 0 if the video is not rendered onto a surface.

• onDrmSessionAcquired

  @Deprecated
  default void onDrmSessionAcquired​(AnalyticsListener.EventTime eventTime)

  Deprecated.

  Implement onDrmSessionAcquired(EventTime, int) instead.

• onDrmSessionAcquired

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

  Called each time a drm session is acquired.

  Parameters:

  eventTime - The event time.

  state - The DrmSession.State of the session when the acquisition completed.

• onDrmKeysLoaded

  default void onDrmKeysLoaded​(AnalyticsListener.EventTime eventTime)

  Called each time drm keys are loaded.

  Parameters:

  eventTime - The event time.

• onDrmSessionManagerError

  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. Player.Listener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException) 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:

  eventTime - The event time.

  error - The error.

• onDrmKeysRestored

  default void onDrmKeysRestored​(AnalyticsListener.EventTime eventTime)

  Called each time offline drm keys are restored.

  Parameters:

  eventTime - The event time.

• onDrmKeysRemoved

  default void onDrmKeysRemoved​(AnalyticsListener.EventTime eventTime)

  Called each time offline drm keys are removed.

  Parameters:

  eventTime - The event time.

• onDrmSessionReleased

  default void onDrmSessionReleased​(AnalyticsListener.EventTime eventTime)

  Called each time a drm session is released.

  Parameters:

  eventTime - The event time.

• onPlayerReleased

  default void onPlayerReleased​(AnalyticsListener.EventTime eventTime)

  Called when the Player is released.

  Parameters:

  eventTime - The event time.

• onEvents

  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(EventTime, int) and onPlayWhenReadyChanged(EventTime, boolean, int)).
  • They need access to the Player object to trigger further events (e.g. to call Player.seekTo(long) after a onMediaItemTransition(EventTime, MediaItem, int)).
  • They intend to use multiple state values together or in combination with Player getter methods. For example using Player.getCurrentWindowIndex() with the timeline provided in onTimelineChanged(EventTime, int) is only safe from within this method.
  • They are interested in events that logically happened together (e.g onPlaybackStateChanged(EventTime, int) to Player.STATE_BUFFERING because of onMediaItemTransition(EventTime, MediaItem, int)).

  Parameters:

  player - The Player.

  events - The AnalyticsListener.Events that occurred in this iteration.