TilesTimelineCache

TilesTimelineCache(timeline: TimelineBuilders.Timeline)

Default constructor.

TilesTimelineCache(timeline: TimelineBuilders.Timeline)

Default constructor.

@MainThread
fun findClosestTileTimelineEntry(timeMillis: Long): TimelineBuilders.TimelineEntry?

A (very) inexact version of findTimelineEntryForTime which finds the closest timeline entry to the current time, regardless of validity. This should only used as a fallback if findTimelineEntryForTime fails, so it can attempt to at least show something.

By this point, we're technically in an error state, so just show _something_. Note that calling this if findTimelineEntryForTime returns a valid entry is invalid, and may lead to incorrect results.

@MainThread
fun findClosestTimelineEntry(timeMillis: Long): TimelineBuilders.TimelineEntry?

A (very) inexact version of findTimelineEntryForTime which finds the closest timeline entry to the current time, regardless of validity. This should only used as a fallback if findTimelineEntryForTime fails, so it can attempt to at least show something.

By this point, we're technically in an error state, so just show _something_. Note that calling this if findTimelineEntryForTime returns a valid entry is invalid, and may lead to incorrect results.

@MainThread
fun findCurrentTimelineEntryExpiry(
    entry: TimelineBuilders.TimelineEntry,
    fromTimeMillis: Long
): Long

Finds when the timeline entry entry should be considered "expired". This is either when it is no longer valid (i.e. end_millis), or when another entry should be presented instead.

@MainThread
fun findCurrentTimelineEntryExpiry(
    entry: TimelineBuilders.TimelineEntry,
    fromTimeMillis: Long
): Long

Finds when the timeline entry entry should be considered "expired". This is either when it is no longer valid (i.e. end_millis), or when another entry should be presented instead.

@MainThread
fun findTileTimelineEntryForTime(timeMillis: Long): TimelineBuilders.TimelineEntry?

Finds the entry which should be active at the given time. This will return the entry which has the _shortest_ validity period at the current time, if validity periods overlap. Note that an entry which has no validity period set will be considered a "default" and will be used if no other entries are suitable.

@MainThread
fun findTimelineEntryForTime(timeMillis: Long): TimelineBuilders.TimelineEntry?

Finds the entry which should be active at the given time. This will return the entry which has the _shortest_ validity period at the current time, if validity periods overlap. Note that an entry which has no validity period set will be considered a "default" and will be used if no other entries are suitable.