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 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 complicação que podem preencher o slot.
Os valores aceitos são
SHORT_TEXT
,LONG_TEXT
,MONOCHROMATIC_IMAGE
,SMALL_IMAGE
,PHOTO_IMAGE
,RANGED_VALUE
eEMPTY
. 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 de255
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:
Recomendados para você
- Observação: o texto do link aparece quando o JavaScript está desativado
- PartImage
- PartVectorImage (link em inglês)
- PartText