Zusatzfunktionen

Eine Zusatzfunktion ist eine Funktion, die auf einem Zifferblatt zusätzlich zur Uhrzeit angezeigt wird. Ein Akku Symbol ist beispielsweise eine Zusatzfunktion. Die Complications API ist sowohl für Zifferblätter als auch für Datenquellen-Apps gedacht.

Im Rest dieses Dokuments werden Datenquellen, Zifferblätter und Zusatzfunktionstypen beschrieben.

Datenquelle einer Zusatzfunktion

Apps, die Daten wie den Akkustand, das Wetter oder die Schrittzahl für Zusatzfunktionen auf Zifferblättern bereitstellen, werden als Datenquellen für Zusatzfunktionen bezeichnet. Diese Daten quellen liefern Rohdaten und sind nicht dafür verantwortlich, wie ihre Daten auf einem Zifferblatt dargestellt werden. Informationen zum Schreiben von Apps, die Daten für Zifferblätter bereitstellen, finden Sie unter Daten für Zusatzfunktionen bereitstellen.

Das folgende Diagramm zeigt, wie Wear OS by Google den Datenfluss von Quellen zu Zifferblättern steuert.

Datenfluss für Zusatzfunktionen
Abbildung 1. Datenfluss von Zusatzfunktionen

Zusatzfunktionen auf Zifferblättern

Zifferblätter empfangen Daten von Datenquellen für Zusatzfunktionen. So können sie Zusatzfunktionen einbinden, ohne dass Code zum Abrufen der zugrunde liegenden Daten erforderlich ist. Zifferblätter behalten die Kontrolle darüber, wie die Daten dargestellt werden, sodass sie Daten auf natürliche Weise in ihr Design einbinden können. Weitere Informationen finden Sie im Designleitfaden zu Zusatzfunktionen.

Informationen zum Hinzufügen von Zusatzfunktionen zu einem Zifferblatt finden Sie unter Zusatzfunktion zu Zifferblatt hinzufügen.

Zusatzfunktionstypen

Zusatzfunktionstypen definieren, welche Arten von Daten in einer Zusatzfunktion angezeigt oder von einer Datenquelle bereitgestellt werden können. Verwenden Sie beispielsweise den SHORT_TEXT Typ, wenn die Daten hauptsächlich aus einem kurzen String bestehen. Ein ComplicationData-Objekt hat immer einen einzelnen Zusatzfunktionstyp, der erforderliche und optionale Felder definiert. Ein Pflichtfeld stellt das primäre Datenelement dar. Die meisten Typen sind nach dem Pflichtfeld benannt.

Datenquellen verwenden Zusatzfunktionstypen anders als Zifferblätter:

  • Eine Datenquelle wählt die Arten von Zusatzfunktionendaten aus, die bereitgestellt werden sollen, einschließlich der optionalen Felder dieser Typen und der Anzahl der unterstützten Typen. Eine Quelle für die Schrittzahl unterstützt beispielsweise die Typen RANGED_VALUE und SHORT_TEXT, während eine Quelle für das nächste Meeting die Typen SHORT_TEXT und LONG_TEXT unterstützt.
  • Sie können auswählen, wie viele Zusatzfunktionen auf dem Zifferblatt angezeigt werden sollen und welche Zusatzfunktionstypen unterstützt werden sollen. Eine Zifferblatt-Zusatzfunktion auf einem Zifferblatt unterstützt beispielsweise die Typen SHORT_TEXT, SMALL_IMAGE und RANGED_VALUE. Eine Anzeige auf dem Zifferblatt unterstützt möglicherweise nur den RANGED_VALUE Typ.

Weitere Informationen zu den verschiedenen Zusatzfunktionstypen und den von den einzelnen Typen unterstützten Feldern finden Sie unter Zusatzfunktionstypen.