Widżet

Wersja formatu tarczy zegarka Wersja 3 Wersja 2 Wersja 1

---

Komora widżetu to obszar tarczy zegarka, do którego użytkownik może dodać widżet. Miejsca na widżety zawierają elementy widżetu, które określają sposób renderowania widżetu w zależności od różnych typów widżetów i trybów tarczy zegarka.

Uwaga: tarcza zegarka może zawierać maksymalnie 8 wartości ComplicationSlot.

Wprowadzone w Wear OS 4.

Składnia

<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" />

Atrybuty

Element ComplicationSlot ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

x, y, width, height

Kolekcja liczb całkowitych określających rozmiar i położenie elementu.

slotId

Unikalny numeryczny identyfikator slotu.

supportedTypes

Lista obsługiwanych typów widżetów, które mogą wypełniać slot. Obsługiwane wartości to SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE i EMPTY. Możesz obsługiwać wiele typów widżetów, rozdzielając je spacją (na przykład SHORT_TEXT RANGED_VALUE).

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

pivotX, pivotY

Dwuwymiarowy punkt obrotu, wokół którego obraca się element. Obie wartości są liczbami zmiennoprzecinkowymi, które są skalowane tak, aby mieścić się w zakresie $ [0, 1] $.

angle

Liczba stopni, o które element ma zostać obrócony zgodnie z kierunkiem ruchu wskazówek zegara wokół punktu obrotu.

alpha

Ustaw poziom przezroczystości tego elementu. Wartość 0 wskazuje, że element powinien być całkowicie przezroczysty. Wartość 255 wskazuje, że element powinien być całkowicie nieprzezroczysty.

scaleX

Współczynnik skalowania poziomego, który ma być zastosowany do tego elementu.

scaleY

Współczynnik skalowania pionowego, który ma być zastosowany do tego elementu.

tintColor

Zastosuj do elementu filtr koloru zabarwiania. Kolor musisz określić w formacie ARGB (#ff000000 = nieprzezroczysta czerń) lub RGB (#000000 = czerń).

displayName

Identyfikator zasobu odpowiadający zlokalizowanej nazwie miejsca na widżet, która jest wyświetlana w edytorze tarczy zegarka.

isCustomizable

Określa, czy użytkownik może zmienić dostawcę w tym slocie w edytorze interfejsu. Domyślna wartość to TRUE.

Elementy wewnętrzne

Element ComplicationSlot musi zawierać dokładnie 1 element Bounding Area.

Element ComplicationSlot musi zawierać co najmniej 1 element Complication na każdy obsługiwany typ widżetu. Element ComplicationSlot może opcjonalnie zawierać więcej elementów komplikacji, aby umożliwić zmianę wyglądu za pomocą elementów wariantu.

Element ComplicationSlot może też zawierać te elementy wewnętrzne:

• DefaultProviderPolicy
• Variant
• ScreenReader