Auf einer Zusatzfunktion für Zifferblatt werden Daten aus einer Datenquelle angezeigt. Mit dem Watch Face-Format können Sie die Datenquellen auswählen, für die die zugrunde liegenden Daten abgerufen werden sollen. So können auf den Zifferblättern Informationen auch außerhalb der Tageszeit angezeigt werden, ohne dass Code zum Abrufen der Daten erforderlich ist.
Watch Face-Format verwenden
Mit dem Element Complication
können Sie bis zu acht Zusatzfunktionen für ein einzelnes Zifferblatt definieren. Außerdem kannst du damit festlegen, wo auf dem Zifferblatt die Zusatzfunktion angezeigt wird.
Weitere Informationen findest du im WatchFaceFormat-Beispiel auf GitHub.
Typen und Felder
In der folgenden Tabelle werden die Typen und Felder des ComplicationData
-Objekts beschrieben. Wenn ein Zifferblatt ein Feld anfordert, das für einen Zusatzfunktionstyp ungültig ist, wird ein Standardwert für das Feld zurückgegeben. Wenn ein Zifferblatt beispielsweise versucht, auf das Feld LONG_TEXT
des Typs SHORT_TEXT
zuzugreifen, wird der Standardwert für das Feld LONG_TEXT
(null) zurückgegeben. Hinweis: Es kann nicht garantiert werden, dass optionale Felder angezeigt werden.
Typ | Pflichtfelder | Optionale Felder | Hinweise |
---|---|---|---|
SHORT_TEXT
|
Kurzer Text |
Symbol Einbrennschutzsymbol Kurzer Titel Beschreibung des Inhalts |
Zeigt nur ein Symbol oder einen kurzen Titel an, wenn eines oder beide angegeben werden. |
MONOCHROMATIC_IMAGE
|
Einfarbiges Bild |
Einbrennschutzsymbol Beschreibung des Inhalts |
Wird verwendet, wenn kein Text benötigt wird. Es wird erwartet, dass das Symbol einfarbig ist und vom Zifferblatt eingefärbt sein kann. |
RANGED_VALUE
|
Wert Mindestwert Höchstwert |
Einfarbiges Bild Einbrennschutzsymbol Kurzer Text Kurzer Titel Farbverlauf Dynamischer Wert Beschreibung des Inhalts |
Wenn Sie eine eigene Fortschrittsanzeige zeichnen möchten, können Sie mit der Methode
isRangedValueProgressHidden() die Fortschrittsanzeige der Klasse
ComplicationDrawable ausblenden.
|
GOAL_PROGRESS
|
Wert Zielwert |
Einfarbiges Bild Einbrennschutzsymbol Kurzer Text Kurzer Titel Farbverlauf Dynamischer Wert Beschreibung des Inhalts |
GOAL_PROGRESS ist z. B. für die Schrittzahl vorgesehen, bei der der Wert bei null beginnt und über den Zielwert hinausgeht. |
LONG_TEXT
|
Langer Text |
Langer Titel Einfarbiges Bild Einbrennschutzsymbol Kleines Bild Beschreibung des Inhalts |
Zeigt den langen Titel an, sofern angegeben |
SMALL_IMAGE
|
Kleines Bild |
Beschreibung des Inhalts |
Für kleine Bilder gibt es zwei Stile: Fotostil oder Symbolstil. Fotostil bedeutet, dass das Bild den gesamten Raum ausfüllt und zugeschnitten werden kann. Symbolstil bedeutet, dass es nicht zugeschnitten und aufgefüllt werden kann.
Die Bildvariabilität kann dazu führen, dass Bilder auf Geräten mit Einbrennschutz oder mit Low-Bit-Inaktivmodus im Inaktivmodus nicht angezeigt werden können. Wenn der Einbrennschutz oder der Inaktivmodus mit niedrigem Bit aktiviert ist, verwendet das Zifferblatt möglicherweise das kleine Bild für den Einbrennschutz, da dies sicher ist. Da es für ein Zifferblatt schwierig ist, die Eignung zu bestimmen, wird kein Bild angezeigt.
|
LARGE_IMAGE
|
Großes Bild |
Beschreibung des Inhalts |
Dieses Bild sollte groß genug sein, um das Zifferblatt auszufüllen.
Die Bildvariabilität kann dazu führen, dass Bilder auf Geräten mit Einbrennschutz oder mit Low-Bit-Inaktivmodus im Inaktivmodus nicht angezeigt werden können. Da es für ein Zifferblatt schwierig ist, die Eignung für das Display zu bestimmen, wird auf dem Zifferblatt kein Bild im Inaktivmodus angezeigt, wenn der Einbrennschutz oder der Low-Bit-Inaktivmodus aktiviert ist.
|
WEIGHTED_ELEMENTS
|
Elementliste |
Einfarbiges Bild Einbrennschutzsymbol Kurzer Text Kurzer Titel Beschreibung des Inhalts |
Jedes Element besteht aus einer Farbe und einer Gewichtung (größer als null). Die Größe des gerenderten Elements sollte proportional zu seiner Gewichtung sein. Es ist nicht erforderlich, dass Gewichtungen zu einem bestimmten Wert addiert werden. Beachten Sie, dass für Zifferblätter die Farbe WEIGHTED_ELEMENTS geändert werden darf. |
In der folgenden Tabelle werden Komplikationstypen für leere Daten beschrieben, die für einen beliebigen Zusatzinformationsslot gesendet werden können. Diese Typen haben keine Felder und müssen nicht in eine Liste der unterstützten Typen aufgenommen werden. Mithilfe dieser Typen können Zifferblätter zwischen den folgenden drei Szenarien unterscheiden:
- Keine Quelle ausgewählt
- Der Nutzer hat für eine Anzeigenfläche „leer“ ausgewählt.
- Eine Quelle hat keine Daten zum Senden
Quellen können TYPE_EMPTY
nicht als Antwort auf Aktualisierungsanfragen senden. Sende stattdessen TYPE_NO_DATA
.
Art der Zusatzfunktion | Beschreibung |
---|---|
TYPE_NOT_CONFIGURED
|
Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird, der Nutzer aber keine Quelle ausgewählt und keine Standardeinstellung festgelegt wurde.
Kann nicht von Quellen gesendet werden. |
TYPE_EMPTY
|
Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird und der Nutzer „leer“ statt einer Quelle auswählt, oder wenn auf dem Zifferblatt keine Quelle und dieser Zusatzfunktionstyp als Standard festgelegt werden.
Kann nicht von Quellen gesendet werden. |
TYPE_NO_DATA
|
Wird vom System gesendet, wenn eine Zusatzfunktion mit einer Quelle aktiviert wird, um diese zu löschen, bevor tatsächliche Daten von der Quelle empfangen werden.
Kann von Quellen gesendet werden, wenn sie keine zu sendenden Daten haben. |
Für die meisten Datenquellen ist ein Zifferblattformat erforderlich
Damit bei zukünftigen Wear OS-Versionen von Zifferblatt Zusatzfunktionen angezeigt werden, müssen Sie das Watch Face-Format verwenden. Wenn Sie für Ihr Zifferblatt stattdessen die Jetpack Watch Face-Bibliothek oder die Wearable Support Library verwenden, zeigen neuere Versionen von Wear OS keine Daten aus den meisten Datenquellen in Zusatzfunktionen für Zifferblatt an.
Damit Zusatzfunktionen auf Zifferblättern ohne Watch Face-Format vollständig angezeigt werden, müssen für diese Zifferblätter eine der folgenden Datenquellen verwendet werden:
DATA_SOURCE_WATCH_BATTERY
DATA_SOURCE_APP_SHORTCUT
DATA_SOURCE_UNREAD_NOTIFICATION_COUNT
DATA_SOURCE_DATE
DATA_SOURCE_TIME_AND_DATE
DATA_SOURCE_DAY_OF_WEEK
DATA_SOURCE_DAY_AND_DATE
DATA_SOURCE_WORLD_CLOCK
Je nach Gerätehersteller können bei Zifferblättern, bei denen das Watch Face-Format nicht verwendet wird, einige zusätzliche Zusatzfunktionen angezeigt werden.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- DefaultProviderPolicy
- Zusatzfunktion
- Zusatzfunktion