Quadrante

L'elemento principale di ogni file watchface.xml. Contiene informazioni sugli elementi che devono essere visualizzati nell'anteprima del quadrante quando gli utenti scelgono quale quadrante utilizzare sui loro dispositivi Wear OS.

Introdotta in Wear OS 4.

Sintassi

<WatchFace width="positive-integer" height="positive-integer"
           clipShape="NONE | CIRCLE | RECTANGLE" cornerRadiusX="float"
           cornerRadiusY="float">
  <!-- Only the required inner element is shown here. -->
  <Scene>
  </Scene>
</WatchFace>

Attributi

L'elemento WatchFace deve contenere i seguenti attributi:

width
Larghezza dello schermo visivo su cui vengono disegnati i componenti del quadrante, in pixel. Tutte le forme geometriche secondarie, come forme e complicazioni, hanno le dimensioni e le posizioni impostate in base alle dimensioni dello schermo visivo. Tieni presente che lo schermo visualizzato potrebbe avere dimensioni diverse rispetto alla risoluzione del display di un dispositivo Wear OS fisico.
height
Altezza dello schermo visivo su cui vengono disegnati i componenti del quadrante, in pixel. Tutte le forme geometriche secondarie, come forme e complicazioni, hanno le dimensioni e le posizioni impostate in base alle dimensioni dello schermo visivo. Tieni presente che lo schermo visualizzato potrebbe avere dimensioni diverse rispetto alla risoluzione del display di un dispositivo Wear OS fisico.

L'elemento WatchFace può contenere anche i seguenti attributi:

clipShape

La forma dello schermo visivo da utilizzare per l'anteprima del quadrante. Se utilizzi un valore di CIRCLE, è probabile che gli elementi vicino ai bordi vengano parzialmente tagliati.

Il valore predefinito è CIRCLE.

cornerRadiusX

La lunghezza della metà dell'asse orizzontale di un'ellisse, che crea angoli arrotondati. Utilizza questo valore, insieme a cornerRadiusY, per creare un effetto di rettangolo arrotondato.

Questo valore non ha alcun effetto a meno che non specifichi un clipShape di RECTANGLE.

cornerRadiusY

La lunghezza della metà dell'asse verticale di un'ellisse, che crea angoli arrotondati. Utilizza questo valore, insieme a cornerRadiusY, per creare un effetto di rettangolo con angoli arrotondati.

Questo valore non ha alcun effetto a meno che non specifichi un clipShape di RECTANGLE.

Elementi interni

L'elemento WatchFace deve contenere almeno un elemento interno Scene.

L'elemento WatchFace può contenere anche i seguenti elementi interni: