RequestBuilders.TileRequest


@RequiresSchemaVersion(major = 1, minor = 0)
public final class RequestBuilders.TileRequest


Parameters passed to a androidx.wear.tiles.TileBuilders.Tile Service when the renderer is requesting a new version of the tile.

Summary

Nested types

Builder for TileRequest

Public methods

@NonNull StateBuilders.State

Gets the androidx.wear.protolayout.StateBuilders.State that should be used when building the tile.

@NonNull DeviceParametersBuilders.DeviceParameters

Gets the androidx.wear.protolayout.DeviceParametersBuilders.DeviceParameters object describing the device requesting the tile update.

@Nullable DeviceParametersBuilders.DeviceParameters

This method is deprecated.

Use getDeviceConfiguration instead.

@NonNull Instant
@RequiresSchemaVersion(major = 1, minor = 600)
getLastVisibleTime()

Gets the Instant representing the last time the tile was visible.

@NonNull ProtoLayoutScope

Returns ProtoLayoutScope object that is required for methods to create resources or pending intents, and it will automatically register them for a tile.

@Nullable StateBuilders.State

This method is deprecated.

Use getCurrentState instead.

int

Gets the instance ID of the tile being requested, allocated when the tile instance is added to the carousel.

@NonNull String

Public methods

getCurrentState

Added in 1.2.0
public @NonNull StateBuilders.State getCurrentState()

Gets the androidx.wear.protolayout.StateBuilders.State that should be used when building the tile.

getDeviceConfiguration

Added in 1.2.0
public @NonNull DeviceParametersBuilders.DeviceParameters getDeviceConfiguration()

Gets the androidx.wear.protolayout.DeviceParametersBuilders.DeviceParameters object describing the device requesting the tile update. If not set, a default empty instance is used.

getDeviceParameters

Added in 1.0.0
Deprecated in 1.2.0
public @Nullable DeviceParametersBuilders.DeviceParameters getDeviceParameters()

Gets the androidx.wear.tiles.DeviceParametersBuilders.DeviceParameters object describing the device requesting the tile update.

getLastVisibleTime

Added in 1.6.0-alpha01
@RequiresSchemaVersion(major = 1, minor = 600)
public @NonNull Instant getLastVisibleTime()

Gets the Instant representing the last time the tile was visible.

If the tile has never been visible, or the last time it was visible is not known, this will return EPOCH.

The returned value is not persistent across reboots or when the tile is removed from the carousel and added again.

getScope

Added in 1.6.0-alpha01
public @NonNull ProtoLayoutScope getScope()

Returns ProtoLayoutScope object that is required for methods to create resources or pending intents, and it will automatically register them for a tile.

getState

Added in 1.0.0
Deprecated in 1.2.0
public @Nullable StateBuilders.State getState()

Gets the androidx.wear.tiles.StateBuilders.State that should be used when building the tile.

getTileId

Added in 1.2.0
public int getTileId()

Gets the instance ID of the tile being requested, allocated when the tile instance is added to the carousel. This ID will remain the same for this tile instance as long it is not removed from the carousel.

toString

public @NonNull String toString()