Zusatzfunktionen

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.

Abbildung 1. Datenfluss für Zusatzfunktionen

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 und SHORT_TEXT unterstützen, während eine Quelle für die nächste Besprechung möglicherweise die Typen SHORT_TEXT und LONG_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 und RANGED_VALUE unterstützen. Ein Anzeigegerät auf dem Zifferblatt unterstützt möglicherweise nur den Typ RANGED_VALUE.

Weitere Informationen zu den verschiedenen Zusatzfunktionen und Feldern, die von den einzelnen Typen unterstützt werden, findest du unter Zusatztypen.