Eine Zusatzfunktion ist jede Funktion, die zusätzlich zur Uhrzeit auf dem Zifferblatt angezeigt wird. Die Akkuanzeige ist beispielsweise eine Zusatzfunktion. Die Complications API eignet sich sowohl für Zifferblätter als auch für Datenquellen-Apps.
Im weiteren Verlauf dieses Dokuments werden Datenquellen, Zifferblätter und Zusatzfunktionen beschrieben.
Datenquelle für Zusatzfunktionen
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 Datenquellen liefern Rohdaten und sind nicht dafür verantwortlich, zu steuern, wie ihre Daten auf einem Zifferblatt gerendert werden. Informationen zum Schreiben von Apps, die Daten für Zifferblätter bereitstellen, findest du unter Daten für Zusatzfunktionen verfügbar machen.
Das folgende Diagramm zeigt, wie Wear OS by Google den Datenfluss von Quellen zu Zifferblättern vermittelt.
![Datenfluss für Zusatzfunktionen Datenfluss für Zusatzfunktionen](https://developer.android.com/static/wear/images/complications-data-flow.png?authuser=6&hl=de)
Zusatzfunktionen auf Zifferblättern
Zifferblätter empfangen Daten aus Datenquellen für Zusatzfunktionen. Dadurch können diese Daten hinzugefügt werden, ohne dass Code zum Abrufen der zugrunde liegenden Daten erforderlich ist. Zifferblätter haben die Kontrolle darüber, wie die Daten gerendert werden, und können sie ganz natürlich in ihr Design einbinden. Weitere Informationen findest du im Designleitfaden zu Zusatzfunktionen.
Informationen zum Hinzufügen von Zusatzfunktionen zu einem Zifferblatt findest du unter Zusatzfunktionen zum Zifferblatt hinzufügen.
Zusatzfunktionen
Mit Zusatzfunktionen wird definiert, welche Arten von Daten in einer Zusatzfunktion angezeigt oder von einer Datenquelle bereitgestellt werden können. Verwenden Sie beispielsweise den Typ SHORT_TEXT
, wenn die Daten hauptsächlich aus einem kurzen String bestehen. Ein
ComplicationData
-Objekt hat immer einen einzelnen Zusatzfunktionstyp, der Pflichtfelder und optionale Felder definiert. Ein Pflichtfeld stellt das primäre Datenelement dar. Die meisten Typen beziehen ihren Namen aus dem Pflichtfeld.
In Datenquellen werden Zusatzfunktionen anders verwendet als Zifferblätter:
- Über die Datenquelle wird festgelegt, welche Arten von Zusatzdaten bereitgestellt werden sollen, einschließlich der optionalen Felder dieser Typen und wie viele verschiedene Typen unterstützt werden können. Beispielsweise könnte eine Quelle für die Schrittzahl die Typen
RANGED_VALUE
undSHORT_TEXT
unterstützen, während eine Quelle für die nächste Besprechung möglicherweise die TypenSHORT_TEXT
undLONG_TEXT
unterstützt. - Du kannst festlegen, wie viele Zusatzfunktionen auf dem Zifferblatt angezeigt werden sollen und welche Arten von Zusatzfunktionen unterstützt werden sollen. Beispielsweise kann eine Einwahlfunktion auf einem Zifferblatt die Typen
SHORT_TEXT
,ICON
undRANGED_VALUE
unterstützen. Ein Anzeigegerät auf dem Zifferblatt unterstützt möglicherweise nur den TypRANGED_VALUE
.
Weitere Informationen zu den verschiedenen Zusatzfunktionen und Feldern, die von den einzelnen Typen unterstützt werden, findest du unter Zusatztypen.