Zusatzfunktionen zu einem Zifferblatt hinzufügen

In einer Zifferblatt-Komplikation werden Daten aus einer Datenquelle angezeigt. Mit dem Zifferblattformat können Sie die Datenquellen für die zugrunde liegenden Daten auswählen. So können auf Ihren Zifferblättern auch andere Informationen als die Uhrzeit angezeigt werden, ohne dass Sie Code zum Abrufen der Daten benötigen.

Watch Face-Format verwenden

Mit dem Element Complication können Sie bis zu acht Zusatzfunktionen für ein einzelnes Zifferblatt definieren. Mit dem Element können Sie auch definieren, wo auf dem Zifferblatt die einzelnen Zusatzfunktionen angezeigt werden.

Weitere Informationen finden Sie 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 Komplikationstyp 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 für das LONG_TEXT-Feld (null) zurückgegeben. Die Anzeige optionaler Felder kann nicht garantiert werden.





Eingeben Pflichtfelder Optionale Felder Hinweise
SHORT_TEXT Kurzer Text Symbol
Symbol für Burn-in-Schutz
Kurztitel
Beschreibung des Inhalts

Es wird nur ein Symbol oder ein kurzer Titel angezeigt, wenn eines oder beide angegeben sind.
MONOCHROMATIC_IMAGE Monochromes Bild
Symbol für den Einbrennschutz
Beschreibung des Inhalts

Wird verwendet, wenn kein Text erforderlich ist. Das Symbol sollte einfarbig sein und kann vom Zifferblatt eingefärbt werden.
RANGED_VALUE Wert
Mindestwert
Höchstwert
Monochromatisches Bild
Symbol für Burn-in-Schutz
Kurzer Text
Kurzer Titel
Farbverlauf
Dynamischer Wert
Inhaltsbeschreibung

Wenn Sie eine eigene Fortschrittsanzeige zeichnen möchten, können Sie die Methode isRangedValueProgressHidden() verwenden, um die von der Klasse ComplicationDrawable bereitgestellte Fortschrittsanzeige auszublenden.
GOAL_PROGRESS Wert
Zielwert
Monochromatisches Bild
Symbol für Burn-in-Schutz
Kurzer Text
Kurzer Titel
Farbverlauf
Dynamischer Wert
Inhaltsbeschreibung

GOAL_PROGRESS ist für Dinge wie die Anzahl der Schritte vorgesehen, bei denen der Wert bei null beginnt und den Zielwert überschreiten darf.
LONG_TEXT Langer Text
Langer Titel
Monochromatisches Bild
Symbol für Burn-in-Schutz
Kleines Bild
Inhaltsbeschreibung
Zeigt den langen Titel an, sofern er angegeben ist.
SMALL_IMAGE Kleines Bild
Inhaltsbeschreibung
Ein kleines Bild kann einen von zwei Stilen haben: Fotostil oder Symbolstil. Der Fotostil soll den Bereich ausfüllen und kann zugeschnitten werden. Das bedeutet, dass das Symbol nicht zugeschnitten, aber mit einem Innenabstand versehen werden kann. Aufgrund der Bildvariabilität kann es sein, dass ein Bild nicht für die Anzeige im Ambient-Modus auf Geräten mit Burn-in-Schutz oder mit Low-Bit-Ambient-Modus geeignet ist. Wenn der Burn-in-Schutz oder der Ambient-Modus mit niedriger Bitrate aktiviert ist, wird möglicherweise das kleine Bild für den Burn-in-Schutz verwendet, 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
Inhaltsbeschreibung
Dieses Bild sollte groß genug sein, um das Zifferblatt auszufüllen. Aufgrund der Bildvariabilität kann es sein, dass ein Bild nicht für die Anzeige im Ambient-Modus auf Geräten mit Burn-in-Schutz oder mit Low-Bit-Ambient-Modus 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 Inaktivmodus mit niedriger Bitrate aktiviert ist.
WEIGHTED_ELEMENTS Liste der Elemente
Monochromatisches Bild
Symbol für den Schutz vor Einbrennen
Kurzer Text
Kurzer Titel
Inhaltsbeschreibung
Jedes Element besteht aus einer Farbe und einem Gewicht (größer als null). Die Größe des gerenderten Elements sollte proportional zu seinem Gewicht sein. Die Gewichte müssen nicht auf einen bestimmten Wert summiert werden. Hinweis: Zifferblätter dürfen WEIGHTED_ELEMENTS neu einfärben.

In der folgenden Tabelle werden Komplikationstypen für leere Daten beschrieben, die für einen beliebigen Komplikations-Slot gesendet werden können. Diese Typen haben keine Felder und müssen nicht in eine Liste der unterstützten Typen aufgenommen werden. Diese Typen ermöglichen es Zifferblättern, zwischen den folgenden drei Fällen zu unterscheiden:

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

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

Zusatzfunktionstyp Beschreibung
TYPE_NOT_CONFIGURED Wird vom System gesendet, wenn eine Komplikation aktiviert wird, der Nutzer aber keine Quelle ausgewählt und keine Standardquelle festgelegt hat.

Kann nicht von Quellen gesendet werden.

TYPE_EMPTY Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird und der Nutzer „leer“ anstelle einer Quelle 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 Komplikation mit einer Quelle aktiviert wird, um die Komplikation zu löschen, bevor tatsächliche Daten von der Quelle empfangen werden.

Kann von Quellen gesendet werden, wenn keine tatsächlichen Daten gesendet werden müssen.

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

Wenn Ihr vorhandenes Zifferblatt die Jetpack Watch Face-Bibliothek oder die Wearable Support Library verwendet, sehen Nutzer auf den folgenden Geräten weiterhin Daten aus allen Datenquellen in den Zusatzfunktionen des Zifferblatts:

  • 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-Bibliothek 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. Aus diesem Grund empfehlen wir, zur Verwendung des Zifferblattformats zu migrieren.