Zusatzfunktionen zu einem Zifferblatt hinzufügen

Auf dem Zifferblatt ist eine Zusatzfunktion mit Daten aus einer Datenquelle zu sehen. Mit der Watch Face-Format: Sie können die Datenquellen für die zugrunde liegende Daten. So können auf Ihren Zifferblättern Informationen außerhalb der Tageszeit angezeigt werden ohne Code zum Abrufen der Daten zu benötigen.

Watch Face-Format verwenden

Mit dem Element Complication können Sie bis zu acht Zusatzfunktionen innerhalb nur ein einziges Zifferblatt. Mit diesem Element kannst du auch festlegen, wo auf dem Zifferblatt angezeigt wird.

Weitere Informationen finden Sie im WatchFaceFormat-Beispiel auf der GitHub

Typen und Felder

In der folgenden Tabelle werden die Typen und Felder der ComplicationData-Objekt. Wenn ein Zifferblatt ein ungültiges Feld anfordert Bei einem Zusatzfunktionstyp wird ein Standardwert für das Feld zurückgegeben. Beispiel: Wenn ein Zifferblatt versucht, auf ein LONG_TEXT-Feld in einem SHORT_TEXT-Typ zuzugreifen, wird das Für das Feld LONG_TEXT wird der Standardwert „null“ zurückgegeben. Optionale Felder für Hinweise werden nicht immer angezeigt.





Typ Pflichtfelder Optionale Felder Hinweise
SHORT_TEXT Kurzer Text Symbol
Symbol für Einbrennschutz
Kurzer Titel
Beschreibung des Inhalts

 Zeigt nur ein Symbol oder einen kurzen Titel an, wenn entweder oder werden beide bereitgestellt.
MONOCHROMATIC_IMAGE Einfarbiges Bild
 Symbol für Einbrennschutz
Beschreibung des Inhalts

 Wird verwendet, wenn kein Text erforderlich ist. Das Symbol sollte einfarbig sein. und möglicherweise durch das Zifferblatt verfärbt.
RANGED_VALUE Wert
Minimalwert
Maximalwert
 Einfarbiges Bild
Symbol für Einbrennschutz
Kurzer Text
Kurzer Titel
Farbverlauf
Dynamischer Wert
Beschreibung des Inhalts

 Wenn Sie eine eigene Fortschrittsanzeige erstellen möchten, verwenden Sie die <ph type="x-smartling-placeholder"></ph> isRangedValueProgressHidden()-Methode zum Ausblenden der Fortschrittsanzeige vom <ph type="x-smartling-placeholder"></ph> ComplicationDrawable.
GOAL_PROGRESS Wert
Zielwert
 Einfarbiges Bild
Symbol für Einbrennschutz
Kurzer Text
Kurzer Titel
Farbverlauf
Dynamischer Wert
Beschreibung des Inhalts

 GOAL_PROGRESS ist beispielsweise für die Schrittzahl vorgesehen, bei der der Wert beginnt. bei Null und darf den Zielwert überschreiten.
LONG_TEXT Langer Text
 Langer Titel
Einfarbiges Bild
Symbol für Einbrennschutz
Kleines Bild
Beschreibung des Inhalts
 Zeigt den langen Titel an, falls angegeben.
SMALL_IMAGE Kleines Bild
 Beschreibung des Inhalts
 Für kleine Bilder gibt es zwei Stile: Fotostil oder Symbol Stil. Als Fotostil wird erwartet, dass es den Raum ausfüllt und zugeschnitten. Symbolstil bedeutet, dass es nicht zugeschnitten und aufgefüllt werden kann. Bildvariabilität kann dazu führen, dass ein Bild nicht für die Darstellung geeignet ist im Inaktivmodus auf Geräten mit Einbrennschutz oder niedriger Bitrate Ambient-Modus zu wechseln. Wenn der Einbrennschutz oder der Low-Bit-Inaktivmodus aktiviert ist, verwendet das Zifferblatt möglicherweise den Einbrennschutz, ein kleines Bild weil es sicher ist. Da es für eine Uhr schwierig ist, wird kein Bild angezeigt.
LARGE_IMAGE Großes Bild
 Beschreibung des Inhalts
 Dieses Bild sollte groß genug sein, um das Zifferblatt auszufüllen. Bildvariabilität kann dazu führen, dass ein Bild nicht für die Darstellung geeignet ist im Inaktivmodus auf Geräten mit Einbrennschutz oder niedriger Bitrate Ambient-Modus zu wechseln. Da es von einem Zifferblatt schwer zu erkennen ist, Eignung für die Darstellung, Auf einem Zifferblatt wird kein Bild angezeigt im Inaktivmodus, wenn der Einbrennschutz oder Low-Bit-Inaktivmodus aktiviert ist.
WEIGHTED_ELEMENTS Elementliste
 Einfarbiges Bild
Symbol für Einbrennschutz
Kurzer Text
Kurzer Titel
Beschreibung des Inhalts
 Jedes Element besteht aus einer Farbe und einer Gewichtung (größer als null). Die Die Größe des Elements sollte beim Rendering proportional zu seiner Gewichtung sein. Gewichtungen müssen nicht in der Summe zu einem bestimmten Wert addiert werden. Hinweis: Zifferblätter dürfen die Farbe WEIGHTED_ELEMENTS ändern.

In der folgenden Tabelle werden Zusatzfunktionen für leere Daten beschrieben, die für jeden Zusatzbereich gesendet werden. Diese Typen haben keine Felder und müssen nicht in eine Liste der unterstützten Typen. Mit diesen Typen ist die Smartwatch zwischen den folgenden drei Fällen unterscheiden:

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

Quellen können TYPE_EMPTY nicht als Antwort senden auf Aktualisierungsanfragen. Stattdessen TYPE_NO_DATA senden.

Zusatzfunktionstyp Beschreibung
TYPE_NOT_CONFIGURED Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird, der Nutzer aber keine Quelle ausgewählt und es wurde keine Standardeinstellung festgelegt.

Kann nicht über Quellen gesendet werden.

TYPE_EMPTY Wird vom System gesendet, wenn eine Zusatzfunktion aktiviert wird und der Nutzer wählt „leer“ oder wenn das Zifferblatt wählt keine Quelle und diese Zusatzfunktion als Standard aus.

Kann nicht über Quellen gesendet werden.

TYPE_NO_DATA Wird vom System gesendet, wenn eine Zusatzfunktion mit einer Quelle gesendet wird wird aktiviert, um die Zusatzfunktion zu löschen, bevor Daten empfangen werden aus der Quelle.

Kann von Quellen gesendet werden, wenn keine echten Daten zum Senden vorhanden sind.

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

Wenn für Ihr vorhandenes Zifferblatt die Jetpack-Zifferblattbibliothek oder das In der Wearable-Supportbibliothek können Nutzer weiterhin Daten aus allen Datenquellen sehen in den Zusatzfunktionen auf dem Zifferblatt auf den folgenden Geräten:

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

Wenn Ihr vorhandenes Zifferblatt die Zifferblatt-Bibliothek von Jetpack verwendet, oder der Wearable-Supportbibliothek installiert ist und auf einem dieser Geräte installiert ist: kann das Zifferblatt weiterhin Updates erhalten.

Auf neuen Smartwatches, die mit Wear OS 5 auf den Markt gebracht wurden, müssen Zifferblätter jedoch die Watch Face-Format: Aus diesem Grund empfehlen wir, dass Sie zu Watch Face-Format.