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 dem Element können Sie 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 |
Zeigt nur ein Symbol oder einen kurzen Titel an, wenn entweder oder sind beide vorhanden. |
MONOCHROMATIC_IMAGE
|
Einfarbiges Bild |
Symbol für den Einbrennschutz Inhaltsbeschreibung |
Wird verwendet, wenn kein Text erforderlich ist. Das Symbol sollte einfarbig sein. und möglicherweise durch das Zifferblatt verfärbt. |
RANGED_VALUE
|
Wert Mindestwert Maximalwert |
Einfarbiges Bild Symbol für Einbrennschutz 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 Symbol für den Burn-in-Schutz Kurzer Text Kurzer Titel Farbrampe Dynamischer Wert Inhaltsbeschreibung |
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 für den Burn-in-Schutz Kleines Bild Inhaltsbeschreibung |
Zeigt den langen Titel an, falls angegeben. |
SMALL_IMAGE
|
Kleines Bild |
Inhaltsbeschreibung |
Für kleine Bilder gibt es zwei Stile: Fotostil oder Symbol
Stil. Der Fotostil gibt an, dass das Foto den gesamten Bereich ausfüllen soll und zugeschnitten werden kann. 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 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. Da es für eine Uhr schwierig ist,
wird kein Bild angezeigt.
|
LARGE_IMAGE
|
Großes Bild |
Inhaltsbeschreibung |
Dieses 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 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 einem Gewicht (größer als null). Die Größe des Elements beim Rendern sollte proportional zu seinem Gewicht 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 beliebigen Zusatzbereich gesendet werden. Diese Typen haben keine Felder und müssen nicht in einer Liste der unterstützten Typen enthalten sein. Mit diesen Typen wird 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 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 es wurde keine Standardeinstellung festgelegt.
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 verwenden
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 mit Wear OS 5 müssen Zifferblätter jedoch mit dem Watch Face-Format erstellt werden. Daher empfehlen wir Ihnen, auf das Zifferblattformat umzustellen.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Daten für Zusatzfunktionen von Zifferblättern in Wear OS bereitstellen
- Zusatzfunktion
- DefaultProviderPolicy