ComplicationSlot

Um slot de complicação é uma área do mostrador do relógio em que uma complicação pode ser adicionada pelo usuário. Os slots contêm elementos de complicação, que definem como ela é renderizada para diferentes tipos e em diferentes modos de mostrador do relógio.

Introduzido no Wear OS 4.

Sintaxe

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

Atributos

O ComplicationSlot tem os seguintes atributos:

Atributos obrigatórios

Os seguintes atributos são obrigatórios:

x, y, width, height
Uma coleção de números inteiros que especifica o tamanho e a posição do elemento.
slotId
Um identificador numérico exclusivo do slot.
supportedTypes
Uma lista dos tipos de complicação que podem preencher o slot. Os valores aceitos são SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE e EMPTY. Vários tipos de complicação podem ser aceitos, separando-os com um espaço (por exemplo, SHORT_TEXT RANGED_VALUE).

Atributos opcionais

Os seguintes atributos são opcionais:

pivotX, pivotY
Um eixo bidimensional em torno do qual o elemento gira. Os dois valores são números de ponto flutuante dimensionados para caber no intervalo $ [0, 1] $.
angle
Um número de graus, no sentido horário, em que o elemento precisa ser girado em torno do eixo.
alpha
Define o nível de transparência que esse elemento precisa ter. Um valor de 0 indica que o elemento precisa ser totalmente transparente. Um valor de 255 indica que o elemento precisa ser completamente opaco.
scaleX
O fator de escalonamento horizontal a ser aplicado a esse elemento.
scaleY
O fator de escalonamento vertical a ser aplicado a esse elemento.
tintColor
Aplica um filtro de cor matiz ao elemento. É preciso especificar a cor usando o formato ARGB (#ff000000 = preto opaco) ou RGB (#000000 = preto).
displayName
Um ID de recurso correspondente a um nome localizado para o slot da complicação, que é mostrado no editor do mostrador do relógio.
isCustomizable
Determina se um usuário pode mudar o provedor do slot no editor do mostrador do relógio. O valor padrão é TRUE.

Elementos internos

O elemento ComplicationSlot precisa conter exatamente um elemento de área delimitadora.

Um elemento ComplicationSlot precisa conter pelo menos um elemento de complicação por tipo aceito. Opcionalmente, um elemento ComplicationSlot pode conter mais elementos de complicação para oferecer suporte à mudança de aparência com elementos de variante.

O elemento ComplicationSlot também pode conter os seguintes elementos internos: