Quadrante

L'elemento principale di ogni file watchface.xml. Contiene informazioni sugli elementi che dovrebbero essere visualizzati nell'anteprima del quadrante quando gli utenti scelgono il quadrante da utilizzare sui propri 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 della schermata visiva su cui sono disegnati i componenti del quadrante, espressa in pixel. Le dimensioni e le posizioni di tutti gli elementi geometrici di bambini, come forme e complicazioni, vengono impostate in relazione alle dimensioni dello schermo visivo. Tieni presente che lo schermo visivo potrebbe avere dimensioni diverse rispetto alla risoluzione di un dispositivo Wear OS fisico.
height
L'altezza della schermata visiva su cui sono disegnati i componenti del quadrante, in pixel. Le dimensioni e le posizioni di tutti gli elementi geometrici di bambini, come forme e complicazioni, vengono impostate in relazione alle dimensioni dello schermo visivo. Tieni presente che lo schermo visivo potrebbe avere dimensioni diverse rispetto alla risoluzione di un dispositivo Wear OS fisico.

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

clipShape

La forma della schermata visiva da utilizzare per l'anteprima del quadrante. Se utilizzi il valore CIRCLE, è probabile che gli elementi vicino agli angoli 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 rettangolo arrotondato.

Questo valore non ha effetto se non specifichi un valore 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 rettangolo arrotondato.

Questo valore non ha effetto se non specifichi un valore clipShape di RECTANGLE.

Elementi interni

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

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