Images

A container for a set of related image resources. Each time the defined trigger occurs, a new image appears.

Introduced in Wear OS 4.

Syntax

<Images change="TAP | ON_VISIBLE | ON_NEXT_SECOND | ON_NEXT_MINUTE | ON_NEXT_HOUR"
    changeDirection="FORWARD | BACKWARD | RANDOM">
    <!-- One or more image elements appear here. -->
    <Image ... />
</Images>

Attributes

change

This attribute defines what must occur in order for a new image (from the set of images) to appear on the watch face:

• TAP (default): The change occurs when the user taps on the element.
• ON_VISIBLE: The change occurs when the element next becomes visible.
• ON_NEXT_SECOND: The change occurs when the next second begins.
• ON_NEXT_MINUTE: The change occurs when the next minute begins.
• ON_NEXT_HOUR: The change occurs when the next hour begins.

changeDirection

Optionally sets the direction to progress through the image collection. Possible values are FORWARD (default), BACKWARD, and RANDOM.

Inner elements

The Images element contains one or more instances of Image as inner elements.