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">
    <!-- 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.

Inner elements

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