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.Builder

Builder for Tile

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

Gets androidx.wear.protolayout.StateBuilders.State for this tile.

@Nullable TimelineBuilders.Timeline

Gets the androidx.wear.protolayout.TimelineBuilders.Timeline containing the layouts for the tiles to show in the carousel, along with their validity periods.

@Nullable TimelineBuilders.Timeline

This method is deprecated.

Use getTileTimeline instead.

@NonNull String

Public methods

getFreshnessIntervalMillis

Added in 1.0.0
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

Added in 1.0.0
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 if the system does not have a copy of the specified resource version.

getTileTimeline

Added in 1.2.0
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.

getTimeline

Added in 1.0.0
Deprecated in 1.2.0
public @Nullable TimelineBuilders.Timeline getTimeline()

Gets the androidx.wear.tiles.TimelineBuilders.Timeline containing the layouts for the tiles to show in the carousel, along with their validity periods.

toString

public @NonNull String toString()