Zusatzfunktionen

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

Im restlichen Teil dieses Dokuments werden Datenquellen, Zifferblätter und Komplikationstypen beschrieben.

Datenquelle für Komplikationen

Apps, die Daten wie Akkustand, Wetter oder 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, 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: Der Fluss von Komplikationsdaten.

Zusatzfunktionen auf Zifferblättern

Zifferblätter erhalten Daten aus Datenquellen für Komplikationen. So können sie Komplikationen einbinden, ohne dass Code für den Abruf der zugrunde liegenden Daten erforderlich ist. Zifferblätter behalten die Kontrolle darüber, wie die Daten gerendert werden, sodass sie Daten auf natürliche Weise in ihr Design integrieren können. Weitere Informationen finden Sie im Designleitfaden zu Komplikationen.

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

Zusatzfunktionstypen

Mit Komplikationstypen wird definiert, welche Arten von Daten in einer Komplikation 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 Typ für die Komplikation, der erforderliche und optionale Felder definiert. Ein Pflichtfeld stellt die primären Daten dar. Die meisten Typen leiten ihren Namen vom Pflichtfeld ab.

Datenquellen verwenden Komplikationstypen anders als Zifferblätter:

  • Eine Datenquelle wählt die Arten von Komplikationsdaten aus, die bereitgestellt werden sollen, einschließlich der optionalen Felder dieser Typen und der Anzahl der unterstützten Typen. Eine Quelle für Schrittzahlen unterstützt möglicherweise die Typen RANGED_VALUE und SHORT_TEXT, eine Quelle für das nächste Meeting die Typen SHORT_TEXT und LONG_TEXT.
  • Du kannst festlegen, wie viele Zusatzfunktionen auf deinem Zifferblatt angezeigt werden sollen und welche Arten von Zusatzfunktionen unterstützt werden sollen. Eine Zifferblatt-Zusatzfunktion auf einem Zifferblatt unterstützt möglicherweise die Typen SHORT_TEXT, SMALL_IMAGE und RANGED_VALUE. Ein Messgerät auf dem Zifferblatt unterstützt möglicherweise nur den Typ RANGED_VALUE.

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