Zusatzfunktionen

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

Im weiteren Verlauf dieses Dokuments werden Datenquellen, Zifferblätter und Zusatzfunktionen beschrieben.

Datenquelle für Zusatzfunktionen

Apps, die Daten zum Akkustand, zum Wetter oder zur Schrittzahl auf Zifferblättern für Zusatzfunktionen 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 freigeben.

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

Datenfluss für Zusatzfunktionen
Abbildung 1: Der Fluss von Daten für Zusatzfunktionen.

Zusatzfunktionen auf Zifferblättern

Zifferblatt empfangen Daten aus Datenquellen für Zusatzfunktionen. Dadurch können Zusatzfunktionen hinzugefügt werden, ohne dass Code zum Abrufen der zugrunde liegenden Daten erforderlich ist. Bei Zifferblättern wird die Kontrolle darüber gesteuert, wie die Daten gerendert werden, sodass sie sich auf natürliche Weise in ihr Design einbinden lassen. Weitere Informationen finden Sie im Designleitfaden zu Zusatzfunktionen.

Hinweis:In künftigen Versionen von Wear OS muss für Zifferblätter das Watch Face-Format verwendet werden, um Zusatzfunktionen zu unterstützen, die Nutzerdaten enthalten. Wir empfehlen, das Zifferblatt auf das Zifferblatt-Format umzustellen. Weitere Informationen zu diesen Änderungen an Zusatzfunktionen.

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

Typen von Zusatzfunktionen

Mit Komplikationstypen 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 erforderliche und optionale Felder definiert. Ein Pflichtfeld stellt das primäre Datenelement dar. Die meisten Typen übernehmen ihren Namen aus dem Pflichtfeld.

In Datenquellen werden Zusatzfunktionen anders als bei Zifferblättern verwendet:

  • Über eine Datenquelle werden die zu liefernden Zusatzdatentypen ausgewählt, einschließlich der optionalen Felder dieser Typen, die bereitgestellt werden sollen, und der Anzahl der verschiedenen Typen, die unterstützt werden können. So könnten beispielsweise eine Quelle für die Schrittzahl die Typen RANGED_VALUE und SHORT_TEXT und eine Quelle für die nächste Besprechung die Typen SHORT_TEXT und LONG_TEXT unterstützen.
  • Du kannst auswählen, wie viele Zusatzfunktionen auf deinem Zifferblatt angezeigt werden sollen und welche Typen von Zusatzfunktionen unterstützt werden sollen. Beispielsweise kann eine Zusatzfunktion auf einem Zifferblatt die Typen SHORT_TEXT, ICON und RANGED_VALUE unterstützen. Eine Anzeige 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, finden Sie unter Zusatzfunktionen.