Method Detail

• setListener

  void setListener​(PlaybackSessionManager.Listener listener)

  Sets the listener to be notified of session updates. Must be called before the session manager is used.

  Parameters:

  listener - The PlaybackSessionManager.Listener to be notified of session updates.

• getSessionForMediaPeriodId

  String getSessionForMediaPeriodId​(Timeline timeline,
                                    MediaSource.MediaPeriodId mediaPeriodId)

  Returns the session identifier for the given media period id.

  Note that this will reserve a new session identifier if it doesn't exist yet, but will not call any PlaybackSessionManager.Listener callbacks.

  Parameters:

  timeline - The timeline, mediaPeriodId is part of.

  mediaPeriodId - A MediaSource.MediaPeriodId.

• belongsToSession

  boolean belongsToSession​(AnalyticsListener.EventTime eventTime,
                           String sessionId)

  Returns whether an event time belong to a session.

  Parameters:

  eventTime - The AnalyticsListener.EventTime.

  sessionId - A session identifier.

  Returns:

  Whether the event belongs to the specified session.

• updateSessions

  void updateSessions​(AnalyticsListener.EventTime eventTime)

  Updates or creates sessions based on a player AnalyticsListener.EventTime.

  Call updateSessionsWithTimelineChange(EventTime) or updateSessionsWithDiscontinuity(EventTime, int) if the event is a Timeline change or a position discontinuity respectively.

  Parameters:

  eventTime - The AnalyticsListener.EventTime.

• updateSessionsWithTimelineChange

  void updateSessionsWithTimelineChange​(AnalyticsListener.EventTime eventTime)

  Updates or creates sessions based on a Timeline change at AnalyticsListener.EventTime.

  Should be called instead of updateSessions(EventTime) if a Timeline change occurred.

  Parameters:

  eventTime - The AnalyticsListener.EventTime with the timeline change.

• updateSessionsWithDiscontinuity

  void updateSessionsWithDiscontinuity​(AnalyticsListener.EventTime eventTime,
                                       @DiscontinuityReason
                                       int reason)

  Updates or creates sessions based on a position discontinuity at AnalyticsListener.EventTime.

  Should be called instead of updateSessions(EventTime) if a position discontinuity occurred.

  Parameters:

  eventTime - The AnalyticsListener.EventTime of the position discontinuity.

  reason - The Player.DiscontinuityReason.

• finishAllSessions

  void finishAllSessions​(AnalyticsListener.EventTime eventTime)

  Finishes all existing sessions and calls their respective PlaybackSessionManager.Listener.onSessionFinished(EventTime, String, boolean) callback.

  Parameters:

  eventTime - The event time at which sessions are finished.