HeadlessWatchFaceClient

@AnyThread
abstract void addClientDisconnectListener(
    @NonNull HeadlessWatchFaceClient.ClientDisconnectListener listener,
    @NonNull Executor executor
)

Registers a ClientDisconnectListener.

abstract @NonNull Map<@NonNull Integer, @NonNull ComplicationSlotState> getComplicationSlotsState()

Map of androidx.wear.watchface.ComplicationSlot ids to ComplicationSlotState for each ComplicationSlot registered with the watch face's ComplicationSlotsManager. The ComplicationSlotState is based on the initial state of each androidx.wear.watchface.ComplicationSlot plus any overrides from the default style's ComplicationSlotsUserStyleSetting. Because the style can't change, ComplicationSlotState is immutable for a headless watch face.

abstract @NonNull Instant getPreviewReferenceInstant()

The Instant to use when rendering previews.

default @NonNull UserStyleFlavors getUserStyleFlavors()

Returns the watch face's UserStyleFlavors if any.

abstract @NonNull UserStyleSchema getUserStyleSchema()

The watch face's UserStyleSchema.

default @NonNull byte[] getUserStyleSchemaDigestHash()

A SHA-1 MessageDigest hash of the UserStyleSchema. Note that for performance reasons where possible the resource id or url for Icons in the schema are used rather than the image bytes. This means that this hash should be considered insensitive to changes to the contents of icons between APK versions, which the user should account for accordingly.

This gives the same result as calling UserStyleSchema.computeDigestHash on userStyleSchema but is slightly faster since less data is passed over AIDL.

@AnyThread
abstract boolean isConnectionAlive()

Returns true if the connection to the server side is alive.

default boolean isRenderWatchFaceToSurfaceSupported()

Whether or not the watch face supports renderWatchFaceToSurface.

@AnyThread
abstract void removeClientDisconnectListener(
    @NonNull HeadlessWatchFaceClient.ClientDisconnectListener listener
)

Removes a ClientDisconnectListener previously registered by addClientDisconnectListener.

@RequiresApi(value = 27)
abstract Bitmap renderComplicationToBitmap(
    int complicationSlotId,
    @NonNull RenderParameters renderParameters,
    @NonNull Instant instant,
    @NonNull ComplicationData complicationData,
    UserStyle userStyle
)

Renders the androidx.wear.watchface.ComplicationSlot to a shared memory backed Bitmap with the given settings. The complication will be rendered at the same scale as it would be when the watch face is full screen.

@RequiresApi(value = 27)
abstract @NonNull Bitmap renderWatchFaceToBitmap(
    @NonNull RenderParameters renderParameters,
    @NonNull Instant instant,
    UserStyle userStyle,
    Map<@NonNull Integer, @NonNull ComplicationData> slotIdToComplicationData
)

Renders the watchface to a shared memory backed Bitmap with the given settings.

abstract @NonNull Bundle toBundle()

Stores the underlying connection in a Bundle.