Zusatzfunktionen zu einem Zifferblatt hinzufügen

Auf dem Zifferblatt ist eine Zusatzfunktion mit Daten aus einer Datenquelle zu sehen. Mit dem Zifferblattformat können Sie die Datenquellen auswählen, aus denen die zugrunde liegenden Daten abgerufen werden sollen. So können auf dem Zifferblatt Informationen über die Tageszeit hinaus angezeigt werden, ohne dass Code zum Abrufen der Daten erforderlich ist.

Watch Face-Format verwenden

Mit dem Element Complication kannst du bis zu acht Zusatzfunktionen für ein einzelnes Zifferblatt definieren. Mit dem Element kannst du auch festlegen, wo auf dem Zifferblatt die einzelnen Zusatzfunktionen angezeigt werden.

Weitere Informationen finden Sie im Beispiel für WatchFaceFormat auf GitHub.

Typen und Felder

In der folgenden Tabelle sind die Typen und Felder des Objekts ComplicationData beschrieben. Wenn ein Zifferblatt ein Feld anfordert, das für einen Zusatztyp ungültig ist, wird ein Standardwert für das Feld zurückgegeben. Wenn ein Zifferblatt beispielsweise versucht, auf ein LONG_TEXT-Feld in einem SHORT_TEXT-Typ zuzugreifen, wird der Standardwert „null“ für das LONG_TEXT-Feld zurückgegeben. Optionale Felder werden nicht unbedingt angezeigt.

Eingeben	Pflichtfelder	Optionale Felder	Hinweise
SHORT_TEXT	Kurzer Text	Symbol Symbol für Einbrennschutz Kurzer Titel Beschreibung des Inhalts	Es wird nur ein Symbol oder ein kurzer Titel angezeigt, wenn entweder oder beide angegeben sind.
MONOCHROMATIC_IMAGE	Einfarbiges Bild	Symbol für den Einbrennschutz Inhaltsbeschreibung	Wird verwendet, wenn kein Text erforderlich ist. Das Symbol sollte einfarbig sein und kann vom Zifferblatt eingefärbt werden.
RANGED_VALUE	Wert Mindestwert Maximalwert	Einfarbiges Bild Symbol für den Burn-in-Schutz Kurzer Text Kurzer Titel Farbrampe Dynamischer Wert Inhaltsbeschreibung	Wenn Sie eine eigene Fortschrittsanzeige erstellen möchten, können Sie mit der Methode isRangedValueProgressHidden() die Fortschrittsanzeige der Klasse ComplicationDrawable ausblenden.
GOAL_PROGRESS	Wert Zielwert	Einfarbiges Bild Symbol für Einbrennschutz Kurzer Text Kurzer Titel Farbanpassung Dynamischer Wert Beschreibung des Inhalts	GOAL_PROGRESS ist für Dinge wie die Schrittzahl gedacht, bei denen der Wert bei null beginnt und über den Zielwert hinausgehen darf.
LONG_TEXT	Langer Text	Langer Titel Einfarbiges Bild Symbol „Einbrennschutz“ Kleines Bild Beschreibung des Inhalts	Der lange Anzeigentitel, falls angegeben.
SMALL_IMAGE	Kleines Bild	Inhaltsbeschreibung	Ein kleines Bild kann einen von zwei Stilen haben: Fotostil oder Symbolstil. Als Fotostil wird erwartet, dass es den Platz ausfüllt und zugeschnitten werden kann. Symbolstil bedeutet, dass es nicht zugeschnitten werden kann und ein Rahmen hinzugefügt werden kann. Bildabweichungen können dazu führen, dass das Bild auf Geräten mit Einbrennschutz oder mit einem Low-Bit-Inaktivmodus nicht für die Anzeige im Inaktivmodus geeignet ist. Wenn der Burn-in-Schutz oder der Low-Bit-Inaktivmodus aktiviert ist, verwendet das Zifferblatt möglicherweise das kleine Bild für den Burn-in-Schutz, da es sicher ist. Andernfalls wird kein Bild angezeigt, da es für ein Zifferblatt schwierig ist, die Eignung zu bestimmen.
LARGE_IMAGE	Großes Bild	Beschreibung des Inhalts	Das Bild sollte groß genug sein, um das Zifferblatt auszufüllen. Bildabweichungen können dazu führen, dass das Bild auf Geräten mit Einbrennschutz oder mit einem Low-Bit-Inaktivmodus nicht für die Anzeige im Inaktivmodus geeignet ist. Da es für ein Zifferblatt schwierig ist, die Eignung für die Anzeige zu bestimmen, wird im Inaktivmodus kein Bild angezeigt, wenn der Einbrennschutz oder der Low-Bit-Inaktivmodus aktiviert ist.
WEIGHTED_ELEMENTS	Elementeliste	Einfarbiges Bild Symbol für den Burn-in-Schutz Kurzer Text Kurzer Titel Inhaltsbeschreibung	Jedes Element besteht aus einer Farbe und einem Gewicht (größer als null). Die Größe des Elements beim Rendern sollte proportional zu seinem Gewicht sein. Die Gewichtungen müssen nicht einen bestimmten Wert ergeben. Hinweis: Bei Zifferblättern ist es zulässig, WEIGHTED_ELEMENTS neu zu färben.

In der folgenden Tabelle werden Zusatzfunktionen für leere Daten beschrieben, die für jeden Zusatzfunktionen-Slot gesendet werden können. Diese Typen haben keine Felder und müssen nicht in einer Liste der unterstützten Typen enthalten sein. Anhand dieser Typen können Zifferblätter zwischen den folgenden drei Fällen unterscheiden:

• Es wurde keine Quelle ausgewählt.
• Der Nutzer hat für einen Slot „leer“ ausgewählt.
• Eine Quelle hat keine zu sendenden Daten

Quellen können TYPE_EMPTY nicht als Antwort auf Aktualisierungsanfragen senden. Senden Sie stattdessen TYPE_NO_DATA.

Zusatzfunktionstyp	Beschreibung
TYPE_NOT_CONFIGURED	Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird, der Nutzer aber keine Quelle ausgewählt und keinen Standard festgelegt hat. Kann nicht von Quellen gesendet werden.
TYPE_EMPTY	Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird und der Nutzer anstelle einer Quelle „leer“ auswählt oder wenn das Zifferblatt keine Quelle und diesen Zusatzfunktionstyp als Standard auswählt. Kann nicht von Quellen gesendet werden.
TYPE_NO_DATA	Wird vom System gesendet, wenn eine Zusatzfunktion mit einer Quelle aktiviert wird, um die Zusatzfunktion zu löschen, bevor tatsächliche Daten von der Quelle empfangen werden. Kann von Quellen gesendet werden, wenn keine Daten gesendet werden können.

Auf einigen Geräten müssen Zifferblätter und Zusatzfunktionen das Watch Face-Format haben

Wenn für Ihr vorhandenes Zifferblatt die Jetpack-Zifferblatt-Bibliothek oder die Wearable-Supportbibliothek verwendet wird, sehen Nutzer auf den folgenden Geräten weiterhin Daten aus allen Datenquellen in Zusatzfunktionen für Zifferblätter:

• Geräte mit Wear OS 4 oder niedriger
• Geräte, die ein OTA-Upgrade auf Wear OS 5 erhalten.

Wenn Ihr vorhandenes Zifferblatt die Jetpack Watch Face Library oder die Wearable Support Library verwendet und auf einem dieser Geräte installiert ist, kann es weiterhin aktualisiert werden.

Auf neuen Smartwatches mit Wear OS 5 müssen Zifferblätter jedoch mit dem Watch Face-Format erstellt werden. Daher empfehlen wir Ihnen, auf das Zifferblattformat umzustellen.