ComplicationSlot

Versão do Formato do mostrador do relógio Versão 2 Versão 1

---

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.

Observação: um mostrador do relógio pode ter no máximo oito instâncias de ComplicationSlot, no total.

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:

• DefaultProviderPolicy
• Variant
• ScreenReader