TileBuilders.Tile
@RequiresSchemaVersion(major = 1, minor = 0)
public final class TileBuilders.Tile
A holder for a tile. This specifies the resources to use for this delivery of the tile, and the timeline for the tile.
Summary
Nested types |
|---|
public final class TileBuilders.Tile.BuilderBuilder for |
Public methods |
|
|---|---|
long |
Gets how many milliseconds of elapsed time (**not** wall clock time) this tile can be considered to be "fresh". |
@NonNull String |
Gets the resource version required for these tiles. |
@Nullable StateBuilders.State |
getState()Gets |
@Nullable TimelineBuilders.Timeline |
Gets the |
@Nullable TimelineBuilders.Timeline |
This method is deprecated. Use |
@NonNull String |
toString() |
Public methods
getFreshnessIntervalMillis
public long getFreshnessIntervalMillis()
Gets how many milliseconds of elapsed time (**not** wall clock time) this tile can be considered to be "fresh". The platform will attempt to refresh your tile at some point in the future after this interval has lapsed. A value of 0 here signifies that auto-refreshes should not be used (i.e. you will manually request updates via TileService#getRequester).
This mechanism should not be used to update your tile more frequently than once a minute, and the system may throttle your updates if you request updates faster than this interval. This interval is also inexact; the system will generally update your tile if it is on-screen, or about to be on-screen, although this is not guaranteed due to system-level optimizations.
getResourcesVersion
public @NonNull String getResourcesVersion()
Gets the resource version required for these tiles. This can be any developer-defined string; it is only used to cache resources, and is passed in androidx.wear.tiles.RequestBuilders.ResourcesRequest if the system does not have a copy of the specified resource version.
getState
public @Nullable StateBuilders.State getState()
Gets androidx.wear.protolayout.StateBuilders.State for this tile.
getTileTimeline
public @Nullable TimelineBuilders.Timeline getTileTimeline()
Gets the androidx.wear.protolayout.TimelineBuilders.Timeline containing the layouts for the tiles to show in the carousel, along with their validity periods.
public @Nullable TimelineBuilders.TimelinegetTimeline()
Gets the androidx.wear.tiles.TimelineBuilders.Timeline containing the layouts for the tiles to show in the carousel, along with their validity periods.