ComplicationSlot

Un espacio para complicación es un área de la cara de reloj donde el usuario puede agregar una complicación. Los espacios para complicación contienen elementos Complication, que definen cómo se renderiza la complicación para diferentes tipos y en diferentes modos de cara de reloj.

Se introdujo en Wear OS 4.

Sintaxis

<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

ComplicationSlot tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

x, y, width y height
Es una colección de números enteros que especifican el tamaño y la posición del elemento.
slotId
Es un identificador numérico único del espacio.
supportedTypes
Una lista de los tipos de complicaciones compatibles que pueden completar el espacio. Los valores admitidos son SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE y EMPTY. Se pueden admitir varios tipos de complicaciones si los separas con un espacio (por ejemplo, SHORT_TEXT RANGED_VALUE).

Atributos opcionales

Los siguientes atributos son opcionales:

pivotX, pivotY
Es un punto de pivote bidimensional sobre el que rota el elemento. Ambos valores son números de punto flotante que se ajustan para adaptarse al rango $ [0, 1] $.
angle
Es la cantidad de grados, en el sentido de las manecillas del reloj, que el elemento debe rotar sobre su punto de pivote.
alpha
Establece el nivel de transparencia que debe tener este elemento. Un valor de 0 indica que el elemento debe ser completamente transparente. Un valor de 255 indica que el elemento debe ser completamente opaco.
scaleX
Es el factor de escala horizontal que se aplica a este elemento.
scaleY
Es el factor de escala vertical que se aplica a este elemento.
tintColor
Aplica un filtro de color de tono al elemento. Debes especificar el color con el formato ARGB (#ff000000 = negro opaco) o el formato RGB (#000000 = negro).
displayName
Es un ID de recurso que corresponde al nombre localizado del espacio para complicación, que se muestra en el editor de caras de reloj.
isCustomizable
Determina si un usuario puede cambiar el proveedor de este espacio en el editor de caras de reloj. La configuración predeterminada es TRUE.

Elementos internos

El elemento ComplicationSlot debe contener exactamente un elemento de área de límite.

Un elemento ComplicationSlot debe contener al menos un elemento Complication por tipo de complicación compatible. De manera opcional, un elemento ComplicationSlot puede contener más elementos Complication para admitir cambios en la apariencia con elementos Variant.

El elemento ComplicationSlot también puede contener los siguientes elementos internos: