ComplicationSlot

Versión de Formato de Caras de Relojes Versión 2 Versión 1

---

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.

Nota: Una cara de reloj puede tener, como máximo, un total de ocho instancias de ComplicationSlot.

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 y 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:

• DefaultProviderPolicy
• Variant
• ScreenReader