ComplicationSlot

Um slot de complemento é uma área do mostrador do relógio em que um complemento pode ser adicionada pelo usuário. Os slots contêm elementos de complemento, 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 estes 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 complemento que podem preencher o slot. Os valores aceitos são SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE e EMPTY. Multiple complication types can be supported by separating them with a space (for example, 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
A resource ID corresponding to a localized name for the complication slot, which is displayed in the watch face editor.
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 complemento por tipo aceito. Opcionalmente, um elemento ComplicationSlot pode conter mais elementos de complemento para oferecer suporte à mudança de aparência com elementos de variante.

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

  • Observação: o texto do link aparece quando o JavaScript está desativado
  • PartImage
  • PartText